# 2. Cryptocurrency exchange for fiat currency

Request method

POST

Request URL

/api/v1/exchange/express/trade/sell

Request Header

Content-Type: application/json; charset=utf-8

Request header parameter description

Parameter name	type	describe	Example Value
access_key	String	Access key obtained from the merchant backend	pFqV75X3
timestamp	int64	13-bit millisecond timestamp	1679724896223
nonce	String	UUID V4 random string	794c26b0-d33c-4394-b2bb-c485eca16d9e
sign	String	Calculate the generated signature value	kAXyh+eerqrefyaF8dyFB0M4FVo=

All parameters must be sent in the Header. Please refer to the data signature specification for signature generation.

# BRL

Request sample :

{
    "externalOrderId": "20250513192316237779",
    "chainType": "BSC",
    "tokenType": "USDT",
    "tokenAmount": "10.214234221423422312",
    "currencyType": "BRL",
    "payType": "PIX",
    "userInfoType" : "CNPJ" ,
    "userInfoNo": "05598146333",
    "userInfoName" : "Jaime de" ,
    "accountType": "EMAIL",
    "accountNo": "[email protected]",
    "remark" : "yuri test" ,
    "notifyUrl" : "https://test/testNotifySuccess"
}

Request parameter description

1. Skip First Screen Mode

Parameter name	type	Is this field required?	describe
externalOrderId	String	Yes	Merchant order number
chainType	String	Yes	Chain type BSC
tokenType	String	Yes	Token Type USDT
tokenAmount	String	Yes	Number of tokens
currencyType	String	Yes	Fiat currency type BRL
payType	String	Yes	Payment Type PIX
userInfoType	String	Yes	User information type CPF CNPJ
userInfoNo	String	Yes	User Information Number
userInfoName	String	Yes	Username
accountType	String	Yes	Account Type CPF CNPJ PHONE EMAIL EVP
accountNo	String	Yes	Account Number
remark	String	No	Transaction Notes
notifyUrl	String	No	Asynchronous notification callback address (public network address is recommended)
reviewQuote	String	No	Skip the quotation page: 1=Yes, 0=No (Default: 0)

2. Standard Quotation Mode

Parameter name	type	Is this field required?	describe
externalOrderId	String	No	Merchant order number
chainType	String	Yes	Blockchain type (BSC)
tokenType	String	Yes	Token type (USDT)
tokenAmount	String	No	Amount of tokens
currencyType	String	Yes	Fiat currency type (BRL)
payType	String	Yes	Payment type: PIX
userInfoType	String	No	User information type: CPF, CNPJ
userInfoNo	String	No	User information number
userInfoName	String	No	User name
accountType	String	No	Account type: CPF, CNPJ, PHONE, EMAIL, EVP
accountNo	String	No	Account number
remark	String	No	Transaction remark
notifyUrl	String	No	Asynchronous callback URL (preferably public URL)
reviewQuote	String	No	Whether to skip the quotation page: 1=Yes, 0=No (default: 0)

Example Response

Response Header Type

Content-Type: application/json; charset=utf-8

Response data (success)

{
    "code": "200",
    "success": true,
    "msg" : "Success" ,
    "msgEn": "SUCCESS",
    "data": {
        "chainType": "BSC",
        "currencyAmount": "57.31",
        "tokenAmount": "10.214234221423422312",
        "currencyType": "BRL",
        "tokenType": "USDT",
        "externalOrderId": "20250513192316237779",
        "orderId": "OEXCHEXCH202505131123171747135397709-U0000000401298841",
        "tradeType": "SELL",
        "addressTo": "0x369b87cbd5851b00c297fdcc461a68d0811ae5ae",
        "exchangePrice": "5.611",
        "orderFee": "1.15",
        "cashierUrl": "http://crypto/OEXCHEXCH202505131123171747135397709-U0000000401298841"
    }
}

Response Field Description

Param	Type	Desc
chainType	String	Chain Type
currencyAmount	String	Fiat Currency Amount
tokenAmount	String	Token Amount
currencyType	String	Fiat Currency Type
tokenType	String	Token Type
externalOrderId	String	Merchant Order ID
orderId	String	Order ID
tradeType	String	Trade Type
addressTo	String	Address
exchangePrice	String	Exchange Rate
orderFee	String	Transaction Fee
cashierUrl	String	Exchange Cashier URL

# INR

Request Example :

{
    "externalOrderId": "20250513184349208965",
    "chainType": "BSC",
    "tokenType": "USDT",
    "tokenAmount": "1",
    "currencyType": "INR",
    "payType": "BANK",
    "userInfoNo": "UTIB0001617",
    "userInfoName": "joy",
    "accountName": "BandhanBank",
    "accountNo": "000000",
    "remark": "test",
    "notifyUrl": "https://test/testNotifySuccess"
}

Request Parameter Explanation

