Trade

Endpoint

Accept Quote

Accept the offered quote by quote ID.

POST

/sapi/v1/convert/acceptQuote

https://api.binance.com

Accept Quote › 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 Quote › Request Weight

This endpoint consumes account (UID)-based request weight. Heavier endpoints consume more of your account rate limit capacity.

Learn more in the Rate limits section.

Account Weight500

Accept Quote › 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 Quote › 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

Request validity window in milliseconds

Example: 5000

Accept Quote › Responses

200

Accept Quote

orderId

string

Example: 933256278426274426

createTime

integer · int64

Example: 1623381330472

orderStatus

string · enum

Order processing status

Enum values:

PROCESS

ACCEPT_SUCCESS

SUCCESS

FAIL

Example: PROCESS

Cancel limit order

Enable users to cancel a limit order

POST

/sapi/v1/convert/limit/cancelOrder

https://api.binance.com

Cancel limit order › 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

Cancel limit order › Request Weight

This endpoint consumes account (UID)-based request weight. Heavier endpoints consume more of your account rate limit capacity.

Learn more in the Rate limits section.

Account Weight200

Cancel limit order › 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

Cancel limit order › Request Body

orderId

integer · int64 · required

The orderId from placeOrder api

Example: 1603680255057330400

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

Request validity window in milliseconds

Example: 5000

Cancel limit order › Responses

200

Cancel limit order

orderId

integer · int64

Example: 1603680255057330400

status

string

Example: CANCELED

Get Convert Trade History

GET

/sapi/v1/convert/tradeFlow

https://api.binance.com

Get Convert Trade History › 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

Get Convert Trade History › Request Weight

This endpoint consumes account (UID)-based request weight. Heavier endpoints consume more of your account rate limit capacity.

Learn more in the Rate limits section.

Account Weight3000

Get Convert Trade History › 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

Get Convert Trade History › Query Parameters

startTime

integer · int64 · required

Example: 1623319461670

endTime

integer · int64 · required

Example: 1641782889000

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

limit

integer · int64 · max: 1000

Number of records to return

Example: 100

Default: 100

recvWindow

integer · int64 · max: 60000

Request validity window in milliseconds

Example: 5000

Get Convert Trade History › Responses

200

Get Convert Trade History

object[]

startTime

integer · int64

Example: 1623824139000

endTime

integer · int64

Example: 1626416139000

limit

integer · int64

Example: 100

moreData

boolean

Example: false

Order status

Query order status by order ID.

GET

/sapi/v1/convert/orderStatus

https://api.binance.com

Order status › 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 › Request Weight

This endpoint consumes account (UID)-based request weight. Heavier endpoints consume more of your account rate limit capacity.

Learn more in the Rate limits section.

Account Weight100

Order status › 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 › 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: 1

quoteId

string

Either orderId or quoteId is required

Example: 1

Order status › 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

Place limit order

Enable users to place a limit order

POST

/sapi/v1/convert/limit/placeOrder

https://api.binance.com

Place limit order › 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

Place limit order › Request Weight

This endpoint consumes account (UID)-based request weight. Heavier endpoints consume more of your account rate limit capacity.

Learn more in the Rate limits section.

Account Weight500

Place limit order › 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

Place limit order › Request Body

baseAsset

string · required

base asset (use the response fromIsBase from GET /sapi/v1/convert/exchangeInfo api to check which one is baseAsset )

Example: BTC

quoteAsset

string · required

quote asset

Example: USDT

limitPrice

number · float · required

Symbol limit price (from baseAsset to quoteAsset)

Example: 1

side

string · enum · required

BUY or SELL

Enum values:

BUY

SELL

Example: BUY

expiredType

string · enum · required

Order expiry duration. 1_D, 3_D, 7_D, 30_D (D means day)

Enum values:

1_D

3_D

7_D

30_D

Example: 1_D

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

baseAmount

number · float

Base asset amount. (One of baseAmount or quoteAmount is required)

Example: 1

quoteAmount

number · float

Quote asset amount. (One of baseAmount or quoteAmount is required)

Example: 1

walletType

string · enum

Wallet to use for payment. Supported values: SPOT, FUNDING, EARN. Combined wallets also supported: SPOT_FUNDING, FUNDING_EARN, SPOT_FUNDING_EARN, SPOT_EARN. Default is SPOT.

Enum values:

