Convert

Endpoint

Accept the offered quote (USER_DATA)

Accept the offered quote by quote ID.

POST

/fapi/v1/convert/acceptQuote

https://fapi.binance.com

Accept the offered quote (USER_DATA) › Authorization

This is a signed endpoint and a signature must be included in the request parameters.Learn more about how to generate a valid signature in the Endpoint Security Type

Accept the offered quote (USER_DATA) › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight200

Accept the offered quote (USER_DATA) › Headers

X-MBX-APIKEY

string · required

An API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.

Example: API_KEY

Accept the offered quote (USER_DATA) › Request Body

quoteId

string · required

Example: 1

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

recvWindow

integer · int64 · max: 60000

Example: 5000

Accept the offered quote (USER_DATA) › Responses

200

Accept the offered quote

orderId

string

Example: 933256278426274426

createTime

integer · int64

Example: 1623381330472

orderStatus

string

Example: PROCESS

List All Convert Pairs

Query for all convertible token pairs and the tokens’ respective upper/lower limits

GET

/fapi/v1/convert/exchangeInfo

https://fapi.binance.com

List All Convert Pairs › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight20

List All Convert Pairs › Query Parameters

fromAsset

string

User spends coin

Example: BTC

toAsset

string

User receives coin

Example: USDT

List All Convert Pairs › Responses

200

List All Convert Pairs

object

fromAsset

string

Example: BTC

toAsset

string

Example: USDT

fromAssetMinAmount

string

Example: 0.0004

fromAssetMaxAmount

string

Example: 50

toAssetMinAmount

string

Example: 20

toAssetMaxAmount

string

Example: 2500000

Order status (USER_DATA)

Query order status by order ID.

GET

/fapi/v1/convert/orderStatus

https://fapi.binance.com

Order status (USER_DATA) › Authorization

This is a signed endpoint and a signature must be included in the request parameters.Learn more about how to generate a valid signature in the Endpoint Security Type

Order status (USER_DATA) › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight50

Order status (USER_DATA) › Headers

X-MBX-APIKEY

string · required

An API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.

Example: API_KEY

Order status (USER_DATA) › Query Parameters

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

orderId

string

Either orderId or quoteId is required

Example: 933256278426274400

quoteId

string

Either orderId or quoteId is required

Example: 1

Order status (USER_DATA) › Responses

200

Order status

orderId

integer · int64

Example: 933256278426274400

orderStatus

string

Example: SUCCESS

fromAsset

string

Example: BTC

fromAmount

string

Example: 0.00054414

toAsset

string

Example: USDT

toAmount

string

Example: 20

ratio

string

Example: 36755

inverseRatio

string

Example: 0.00002721

createTime

integer · int64

Example: 1623381330472

Send Quote Request (USER_DATA)

Request a quote for the requested token pairs

POST

/fapi/v1/convert/getQuote

https://fapi.binance.com

Send Quote Request (USER_DATA) › Authorization

This is a signed endpoint and a signature must be included in the request parameters.Learn more about how to generate a valid signature in the Endpoint Security Type

Send Quote Request (USER_DATA) › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight

50(IP) 360/hour, 500/day

Send Quote Request (USER_DATA) › Headers

X-MBX-APIKEY

string · required

An API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.

Example: API_KEY

Send Quote Request (USER_DATA) › Request Body

fromAsset

string · required

Example: BTC

toAsset

string · required

Example: USDT

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

fromAmount

number · float

When specified, it is the amount you will be debited after the conversion

Example: 1.0

toAmount

number · float

When specified, it is the amount you will be credited after the conversion

Example: 1.0

validTime

string

10s, default 10s

Example: 10s

recvWindow

integer · int64 · max: 60000

Example: 5000

Send Quote Request (USER_DATA) › Responses

200

Send Quote Request

quoteId

string

Example: 12415572564

ratio

string

Example: 38163.7

inverseRatio

string

Example: 0.0000262

validTimestamp

integer · int64

Example: 1623319461670

toAmount

string

Example: 3816.37

fromAmount

string

Example: 0.1

Convert

Endpoint

Download schema

Accept the offered quote (USER_DATA)

Accept the offered quote by quote ID.

POST

/fapi/v1/convert/acceptQuote

https://fapi.binance.com

Accept the offered quote (USER_DATA) › Authorization

