Trade

Endpoint

Download schema

Query Special key(Low Latency Trading)

Query Special Key Information.

This only applies to Special Key for Low Latency Trading.

GET

/sapi/v1/margin/apiKey

https://api.binance.com

Query Special key(Low Latency Trading) › 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 Special key(Low Latency Trading) › 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 Weight1

Query Special key(Low Latency Trading) › 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 Special key(Low Latency Trading) › Query Parameters

apiKey

string · required

Example: API_KEY

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

symbol

string

Example: BTCUSDT

recvWindow

integer · int64 · max: 60000

Example: 5000

Query Special key(Low Latency Trading) › Responses

200

Special key

apiKey

string

api Key.

Example: npOzOAeLVgr2TuxWfNo43AaPWpBbJEoKezh1o8mSQb6ryE2odE11A4AoVlJbQoGx

ip

string

0.0.0.0 is just an initial statereference (no extra meaning).

Example: 0.0.0.0,192.168.0.1,192.168.0.2

apiName

string

api Name.

Example: testName

type

string

type.

Example: RSA

permissionMode

string

permission Mode.

Example: TRADE

Create Special Key(Low-Latency Trading)

Eligibility

Binance Margin offers low-latency trading through a special key, available exclusively to users with VIP level 7 or higher.
If you are VIP level 6 or below, please contact your VIP manager for eligibility criterias.
All new Margin Special Key users are required to read, understand, and agree to the Margin Special Key Supplemental Product Terms at the master account level before creating a Margin Special Key.
Once signed at the master account level, the agreement applies to all sub-accounts. The master account and all sub-accounts (Cross Margin Classic and Portfolio Margin Pro) are authorized to create a Margin Special Key and are subject to the LiquidationLoan policy.

For more information, please refer to FAQ.

Supported Products:

Cross Margin
Isolated Margin
Portfolio Margin Pro

Unsupported Products:

Portfolio Margin

We support several types of API keys:

Ed25519 (recommended)
HMAC
RSA

We recommend to use Ed25519 API keys as it should provide the best performance and security out of all supported key types. We accept PKCS#8 (BEGIN PUBLIC KEY). For how to generate an RSA key pair to send API requests on Binance. Please refer to the document below FAQ .

How to use the Margin Special Key

