v1

latestOpenAPI 3.1.02026-07-24590534.0 KB

Create Instant swap

This endpoint is used to generate an instant swap quotation. Please note that the instant swap quotation is valid for only 15 seconds. To refresh the swap and obtain a new quotation, you can use the Refresh Instant Swap endpoint. https://docs.quidax.io/reference/refresh-instant-swap

post/users/{user_id}/swap_quotation

Path parameters

user_idstring required

The User ID. Use 'me' if fetching wallets of main authenticated user, use the user_id if fetching for Sub-account linked to the authenticated user

Request body

from_currency'btc' | 'ngn' | 'usdt' | 'eth' | 'xaut' | 'usdc' | 'trx' | 'dash' | 'ltc' | 'xrp' | 'sol' | 'qdx' | 'bnb' | 'doge' | 'usat' | 'link' | 'pol' | 'dot' | 'aave' | 'shib' | 'xlm' | 'cake' | 'ada' | 'bch' | 'slp' | 'floki' | 'cfx' | 'pepe' | 'bonk' | 'algo' | 'wif' | 'ton' | 'rndr' | 'xyo' | 'hype' | 'fartcoin' | 'cngn' | 'sui' | 'ghs' | 'lsk' | 'axcnh' | 'xaf' | 'xof' | 'zar' | 'kes' | 'axs' | 'fil' | 'babydoge' | 'one' | 'xtz' | 'sushi' | 'zil' | 'mana' | 'sand' | 'ape' | 'enj' | 'lrc' | 'wld' | 'meme' | 'ordi' | 'ens' | 'arb' | 'myro' | 'magatrump' | 'jup' | 'blur' | 'coq' | 'fet' | 'ai' | 'bob' | 'bome' | 'stx' | 'mog' | 'inj' | 'mnt' | 'beam' | 'mew' | 'gno' | 'waves' | 'trump' | 'pnut' | 'etc' | 'watson' | 'wlfi' | 'usd' | 'nochill' | 'kata' | 'slerf' | 'nos' | 'near' | 'strk' | 'zk' | 's'

the currency you are swapping from

to_currency'btc' | 'ngn' | 'usdt' | 'eth' | 'xaut' | 'usdc' | 'trx' | 'dash' | 'ltc' | 'xrp' | 'sol' | 'qdx' | 'bnb' | 'doge' | 'usat' | 'link' | 'pol' | 'dot' | 'aave' | 'shib' | 'xlm' | 'cake' | 'ada' | 'bch' | 'slp' | 'floki' | 'cfx' | 'pepe' | 'bonk' | 'algo' | 'wif' | 'ton' | 'rndr' | 'xyo' | 'hype' | 'fartcoin' | 'cngn' | 'sui' | 'ghs' | 'lsk' | 'axcnh' | 'xaf' | 'xof' | 'zar' | 'kes' | 'axs' | 'fil' | 'babydoge' | 'one' | 'xtz' | 'sushi' | 'zil' | 'mana' | 'sand' | 'ape' | 'enj' | 'lrc' | 'wld' | 'meme' | 'ordi' | 'ens' | 'arb' | 'myro' | 'magatrump' | 'jup' | 'blur' | 'coq' | 'fet' | 'ai' | 'bob' | 'bome' | 'stx' | 'mog' | 'inj' | 'mnt' | 'beam' | 'mew' | 'gno' | 'waves' | 'trump' | 'pnut' | 'etc' | 'watson' | 'wlfi' | 'usd' | 'nochill' | 'kata' | 'slerf' | 'nos' | 'near' | 'strk' | 'zk' | 's'

the currency you are swapping to.

from_amountstring

the amount you want to swap.

to_amountstring

the amount you want to swap.

Response

200

statusstring

messagestring

Example response

{
  "status": "success",
  "message": "Successful",
  "data": {
    "id": "0beeb71ed9fe9593e9f2e101f4c8b038",
    "from_currency": "USDT",
    "to_currency": "NGN",
    "quoted_price": "1382.54",
    "quoted_currency": "USDT",
    "from_amount": "100.0000",
    "to_amount": "138254.0000",
    "expires_at": "2026-02-13T15:15:20.442Z",
    "created_at": "2026-02-13T15:15:09.458Z",
    "updated_at": "2026-02-13T15:15:09.458Z",
    "user": {
      "id": "24rhpmow",
      "sn": "Qw1os7uj7",
      "email": "test@gmail.com",
      "first_name": "test",
      "last_name": "tester",
      "display_name": "Adigun Efon Exchange",
      "created_at": "2026-02-09T13:22:14.000Z",
      "updated_at": "2026-02-13T10:45:42.000Z"
    }
  }
}