1. Skip First Screen Mode

Parameter Name	Type	Required	Description
externalOrderId	String	Yes	Merchant order number
chainType	String	Yes	Blockchain type (BSC)
tokenType	String	Yes	Token type (USDT)
tokenAmount	String	Yes	Token amount
currencyType	String	Yes	Fiat currency type (INR)
payType	String	Yes	Payment type (BANK)
userInfoNo	String	Yes	User information number
userInfoName	String	No	User name
accountName	String	Yes	Account name
accountNo	String	Yes	Account number
remark	String	No	Transaction remark
notifyUrl	String	No	Asynchronous notification callback URL (suggested public URL)
reviewQuote	String	no	Skip the quotation page: 1=Yes, 0=No (Default: 0)

2. Standard Quotation Mode

Parameter Name	Type	Required	Description
externalOrderId	String	No	Merchant order number
chainType	String	Yes	Blockchain type (BSC)
tokenType	String	Yes	Token type (USDT)
tokenAmount	String	No	Amount of tokens
currencyType	String	Yes	Fiat currency type (INR)
payType	String	Yes	Payment type (BANK)
userInfoNo	String	No	User information number
userInfoName	String	No	User name
accountName	String	No	Account name
accountNo	String	No	Account number
remark	String	No	Transaction remark
notifyUrl	String	No	Asynchronous callback URL (preferably public URL)
reviewQuote	String	No	Whether to skip the quotation page: 1=Yes, 0=No (default: 0)

Response Example

Response Header Type

Content-Type: application/json; charset=utf-8

Response Data (Success)

{
    "code": "200",
    "success": true,
    "msg": "成功",
    "msgEn": "SUCCESS",
    "data": {
        "chainType": "BSC",
        "currencyAmount": "93.61",
        "tokenAmount": "1",
        "currencyType": "INR",
        "tokenType": "USDT",
        "externalOrderId": "20250513184349208965",
        "orderId": "OEXCHEXCH202505131043501747133030606-U0000000401298826",
        "tradeType": "SELL",
        "addressTo": "0x6871d4c9146d9d8d17ce540340989838064e783d",
        "exchangePrice": "93.6169",
        "orderFee": "1.16",
        "cashierUrl": "http://crypto/OEXCHEXCH202505131043501747133030606-U0000000401298826"
    }
}

Response Field Explanation

Param	Type	Desc
chainType	String	Main chain
currencyAmount	String	Fiat currency amount
tokenAmount	String	Token amount
currencyType	String	Fiat currency type
tokenType	String	Token type
externalOrderId	String	Merchant order number
orderId	String	Order number
tradeType	String	Trade type
addressTo	String	Address
exchangePrice	String	Exchange rate
orderFee	String	Transaction fee
cashierUrl	String	Exchange cashier URL

# MXN

Request Example :

{
	"externalOrderId": "20250513184349208965",
	"chainType": "BSC",
	"tokenType": "USDT",
	"tokenAmount": "1",
	"currencyType": "MXN",
	"payType": "BANK",
	"userInfoNo": "000681199509245710",
	"userInfoName": "Abraham Meza Aragon",
	"accountName": "BANSI",
	"accountNo": "0000800156793042",
    "accountType":"BANK_CARD",
	"remark": "test",
	"notifyUrl": "https://test/testNotifySuccess"
}

Request Parameter Explanation

1. Skip First Screen Mode

Parameter Name	Type	Required	Description
externalOrderId	String	Yes	Merchant order ID
chainType	String	Yes	Chain type (BSC)
tokenType	String	Yes	Token type (USDT)
tokenAmount	String	Yes	Token amount
currencyType	String	Yes	Fiat currency type (MXN)
payType	String	Yes	Payment type (BANK)
accountType	String	Yes	Account type (CLABE, BANK_CARD)
userInfoNo	String	Yes	Identification number
userInfoName	String	Yes	Bank account holder name
accountName	String	Yes	Bank name
accountNo	String	Yes	Bank account number
remark	String	No	Transaction remark
notifyUrl	String	No	Asynchronous notification callback URL (suggested: public URL)
reviewQuote	String	No	Skip quotation page: 1 = yes, 0 = no (default: 0)

2. Standard Quotation Mode

Parameter Name	Type	Required	Description
externalOrderId	String	No	Merchant order number
chainType	String	Yes	Blockchain type (BSC)
tokenType	String	Yes	Token type (USDT)
tokenAmount	String	No	Amount of tokens
currencyType	String	Yes	Fiat currency type (MXN)
payType	String	Yes	Payment type (BANK)
accountType	String	No	Account type (CLABE, BANK_CARD)
userInfoNo	String	No	ID number
userInfoName	String	No	Bank account name
accountName	String	No	Bank name
accountNo	String	No	Bank account number
remark	String	No	Transaction remark
notifyUrl	String	No	Asynchronous callback URL (preferably public URL)
reviewQuote	String	No	Whether to skip the quotation page: 1=Yes, 0=No (default: 0)