SPOT

FUNDING

EARN

SPOT_FUNDING

FUNDING_EARN

SPOT_FUNDING_EARN

SPOT_EARN

Example: SPOT

Default: SPOT

recvWindow

integer · int64 · max: 60000

Request validity window in milliseconds

Example: 5000

Place limit order › Responses

200

Place limit order

orderId

integer · int64

Example: 1603680255057330400

status

string

Example: PROCESS

Query limit open orders

Query current open limit orders

GET

/sapi/v1/convert/limit/queryOpenOrders

https://api.binance.com

Query limit open orders › 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

Query limit open orders › Request Weight

This endpoint consumes account (UID)-based request weight. Heavier endpoints consume more of your account rate limit capacity.

Learn more in the Rate limits section.

Account Weight3000

Query limit open orders › 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

Query limit open orders › 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

recvWindow

integer · int64 · max: 60000

Request validity window in milliseconds

Example: 5000

Query limit open orders › Responses

200

limit open orders

object[]

Send Quote Request

Request a quote for the requested token pairs

POST

/sapi/v1/convert/getQuote

https://api.binance.com

Send Quote Request › 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 › Request Weight

This endpoint consumes account (UID)-based request weight. Heavier endpoints consume more of your account rate limit capacity.

Learn more in the Rate limits section.

Account Weight200

Send Quote Request › 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 › 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

toAmount

number · float

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

Example: 1

walletType

string · enum

Wallet to use for payment. Supported values: SPOT, FUNDING, EARN. Combined wallets also supported: SPOT_FUNDING, FUNDING_EARN, SPOT_FUNDING_EARN, SPOT_EARN. Default is SPOT.

Enum values:

SPOT

FUNDING

EARN

SPOT_FUNDING

FUNDING_EARN

SPOT_FUNDING_EARN

SPOT_EARN

Example: SPOT

Default: SPOT

validTime

string · enum

Quote valid duration. Supported values: 10s, 30s, 1m. Default is 10s.

Enum values:

10s

30s

Example: 10s

Default: 10s

recvWindow

integer · int64 · max: 60000

Request validity window in milliseconds

Example: 5000

Send Quote Request › 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

Trade

Endpoint

Download schema

Accept Quote

Accept the offered quote by quote ID.

POST

/sapi/v1/convert/acceptQuote

https://api.binance.com

Accept Quote › 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 Quote › Request Weight

This endpoint consumes account (UID)-based request weight. Heavier endpoints consume more of your account rate limit capacity.

Learn more in the Rate limits section.

Account Weight500

Accept Quote › 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 Quote › 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

Request validity window in milliseconds

Example: 5000

Accept Quote › Responses

200

Accept Quote

orderId

string

Example: 933256278426274426

createTime

integer · int64

Example: 1623381330472

orderStatus

string · enum

Order processing status

Enum values:

PROCESS

ACCEPT_SUCCESS

SUCCESS

FAIL

Example: PROCESS

Cancel limit order

Enable users to cancel a limit order

POST

/sapi/v1/convert/limit/cancelOrder

https://api.binance.com

Cancel limit order › 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

Cancel limit order › Request Weight

This endpoint consumes account (UID)-based request weight. Heavier endpoints consume more of your account rate limit capacity.

Learn more in the Rate limits section.

Account Weight200

Cancel limit order › 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

Cancel limit order › Request Body

orderId

integer · int64 · required

The orderId from placeOrder api

Example: 1603680255057330400

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

Request validity window in milliseconds

Example: 5000

Cancel limit order › Responses

200

Cancel limit order

orderId

integer · int64

Example: 1603680255057330400

status

string

Example: CANCELED

Get Convert Trade History

GET

/sapi/v1/convert/tradeFlow

https://api.binance.com

Get Convert Trade History › 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

Get Convert Trade History › Request Weight

This endpoint consumes account (UID)-based request weight. Heavier endpoints consume more of your account rate limit capacity.

Learn more in the Rate limits section.

Account Weight3000

Get Convert Trade History › 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

Get Convert Trade History › Query Parameters

startTime

integer · int64 · required

Example: 1623319461670

endTime

integer · int64 · required

Example: 1641782889000

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

limit

integer · int64 · max: 1000

Number of records to return

Example: 100

Default: 100

recvWindow

integer · int64 · max: 60000

Request validity window in milliseconds