This is a signed endpoint and a signature must be included in the request parameters.Learn more about how to generate a valid signature in the Endpoint Security Type

Accept the offered quote (USER_DATA) › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight200

Accept the offered quote (USER_DATA) › Headers

X-MBX-APIKEY

string · required

An API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.

Example: API_KEY

Accept the offered quote (USER_DATA) › Request Body

quoteId

string · required

Example: 1

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

recvWindow

integer · int64 · max: 60000

Example: 5000

Accept the offered quote (USER_DATA) › Responses

200

Accept the offered quote

orderId

string

Example: 933256278426274426

createTime

integer · int64

Example: 1623381330472

orderStatus

string

Example: PROCESS

List All Convert Pairs

Query for all convertible token pairs and the tokens’ respective upper/lower limits

GET

/fapi/v1/convert/exchangeInfo

https://fapi.binance.com

List All Convert Pairs › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight20

List All Convert Pairs › Query Parameters

fromAsset

string

User spends coin

Example: BTC

toAsset

string

User receives coin

Example: USDT

List All Convert Pairs › Responses

200

List All Convert Pairs

object

fromAsset

string

Example: BTC

toAsset

string

Example: USDT

fromAssetMinAmount

string

Example: 0.0004

fromAssetMaxAmount

string

Example: 50

toAssetMinAmount

string

Example: 20

toAssetMaxAmount

string

Example: 2500000

Order status (USER_DATA)

Query order status by order ID.

GET

/fapi/v1/convert/orderStatus

https://fapi.binance.com

Order status (USER_DATA) › Authorization

This is a signed endpoint and a signature must be included in the request parameters.Learn more about how to generate a valid signature in the Endpoint Security Type

Order status (USER_DATA) › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight50

Order status (USER_DATA) › Headers

X-MBX-APIKEY

string · required

An API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.

Example: API_KEY

Order status (USER_DATA) › Query Parameters

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

orderId

string

Either orderId or quoteId is required

Example: 933256278426274400

quoteId

string

Either orderId or quoteId is required

Example: 1

Order status (USER_DATA) › Responses

200

Order status

orderId

integer · int64

Example: 933256278426274400

orderStatus

string

Example: SUCCESS

fromAsset

string

Example: BTC

fromAmount

string

Example: 0.00054414

toAsset

string

Example: USDT

toAmount

string

Example: 20

ratio

string

Example: 36755

inverseRatio

string

Example: 0.00002721

createTime

integer · int64

Example: 1623381330472

Send Quote Request (USER_DATA)

Request a quote for the requested token pairs

POST

/fapi/v1/convert/getQuote

https://fapi.binance.com

Send Quote Request (USER_DATA) › Authorization

This is a signed endpoint and a signature must be included in the request parameters.Learn more about how to generate a valid signature in the Endpoint Security Type

Send Quote Request (USER_DATA) › Request Weight

This endpoint consumes IP-based request weight. Heavier endpoints consume more of your IP rate limit capacity.

Learn more in the Rate limits section.

IP Weight

50(IP) 360/hour, 500/day

Send Quote Request (USER_DATA) › Headers

X-MBX-APIKEY

string · required

An API Key is required to access this endpoint and must be included in the request headers. To create an API Key, refer to: https://www.binance.com/en/support/faq/detail/360002502072.

Example: API_KEY

Send Quote Request (USER_DATA) › Request Body

fromAsset

string · required

Example: BTC

toAsset

string · required

Example: USDT

timestamp

integer · int64 · required

Unix timestamp in milliseconds used to sign the request. The value must reflect the current client time and is validated by the server for signed endpoints.

Example: 1770736694138

fromAmount

number · float

When specified, it is the amount you will be debited after the conversion

Example: 1.0

toAmount

number · float

When specified, it is the amount you will be credited after the conversion

Example: 1.0

validTime

string

10s, default 10s

Example: 10s

recvWindow

integer · int64 · max: 60000

Example: 5000

Send Quote Request (USER_DATA) › Responses

200

Send Quote Request

quoteId

string

Example: 12415572564

ratio

string

Example: 38163.7

inverseRatio

string

Example: 0.0000262

validTimestamp

integer · int64

Example: 1623319461670

toAmount

string

Example: 3816.37

fromAmount

string

Example: 0.1