Sign in

v1

latestOpenAPI 3.1.02026-07-24320172.9 KB

post/api/ramp/v2/swaporder/preview

Headers

Authorizationstring required

Request body

taxIdstring required

Field that uniquely identifies the individual or country. Only numbers accepted, all number should be sent, including leading zeros when applicable.

taxIdCountry'ALB' | 'AND' | 'ARE' | 'ARG' | 'ARM' | 'AUS' | 'AUT' | 'AZE' | 'BEL' | 'BGR' | 'BHR' | 'BIH' | 'BLR' | 'BOL' | 'BRA' | 'CAN' | 'CHE' | 'CHL' | 'CHN' | 'COL' | 'CRI' | 'CUB' | 'CYP' | 'CZE' | 'DEU' | 'DNK' | 'DOM' | 'ECU' | 'ESP' | 'EST' | 'FIN' | 'FLK' | 'FRA' | 'FRO' | 'GBR' | 'GEO' | 'GRC' | 'GTM' | 'GUF' | 'GUY' | 'HKG' | 'HRV' | 'HUN' | 'IDN' | 'IND' | 'IRL' | 'ISL' | 'ISR' | 'ITA' | 'JPN' | 'KAZ' | 'KOR' | 'LTU' | 'LUX' | 'LVA' | 'MCO' | 'MDA' | 'MEX' | 'MKD' | 'MLT' | 'MNE' | 'MUS' | 'MYS' | 'NGA' | 'NLD' | 'NOR' | 'NZL' | 'PAK' | 'PER' | 'PHL' | 'POL' | 'PRT' | 'PRY' | 'ROU' | 'RUS' | 'SLV' | 'SMR' | 'SRB' | 'SUR' | 'SVK' | 'SVN' | 'SWE' | 'THA' | 'TUR' | 'TWN' | 'UKR' | 'URY' | 'USA' | 'UZB' | 'VEN' | 'ZAF' required
externalIdstring

Field used for partner link a personal identifier

namestring

Holder's name

emailstring

Holder's email

depositBlockchain'None' | 'Ethereum' | 'BinanceSmartChain' | 'Solana' | 'Stellar' | 'Ripple' | 'Bitcoin' | 'Polygon' | 'Avalanche' | 'Polkadot' | 'Fantom' | 'Cosmos' | 'Terra' | 'Tron' | 'Optimism' | 'Arbitrum' | 'Tezos' | 'Rootstock' | 'Moonbeam' | 'Injective' | 'Sui' | 'Aptos' | 'Celo' | 'Aurora' | 'Cronos' | 'Base' | 'ZySync' | 'Linea' | 'Zeniq' | 'PolygonZvEVM' | 'Mantle' | 'TON' | 'BinancePay' | 'Gnosis' | 'Chiliz' | 'LightningNetwork'

Target deposit blockchain

refundCryptoAddressstring

Wallet address to auto-refund crypto in case of error during the flow

Response

OK

previewIdstring
blockchainFeenumber

Example response

{
  "previewId": "6294e109-35c2-442e-943d-3ef0204f2fe0",
  "quoteInformation": {
    "side": "Sell",
    "quoteId": "c5757347-fc16-4e68-a0f4-0ade57ab84eb",
    "baseCurrency": "USDC",
    "quoteCurrency": "MXN",
    "quoteAmount": 300,
    "price": 17.203439,
    "expireAt": "2025-12-15T21:50:32.415939+00:00"
  }
}