Example: 5000

Get Convert Trade History › Responses

200

Get Convert Trade History

object[]

startTime

integer · int64

Example: 1623824139000

endTime

integer · int64

Example: 1626416139000

limit

integer · int64

Example: 100

moreData

boolean

Example: false

Order status

Query order status by order ID.

GET

/sapi/v1/convert/orderStatus

https://api.binance.com

Order status › 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 › Request Weight

This endpoint consumes account (UID)-based request weight. Heavier endpoints consume more of your account rate limit capacity.

Learn more in the Rate limits section.

Account Weight100

Order status › 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 › 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: 1

quoteId

string

Either orderId or quoteId is required

Example: 1

Order status › 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

Place limit order

Enable users to place a limit order

POST

/sapi/v1/convert/limit/placeOrder

https://api.binance.com

Place limit order › 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

Place limit order › Request Weight

This endpoint consumes account (UID)-based request weight. Heavier endpoints consume more of your account rate limit capacity.

Learn more in the Rate limits section.

Account Weight500

Place limit order › 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

Place limit order › Request Body

baseAsset

string · required

base asset (use the response fromIsBase from GET /sapi/v1/convert/exchangeInfo api to check which one is baseAsset )

Example: BTC

quoteAsset

string · required

quote asset

Example: USDT

limitPrice

number · float · required

Symbol limit price (from baseAsset to quoteAsset)

Example: 1

side

string · enum · required

BUY or SELL

Enum values:

BUY

SELL

Example: BUY

expiredType

string · enum · required

Order expiry duration. 1_D, 3_D, 7_D, 30_D (D means day)

Enum values:

1_D

3_D

7_D

30_D

Example: 1_D

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

baseAmount

number · float

Base asset amount. (One of baseAmount or quoteAmount is required)

Example: 1

quoteAmount

number · float

Quote asset amount. (One of baseAmount or quoteAmount is required)

Example: 1

walletType

string · enum

Wallet to use for payment. Supported values: SPOT, FUNDING, EARN. Combined wallets also supported: SPOT_FUNDING, FUNDING_EARN, SPOT_FUNDING_EARN, SPOT_EARN. Default is SPOT.

Enum values:

SPOT

FUNDING

EARN

SPOT_FUNDING

FUNDING_EARN

SPOT_FUNDING_EARN

SPOT_EARN

Example: SPOT

Default: SPOT

recvWindow

integer · int64 · max: 60000

Request validity window in milliseconds

Example: 5000

Place limit order › Responses

200

Place limit order

orderId

integer · int64

Example: 1603680255057330400

status

string

Example: PROCESS

Query limit open orders

Query current open limit orders

GET

/sapi/v1/convert/limit/queryOpenOrders

https://api.binance.com

Query limit open orders › 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

Query limit open orders › Request Weight

This endpoint consumes account (UID)-based request weight. Heavier endpoints consume more of your account rate limit capacity.

Learn more in the Rate limits section.

Account Weight3000

Query limit open orders › 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

Query limit open orders › 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

recvWindow

integer · int64 · max: 60000

Request validity window in milliseconds

Example: 5000

Query limit open orders › Responses

200

limit open orders

object[]

Send Quote Request

Request a quote for the requested token pairs

POST

/sapi/v1/convert/getQuote

https://api.binance.com

Send Quote Request › 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 › Request Weight

This endpoint consumes account (UID)-based request weight. Heavier endpoints consume more of your account rate limit capacity.

Learn more in the Rate limits section.

Account Weight200

Send Quote Request › 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 › 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

toAmount

number · float

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

Example: 1

walletType

string · enum

Wallet to use for payment. Supported values: SPOT, FUNDING, EARN. Combined wallets also supported: SPOT_FUNDING, FUNDING_EARN, SPOT_FUNDING_EARN, SPOT_EARN. Default is SPOT.

Enum values:

SPOT

FUNDING

EARN

SPOT_FUNDING

FUNDING_EARN

SPOT_FUNDING_EARN

SPOT_EARN

Example: SPOT

Default: SPOT

validTime

string · enum

Quote valid duration. Supported values: 10s, 30s, 1m. Default is 10s.

Enum values:

10s

30s

Example: 10s

Default: 10s

recvWindow

integer · int64 · max: 60000

Request validity window in milliseconds

Example: 5000

Send Quote Request › 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