Response Example

Response Header Type

Content-Type: application/json; charset=utf-8

Response Data (Success)

{
	"code": "200",
	"success": true,
	"msg": "Success",
	"msgEn": "SUCCESS",
	"data": {
		"chainType": "BSC",
		"currencyAmount": "93.61",
		"tokenAmount": "1",
		"currencyType": "MXN",
		"tokenType": "USDT",
		"externalOrderId": "20250513184349208965",
		"orderId": "OEXCHEXCH202505131043501747133030606-U0000000401298826",
		"tradeType": "SELL",
		"addressTo": "0x6871d4c9146d9d8d17ce540340989838064e783d",
		"exchangePrice": "93.6169",
		"orderFee": "1.16",
		"cashierUrl": "http://crypto/OEXCHEXCH202505131043501747133030606-U0000000401298826"
	}
}

Response Field Explanation

Parameter Name	Type	Description
chainType	String	Main chain
currencyAmount	String	Fiat currency amount
tokenAmount	String	Token amount
currencyType	String	Fiat currency type
tokenType	String	Token type
externalOrderId	String	Merchant order ID
orderId	String	Order ID
tradeType	String	Transaction type
addressTo	String	Address
exchangePrice	String	Exchange rate
orderFee	String	Transaction fee
cashierUrl	String	Exchange cashier URL

# VND

Request Example :

{
	"externalOrderId": "YURITEST20250610100000831797",
	"chainType": "BSC",
	"tokenType": "USDT",
	"tokenAmount": "2.01243",
	"currencyType": "VND",
	"payType": "BANK",
	"accountName": "test bank",
	"accountNo": "123456789123456789",
	"userInfoName": "yuri",
	"reviewQuote": "1",
	"remark": "yuri test",
	"notifyUrl": ""
}

Request Parameter Explanation

1. Skip First Screen Mode

Parameter Name	Type	Required	Description
externalOrderId	String	Yes	Merchant order ID
chainType	String	Yes	Blockchain network (e.g. BSC)
tokenType	String	Yes	Token type (e.g. USDT)
tokenAmount	String	Yes	Token quantity
currencyType	String	Yes	Fiat currency (e.g. VND)
payType	String	Yes	Payment method (e.g. BANK)
userInfoName	String	Yes	Bank account holder name
accountName	String	Yes	Bank name
accountNo	String	Yes	Bank account number
remark	String	No	Transaction remarks
notifyUrl	String	No	Asynchronous callback URL (Public network recommended)
reviewQuote	String	No	Skip quote page: 1=Yes, 0=No (Default: 0)

2. Standard Quotation Mode

Parameter Name	Type	Required	Description
externalOrderId	String	No	Merchant order number
chainType	String	Yes	Blockchain type (BSC)
tokenType	String	Yes	Token type (USDT)
tokenAmount	String	No	Amount of tokens
currencyType	String	Yes	Fiat currency type (VND)
payType	String	Yes	Payment type (BANK)
userInfoName	String	No	Bank account name
accountName	String	No	Bank name
accountNo	String	No	Bank account number
remark	String	No	Transaction remark
notifyUrl	String	No	Asynchronous callback URL (preferably public URL)
reviewQuote	String	No	Whether to skip the quotation page: 1=Yes, 0=No (default: 0)

Response Example

Response Header Type

Content-Type: application/json; charset=utf-8

Response Data (Success)

{
	"code": "200",
	"success": true,
	"msg": "成功",
	"msgEn": "SUCCESS",
	"data": {
		"chainType": "BSC",
		"currencyAmount": "52729",
		"tokenAmount": "2.01243",
		"currencyType": "VND",
		"tokenType": "USDT",
		"externalOrderId": "YURITEST20250610100000831797",
		"orderId": "OEXCHEXCH202506100200011749520801125U0000000400000255",
		"tradeType": "SELL",
		"addressTo": "0x6871d4c9146d9d8d17ce540340989838064e783d",
		"exchangePrice": "26202",
		"orderFee": "1055",
		"cashierUrl": "http://ramp-cashier.io/crypto/OEXCHEXCH202506100200011749520801125U0000000400000255"
	}
}

Response Field Explanation

Parameter Name	Type	Description
chainType	String	Main chain
currencyAmount	String	Fiat currency amount
tokenAmount	String	Token amount
currencyType	String	Fiat currency type
tokenType	String	Token type
externalOrderId	String	Merchant order ID
orderId	String	Order ID
tradeType	String	Transaction type
addressTo	String	Address
exchangePrice	String	Exchange rate
orderFee	String	Transaction fee
cashierUrl	String	Exchange cashier URL

← 1. Fiat-to-cryptocurrency exchange 3. Quotes →