---
title: "Create a Ramp"
method: POST
path: "/api/ramp/v1/swaporder"
---

# Create a Ramp

`POST /api/ramp/v1/swaporder`

## Headers

- `Authorization` string, required

## Request body

- object
  - `taxId` string, 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 — The target country. It is obrigatory if param taxId is filled
  - `externalId` string — Field used for partner link a personal identifier
  - `name` string — Holder's name
  - `email` string — Holder's email
  - `quoteId` string — Previously generated quote Id by using the Request a Quote endpoint. Mandatory if the quoteRequest is not filled
  - `quoteRequest` object — Properties for quote request
    - `side` string — Specifies the direction of the trade relative to the BaseCurrency. Buy: You are buying the BaseCurrency, using the QuoteCurrency to pay. Sell: You are selling the BaseCurrency, receiving the QuoteCurrency in exchange
    - `baseCurrency` string — The ticker symbol of the primary currency in the pair
    - `quoteCurrency` string — The ticker symbol of the secondary currency in the pair
    - `baseAmount` number — The specific amount of the BaseCurrency you wish to trade. Note: You must define either BaseAmount or QuoteAmount. If you set a value here, QuoteAmount must be 0.
    - `quoteAmount` number — The specific amount of the QuoteCurrency you wish to trade. Note: You must define either BaseAmount or QuoteAmount. If you set a value here, BaseAmount must be 0.
  - `fiatWithdrawalInformation` object — Information for withdraw in off-ramp proccess. Only mandatory in off-ramp proccess
    - `bankAccount` string — Bank account number
    - `bankBranch` string — Bank's identifier
    - `accountType` string — The current account type in target bank
    - `iban` string — International bank account number
    - `key` string — Unique withdrawal information key
    - `qrCode` string — QR Code string for withdrawal
  - `cryptoWithdrawalInformation` object — Information for withdraw in on-ramp proccess. Only mandatory in on-ramp proccess
    - `blockchain` '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' | 'ZkSync' | 'Linea' | 'Zeniq' | 'PolygonZkEVM' | 'Mantle' | 'TONBinancePayGnosisChiliz' | 'LightningNetwork', required — Target blockchain
    - `key` string, required — The target wallet address
  - `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' | 'ZkSync' | 'Linea' | 'Zeniq' | 'PolygonZkEVM' | 'Mantle' | 'TON' | 'BinancePay' | 'Gnosis' | 'Chiliz' | 'LightningNetwork' — Target deposit blockchain
  - `refundCryptoAddress` string

## Response `200`

200

- object
  - `id` string
  - `currency` string
  - `blockchain` string
  - `depositAmount` number
  - `referenceId` string
  - `expireAt` string
  - `depositAddress` string
  - `blockchainFee` integer
  - `walletAddress` string
  - `base64QRCode` string

## Other responses

- `400` — 400
- `500` — 500

---

[API](https://skmtc.net/transfero/apis/authentication.md) · [All operations](https://skmtc.net/transfero/apis/authentication/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/transfero/authentication/versions/c1cf67f85267/schema)