GhostSwap

Create a new swap. Returns payinAddress where the end-user must send funds. REQUIRES refundAddress (the user's own wallet on the FROM chain). If the TO coin needs a memo / destination tag (requiresExtraId on list_currencies), pass it as extraId — without it the API returns missing_extra_id; only if the user confirms their wallet has no tag, send extraIdNotRequired=true. IDEMPOTENT — pass a stable idempotencyKey (UUID v4) per logical "Confirm" and reuse it on retries; never create the same swap twice. If a result has stop:true, relay its neutral userMessage and STOP — never speculate about the reason, never name an address, never suggest "try a different address", never retry.

Get the min and max swap amount for a single (from, to) pair. Returns separate min/max for float-rate and fixed-rate modes.

Get a live swap quote — rate, amountUserReceives, network fee, min/max. Always display amountUserReceives (not amountTo). mode="fixed" locks the rate and returns a short-lived rateId. The result includes swapUrl, a ghostswap.io link with this pair and amount filled in that the user can open to swap themselves.

Get the current status of a swap by id. Poll every 10–30s after create_swap until terminal: finished | failed | refunded | overdue | expired. `hold` = the swap is paused (poll slowly; tell the user to contact support@ghostswap.io with the swap id).

Get a ghostswap.io link that opens the swap with the coins (and optionally the amount) already filled in. Give it to the user when they want to do the swap themselves in the browser, or when create_swap isn't available. The link creates nothing and never carries an address: the user enters their own receiving and refund address on the page and presses Exchange. Tickers are network-specific (usdtrx = USDT on Tron, usdt20 = USDT on Ethereum). Check the amount against get_pair or get_quote first; below the minimum the page shows a warning.

List all coins GhostSwap supports for swapping (700+ assets). Use lite=true for just an array of tickers (e.g. ["btc","eth","ltc"]). Full metadata includes requiresExtraId + extraIdName: when the TO coin has requiresExtraId=true (XRP, XLM, ATOM, HBAR, TON…), collect the memo / destination tag before create_swap.

Check whether a wallet address is valid for a given currency. Returns {valid:true} or {valid:false,message}. Permissive pre-check — create_swap runs a stricter validator.