Sablebolt swaps

Creates the swap and returns the payment instruction: the one-time deposit address, the memo if the chain needs one, the exact amount in decimal and in base units with the decimals and token contract as listed by the provider, a wallet URI where a standard exists (BIP-21, ERC-681, Solana Pay, Monero, TON), and the status URL. Use it only when you control the wallet at fromAddress and will send the deposit yourself; for a person use get_swap_page_link, so they create the swap on the page with both addresses in front of them. The deposit must come from fromAddress. Not idempotent: calling it twice creates two swaps. There is no cancellation; a swap that cannot be completed is handled by support from the swap id. Floating rate: the final amount is set when the deposit confirms. Limited to 10 creations a minute per IP.

Get the minimum and maximum amount for one route, in the asset you send. Call it before get_quote or create_swap: an amount outside the limits is refused by both. For the estimate itself use get_quote. With mode=private the swap runs as two legs through an intermediate coin and the limits cover both legs. Limits are read live and can change between calls.

Get a floating estimate for a route and amount: amountTo, networkFee (taken out of the payout), receiveAmount (what arrives after that fee) and rate. Use it to tell a person what they would receive or to size a create_swap. Not for the allowed range (get_limits) and it creates nothing. The estimate is not a reservation: the final amount is set when the deposit confirms, and a quote read later may differ. With mode=private the response carries legs[] for the two legs.

Get the link to the page where a person completes the swap, with the route and, optionally, the amount prefilled; also the page's markdown twin and the hand-off rule. Use it whenever the person will send from their own wallet: they open the link, check the amount, both addresses and the memo on screen, then send the deposit. Not for an agent that controls the sending wallet: that agent uses create_swap. Builds the URL from the slugs on the server; it creates no swap, reserves no rate and calls no external service. mode=private opens the page with Private mode switched on; via=xmr together with mode=private opens it with Untraceable mode switched on. A swap for a person is completed by that person on the page: open the link, check the amount, both addresses and the memo on screen, then send the deposit from your own wallet. An agent that controls the sending wallet itself uses create_swap and pays the instruction it gets back.

Get the status of one swap by its id: status and stage (1 waiting for the deposit, 2 confirming, 3 exchanging, 4 sending, 5 finished), rateType (floating or fixed) with payTill (a fixed order's deposit deadline), deposit and payout addresses, amounts, both transaction hashes and the status page URL; while the deposit is awaited the response also carries the payment instruction. Amounts: receiveAmount is the estimate after the network fee; amountReceived is the deposit as credited once seen, and when it differs from amountFrom the estimate no longer applies; amountTo is the actual payout once known. Use it once a swap exists (the id comes from create_swap or from the status page URL). There is no account, so there is no list of swaps and no cancellation: the id is the only handle, and a swap that cannot be completed is handled by support from the swap id. For a price before a swap exists use get_quote. A swap that stops progressing keeps the last stage reached and is flagged in status. Poll at a sensible interval: the endpoint allows 60 requests a minute per IP.

List every asset the swap form knows: slug (the network is part of the slug, e.g. usdt-trc20, usdt-erc20), ticker, network, confirmations, the name of the extra id (memo, tag, payment ID) where the chain uses one, and whether the asset is available right now. Use it first, to turn a coin name into the slug that get_limits, get_quote, validate_address and create_swap expect. Not the list of documented routes: for the routes with their own page use list_routes. Returns the whole catalogue in one call, unavailable assets included with their availability flag; availability can change between calls. No arguments.

List the routes that have their own page on sablebolt.io: from and to slugs, a curated core, and whether both sides are available right now. Use it to find a documented route or to link its page. Not the limit of what can be swapped: any two assets from list_assets can be swapped through get_limits, get_quote and create_swap. No arguments.

Check whether an address has the right format for one asset. Use it on both addresses before get_swap_page_link or create_swap. Format only: it does not check who owns the address, whether it is in use, or whether an exchange needs a memo; when the asset uses an extra id the response names it (extraIdName). A 0x… address can belong to Ethereum, BNB Smart Chain, Polygon or Base: ask which network before choosing the asset. With mode=private and side=to the receiving address is checked at the provider that will pay it.