Use the below sapi endpoint to create your margin special API Key.
For accessing the Cross Margin account, do not send the symbol parameter.
For accessing the Isolated Margin account(s), pass the relevant symbol parameter in the API Key creation request.
Use the generated API Key (and Secret key, if applicable) to perform margin trading and listenKey generation via Spot REST API (https://api.binance.com/api/v3/*) endpoints.

Read REST API or WebSocket API documentation to learn how to use different API keys

You need to enable Permits “Enable Spot & Margin Trading” option for the API Key which requests this endpoint.

POST

/sapi/v1/margin/apiKey

https://api.binance.com

Create Special Key(Low-Latency Trading) › 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

Create Special Key(Low-Latency Trading) › 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 Weight1

Create Special Key(Low-Latency Trading) › 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

Create Special Key(Low-Latency Trading) › Request Body

apiName

string · required

Example: apiName

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

symbol

string

Example: BTCUSDT

ip

string

Can be added in batches, separated by commas. Max 30 for an API key

Example: 69.210.67.14,69.210.67.15

publicKey

string

If publicKey is inputted it will create an RSA or Ed25519 key.
Need to be encoded to URL-encoded format

Example: publicKey

permissionMode

string · enum

This parameter is only for the Ed25519 API key, and does not effact for other encryption methods. The value can be TRADE (TRADE for all permissions) or READ (READ for USER_DATA, FIX_API_READ_ONLY). The default value is TRADE.

Enum values:

TRADE

READ

Example: READ

Default: TRADE

recvWindow

integer · int64 · max: 60000

Example: 5000

Create Special Key(Low-Latency Trading) › Responses

200

Create Special Key

apiKey

string

api Key.

Example: npOzOAeLVgr2TuxWfNo43AaPWpBbJEoKezh1o8mSQb6ryE2odE11A4AoVlJbQoGx

secretKey

string

secretKey will be null when creating an RSA key

Example: 87ssWB7azoy6ACRfyp6OVOL5U3rtZptX31QWw2kWjl1jHEYRbyM1pd6qykRBQw8p

type

string

HMAC_SHA256 or RSA

Example: HMAC_SHA256

Delete Special Key(Low-Latency Trading)

Deleting your Margin Special Key alone does not exit you from the Margin Special Key framework or discharge your obligations under the Margin Special Key Supplemental Product Terms. To fully exit, you must:

Delete your Margin Special Key.
Ensure there are no outstanding liabilities on the account.
Call the Exit Margin Special Key API endpoint.
Confirm the exit status via the API response.

Only after step 4 is completed and the exit status is confirmed by Binance will your account revert to standard liquidation logic and no longer be subject to the Margin Special Key Supplemental Product Terms.

If apiKey is given, apiName will be ignored. If apiName is given with no apiKey, all apikeys with given apiName will be deleted.

You need to enable Permits “Enable Spot & Margin” option for the API Key which requests this endpoint.

DELETE

/sapi/v1/margin/apiKey

https://api.binance.com

Delete Special Key(Low-Latency Trading) › 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

Delete Special Key(Low-Latency Trading) › 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 Weight1

Delete Special Key(Low-Latency Trading) › 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

Delete Special Key(Low-Latency Trading) › 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

apiKey

string

Example: apiKey

apiName

string

Example: apiName

symbol

string

isolated margin pair

Example: BTCUSDT

recvWindow

integer · int64 · max: 60000

Example: 5000

Delete Special Key(Low-Latency Trading) › Responses

200

No data returned

Edit ip for Special Key(Low-Latency Trading)

Edit ip restriction. This only applies to Special Key for Low Latency Trading.

You need to enable Permits “Enable Spot & Margin” option for the API Key which requests this endpoint.

PUT

/sapi/v1/margin/apiKey/ip

https://api.binance.com

Edit ip for Special Key(Low-Latency Trading) › 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

Edit ip for Special Key(Low-Latency Trading) › 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 Weight1

Edit ip for Special Key(Low-Latency Trading) › 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

Edit ip for Special Key(Low-Latency Trading) › Request Body

apiKey

string · required

Example: apiKey

ip

string · required

Can be added in batches, separated by commas. Max 30 for an API key

Example: 24.156.99.202

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

symbol

string

isolated margin pair

Example: BTCUSDT

recvWindow

integer · int64 · max: 60000

Example: 5000

Edit ip for Special Key(Low-Latency Trading) › Responses

200

No data returned

Exit Special Key Mode (TRADE)

Exit the Margin Special Key mode for Cross Margin Classic accounts.

All outstanding liabilities under the Cross Margin Classic account must be fully repaid before calling this endpoint. Deleting the Margin Special Key alone does not constitute a valid exit.

When a user creates a Margin Special API Key, the account enters "Special Key Mode". Upon a successful request, the following actions will be performed atomically:

All existing Margin Special API Keys under the Cross Margin Classic mode account will be deleted.
All pre-execution margin checks (including Open-order-loss calculation) will revert to standard mode.
A cooldown period (default: 24 hours) will be enforced, during which the account will not be permitted to create new Margin Special API Keys.

For more information, please refer to FAQ.

Preconditions:

The following conditions must be met; otherwise the request will be rejected:

Account type must be Cross Margin Classic.
Account must currently be in Special Key Mode. If not, the request silently succeeds.
Account must not be in liquidation.
Account must have no liability.

You need to enable "Permits Enable Spot & Margin Trading" option for the API Key which requests this endpoint.

POST

/sapi/v1/margin/exit-special-key-mode

https://api.binance.com

Exit Special Key Mode (TRADE) › 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

Exit Special Key Mode (TRADE) › 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 Weight10

Exit Special Key Mode (TRADE) › 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

Exit Special Key Mode (TRADE) › Request Body

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

The value cannot be greater than 60000

Example: 5000

Exit Special Key Mode (TRADE) › Responses

200

Exit Special Key Mode

Get Force Liquidation Record

GET

/sapi/v1/margin/forceLiquidationRec

https://api.binance.com

Get Force Liquidation Record › 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 Force Liquidation Record › 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 Weight1

Get Force Liquidation Record › 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 Force Liquidation Record › 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

startTime

integer · int64

Example: 1623319461670

endTime

integer · int64

Example: 1641782889000

isolatedSymbol

string

Example: BTCUSDT

current

integer · int64 · min: 1

Currently querying page.

Example: 1

Default: 1

size

integer · int64 · max: 100

Example: 10

Default: 10

recvWindow

integer · int64 · max: 60000

Example: 5000

Get Force Liquidation Record › Responses

200

Get Force Liquidation Record

object[]

rows list.

total

integer · int64

total.

Example: 1

Get Small Liability Exchange Coin List

Query the coins which can be small liability exchange

GET

/sapi/v1/margin/exchange-small-liability

https://api.binance.com

Get Small Liability Exchange Coin List › 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 Small Liability Exchange Coin List › 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 Weight100

Get Small Liability Exchange Coin List › 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 Small Liability Exchange Coin List › 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

Example: 5000

Get Small Liability Exchange Coin List › Responses

200

Get Small Liability Exchange Coin List

object

asset

string

asset.

Example: ETH

interest

string

interest.

Example: 0.00083334

principal

string

principal.

Example: 0.001

liabilityAsset

string

liability Asset.

Example: USDT

liabilityQty

number · float

liability Qty.

Example: 0.3552

Small Liability Exchange

POST

/sapi/v1/margin/exchange-small-liability

https://api.binance.com

Small Liability Exchange › 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

Small Liability Exchange › 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

Small Liability Exchange › 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

Small Liability Exchange › Request Body

assetNames

string · required

The assets list of small liability exchange

Example: BTC,ETH

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

Small Liability Exchange › Responses

200

No data returned

Get Small Liability Exchange History

Get Small liability Exchange History

GET

/sapi/v1/margin/exchange-small-liability-history

https://api.binance.com

Get Small Liability Exchange 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 Small Liability Exchange 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 Weight100

Get Small Liability Exchange 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 Small Liability Exchange History › Query Parameters

current

integer · int64 · min: 1 · required

Currently querying page.

Example: 1

Default: 1

size

integer · int64 · max: 100 · required

Example: 10

Default: 10

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

startTime

integer · int64

Default: 30 days from current timestamp

Example: 1623319461670

endTime

integer · int64

Default: present timestamp

Example: 1641782889000

recvWindow

integer · int64 · max: 60000

Example: 5000

Get Small Liability Exchange History › Responses

200

Get Small Liability Exchange History

total

integer · int64

total.

Example: 1

object[]

rows list.

Query Margin Account's Open Orders

GET

/sapi/v1/margin/openOrders

https://api.binance.com

Query Margin Account's 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 Margin Account's Open Orders › 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 Weight10

Query Margin Account's 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 Margin Account's 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

symbol

string

isolated margin pair

Example: BNBBTC

isIsolated

string · enum

Enum values:

TRUE

FALSE

Example: FALSE

Default: FALSE

recvWindow

integer · int64 · max: 60000

Example: 5000

Query Margin Account's Open Orders › Responses

200

Margin Account's Open Orders

object

clientOrderId

string

client Order Id.

Example: qhcZw71gAkCCTv0t0k8LUK

cummulativeQuoteQty

string

cummulative Quote Qty.

Example: 0.00000000

executedQty

string

executed Qty.

Example: 0.00000000

icebergQty

string

iceberg Qty.

Example: 0.00000000

isWorking

boolean

is Working.

Example: true

orderId

integer · int64

order Id.

Example: 211842552

origQty

string

orig Qty.

Example: 0.30000000

price

string

price.

Example: 0.00475010

side

string

side.

Example: SELL

status

string

status.

Example: NEW

stopPrice

string

stop Price.

Example: 0.00000000

symbol

string

symbol.

Example: BNBBTC

isIsolated

boolean

is Isolated.

Example: true

time

integer · int64

time.

Example: 1562040170089

timeInForce

string

time In Force.

Example: GTC

type

string

type.

Example: LIMIT

selfTradePreventionMode

string

self Trade Prevention Mode.

Example: NONE

updateTime

integer · int64

update Time.

Example: 1562040170089

Margin Account Cancel all Open Orders on a Symbol

Cancels all active orders on a symbol for margin account.

This includes OCO orders.

DELETE

/sapi/v1/margin/openOrders

https://api.binance.com

Margin Account Cancel all Open Orders on a Symbol › 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

Margin Account Cancel all Open Orders on a Symbol › 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 Weight1

Margin Account Cancel all Open Orders on a Symbol › 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

Margin Account Cancel all Open Orders on a Symbol › Query Parameters

symbol

string · required

Example: BTCUSDT

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

isIsolated

string · enum

Enum values:

TRUE

FALSE

Example: FALSE

Default: FALSE

recvWindow

integer · int64 · max: 60000

Example: 5000

Margin Account Cancel all Open Orders on a Symbol › Responses

200

Margin Account Cancel all Open Orders on a Symbol

object

symbol

string

symbol.

Example: BTCUSDT

isIsolated

boolean

if isolated margin

Example: true

origClientOrderId

string

orig Client Order Id.

Example: E6APeyTJvkMvLMYMqu1KQ4

orderId

integer · int64

order Id.

Example: 11

orderListId

integer · int64

order List Id.

Example: -1

clientOrderId

string

client Order Id.

Example: pXLV6Hz6mprAcVYpVMTGgx

price

string

price.

Example: 0.089853

origQty

string

orig Qty.

Example: 0.178622

executedQty

string

executed Qty.

Example: 0.000000

cummulativeQuoteQty

string

cummulative Quote Qty.

Example: 0.000000

status

string

status.

Example: CANCELED

timeInForce

string

time In Force.

Example: GTC

type

string

type.

Example: LIMIT

side

string

side.

Example: BUY

selfTradePreventionMode

string

self Trade Prevention Mode.

Example: NONE

contingencyType

string

contingency Type.

Example: OCO

listStatusType

string

list Status Type.

Example: ALL_DONE

listOrderStatus

string

list Order Status.

Example: ALL_DONE

listClientOrderId

string

list Client Order Id.

Example: 2inzWQdDvZLHbbAmAozX2N

transactionTime

integer · int64

transaction Time.

Example: 1585230948299

object[]

orders list.

object[]

order Reports list.

DELETE/sapi/v1/margin/openOrders

curl --request DELETE \
  --url 'https://api.binance.com/sapi/v1/margin/openOrders?symbol=%3Cstring%3E&timestamp=%3Cnumber%3E' \
  --header 'X-MBX-APIKEY: <string>'

Example Responses

[
  {
    "symbol": "BTCUSDT",
    "isIsolated": true,
    "origClientOrderId": "E6APeyTJvkMvLMYMqu1KQ4",
    "orderId": 11,
    "orderListId": -1,
    "clientOrderId": "pXLV6Hz6mprAcVYpVMTGgx",
    "price": "0.089853",
    "origQty": "0.178622",
    "executedQty": "0.000000",
    "cummulativeQuoteQty": "0.000000",
    "status": "CANCELED",
    "timeInForce": "GTC",
    "type": "LIMIT",
    "side": "BUY",
    "selfTradePreventionMode": "NONE",
    "contingencyType": "OCO",
    "listStatusType": "ALL_DONE",
    "listOrderStatus": "ALL_DONE",
    "listClientOrderId": "2inzWQdDvZLHbbAmAozX2N",
    "transactionTime": 1585230948299,
    "orders": [
      {
        "symbol": "BTCUSDT",
        "orderId": 20,
        "clientOrderId": "CwOOIPHSmYywx6jZX77TdL"
      }
    ],
    "orderReports": [
      {
        "symbol": "BTCUSDT",
        "origClientOrderId": "CwOOIPHSmYywx6jZX77TdL",
        "orderId": 20,
        "orderListId": 1929,
        "clientOrderId": "pXLV6Hz6mprAcVYpVMTGgx",
        "price": "0.668611",
        "origQty": "0.690354",
        "executedQty": "0.000000",
        "cummulativeQuoteQty": "0.000000",
        "status": "CANCELED",
        "timeInForce": "GTC",
        "type": "STOP_LOSS_LIMIT",
        "side": "BUY",
        "stopPrice": "0.378131",
        "icebergQty": "0.017083"
      }
    ]
  }
]

json

application/json

Query Margin Account's OCO

Retrieves a specific OCO based on provided optional parameters

GET

/sapi/v1/margin/orderList

https://api.binance.com

Query Margin Account's OCO › 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 Margin Account's OCO › 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 Weight10

Query Margin Account's OCO › 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 Margin Account's OCO › 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

isIsolated

string · enum

Enum values:

TRUE

FALSE

Example: FALSE

Default: FALSE

symbol

string

mandatory for isolated margin, not supported for cross margin

Example: LTCBTC

orderListId

integer · int64

Either orderListId or origClientOrderId must be provided

Example: 1

origClientOrderId

string

Either orderListId or origClientOrderId must be provided

Example: 1

recvWindow

integer · int64 · max: 60000

Example: 5000

Query Margin Account's OCO › Responses

200

Margin Account's OCO

orderListId

integer · int64

order List Id.

Example: 27

contingencyType

string

contingency Type.

Example: OCO

listStatusType

string

list Status Type.

Example: EXEC_STARTED

listOrderStatus

string

list Order Status.

Example: EXECUTING

listClientOrderId

string

list Client Order Id.

Example: h2USkA5YQpaXHPIrkd96xE

transactionTime

integer · int64

transaction Time.

Example: 1565245656253

symbol

string

symbol.

Example: LTCBTC

isIsolated

boolean

if isolated margin

Example: true

object[]

orders list.

Margin Account Cancel OCO

Cancel an entire Order List for a margin account.

DELETE

/sapi/v1/margin/orderList

https://api.binance.com

Margin Account Cancel OCO › 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

Margin Account Cancel OCO › 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 Weight1

Margin Account Cancel OCO › 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

Margin Account Cancel OCO › Query Parameters

symbol

string · required

Example: BTCUSDT

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

isIsolated

string · enum

Enum values:

TRUE

FALSE

Example: FALSE

Default: FALSE

orderListId

integer · int64

Either orderListId or listClientOrderId must be provided

Example: 1

listClientOrderId

string

Either orderListId or listClientOrderId must be provided

Example: 1

newClientOrderId

string

Used to uniquely identify this cancel. Automatically generated by default

Example: 1

recvWindow

integer · int64 · max: 60000

Example: 5000

Margin Account Cancel OCO › Responses

200

Margin Account Cancel OCO

orderListId

integer · int64

order List Id.

Example: 0

contingencyType

string

contingency Type.

Example: OCO

listStatusType

string

list Status Type.

Example: ALL_DONE

listOrderStatus

string

list Order Status.

Example: ALL_DONE

listClientOrderId

string

list Client Order Id.

Example: C3wyj4WVEktd7u9aVBRXcN

transactionTime

integer · int64

transaction Time.

Example: 1574040868128

symbol

string

symbol.

Example: LTCBTC

isIsolated

boolean

if isolated margin

Example: false

object[]

orders list.

object[]

order Reports.

DELETE/sapi/v1/margin/orderList

curl --request DELETE \
  --url 'https://api.binance.com/sapi/v1/margin/orderList?symbol=%3Cstring%3E&timestamp=%3Cnumber%3E' \
  --header 'X-MBX-APIKEY: <string>'

Example Responses

{
  "orderListId": 0,
  "contingencyType": "OCO",
  "listStatusType": "ALL_DONE",
  "listOrderStatus": "ALL_DONE",
  "listClientOrderId": "C3wyj4WVEktd7u9aVBRXcN",
  "transactionTime": 1574040868128,
  "symbol": "LTCBTC",
  "isIsolated": false,
  "orders": [
    {
      "symbol": "LTCBTC",
      "orderId": 2,
      "clientOrderId": "pO9ufTiFGg3nw2fOdgeOXa"
    }
  ],
  "orderReports": [
    {
      "symbol": "LTCBTC",
      "origClientOrderId": "pO9ufTiFGg3nw2fOdgeOXa",
      "orderId": 2,
      "orderListId": 0,
      "clientOrderId": "unfWT8ig8i0uj6lPuYLez6",
      "price": "1.00000000",
      "origQty": "10.00000000",
      "executedQty": "0.00000000",
      "cummulativeQuoteQty": "0.00000000",
      "status": "CANCELED",
      "timeInForce": "GTC",
      "type": "STOP_LOSS_LIMIT",
      "side": "SELL",
      "stopPrice": "1.00000000",
      "selfTradePreventionMode": "NONE"
    }
  ]
}

json

application/json

Query Margin Account's Order

GET

/sapi/v1/margin/order

https://api.binance.com

Query Margin Account's 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

Query Margin Account's Order › 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 Weight10

Query Margin Account's 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

Query Margin Account's Order › Query Parameters

symbol

string · required

Example: BNBBTC

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

isIsolated

string · enum

Enum values:

TRUE

FALSE

Example: FALSE

Default: FALSE

orderId

integer · int64

Example: 1

origClientOrderId

string

Example: 1

recvWindow

integer · int64 · max: 60000

Example: 5000

Query Margin Account's Order › Responses

200

Margin Account's Order

clientOrderId

string

client Order Id.

Example: ZwfQzuDIGpceVhKW5DvCmO

cummulativeQuoteQty

string

cummulative Quote Qty.

Example: 0.00000000

executedQty

string

executed Qty.

Example: 0.00000000

icebergQty

string

iceberg Qty.

Example: 0.00000000

isWorking

boolean

is Working.

Example: true

orderId

integer · int64

order Id.

Example: 213205622

origQty

string

orig Qty.

Example: 0.30000000

price

string

price.

Example: 0.00493630

side

string

side.

Example: SELL

status

string

status.

Example: NEW

stopPrice

string

stop Price.

Example: 0.00000000

symbol

string

symbol.

Example: BNBBTC

isIsolated

boolean

is Isolated.

Example: true

time

integer · int64

time.

Example: 1562133008725

timeInForce

string

time In Force.

Example: GTC

type

string

type.

Example: LIMIT

selfTradePreventionMode

string

self Trade Prevention Mode.

Example: NONE

updateTime

integer · int64

update Time.

Example: 1562133008725

Margin Account New Order

Post a new order for margin account.

POST

/sapi/v1/margin/order

https://api.binance.com

Margin Account New 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

Margin Account New Order › 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

6(UID) or 1500(UID) when sideEffectType is MARGIN_BUY or AUTO_BORROW_REPAY

Margin Account New 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

Margin Account New Order › Request Body

symbol

string · required

Example: BTCUSDT

side

string · enum · required

Enum values:

BUY

SELL

Example: BUY

type

string · enum · required

Enum values:

LIMIT

MARKET

STOP_LOSS

STOP_LOSS_LIMIT

TAKE_PROFIT

TAKE_PROFIT_LIMIT

LIMIT_MAKER

Example: LIMIT

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

isIsolated

string · enum

Enum values:

TRUE

FALSE

Example: FALSE

Default: FALSE

quantity

number · float

Example: 1.0

quoteOrderQty

number · float

Example: 1.0

price

number · float

Example: 1.0

stopPrice

number · float

Used with STOP_LOSS, STOP_LOSS_LIMIT, TAKE_PROFIT, and TAKE_PROFIT_LIMIT orders.

Example: 1.0

newClientOrderId

string

A unique id among open orders. Automatically generated if not sent.

Example: 1

icebergQty

number · float

Used with LIMIT, STOP_LOSS_LIMIT, and TAKE_PROFIT_LIMIT to create an iceberg order.

Example: 1.0

newOrderRespType

string · enum

MARKET and LIMIT order types default to FULL, all other orders default to ACK.

Enum values:

ACK

RESULT

FULL

Example: ACK

sideEffectType

string · enum

Enum values:

NO_SIDE_EFFECT

MARGIN_BUY

AUTO_REPAY

AUTO_BORROW_REPAY

Example: NO_SIDE_EFFECT

Default: NO_SIDE_EFFECT

timeInForce

string · enum

Enum values:

GTC

IOC

FOK

Example: GTC

selfTradePreventionMode

string · enum

Enum values:

EXPIRE_TAKER

EXPIRE_MAKER

EXPIRE_BOTH

NONE

Example: NONE

trailingDelta

integer · int64

Used with STOP_LOSS, STOP_LOSS_LIMIT, TAKE_PROFIT, and TAKE_PROFIT_LIMIT orders.

Example: 100

autoRepayAtCancel

boolean

Only when MARGIN_BUY or AUTO_BORROW_REPAY order takes effect, true means that the debt generated by the order needs to be repaid after the order is cancelled.

Example: true

Default: true

recvWindow

integer · int64 · max: 60000

Example: 5000

Margin Account New Order › Responses

200

Margin Account New Order

symbol

string

symbol.

Example: BTCUSDT

orderId

integer · int64

order Id.

Example: 26769564559

clientOrderId

string

client Order Id.

Example: E156O3KP4gOif65bjuUK5V

isIsolated

boolean

if isolated margin

Example: false

transactTime

integer · int64

transact Time.

Example: 1713873075893

price

string

price.

Example: 0

origQty

string

orig Qty.

Example: 0.001

executedQty

string

executed Qty.

Example: 0.001

cummulativeQuoteQty

string

cummulative Quote Qty.

Example: 65.98253

status

string

status.

Example: FILLED

timeInForce

string

time In Force.

Example: GTC

type

string

type.

Example: MARKET

side

string

side.

Example: SELL

selfTradePreventionMode

string

self Trade Prevention Mode.

Example: EXPIRE_MAKER

marginBuyBorrowAmount

integer · int64

margin Buy Borrow Amount.

Example: 5

marginBuyBorrowAsset

string

margin Buy Borrow Asset.

Example: BTC

object[]

fills list.

POST/sapi/v1/margin/order

curl --request POST \
  --url https://api.binance.com/sapi/v1/margin/order \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --header 'X-MBX-APIKEY: <string>' \
  --data symbol=BTCUSDT \
  --data side=BUY \
  --data type=LIMIT \
  --data timestamp=1770736694138

Example Request Body

{
  "symbol": "BTCUSDT",
  "side": "BUY",
  "type": "LIMIT",
  "timestamp": 1770736694138
}

json

Example Responses

{
  "symbol": "BTCUSDT",
  "orderId": 26769564559,
  "clientOrderId": "E156O3KP4gOif65bjuUK5V",
  "isIsolated": false,
  "transactTime": 1713873075893,
  "price": "0",
  "origQty": "0.001",
  "executedQty": "0.001",
  "cummulativeQuoteQty": "65.98253",
  "status": "FILLED",
  "timeInForce": "GTC",
  "type": "MARKET",
  "side": "SELL",
  "selfTradePreventionMode": "EXPIRE_MAKER",
  "marginBuyBorrowAmount": 5,
  "marginBuyBorrowAsset": "BTC",
  "fills": [
    {
      "price": "65982.53",
      "qty": "0.001",
      "commission": "0.06598253",
      "commissionAsset": "USDT",
      "tradeId": 3570680726
    }
  ]
}

json

application/json

Margin Account Cancel Order

Cancel an active order for margin account.

DELETE

/sapi/v1/margin/order

https://api.binance.com

Margin Account Cancel 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

Margin Account Cancel Order › 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 Weight10

Margin Account Cancel 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

Margin Account Cancel Order › Query Parameters

symbol

string · required

Example: LTCBTC

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

isIsolated

string · enum

Enum values:

TRUE

FALSE

Example: FALSE

Default: FALSE

orderId

integer · int64

Example: 1

origClientOrderId

string

Example: 1

newClientOrderId

string

Used to uniquely identify this cancel. Automatically generated by default.

Example: 1

recvWindow

integer · int64 · max: 60000

Example: 5000

Margin Account Cancel Order › Responses

200

Margin Account Cancel Order

symbol

string

symbol.

Example: LTCBTC

orderId

string

order Id.

Example: 28

origClientOrderId

string

orig Client Order Id.

Example: myOrder1

clientOrderId

string

client Order Id.

Example: cancelMyOrder1

price

string

price.

Example: 1.00000000

origQty

string

orig Qty.

Example: 10.00000000

executedQty

string

executed Qty.

Example: 8.00000000

cummulativeQuoteQty

string

cummulative Quote Qty.

Example: 8.00000000

status

string

status.

Example: CANCELED

timeInForce

string

time In Force.

Example: GTC

type

string

type.

Example: LIMIT

side

string

side.

Example: SELL

isIsolated

boolean

if isolated margin

Example: true

Margin Account New OCO

Send in a new OCO for a margin account

POST

/sapi/v1/margin/order/oco

https://api.binance.com

Margin Account New OCO › 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

Margin Account New OCO › 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

6(UID) or 1500(UID) when sideEffectType is MARGIN_BUY or AUTO_BORROW_REPAY

Margin Account New OCO › 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

Margin Account New OCO › Request Body

symbol

string · required

Example: LTCBTC

side

string · enum · required

Enum values:

BUY

SELL

Example: BUY

quantity

number · float · required

Example: 1.0

price

number · float · required

Example: 1.0

stopPrice

number · float · required

Example: 1.0

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

isIsolated

string · enum

Enum values:

TRUE

FALSE

Example: FALSE

Default: FALSE

listClientOrderId

string

A unique Id for the entire orderList

Example: 1

limitClientOrderId

string

A unique Id for the limit order

Example: 1

limitIcebergQty

number · float

Example: 1.0

stopClientOrderId

string

A unique Id for the stop loss/stop loss limit leg

Example: 1

stopLimitPrice

number · float

If provided, stopLimitTimeInForce is required.

Example: 1.0

stopIcebergQty

number · float

Example: 1.0

stopLimitTimeInForce

string · enum

Enum values:

GTC

FOK

IOC

Example: GTC

newOrderRespType

string · enum

Enum values:

ACK

RESULT

FULL

Example: ACK

sideEffectType

string · enum

Enum values:

NO_SIDE_EFFECT

MARGIN_BUY

AUTO_REPAY

AUTO_BORROW_REPAY

Example: NO_SIDE_EFFECT

Default: NO_SIDE_EFFECT

selfTradePreventionMode

string · enum

Enum values:

EXPIRE_TAKER

EXPIRE_MAKER

EXPIRE_BOTH

NONE

Example: NONE

autoRepayAtCancel

boolean

Only when MARGIN_BUY or AUTO_BORROW_REPAY order takes effect, true means that the debt generated by the order needs to be repay after the order is cancelled.

Example: false

Default: true

recvWindow

integer · int64 · max: 60000

Example: 5000

Margin Account New OCO › Responses

200

Margin Account New OCO

orderListId

integer · int64

order List Id.

Example: 0

contingencyType

string

contingency Type.

Example: OCO

listStatusType

string

list Status Type.

Example: EXEC_STARTED

listOrderStatus

string

list Order Status.

Example: EXECUTING

listClientOrderId

string

list Client Order Id.

Example: JYVpp3F0f5CAG15DhtrqLp

transactionTime

integer · int64

transaction Time.

Example: 1563417480525

symbol

string

symbol.

Example: LTCBTC

marginBuyBorrowAmount

string

will not return if no margin trade happens

Example: 5

marginBuyBorrowAsset

string

will not return if no margin trade happens

Example: BTC

isIsolated

boolean

if isolated margin

Example: false

object[]

orders list.

object[]

POST/sapi/v1/margin/order/oco

curl --request POST \
  --url https://api.binance.com/sapi/v1/margin/order/oco \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --header 'X-MBX-APIKEY: <string>' \
  --data symbol=LTCBTC \
  --data side=BUY \
  --data quantity=1.0 \
  --data price=1.0 \
  --data stopPrice=1.0 \
  --data timestamp=1770736694138

Example Request Body

{
  "symbol": "LTCBTC",
  "side": "BUY",
  "quantity": "1.0",
  "price": "1.0",
  "stopPrice": "1.0",
  "timestamp": 1770736694138
}

json

Example Responses

{
  "orderListId": 0,
  "contingencyType": "OCO",
  "listStatusType": "EXEC_STARTED",
  "listOrderStatus": "EXECUTING",
  "listClientOrderId": "JYVpp3F0f5CAG15DhtrqLp",
  "transactionTime": 1563417480525,
  "symbol": "LTCBTC",
  "marginBuyBorrowAmount": "5",
  "marginBuyBorrowAsset": "BTC",
  "isIsolated": false,
  "orders": [
    {
      "symbol": "LTCBTC",
      "orderId": 2,
      "clientOrderId": "Kk7sqHb9J6mJWTMDVW7Vos"
    }
  ],
  "orderReports": [
    {
      "symbol": "LTCBTC",
      "orderId": 2,
      "orderListId": 0,
      "clientOrderId": "Kk7sqHb9J6mJWTMDVW7Vos",
      "transactTime": 1563417480525,
      "price": "0.000000",
      "origQty": "0.624363",
      "executedQty": "0.000000",
      "cummulativeQuoteQty": "0.000000",
      "status": "NEW",
      "timeInForce": "GTC",
      "type": "STOP_LOSS",
      "side": "BUY",
      "stopPrice": "0.960664",
      "selfTradePreventionMode": "NONE"
    }
  ]
}

json

application/json

Margin Account New OTO

Post a new OTO order for margin account:

An OTO (One-Triggers-the-Other) is an order list comprised of 2 orders.
The first order is called the working order and must be LIMIT or LIMIT_MAKER. Initially, only the working order goes on the order book.
The second order is called the pending order. It can be any order type except for MARKET orders using parameter quoteOrderQty. The pending order is only placed on the order book when the working order gets fully filled.
If either the working order or the pending order is cancelled individually, the other order in the order list will also be canceled or expired.
When the order list is placed, if the working order gets immediately fully filled, the placement response will show the working order as FILLED but the pending order will still appear as PENDING_NEW. You need to query the status of the pending order again to see its updated status.
OTOs add 2 orders to the unfilled order count, EXCHANGE_MAX_NUM_ORDERS filter and MAX_NUM_ORDERS filter.

POST

/sapi/v1/margin/order/oto

https://api.binance.com

Margin Account New OTO › 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

Margin Account New OTO › 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

6(UID) or 1500(UID) when sideEffectType is MARGIN_BUY or AUTO_BORROW_REPAY

Margin Account New OTO › 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

Margin Account New OTO › Request Body

symbol

string · required

Example: BTCUSDT

workingType

string · enum · required

Enum values:

LIMIT

LIMIT_MAKER

Example: LIMIT

workingSide

string · enum · required

Enum values:

BUY

SELL

Example: SELL

workingPrice

number · float · required

Example: 1.0

workingQuantity

number · float · required

Sets the quantity for the working order.

Example: 1.0

workingIcebergQty

number · float · required

This can only be used if workingTimeInForce is GTC.

Example: 1.0

pendingType

string · enum · required

Enum values:

LIMIT

MARKET

STOP_LOSS

STOP_LOSS_LIMIT

TAKE_PROFIT

TAKE_PROFIT_LIMIT

LIMIT_MAKER

Example: LIMIT

pendingSide

string · enum · required

Enum values:

BUY

SELL

Example: BUY

pendingQuantity

number · float · required

Sets the quantity for the pending order.

Example: 1.0

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

isIsolated

string · enum

Enum values:

TRUE

FALSE

Example: FALSE

Default: FALSE

listClientOrderId

string

Arbitrary unique ID among open order lists. Automatically generated if not sent.
A new order list with the same listClientOrderId is accepted only when the previous one is filled or completely expired.
listClientOrderId is distinct from the workingClientOrderId and the pendingClientOrderId.

Example: 1

newOrderRespType

string · enum

MARKET and LIMIT order types default to FULL, all other orders default to ACK.

Enum values:

ACK

RESULT

FULL

Example: ACK

sideEffectType

string · enum

Enum values:

NO_SIDE_EFFECT

MARGIN_BUY

Example: NO_SIDE_EFFECT

selfTradePreventionMode

string · enum

Enum values:

EXPIRE_TAKER

EXPIRE_MAKER

EXPIRE_BOTH

NONE

Example: NONE

autoRepayAtCancel

boolean

Only when MARGIN_BUY order takes effect, true means that the debt generated by the order needs to be repaid after the order is cancelled.

Example: true

Default: true

workingClientOrderId

string

Arbitrary unique ID among open orders for the working order. Automatically generated if not sent.

Example: 1

workingTimeInForce

string · enum

Enum values:

GTC

IOC

FOK

Example: GTC

pendingClientOrderId

string

Arbitrary unique ID among open orders for the pending order. Automatically generated if not sent.

Example: 1

pendingPrice

number · float

Example: 1.0

pendingStopPrice

number · float

Example: 1.0

pendingTrailingDelta

number · float

Example: 1.0

pendingIcebergQty

number · float

This can only be used if pendingTimeInForce is GTC.

Example: 1.0

pendingTimeInForce

string · enum

Enum values:

GTC

IOC

FOK

Example: GTC

Margin Account New OTO › Responses

200

Margin Account New OTO

orderListId

integer · int64

order List Id.

Example: 13551

contingencyType

string

contingency Type.

Example: OTO

listStatusType

string

list Status Type.

Example: EXEC_STARTED

listOrderStatus

string

list Order Status.

Example: EXECUTING

listClientOrderId

string

list Client Order Id.

Example: JDuOrsu0Ge8GTyvx8J7VTD

transactionTime

integer · int64

transaction Time.

Example: 1725521998054

symbol

string

symbol.

Example: BTCUSDT

isIsolated

boolean

is Isolated.

Example: false

object[]

orders list.

object[]

order Reports list.

POST/sapi/v1/margin/order/oto

curl --request POST \
  --url https://api.binance.com/sapi/v1/margin/order/oto \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --header 'X-MBX-APIKEY: <string>' \
  --data symbol=BTCUSDT \
  --data workingType=LIMIT \
  --data workingSide=SELL \
  --data workingPrice=1.0 \
  --data workingQuantity=1.0 \
  --data workingIcebergQty=1.0 \
  --data pendingType=LIMIT \
  --data pendingSide=BUY \
  --data pendingQuantity=1.0 \
  --data timestamp=1770736694138

Example Request Body

{
  "symbol": "BTCUSDT",
  "workingType": "LIMIT",
  "workingSide": "SELL",
  "workingPrice": "1.0",
  "workingQuantity": "1.0",
  "workingIcebergQty": "1.0",
  "pendingType": "LIMIT",
  "pendingSide": "BUY",
  "pendingQuantity": "1.0",
  "timestamp": 1770736694138
}

json

Example Responses

{
  "orderListId": 13551,
  "contingencyType": "OTO",
  "listStatusType": "EXEC_STARTED",
  "listOrderStatus": "EXECUTING",
  "listClientOrderId": "JDuOrsu0Ge8GTyvx8J7VTD",
  "transactionTime": 1725521998054,
  "symbol": "BTCUSDT",
  "isIsolated": false,
  "orders": [
    {
      "symbol": "BTCUSDT",
      "orderId": 29896699,
      "clientOrderId": "y8RB6tQEMuHUXybqbtzTxk"
    }
  ],
  "orderReports": [
    {
      "symbol": "BTCUSDT",
      "orderId": 29896699,
      "orderListId": 13551,
      "clientOrderId": "y8RB6tQEMuHUXybqbtzTxk",
      "transactTime": 1725521998054,
      "price": "80000.00000000",
      "origQty": "0.02000000",
      "executedQty": "0",
      "cummulativeQuoteQty": "0",
      "status": "NEW",
      "timeInForce": "GTC",
      "type": "LIMIT",
      "side": "SELL",
      "selfTradePreventionMode": "NONE"
    }
  ]
}

json

application/json

Margin Account New OTOCO

Post a new OTOCO order for margin account：

An OTOCO (One-Triggers-One-Cancels-the-Other) is an order list comprised of 3 orders.
The first order is called the working order and must be LIMIT or LIMIT_MAKER. Initially, only the working order goes on the order book.
- The behavior of the working order is the same as the OTO.
OTOCO has 2 pending orders (pending above and pending below), forming an OCO pair. The pending orders are only placed on the order book when the working order gets fully filled.
- The rules of the pending above and pending below follow the same rules as the Order List OCO.
OTOCOs add 3 orders against the unfilled order count, EXCHANGE_MAX_NUM_ORDERS filter, and MAX_NUM_ORDERS filter.

POST

/sapi/v1/margin/order/otoco

https://api.binance.com

Margin Account New OTOCO › 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

Margin Account New OTOCO › 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

6(UID) or 1500(UID) when sideEffectType is MARGIN_BUY or AUTO_BORROW_REPAY

Margin Account New OTOCO › 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

Margin Account New OTOCO › Request Body

symbol

string · required

Example: BTCUSDT

workingType

string · enum · required

Enum values:

LIMIT

LIMIT_MAKER

Example: LIMIT

workingSide

string · enum · required

Enum values:

BUY

SELL

Example: SELL

workingPrice

number · float · required

Example: 1.0

workingQuantity

number · float · required

Example: 1.0

pendingSide

string · enum · required

Enum values:

BUY

SELL

Example: BUY

pendingQuantity

number · float · required

Example: 1.0

pendingAboveType

string · enum · required

Enum values:

LIMIT_MAKER

STOP_LOSS

STOP_LOSS_LIMIT

Example: LIMIT_MAKER

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

isIsolated

string · enum

Enum values:

TRUE

FALSE

Example: FALSE

Default: FALSE

sideEffectType

string · enum

Enum values:

NO_SIDE_EFFECT

MARGIN_BUY

Example: NO_SIDE_EFFECT

autoRepayAtCancel

boolean

Only when MARGIN_BUY order takes effect, true means that the debt generated by the order needs to be repaid after the order is cancelled.

Example: true

Default: true

listClientOrderId

string

Arbitrary unique ID among open order lists. Automatically generated if not sent. A new order list with the same listClientOrderId is accepted only when the previous one is filled or completely expired. listClientOrderId is distinct from the workingClientOrderId, pendingAboveClientOrderId, and the pendingBelowClientOrderId.

Example: 1

newOrderRespType

string · enum

Enum values:

ACK

RESULT

FULL

Example: ACK

selfTradePreventionMode

string · enum

Enum values:

EXPIRE_TAKER

EXPIRE_MAKER

EXPIRE_BOTH

NONE

Example: NONE

workingClientOrderId

string

Arbitrary unique ID among open orders for the working order. Automatically generated if not sent.

Example: 1

workingIcebergQty

number · float

This can only be used if workingTimeInForce is GTC.

Example: 1.0

workingTimeInForce

string · enum

Enum values:

GTC

IOC

FOK

Example: FOK

pendingAboveClientOrderId

string

Arbitrary unique ID among open orders for the pending above order. Automatically generated if not sent.

Example: 1

pendingAbovePrice

number · float

Example: 1.0

pendingAboveStopPrice

number · float

Example: 1.0

pendingAboveTrailingDelta

number · float

Example: 1.0

pendingAboveIcebergQty

number · float

This can only be used if pendingAboveTimeInForce is GTC.

Example: 1.0

pendingAboveTimeInForce

string · enum

Enum values:

GTC

IOC

FOK

Example: FOK

pendingBelowType

string · enum

Enum values:

LIMIT_MAKER

STOP_LOSS

STOP_LOSS_LIMIT

Example: LIMIT_MAKER

pendingBelowClientOrderId

string

Arbitrary unique ID among open orders for the pending below order. Automatically generated if not sent.

Example: 1

pendingBelowPrice

number · float

Example: 1.0

pendingBelowStopPrice

number · float

Example: 1.0

pendingBelowTrailingDelta

number · float

Example: 1.0

pendingBelowIcebergQty

number · float

This can only be used if pendingBelowTimeInForce is GTC.

Example: 1.0

pendingBelowTimeInForce

string · enum

Enum values:

GTC

IOC

FOK

Example: FOK

Margin Account New OTOCO › Responses

200

Margin Account New OTOCO

orderListId

integer · int64

order List Id.

Example: 13509

contingencyType

string

contingency Type.

Example: OTO

listStatusType

string

list Status Type.

Example: EXEC_STARTED

listOrderStatus

string

list Order Status.

Example: EXECUTING

listClientOrderId

string

list Client Order Id.

Example: u2AUo48LLef5qVenRtwJZy

transactionTime

integer · int64

transaction Time.

Example: 1725521881300

symbol

string

symbol.

Example: BNBUSDT

isIsolated

boolean

is Isolated.

Example: false

object[]

orders list.

object[]

order Reports list.

POST/sapi/v1/margin/order/otoco

curl --request POST \
  --url https://api.binance.com/sapi/v1/margin/order/otoco \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --header 'X-MBX-APIKEY: <string>' \
  --data symbol=BTCUSDT \
  --data workingType=LIMIT \
  --data workingSide=SELL \
  --data workingPrice=1.0 \
  --data workingQuantity=1.0 \
  --data pendingSide=BUY \
  --data pendingQuantity=1.0 \
  --data pendingAboveType=LIMIT_MAKER \
  --data timestamp=1770736694138

Example Request Body

{
  "symbol": "BTCUSDT",
  "workingType": "LIMIT",
  "workingSide": "SELL",
  "workingPrice": "1.0",
  "workingQuantity": "1.0",
  "pendingSide": "BUY",
  "pendingQuantity": "1.0",
  "pendingAboveType": "LIMIT_MAKER",
  "timestamp": 1770736694138
}

json

Example Responses

{
  "orderListId": 13509,
  "contingencyType": "OTO",
  "listStatusType": "EXEC_STARTED",
  "listOrderStatus": "EXECUTING",
  "listClientOrderId": "u2AUo48LLef5qVenRtwJZy",
  "transactionTime": 1725521881300,
  "symbol": "BNBUSDT",
  "isIsolated": false,
  "orders": [
    {
      "symbol": "BNBUSDT",
      "orderId": 28282534,
      "clientOrderId": "IfYDxvrZI4kiyqYpRH13iI"
    }
  ],
  "orderReports": [
    {
      "symbol": "BNBUSDT",
      "orderId": 28282534,
      "orderListId": 13509,
      "clientOrderId": "IfYDxvrZI4kiyqYpRH13iI",
      "transactTime": 1725521881300,
      "price": "300.00000000",
      "origQty": "1.00000000",
      "executedQty": "0",
      "cummulativeQuoteQty": "0",
      "status": "NEW",
      "timeInForce": "GTC",
      "type": "LIMIT",
      "side": "BUY",
      "selfTradePreventionMode": "NONE",
      "stopPrice": "299.00000000"
    }
  ]
}

json

application/json

Margin Manual Liquidation

POST

/sapi/v1/margin/manual-liquidation

https://api.binance.com

Margin Manual Liquidation › 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

Margin Manual Liquidation › 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

Margin Manual Liquidation › 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

Margin Manual Liquidation › Request Body

type

string · enum · required

Enum values:

MARGIN

ISOLATED

Example: MARGIN

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

symbol

string

When type selects ISOLATED, symbol must be filled in

Example: ETHUSDT

recvWindow

integer · int64 · max: 60000

Example: 5000

Margin Manual Liquidation › Responses

200

Margin Manual Liquidation

asset

string

asset.

Example: ETH

interest

string

interest.

Example: 0.00083334

principal

string

principal.

Example: 0.001

liabilityAsset

string

liability Asset.

Example: USDT

liabilityQty

number · float

liability Qty.

Example: 0.3552

Query Current Margin Order Count Usage

Displays the user's current margin order count usage for all intervals.

GET

/sapi/v1/margin/rateLimit/order

https://api.binance.com

Query Current Margin Order Count Usage › 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 Current Margin Order Count Usage › 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

Query Current Margin Order Count Usage › 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 Current Margin Order Count Usage › 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

isIsolated

string · enum

Enum values:

TRUE

FALSE

Example: FALSE

Default: FALSE

symbol

string

isolated symbol, mandatory for isolated margin

Example: BTCUSDT

recvWindow

integer · int64 · max: 60000

Example: 5000

Query Current Margin Order Count Usage › Responses

200

Current Margin Order Count Usage

object

rateLimitType

string

rate Limit Type.

Example: ORDERS

interval

string

interval.

Example: SECOND

intervalNum

integer · int64

interval Num.

Example: 10

limit

integer · int64

limit.

Example: 10000

count

integer · int64

count.

Example: 0

Query Margin Account's all OCO

Retrieves all OCO for a specific margin account based on provided optional parameters

GET

/sapi/v1/margin/allOrderList

https://api.binance.com

Query Margin Account's all OCO › 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 Margin Account's all OCO › 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

Query Margin Account's all OCO › 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 Margin Account's all OCO › 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

isIsolated

string · enum

Enum values:

TRUE

FALSE

Example: FALSE

Default: FALSE

symbol

string

mandatory for isolated margin, not supported for cross margin

Example: LTCBTC

fromId

integer · int64

If supplied, neither startTime or endTime can be provided

Example: 1

startTime

integer · int64

Example: 1623319461670

endTime

integer · int64

Example: 1641782889000

limit

integer · int64 · max: 1000

Example: 100

Default: 500

recvWindow

integer · int64 · max: 60000

Example: 5000

Query Margin Account's all OCO › Responses

200

Margin Account's all OCO

object

orderListId

integer · int64

order List Id.

Example: 29

contingencyType

string

contingency Type.

Example: OCO

listStatusType

string

list Status Type.

Example: EXEC_STARTED

listOrderStatus

string

list Order Status.

Example: EXECUTING

listClientOrderId

string

list Client Order Id.

Example: amEEAXryFzFwYF1FeRpUoZ

transactionTime

integer · int64

transaction Time.

Example: 1565245913483

symbol

string

symbol.

Example: LTCBTC

isIsolated

boolean

if isolated margin

Example: true

object[]

orders list.

Query Margin Account's All Orders

GET

/sapi/v1/margin/allOrders

https://api.binance.com

Query Margin Account's All 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 Margin Account's All Orders › 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

Query Margin Account's All 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 Margin Account's All Orders › Query Parameters

symbol

string · required

Example: BNBBTC

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

isIsolated

string · enum

Enum values:

TRUE

FALSE

Example: FALSE

Default: FALSE

orderId

integer · int64

Example: 1

startTime

integer · int64

Example: 1623319461670

endTime

integer · int64

Example: 1641782889000

limit

integer · int64 · max: 500

Example: 100

Default: 500

recvWindow

integer · int64 · max: 60000

Example: 5000

Query Margin Account's All Orders › Responses

200

Margin Account's All Orders

object

clientOrderId

string

client Order Id.

Example: D2KDy4DIeS56PvkM13f8cP

cummulativeQuoteQty

string

cummulative Quote Qty.

Example: 0.00000000

executedQty

string

executed Qty.

Example: 0.00000000

icebergQty

string

iceberg Qty.

Example: 0.00000000

isWorking

boolean

is Working.

Example: false

orderId

integer · int64

order Id.

Example: 41295

origQty

string

orig Qty.

Example: 5.31000000

price

string

price.

Example: 0.22500000

side

string

side.

Example: SELL

status

string

status.

Example: CANCELED

stopPrice

string

stop Price.

Example: 0.18000000

symbol

string

symbol.

Example: BNBBTC

isIsolated

boolean

is Isolated.

Example: false

time

integer · int64

time.

Example: 1565769338806

timeInForce

string

time In Force.

Example: GTC

type

string

type.

Example: TAKE_PROFIT_LIMIT

selfTradePreventionMode

string

self Trade Prevention Mode.

Example: NONE

updateTime

integer · int64

update Time.

Example: 1565769342148

Query Margin Account's Open OCO

GET

/sapi/v1/margin/openOrderList

https://api.binance.com

Query Margin Account's Open OCO › 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 Margin Account's Open OCO › 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 Weight10

Query Margin Account's Open OCO › 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 Margin Account's Open OCO › 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

isIsolated

string · enum

Enum values:

TRUE

FALSE

Example: FALSE

Default: FALSE

symbol

string

mandatory for isolated margin, not supported for cross margin

Example: LTCBTC

recvWindow

integer · int64 · max: 60000

Example: 5000

Query Margin Account's Open OCO › Responses

200

Margin Account's Open OCO

object

orderListId

integer · int64

order List Id.

Example: 31

contingencyType

string

contingency Type.

Example: OCO

listStatusType

string

list Status Type.

Example: EXEC_STARTED

listOrderStatus

string

list Order Status.

Example: EXECUTING

listClientOrderId

string

list Client Order Id.

Example: wuB13fmulKj3YjdqWEcsnp

transactionTime

integer · int64

transaction Time.

Example: 1565246080644

symbol

string

symbol.

Example: LTCBTC

isIsolated

boolean

if isolated margin

Example: true

object[]

orders list.

Query Margin Account's Trade List

GET

/sapi/v1/margin/myTrades

https://api.binance.com

Query Margin Account's Trade List › 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 Margin Account's Trade List › 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 Weight10

Query Margin Account's Trade List › 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 Margin Account's Trade List › Query Parameters

symbol

string · required

Example: BNBBTC

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

isIsolated

string · enum

Enum values:

TRUE

FALSE

Example: FALSE

Default: FALSE

orderId

integer · int64

Example: 1

startTime

integer · int64

Example: 1623319461670

endTime

integer · int64

Example: 1641782889000

fromId

integer · int64

TradeId to fetch from. Default gets most recent trades.

Example: 1

limit

integer · int64 · max: 1000

Example: 500

Default: 500

recvWindow

integer · int64 · max: 60000

Example: 5000

Query Margin Account's Trade List › Responses

200

Margin Account's Trade List

object

commission

string

commission.

Example: 0.00006000

commissionAsset

string

commission Asset.

Example: BTC

id

integer · int64

id.

Example: 34

isBestMatch

boolean

is Best Match.

Example: true

isBuyer

boolean

is Buyer.

Example: false

isMaker

boolean

is Maker.

Example: false

orderId

integer · int64

order Id.

Example: 39324

price

string

price.

Example: 0.02000000

qty

string

qty.

Example: 3.00000000

symbol

string

symbol.

Example: BNBBTC

isIsolated

boolean

is Isolated.

Example: false

time

integer · int64

time.

Example: 1561973357171

Query Prevented Matches

Displays the list of orders that were expired due to STP. (Self-Trade Prevention).

GET

/sapi/v1/margin/myPreventedMatches

https://api.binance.com

Query Prevented Matches › 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 Prevented Matches › 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 Weight10

Query Prevented Matches › 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 Prevented Matches › Query Parameters

symbol

string · required

Example: BTCUSDT

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

preventedMatchId

integer · int64

Example: 1

orderId

integer · int64

Example: 1

fromPreventedMatchId

integer · int64

Example: 1

isIsolated

string · enum

Enum values:

TRUE

FALSE

Example: FALSE

Default: FALSE

recvWindow

integer · int64 · max: 60000

Example: 5000

Query Prevented Matches › Responses

200

Prevented Matches

object

symbol

string

symbol.

Example: BTCUSDT

preventedMatchId

integer · int64

prevented Match Id.

Example: 1

takerOrderId

integer · int64

taker Order Id.

Example: 5

makerSymbol

string

maker Symbol.

Example: BTCUSDT

makerOrderId

integer · int64

maker Order Id.

Example: 3

tradeGroupId

integer · int64

trade Group Id.

Example: 1

selfTradePreventionMode

string

self Trade Prevention Mode.

Example: EXPIRE_MAKER

price

string

price.

Example: 1.100000

makerPreventedQuantity

string

maker Prevented Quantity.

Example: 1.300000

transactTime

integer · int64

transact Time.

Example: 1669101687094

Query Special key List(Low Latency Trading)

This only applies to Special Key for Low Latency Trading.

GET

/sapi/v1/margin/api-key-list

https://api.binance.com

Query Special key List(Low Latency Trading) › 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 Special key List(Low Latency Trading) › 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 Weight1

Query Special key List(Low Latency Trading) › 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 Special key List(Low Latency Trading) › 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

symbol

string

Example: BTCUSDT

recvWindow

integer · int64 · max: 60000

Example: 5000

Query Special key List(Low Latency Trading) › Responses

200

Special key List

object

apiName

string

api Name.

Example: testName1

apiKey

string

api Key.

Example: znpOzOAeLVgr2TuxWfNo43AaPWpBbJEoKezh1o8mSQb6ryE2odE11A4AoVlJbQoG

ip

string

ip.

Example: 192.168.0.1,192.168.0.2

type

string

type.

Example: RSA

permissionMode

string

permission Mode.

Example: TRADE

Query Liquidation Loan

Query the current user's cross-margin liquidation loan information, including the original loan amount, repaid amount, and remaining amount. When a cross-margin account is liquidated and the account equity turns negative (bankruptcy), the system generates a liquidation loan record representing the deficit. This represents the shortfall amount denominated in USDC.

GET

/sapi/v1/margin/liquidation-loan

https://api.binance.com

Query Liquidation Loan › 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 Liquidation Loan › 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

Query Liquidation Loan › 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 Liquidation Loan › 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

Example: 5000

Query Liquidation Loan › Responses

200

Query Liquidation Loan

asset

string

The asset of the liquidation loan (USDC by default)

Example: USDC

amount

string

Total liquidation loan amount

Example: 1000.00000000

repaidAmount

string

Amount that has been repaid

Example: 300.00000000

remainingAmount

string

Outstanding amount remaining to be repaid

Example: 700.00000000

Liquidation Loan Repay

Repays the outstanding cross-margin liquidation loan from the user's spot wallet. A liquidation loan represents the account deficit incurred when account equity turns negative during liquidation (bankruptcy). The repayment amount must be greater than 0 and cannot exceed the remaining loan balance. If the Spot Account has insufficient USDC balance, the repayment will fail.

POST

/sapi/v1/margin/liquidation-loan/repay

https://api.binance.com

Liquidation Loan Repay › 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

Liquidation Loan Repay › 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

Liquidation Loan Repay › 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

Liquidation Loan Repay › Request Body

asset

string · required

The asset to repay (e.g. USDT, USDC)

Example: USDT

amount

number · float · required

Repayment amount, must be greater than 0

Example: 300.00

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

Liquidation Loan Repay › Responses

200

Liquidation Loan Repay

repayId

integer · int64

Unique identifier for this repayment transaction

Example: 12345678

asset

string

Asset used for repayment

Example: USDT

amount

string

Actual repayment amount

Example: 300.00000000

status

string · enum

Repayment status: SUCCESS (completed) or PENDING (processing)

Enum values:

SUCCESS

PENDING

Example: SUCCESS

createTime

integer · int64

Unix timestamp (milliseconds) when the repayment was created

Example: 1714492800000

Query Liquidation Loan Repay History

Query the repayment history of cross-margin liquidation loans (deficit caused by bankruptcy during liquidation). Supports time-range filtering and pagination.

GET

/sapi/v1/margin/liquidation-loan/repay-history

https://api.binance.com

Query Liquidation Loan Repay 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

Query Liquidation Loan Repay 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 Weight100

Query Liquidation Loan Repay 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

Query Liquidation Loan Repay History › 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

startTime

integer · int64

Start time in Unix timestamp (milliseconds). Defaults to 7 days ago if not specified

Example: 1714492800000

endTime

integer · int64

End time in Unix timestamp (milliseconds). Defaults to now if not specified

Example: 1714579200000

current

integer · int64

Current page number, default 1

Example: 1

Default: 1

size

integer · int64

Page size, default 50

Example: 50

Default: 50

recvWindow

integer · int64 · max: 60000

Example: 5000

Query Liquidation Loan Repay History › Responses

200

Query Liquidation Loan Repay History

total

integer · int64

Total number of repayment records

Example: 2

object[]