Account

Endpoint

Account Commission Rates

Get current account commission rates.

WSS

account.commission

wss://ws-api.binance.com:443/ws-api/v3

Account Commission Rates › 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

Account Commission Rates › 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

Account Commission Rates › Request Parameters

id

string · required

Client-generated request identifier.

Example: 7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b

method

string · enum · required

WebSocket API method name.

Enum values:

account.commission

Example: account.commission

object · required

Account Commission Rates › Responses

Successful Response

Account Commission Rates

id

string

Example: d3df8a61-98ea-4fe0-8f4e-0fcea5d418b0

status

integer · int64

Example: 200

object

object[]

WSSaccount.commission

wscat -c wss://ws-api.binance.com:443/ws-api/v3 -x '{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "account.commission",
  "params": {
    "symbol": "BNBUSDT",
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}'

Example Request

{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "account.commission",
  "params": {
    "symbol": "BNBUSDT",
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}

json

application/json

Example Responses

{
  "id": "d3df8a61-98ea-4fe0-8f4e-0fcea5d418b0",
  "status": 200,
  "result": {
    "symbol": "BTCUSDT",
    "standardCommission": {
      "maker": "0.00000010",
      "taker": "0.00000020",
      "buyer": "0.00000030",
      "seller": "0.00000040"
    },
    "specialCommission": {
      "maker": "0.01000000",
      "taker": "0.02000000",
      "buyer": "0.03000000",
      "seller": "0.04000000"
    },
    "taxCommission": {
      "maker": 0.00000112,
      "taker": 0.00000114,
      "buyer": 0.00000118,
      "seller": 0.00000116
    },
    "discount": {
      "enabledForAccount": true,
      "enabledForSymbol": true,
      "discountAsset": "BNB",
      "discount": "0.75000000"
    }
  },
  "rateLimits": [
    {
      "rateLimitType": "REQUEST_WEIGHT",
      "interval": "MINUTE",
      "intervalNum": 1,
      "limit": 6000,
      "count": 321
    }
  ]
}

json

application/json

Unfilled Order Count

Query your current unfilled order count for all intervals.

WSS

account.rateLimits.orders

wss://ws-api.binance.com:443/ws-api/v3

Unfilled Order Count › 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

Unfilled Order Count › 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 Weight40

Unfilled Order Count › Request Parameters optional

id

string · required

Client-generated request identifier.

Example: 7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b

method

string · enum · required

WebSocket API method name.

Enum values:

account.rateLimits.orders

Example: account.rateLimits.orders

object · required

Unfilled Order Count › Responses

Successful Response

Unfilled Order Count

id

string

Example: d3783d8d-f8d1-4d2c-b8a0-b7596af5a664

status

integer · int64

Example: 200

object[]

WSSaccount.rateLimits.orders

wscat -c wss://ws-api.binance.com:443/ws-api/v3 -x '{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "account.rateLimits.orders",
  "params": {
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}'

Example Request

{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "account.rateLimits.orders",
  "params": {
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}

json

application/json

Example Responses

{
  "id": "d3783d8d-f8d1-4d2c-b8a0-b7596af5a664",
  "status": 200,
  "result": [
    {
      "rateLimitType": "ORDERS",
      "interval": "SECOND",
      "intervalNum": 10,
      "limit": 50,
      "count": 0
    }
  ],
  "rateLimits": [
    {
      "rateLimitType": "REQUEST_WEIGHT",
      "interval": "MINUTE",
      "intervalNum": 1,
      "limit": 6000,
      "count": 321
    }
  ]
}

json

application/json

Account information

Query information about your account.

WSS

account.status

wss://ws-api.binance.com:443/ws-api/v3

Account information › 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

Account information › 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

Account information › Request Parameters optional

id

string · required

Client-generated request identifier.

Example: 7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b

method

string · enum · required

WebSocket API method name.

Enum values:

account.status

Example: account.status

object · required

Account information › Responses

Successful Response

Account information

id

string

Example: 605a6d20-6588-4cb9-afa0-b0ab087507ba

status

integer · int64

Example: 200

object

object[]

WSSaccount.status

wscat -c wss://ws-api.binance.com:443/ws-api/v3 -x '{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "account.status",
  "params": {
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}'

Example Request

{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "account.status",
  "params": {
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}

json

application/json

Example Responses

{
  "id": "605a6d20-6588-4cb9-afa0-b0ab087507ba",
  "status": 200,
  "result": {
    "makerCommission": 15,
    "takerCommission": 15,
    "buyerCommission": 0,
    "sellerCommission": 0,
    "canTrade": true,
    "canWithdraw": true,
    "canDeposit": true,
    "commissionRates": {
      "maker": 0.0015,
      "taker": 0.0015,
      "buyer": 0,
      "seller": 0
    },
    "brokered": false,
    "requireSelfTradePrevention": false,
    "preventSor": false,
    "updateTime": 1660801833000,
    "accountType": "SPOT",
    "balances": [
      {
        "asset": "BNB",
        "free": 0,
        "locked": 0
      }
    ],
    "permissions": [
      "SPOT"
    ],
    "uid": 354937868
  },
  "rateLimits": [
    {
      "rateLimitType": "REQUEST_WEIGHT",
      "interval": "MINUTE",
      "intervalNum": 1,
      "limit": 6000,
      "count": 321
    }
  ]
}

json

application/json

Account order list history

Query information about all your order lists, filtered by time range.

WSS

allOrderLists

wss://ws-api.binance.com:443/ws-api/v3

Account order list 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

Account order list history › 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

Account order list history › Request Parameters optional

id

string · required

Client-generated request identifier.

Example: 7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b

method

string · enum · required

WebSocket API method name.

Enum values:

allOrderLists

Example: allOrderLists

object · required

Account order list history › Responses

Successful Response

Account order list history

id

string

Example: 8617b7b3-1b3d-4dec-94cd-eefd929b8ceb

status

integer · int64

Example: 200

object[]

WSSallOrderLists

wscat -c wss://ws-api.binance.com:443/ws-api/v3 -x '{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "allOrderLists",
  "params": {
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}'

Example Request

{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "allOrderLists",
  "params": {
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}

json

application/json

Example Responses

{
  "id": "8617b7b3-1b3d-4dec-94cd-eefd929b8ceb",
  "status": 200,
  "result": [
    {
      "orderListId": 1274512,
      "contingencyType": "OCO",
      "listStatusType": "EXEC_STARTED",
      "listOrderStatus": "EXECUTING",
      "listClientOrderId": "08985fedd9ea2cf6b28996",
      "transactionTime": 1660801713793,
      "symbol": "BTCUSDT",
      "orders": [
        {
          "symbol": "BTCUSDT",
          "orderId": 12569138901,
          "clientOrderId": "BqtFCj5odMoWtSqGk2X9tU"
        }
      ]
    }
  ],
  "rateLimits": [
    {
      "rateLimitType": "REQUEST_WEIGHT",
      "interval": "MINUTE",
      "intervalNum": 1,
      "limit": 6000,
      "count": 321
    }
  ]
}

json

application/json

Account order history

Query information about all your orders – active, canceled, filled – filtered by time range.

WSS

allOrders

wss://ws-api.binance.com:443/ws-api/v3

Account order 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

Account order history › 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

Account order history › Request Parameters

id

string · required

Client-generated request identifier.

Example: 7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b

method

string · enum · required

WebSocket API method name.

Enum values:

allOrders

Example: allOrders

object · required

Account order history › Responses

Successful Response

Account order history

id

string

Example: 734235c2-13d2-4574-be68-723e818c08f3

status

integer · int64

Example: 200

object[]

WSSallOrders

wscat -c wss://ws-api.binance.com:443/ws-api/v3 -x '{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "allOrders",
  "params": {
    "symbol": "BNBUSDT",
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}'

Example Request

{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "allOrders",
  "params": {
    "symbol": "BNBUSDT",
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}

json

application/json

Example Responses

{
  "id": "734235c2-13d2-4574-be68-723e818c08f3",
  "status": 200,
  "result": [
    {
      "symbol": "BTCUSDT",
      "orderId": 12569099453,
      "orderListId": -1,
      "clientOrderId": "4d96324ff9d44481926157",
      "price": 23416.1,
      "origQty": 0.00847,
      "executedQty": 0.00847,
      "cummulativeQuoteQty": 198.335215,
      "status": "FILLED",
      "timeInForce": "GTC",
      "type": "LIMIT",
      "side": "SELL",
      "time": 1660801715639,
      "updateTime": 1660801717945,
      "isWorking": true,
      "workingTime": 1660801715639,
      "origQuoteOrderQty": 0,
      "selfTradePreventionMode": "NONE",
      "preventedMatchId": 0,
      "preventedQuantity": 1.2,
      "icebergQty": "0.00000000",
      "stopPrice": "0.00000000",
      "strategyId": 1,
      "strategyType": 1000000,
      "trailingDelta": 10,
      "trailingTime": -1,
      "usedSor": true,
      "workingFloor": "SOR",
      "pegPriceType": "PRIMARY_PEG",
      "pegOffsetType": "PRICE_LEVEL",
      "pegOffsetValue": 5,
      "peggedPrice": "87523.83710000",
      "expiryReason": "INSUFFICIENT_LIQUIDITY"
    }
  ],
  "rateLimits": [
    {
      "rateLimitType": "REQUEST_WEIGHT",
      "interval": "MINUTE",
      "intervalNum": 1,
      "limit": 6000,
      "count": 321
    }
  ]
}

json

application/json

Account allocations

Retrieves allocations resulting from SOR order placement.

WSS

myAllocations

wss://ws-api.binance.com:443/ws-api/v3

Account allocations › 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

Account allocations › 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

Account allocations › Request Parameters

id

string · required

Client-generated request identifier.

Example: 7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b

method

string · enum · required

WebSocket API method name.

Enum values:

myAllocations

Example: myAllocations

object · required

Data Source: Database

Supported parameter combinations:

Parameters	Response
`symbol`	allocations from oldest to newest
`symbol` + `startTime`	oldest allocations since `startTime`
`symbol` + `endTime`	newest allocations until `endTime`
`symbol` + `startTime` + `endTime`	allocations within the time range
`symbol` + `fromAllocationId`	allocations by allocation ID
`symbol` + `orderId`	allocations related to an order starting with oldest
`symbol` + `orderId` + `fromAllocationId`	allocations related to an order by allocation ID

Note: The time between startTime and endTime can't be longer than 24 hours.

Account allocations › Responses

Successful Response

Account allocations

id

string

Example: g4ce6a53-a39d-4f71-823b-4ab5r391d6y8

status

integer · int64

Example: 200

object[]

WSSmyAllocations

wscat -c wss://ws-api.binance.com:443/ws-api/v3 -x '{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "myAllocations",
  "params": {
    "symbol": "BNBUSDT",
    "apiKey": "API_KEY",
    "timestamp": 1770736694138
  }
}'

Example Request

{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "myAllocations",
  "params": {
    "symbol": "BNBUSDT",
    "apiKey": "API_KEY",
    "timestamp": 1770736694138
  }
}

json

application/json

Example Responses

{
  "id": "g4ce6a53-a39d-4f71-823b-4ab5r391d6y8",
  "status": 200,
  "result": [
    {
      "symbol": "BTCUSDT",
      "allocationId": 0,
      "allocationType": "SOR",
      "orderId": 500,
      "orderListId": -1,
      "price": 1,
      "qty": 0.1,
      "quoteQty": 0.1,
      "commission": 0,
      "commissionAsset": "BTC",
      "time": 1687319487614,
      "isBuyer": false,
      "isMaker": false,
      "isAllocator": false
    }
  ],
  "rateLimits": [
    {
      "rateLimitType": "REQUEST_WEIGHT",
      "interval": "MINUTE",
      "intervalNum": 1,
      "limit": 6000,
      "count": 321
    }
  ]
}

json

application/json

Query Relevant Filters

Retrieves the list of filters relevant to an account on a given symbol. This is the only method that shows if an account has MAX_ASSET filters applied to it.

WSS

myFilters

wss://ws-api.binance.com:443/ws-api/v3

Query Relevant Filters › 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 Relevant Filters › 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 Weight40

Query Relevant Filters › Request Parameters

id

string · required

Client-generated request identifier.

Example: 7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b

method

string · enum · required

WebSocket API method name.

Enum values:

myFilters

Example: myFilters

object · required

Query Relevant Filters › Responses

Successful Response

Query Relevant Filters

id

string

Example: 1758009606869

status

integer · int64

Example: 200

object

WSSmyFilters

wscat -c wss://ws-api.binance.com:443/ws-api/v3 -x '{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "myFilters",
  "params": {
    "symbol": "BNBUSDT",
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}'

Example Request

{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "myFilters",
  "params": {
    "symbol": "BNBUSDT",
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}

json

application/json

Example Responses

{
  "id": 1758009606869,
  "status": 200,
  "result": {
    "exchangeFilters": [
      {
        "filterType": "EXCHANGE_MAX_NUM_ORDERS",
        "maxNumOrders": 1000
      }
    ],
    "symbolFilters": [
      {
        "filterType": "PRICE_FILTER",
        "priceExponent": 8,
        "minPrice": "0.00000100",
        "maxPrice": "100000.00000000",
        "tickSize": "0.00000100"
      }
    ],
    "assetFilters": [
      {
        "filterType": "MAX_ASSET",
        "qtyExponent": 8,
        "limit": "1000000.00000000",
        "asset": "JPY"
      }
    ],
    "rateLimits": [
      {
        "rateLimitType": "REQUEST_WEIGHT",
        "interval": "MINUTE",
        "intervalNum": 1,
        "limit": 6000,
        "count": 321
      }
    ]
  }
}

json

application/json

Account prevented matches

Displays the list of orders that were expired due to STP.

These are the combinations supported:

symbol + preventedMatchId
symbol + orderId
symbol + orderId + fromPreventedMatchId (limit will default to 500)
symbol + orderId + fromPreventedMatchId + limit

WSS

myPreventedMatches

wss://ws-api.binance.com:443/ws-api/v3

Account 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

Account 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 Weight

Case	Weight
If `symbol` is invalid	2
Querying by `preventedMatchId`	2
Querying by `orderId`	20

Account prevented matches › Request Parameters

id

string · required

Client-generated request identifier.

Example: 7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b

method

string · enum · required

WebSocket API method name.

Enum values:

myPreventedMatches

Example: myPreventedMatches

object · required

Account prevented matches › Responses

Successful Response

Account prevented matches

id

string

Example: g4ce6a53-a39d-4f71-823b-4ab5r391d6y8

status

integer · int64

Example: 200

object[]

WSSmyPreventedMatches

wscat -c wss://ws-api.binance.com:443/ws-api/v3 -x '{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "myPreventedMatches",
  "params": {
    "symbol": "BNBUSDT",
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}'

Example Request

{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "myPreventedMatches",
  "params": {
    "symbol": "BNBUSDT",
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}

json

application/json

Example Responses

{
  "id": "g4ce6a53-a39d-4f71-823b-4ab5r391d6y8",
  "status": 200,
  "result": [
    {
      "symbol": "BTCUSDT",
      "preventedMatchId": 1,
      "takerOrderId": 5,
      "makerSymbol": "BTCUSDT",
      "makerOrderId": 3,
      "tradeGroupId": 1,
      "selfTradePreventionMode": "EXPIRE_MAKER",
      "price": 1.1,
      "makerPreventedQuantity": 1.3,
      "transactTime": 1669101687094
    }
  ],
  "rateLimits": [
    {
      "rateLimitType": "REQUEST_WEIGHT",
      "interval": "MINUTE",
      "intervalNum": 1,
      "limit": 6000,
      "count": 321
    }
  ]
}

json

application/json

Account trade history

Query information about all your trades, filtered by time range.

WSS

myTrades

wss://ws-api.binance.com:443/ws-api/v3

Account 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

Account trade history › 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

Condition	Weight
Without orderId	20
With orderId	5

Account trade history › Request Parameters

id

string · required

Client-generated request identifier.

Example: 7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b

method

string · enum · required

WebSocket API method name.

Enum values:

myTrades

Example: myTrades

object · required

Account trade history › Responses

Successful Response

Account trade history

id

string

Example: f4ce6a53-a29d-4f70-823b-4ab59391d6e8

status

integer · int64

Example: 200

object[]

WSSmyTrades

wscat -c wss://ws-api.binance.com:443/ws-api/v3 -x '{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "myTrades",
  "params": {
    "symbol": "BNBUSDT",
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}'

Example Request

{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "myTrades",
  "params": {
    "symbol": "BNBUSDT",
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}

json

application/json

Example Responses

{
  "id": "f4ce6a53-a29d-4f70-823b-4ab59391d6e8",
  "status": 200,
  "result": [
    {
      "symbol": "BTCUSDT",
      "id": 1650422481,
      "orderId": 12569099453,
      "orderListId": -1,
      "price": 23416.1,
      "qty": 0.00635,
      "quoteQty": 148.692235,
      "commission": 0,
      "commissionAsset": "BNB",
      "time": 1660801715793,
      "isBuyer": false,
      "isMaker": true,
      "isBestMatch": true
    }
  ],
  "rateLimits": [
    {
      "rateLimitType": "REQUEST_WEIGHT",
      "interval": "MINUTE",
      "intervalNum": 1,
      "limit": 6000,
      "count": 321
    }
  ]
}

json

application/json

Current open Order lists

Query execution status of all open order lists.

If you need to continuously monitor order status updates, please consider using WebSocket Streams:

userDataStream.subscribe if on an authenticated session
userDataStream.subscribe.signature if subscribing through signature subscription

WSS

openOrderLists.status

wss://ws-api.binance.com:443/ws-api/v3

Current open Order lists › 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

Current open Order lists › 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 Weight6

Current open Order lists › Request Parameters optional

id

string · required

Client-generated request identifier.

Example: 7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b

method

string · enum · required

WebSocket API method name.

Enum values:

openOrderLists.status

Example: openOrderLists.status

object · required

Current open Order lists › Responses

Successful Response

Current open Order lists

id

string

Example: 3a4437e2-41a3-4c19-897c-9cadc5dce8b6

status

integer · int64

Example: 200

object[]

WSSopenOrderLists.status

wscat -c wss://ws-api.binance.com:443/ws-api/v3 -x '{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "openOrderLists.status",
  "params": {
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}'

Example Request

{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "openOrderLists.status",
  "params": {
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}

json

application/json

Example Responses

{
  "id": "3a4437e2-41a3-4c19-897c-9cadc5dce8b6",
  "status": 200,
  "result": [
    {
      "orderListId": 0,
      "contingencyType": "OCO",
      "listStatusType": "EXEC_STARTED",
      "listOrderStatus": "EXECUTING",
      "listClientOrderId": "08985fedd9ea2cf6b28996",
      "transactionTime": 1660801713793,
      "symbol": "BTCUSDT",
      "orders": [
        {
          "symbol": "BTCUSDT",
          "orderId": 4,
          "clientOrderId": "CUhLgTXnX5n2c0gWiLpV4d"
        }
      ]
    }
  ],
  "rateLimits": [
    {
      "rateLimitType": "REQUEST_WEIGHT",
      "interval": "MINUTE",
      "intervalNum": 1,
      "limit": 6000,
      "count": 321
    }
  ]
}

json

application/json

Current open orders

Query execution status of all open orders.

If you need to continuously monitor order status updates, please consider using WebSocket Streams:

userDataStream.subscribe if on an authenticated session
userDataStream.subscribe.signature if subscribing through signature subscription

WSS

openOrders.status

wss://ws-api.binance.com:443/ws-api/v3

Current 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

Current 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 Weight

Parameter	Weight
`symbol`	6
none	80

Current open orders › Request Parameters optional

id

string · required

Client-generated request identifier.

Example: 7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b

method

string · enum · required

WebSocket API method name.

Enum values:

openOrders.status

Example: openOrders.status

object · required

Current open orders › Responses

Successful Response

Current open orders

id

string

Example: 55f07876-4f6f-4c47-87dc-43e5fff3f2e7

status

integer · int64

Example: 200

object[]

WSSopenOrders.status

wscat -c wss://ws-api.binance.com:443/ws-api/v3 -x '{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "openOrders.status",
  "params": {
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}'

Example Request

{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "openOrders.status",
  "params": {
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}

json

application/json

Example Responses

{
  "id": "55f07876-4f6f-4c47-87dc-43e5fff3f2e7",
  "status": 200,
  "result": [
    {
      "symbol": "BTCUSDT",
      "orderId": 12569099453,
      "orderListId": -1,
      "clientOrderId": "4d96324ff9d44481926157",
      "price": 23416.1,
      "origQty": 0.00847,
      "executedQty": 0.0072,
      "origQuoteOrderQty": 0,
      "cummulativeQuoteQty": 172.43931,
      "status": "PARTIALLY_FILLED",
      "timeInForce": "GTC",
      "type": "LIMIT",
      "side": "SELL",
      "time": 1660801715639,
      "updateTime": 1660801717945,
      "isWorking": true,
      "workingTime": 1660801715639,
      "selfTradePreventionMode": "NONE",
      "icebergQty": "0.00000000",
      "preventedMatchId": 0,
      "preventedQuantity": "1.200000",
      "stopPrice": "0.00000000",
      "strategyId": 1,
      "strategyType": 1000000,
      "trailingDelta": 10,
      "trailingTime": -1,
      "usedSor": true,
      "workingFloor": "SOR",
      "pegPriceType": "PRIMARY_PEG",
      "pegOffsetType": "PRICE_LEVEL",
      "pegOffsetValue": 5,
      "peggedPrice": "87523.83710000",
      "expiryReason": "INSUFFICIENT_LIQUIDITY"
    }
  ],
  "rateLimits": [
    {
      "rateLimitType": "REQUEST_WEIGHT",
      "interval": "MINUTE",
      "intervalNum": 1,
      "limit": 6000,
      "count": 321
    }
  ]
}

json

application/json

Query Order Amendments

Queries all amendments of a single order.

WSS

order.amendments

wss://ws-api.binance.com:443/ws-api/v3

Query Order Amendments › 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 Order Amendments › 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 Weight4

Query Order Amendments › Request Parameters

id

string · required

Client-generated request identifier.

Example: 7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b

method

string · enum · required

WebSocket API method name.

Enum values:

order.amendments

Example: order.amendments

object · required

Query Order Amendments › Responses

Successful Response

Query Order Amendments

id

string

Example: 6f5ebe91-01d9-43ac-be99-57cf062e0e30

status

integer · int64

Example: 200

object[]

WSSorder.amendments

wscat -c wss://ws-api.binance.com:443/ws-api/v3 -x '{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "order.amendments",
  "params": {
    "symbol": "BNBUSDT",
    "orderId": 1,
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}'

Example Request

{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "order.amendments",
  "params": {
    "symbol": "BNBUSDT",
    "orderId": 1,
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}

json

application/json

Example Responses

{
  "id": "6f5ebe91-01d9-43ac-be99-57cf062e0e30",
  "status": 200,
  "result": [
    {
      "symbol": "BTCUSDT",
      "orderId": 23,
      "executionId": 60,
      "origClientOrderId": "my_pending_order",
      "newClientOrderId": "xbxXh5SSwaHS7oUEOCI88B",
      "origQty": 7,
      "newQty": 5,
      "time": 1741924229819
    }
  ],
  "rateLimits": [
    {
      "rateLimitType": "REQUEST_WEIGHT",
      "interval": "MINUTE",
      "intervalNum": 1,
      "limit": 6000,
      "count": 321
    }
  ]
}

json

application/json

Query Order list

Check execution status of an Order list.

For execution status of individual orders, use order.status.

WSS

orderList.status

wss://ws-api.binance.com:443/ws-api/v3

Query Order 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 Order 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 Weight4

Query Order list › Request Parameters optional

id

string · required

Client-generated request identifier.

Example: 7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b

method

string · enum · required

WebSocket API method name.

Enum values:

orderList.status

Example: orderList.status

object · required

Query Order list › Responses

Successful Response

Query Order list

id

string

Example: b53fd5ff-82c7-4a04-bd64-5f9dc42c2100

status

integer · int64

Example: 200

object

object[]

WSSorderList.status

wscat -c wss://ws-api.binance.com:443/ws-api/v3 -x '{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "orderList.status",
  "params": {
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}'

Example Request

{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "orderList.status",
  "params": {
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}

json

application/json

Example Responses

{
  "id": "b53fd5ff-82c7-4a04-bd64-5f9dc42c2100",
  "status": 200,
  "result": {
    "orderListId": 1274512,
    "contingencyType": "OCO",
    "listStatusType": "EXEC_STARTED",
    "listOrderStatus": "EXECUTING",
    "listClientOrderId": "08985fedd9ea2cf6b28996",
    "transactionTime": 1660801713793,
    "symbol": "BTCUSDT",
    "orders": [
      {
        "symbol": "BTCUSDT",
        "orderId": 12569138901,
        "clientOrderId": "BqtFCj5odMoWtSqGk2X9tU"
      }
    ]
  },
  "rateLimits": [
    {
      "rateLimitType": "REQUEST_WEIGHT",
      "interval": "MINUTE",
      "intervalNum": 1,
      "limit": 6000,
      "count": 321
    }
  ]
}

json

application/json

Query order

Check execution status of an order.

WSS

order.status

wss://ws-api.binance.com:443/ws-api/v3

Query 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 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 Weight4

Query order › Request Parameters

id

string · required

Client-generated request identifier.

Example: 7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b

method

string · enum · required

WebSocket API method name.

Enum values:

order.status

Example: order.status

object · required

Query order › Responses

Successful Response

Query order

id

string

Example: aa62318a-5a97-4f3b-bdc7-640bbe33b291

status

integer · int64

Example: 200

object

object[]

WSSorder.status

wscat -c wss://ws-api.binance.com:443/ws-api/v3 -x '{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "order.status",
  "params": {
    "symbol": "BNBUSDT",
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}'

Example Request

{
  "id": "7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b",
  "method": "order.status",
  "params": {
    "symbol": "BNBUSDT",
    "timestamp": 1770736694138,
    "apiKey": "API_KEY"
  }
}

json

application/json

Example Responses

{
  "id": "aa62318a-5a97-4f3b-bdc7-640bbe33b291",
  "status": 200,
  "result": {
    "symbol": "BTCUSDT",
    "orderId": 12569099453,
    "orderListId": -1,
    "clientOrderId": "4d96324ff9d44481926157",
    "price": 23416.1,
    "origQty": 0.00847,
    "executedQty": 0.00847,
    "origQuoteOrderQty": 0,
    "cummulativeQuoteQty": 198.335215,
    "status": "FILLED",
    "timeInForce": "GTC",
    "type": "LIMIT",
    "side": "SELL",
    "stopPrice": 0,
    "trailingDelta": 10,
    "trailingTime": -1,
    "icebergQty": 0,
    "time": 1660801715639,
    "updateTime": 1660801717945,
    "isWorking": true,
    "workingTime": 1660801715639,
    "strategyId": 37463720,
    "strategyType": 1000000,
    "selfTradePreventionMode": "NONE",
    "preventedMatchId": 0,
    "preventedQuantity": 1.2,
    "usedSor": true,
    "workingFloor": "SOR",
    "pegPriceType": "PRIMARY_PEG",
    "pegOffsetType": "PRICE_LEVEL",
    "pegOffsetValue": 5,
    "peggedPrice": "87523.83710000",
    "expiryReason": "INSUFFICIENT_LIQUIDITY"
  },
  "rateLimits": [
    {
      "rateLimitType": "REQUEST_WEIGHT",
      "interval": "MINUTE",
      "intervalNum": 1,
      "limit": 6000,
      "count": 321
    }
  ]
}

json

application/json