Trade

Endpoint

Account Trade List (USER_DATA)

Get trades for a specific account and symbol.

GET

/eapi/v1/userTrades

https://eapi.binance.com

Account Trade List (USER_DATA) › Authorization

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

Account Trade List (USER_DATA) › Request Weight

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

Learn more in the Rate limits section.

IP Weight5

Account Trade List (USER_DATA) › Headers

X-MBX-APIKEY

string · required

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

Example: API_KEY

Account Trade List (USER_DATA) › Query Parameters

symbol

string · required

Option trading pair.

Example: BTC-200730-9000-C

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

fromId

integer · int64

Trade id to fetch from. Default gets most recent trades, e.g 4611875134427365376

Example: 1

startTime

integer · int64

Start Time, e.g 1593511200000

Example: 1623319461670

endTime

integer · int64

End Time, e.g 1593512200000

Example: 1641782889000

limit

integer · int64 · max: 1000

Number of result sets returned.

Example: 20

Default: 100

recvWindow

integer · int64

Recv Window.

Example: 5000

Account Trade List (USER_DATA) › Responses

200

Account Trade List

object

id

integer · int64

unique id

Example: 4611875134427365000

tradeId

integer · int64

trade id

Example: 239

orderId

integer · int64

order id

Example: 4611875134427365000

symbol

string

option symbol

Example: BTC-200730-9000-C

price

string

trade price

Example: 100

quantity

string

trade quantity

Example: 1

fee

string

fee(negative is fee deduction)

Example: -1.04378629

realizedProfit

string

realized profit/loss

Example: 0.00000000

side

string

order side

Example: BUY

type

string

order type

Example: LIMIT

liquidity

string

TAKER or MAKER

Example: TAKER

time

integer · int64

trade time

Example: 1592465880683

priceScale

integer · int64

price Scale

Example: 2

quantityScale

integer · int64

quantity Scale

Example: 2

optionSide

string

option Side

Example: CALL

quoteAsset

string

quote Asset

Example: USDT

Cancel All Option Orders By Underlying (TRADE)

Cancel all active orders on specified underlying.

DELETE

/eapi/v1/allOpenOrdersByUnderlying

https://eapi.binance.com

Cancel All Option Orders By Underlying (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

Cancel All Option Orders By Underlying (TRADE) › 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 Weight5

Cancel All Option Orders By Underlying (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

Cancel All Option Orders By Underlying (TRADE) › Query Parameters

underlying

string · required

Underlying asset.

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

recvWindow

integer · int64

Recv Window.

Example: 5000

Cancel All Option Orders By Underlying (TRADE) › Responses

200

Cancel All Option Orders By Underlying

code

integer · int64

code

Example: 0

msg

string

msg

Example: success

Cancel all Option orders on specific symbol (TRADE)

Cancel all active order on a symbol.

DELETE

/eapi/v1/allOpenOrders

https://eapi.binance.com

Cancel all Option orders on specific symbol (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

Cancel all Option orders on specific symbol (TRADE) › 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

Cancel all Option orders on specific symbol (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

Cancel all Option orders on specific symbol (TRADE) › Query Parameters

symbol

string · required

Option trading pair.

Example: BTC-200730-9000-C

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

Recv Window.

Example: 5000

Cancel all Option orders on specific symbol (TRADE) › Responses

200

Cancel all Option orders on specific symbol

code

string

code

Example: 0

msg

string

msg

Example: success

Place Multiple Orders (TRADE)

Send multiple option orders.

POST

/eapi/v1/batchOrders

https://eapi.binance.com

Place Multiple Orders (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

Place Multiple Orders (TRADE) › 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 Weight5

Place Multiple Orders (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

Place Multiple Orders (TRADE) › Request Body

object[] · required

order list. Max 10 orders

symbol

string · required

Example: BTC-200730-9000-C

side

string · enum · required

Enum values:

BUY

SELL

Example: BUY

type

string · enum · required

Enum values:

LIMIT

Example: LIMIT

quantity

number · float · required

Order Quantity

Example: 1.0

price

number · float

Order Price

Example: 1.0

timeInForce

string · enum

Enum values:

GTC

IOC

FOK

GTX

Example: GTC

Default: GTC

reduceOnly

boolean

Example: false

Default: false

postOnly

boolean

Example: false

Default: false

newOrderRespType

string · enum

Enum values:

ACK

RESULT

Example: ACK

Default: ACK

clientOrderId

string

User-defined order ID cannot be repeated in pending orders

Example: 1

isMmp

boolean

is market maker protection order

Example: true

selfTradePreventionMode

string · enum

EXPIRE_TAKER taker order when STP triggers/ EXPIRE_MAKER maker order when STP triggers/ EXPIRE_BOTH both orders when STP triggers; Default EXPIRE_MAKER

Enum values:

EXPIRE_TAKER

EXPIRE_MAKER

EXPIRE_BOTH

Example: NONE

Default: EXPIRE_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

recvWindow

integer · int64

Example: 5000

Some parameters are mandatory depending on the order type as follows:

Type	Mandatory parameters
LIMIT	timeInForce, quantity, price

Parameter rules are same with New Order
Batch orders are processed concurrently, and the order of matching is not guaranteed.

Place Multiple Orders (TRADE) › Responses

200

Place Multiple Orders

object

orderId

integer · int64

System order number

Example: 4611875134427365000

symbol

string

Option trading pair

Example: BTC-200730-9000-C

price

string

Order Price

Example: 100

quantity

string

Order Quantity

Example: 1

executedQty

string

Number of executed quantity

Example: 0

fee

integer · int64

fee

Example: 0

side

string

Buy/sell direction

Example: BUY

type

string

Order type

Example: LIMIT

timeInForce

string

Time in force method

Example: GTC

reduceOnly

boolean

Order is reduce only Y/N

Example: false

postOnly

boolean

post Only

Example: false

createTime

integer · int64

Order Time

Example: 1592465880683

updateTime

integer · int64

Update time

Example: 1566818724722

status

string

Order status

Example: NEW

avgPrice

string

Average price of completed trade

Example: 0

clientOrderId

string

Client order ID

Example:

priceScale

integer · int64

price Scale

Example: 2

quantityScale

integer · int64

quantity Scale

Example: 2

optionSide

string

option Side

Example: CALL

quoteAsset

string

quote Asset

Example: USDT

mmp

boolean

mmp

Example: false

selfTradePreventionMode

string

Example: EXPIRE_MAKER

source

string

Example: API

POST/eapi/v1/batchOrders

curl --request POST \
  --url https://eapi.binance.com/eapi/v1/batchOrders \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --header 'X-MBX-APIKEY: <string>' \
  --data 'orders={"symbol":"BTC-200730-9000-C","side":"BUY","type":"LIMIT","quantity":"1.0"}' \
  --data timestamp=1770736694138

Example Request Body

{
  "orders": [
    {
      "symbol": "BTC-200730-9000-C",
      "side": "BUY",
      "type": "LIMIT",
      "quantity": "1.0"
    }
  ],
  "timestamp": 1770736694138
}

json

Example Responses

[
  {
    "orderId": 4611875134427365000,
    "symbol": "BTC-200730-9000-C",
    "price": "100",
    "quantity": "1",
    "executedQty": "0",
    "fee": 0,
    "side": "BUY",
    "type": "LIMIT",
    "timeInForce": "GTC",
    "reduceOnly": false,
    "postOnly": false,
    "createTime": 1592465880683,
    "updateTime": 1566818724722,
    "status": "NEW",
    "avgPrice": "0",
    "clientOrderId": "",
    "priceScale": 2,
    "quantityScale": 2,
    "optionSide": "CALL",
    "quoteAsset": "USDT",
    "mmp": false,
    "selfTradePreventionMode": "EXPIRE_MAKER",
    "source": "API"
  }
]

json

application/json

Cancel Multiple Option Orders (TRADE)

Cancel multiple orders.

DELETE

/eapi/v1/batchOrders

https://eapi.binance.com

Cancel Multiple Option Orders (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

Cancel Multiple Option Orders (TRADE) › 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 Weight5

Cancel Multiple Option Orders (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

Cancel Multiple Option Orders (TRADE) › Query Parameters

symbol

string · required

Option trading pair.

Example: BTC-200730-9000-C

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

orderIds

integer[]

Order ID list.

clientOrderIds

string[]

Client order ID list.

recvWindow

integer · int64

Recv Window.

Example: 5000

Cancel Multiple Option Orders (TRADE) › Responses

200

Cancel Multiple Option Orders

object

orderId

integer · int64

System order number

Example: 4611875134427365000

symbol

string

Option trading pair

Example: BTC-200730-9000-C

price

string

Order Price

Example: 100

quantity

string

Order Quantity

Example: 1

executedQty

string

Number of completed quantity

Example: 0

fee

string

fee

Example: 0

side

string

Buy/sell direction

Example: BUY

type

string

Order type

Example: LIMIT

timeInForce

string

Time in force method

Example: GTC

reduceOnly

boolean

Order is reduce only Y/N

Example: false

createTime

integer · int64

Order Time

Example: 1592465880683

updateTime

integer · int64

Update time

Example: 1566818724722

status

string

Order status

Example: ACCEPTED

avgPrice

string

Average price of completed trade

Example: 0

clientOrderId

string

Client order ID

Example:

priceScale

integer · int64

price Scale

Example: 3

quantityScale

integer · int64

quantity Scale

Example: 4

optionSide

string

option Side

Example: CALL

quoteAsset

string

quote Asset

Example: USDT

mmp

boolean

mmp

Example: false

source

string

Example: API

selfTradePreventionMode

string

Example: EXPIRE_MAKER

DELETE/eapi/v1/batchOrders

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

Example Responses

[
  {
    "orderId": 4611875134427365000,
    "symbol": "BTC-200730-9000-C",
    "price": "100",
    "quantity": "1",
    "executedQty": "0",
    "fee": "0",
    "side": "BUY",
    "type": "LIMIT",
    "timeInForce": "GTC",
    "reduceOnly": false,
    "createTime": 1592465880683,
    "updateTime": 1566818724722,
    "status": "ACCEPTED",
    "avgPrice": "0",
    "clientOrderId": "",
    "priceScale": 3,
    "quantityScale": 4,
    "optionSide": "CALL",
    "quoteAsset": "USDT",
    "mmp": false,
    "source": "API",
    "selfTradePreventionMode": "EXPIRE_MAKER"
  }
]

json

application/json

Query Single Order (TRADE)

Check an order status.

These orders will not be found:
- order status is CANCELED or REJECTED, AND
- order has NO filled trade, AND
- created time + 3 days < current time

GET

/eapi/v1/order

https://eapi.binance.com

Query Single Order (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

Query Single Order (TRADE) › 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

Query Single Order (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

Query Single Order (TRADE) › Query Parameters

symbol

string · required

Option trading pair.

Example: BTC-200730-9000-C

timestamp

integer · int64 · required

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

Example: 1770736694138

orderId

integer · int64

Order ID.

Example: 4611875134427365000

clientOrderId

string

User-defined order ID; cannot be duplicated among open orders.

Example: abc123

recvWindow

integer · int64

Recv Window.

Example: 5000

Query Single Order (TRADE) › Responses

200

Single Order

orderId

integer · int64

System order id

Example: 4611875134427365000

symbol

string

Option trading pair

Example: BTC-200730-9000-C

price

string

Order Price

Example: 100

quantity

string

Order Quantity

Example: 1

executedQty

string

Number of executed quantity

Example: 0

side

string

Buy/sell direction

Example: BUY

type

string

Order type

Example: LIMIT

timeInForce

string

Time in force method

Example: GTC

reduceOnly

boolean

Order is reduce only Y/N

Example: false

postOnly

boolean

post Only

Example: false

createTime

integer · int64

Order Time

Example: 1592465880683

updateTime

integer · int64

Update time

Example: 1566818724722

status

string

Order status

Example: NEW

avgPrice

string

Average price of completed trade

Example: 0

clientOrderId

string

Client order ID

Example:

priceScale

integer · int64

price Scale

Example: 2

quantityScale

integer · int64

quantity Scale

Example: 2

optionSide

string

option Side

Example: CALL

quoteAsset

string

quote Asset

Example: USDT

mmp

boolean

mmp

Example: false

selfTradePreventionMode

string

Self trade prevention mode.

Example: EXPIRE_MAKER

New Order (TRADE)

Send a new order.

POST

/eapi/v1/order

https://eapi.binance.com

New Order (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

New Order (TRADE) › 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 Weight0

New Order (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

New Order (TRADE) › Request Body

symbol

string · required

Example: BTC-200730-9000-C

side

string · enum · required

Enum values:

BUY

SELL

Example: BUY

type

string · enum · required

Enum values:

LIMIT

Example: LIMIT

quantity

number · float · required

Order Quantity

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

price

number · float

Order Price

Example: 1.0

timeInForce

string · enum

Enum values:

GTC

IOC

FOK

GTX

Example: GTC

Default: GTC

reduceOnly

boolean

Example: false

Default: false

postOnly

boolean

Example: false

Default: false

newOrderRespType

string · enum

Enum values:

ACK

RESULT

Example: ACK

Default: ACK

clientOrderId

string

User-defined order ID cannot be repeated in pending orders

Example: 1

isMmp

boolean

is market maker protection order

Example: true

selfTradePreventionMode

string · enum

Self-trade prevention mode

Enum values:

NONE

EXPIRE_TAKER

EXPIRE_MAKER

EXPIRE_BOTH

Example: NONE

recvWindow

integer · int64

Example: 5000

New Order (TRADE) › Responses

200

New Order

orderId

integer · int64

System order number

Example: 4611875134427365000

symbol

string

Option trading pair

Example: BTC-200730-9000-C

price

string

Order Price

Example: 100

quantity

string

Order Quantity

Example: 1

executedQty

string

Number of executed quantity

Example: 0

fee

integer · int64

fee

Example: 0

side

string

Buy/sell direction

Example: BUY

type

string

Order type

Example: LIMIT

timeInForce

string

Time in force method

Example: GTC

reduceOnly

boolean

Order is reduce only Y/N

Example: false

postOnly

boolean

post Only

Example: false

createTime

integer · int64

Order Time

Example: 1592465880683

updateTime

integer · int64

Update time

Example: 1566818724722

status

string

Order status

Example: NEW

avgPrice

string

Average price of completed trade

Example: 0

source

string

source

Example: API

clientOrderId

string

Client order ID

Example:

priceScale

integer · int64

price Scale

Example: 2

quantityScale

integer · int64

quantity Scale

Example: 2

optionSide

string

option Side

Example: CALL

quoteAsset

string

quote Asset

Example: USDT

mmp

boolean

mmp

Example: false

selfTradePreventionMode

string

Self-trade prevention mode

Example: EXPIRE_MAKER

POST/eapi/v1/order

curl --request POST \
  --url https://eapi.binance.com/eapi/v1/order \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --header 'X-MBX-APIKEY: <string>' \
  --data symbol=BTC-200730-9000-C \
  --data side=BUY \
  --data type=LIMIT \
  --data quantity=1.0 \
  --data timestamp=1770736694138

Example Request Body

{
  "symbol": "BTC-200730-9000-C",
  "side": "BUY",
  "type": "LIMIT",
  "quantity": "1.0",
  "timestamp": 1770736694138
}

json

Example Responses

{
  "orderId": 4611875134427365000,
  "symbol": "BTC-200730-9000-C",
  "price": "100",
  "quantity": "1",
  "executedQty": "0",
  "fee": 0,
  "side": "BUY",
  "type": "LIMIT",
  "timeInForce": "GTC",
  "reduceOnly": false,
  "postOnly": false,
  "createTime": 1592465880683,
  "updateTime": 1566818724722,
  "status": "NEW",
  "avgPrice": "0",
  "source": "API",
  "clientOrderId": "",
  "priceScale": 2,
  "quantityScale": 2,
  "optionSide": "CALL",
  "quoteAsset": "USDT",
  "mmp": false,
  "selfTradePreventionMode": "EXPIRE_MAKER"
}

json

application/json

Cancel Option Order (TRADE)

Cancel an active order.

DELETE

/eapi/v1/order

https://eapi.binance.com

Cancel Option Order (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

Cancel Option Order (TRADE) › 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

Cancel Option Order (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

Cancel Option Order (TRADE) › Query Parameters

symbol

string · required

Option trading pair.

Example: BTC-200730-9000-C

timestamp

integer · int64 · required

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

Example: 1770736694138

orderId

integer · int64

Order ID.

Example: 4611875134427365000

clientOrderId

string

clientOrderId

Example: 10000

recvWindow

integer · int64

Recv Window.

Example: 5000

Cancel Option Order (TRADE) › Responses

200

Cancel Option Order

orderId

integer · int64

System order number

Example: 4611875134427365000

symbol

string

Option trading pair

Example: BTC-200730-9000-C

price

string

Order Price

Example: 100

quantity

string

Order Quantity

Example: 1

executedQty

string

Number of executed quantity

Example: 0

side

string

Buy/sell direction

Example: BUY

type

string

Order type

Example: LIMIT

timeInForce

string

Time in force method

Example: GTC

reduceOnly

boolean

Order is reduce only Y/N

Example: false

createDate

integer · int64

Order Time

Example: 1592465880683

updateTime

integer · int64

Update time

Example: 1566818724722

status

string

Order status

Example: ACCEPTED

avgPrice

string

Average price of completed trade

Example: 0

source

string

source

Example: API

clientOrderId

string

Client order ID

Example:

priceScale

integer · int64

price Scale

Example: 4

quantityScale

integer · int64

quantity Scale

Example: 4

optionSide

string

option Side

Example: CALL

quoteAsset

string

quote Asset

Example: USDT

mmp

boolean

mmp

Example: false

selfTradePreventionMode

string

Example: EXPIRE_MAKER

Option Position Information (USER_DATA)

Get current position information.

GET

/eapi/v1/position

https://eapi.binance.com

Option Position Information (USER_DATA) › Authorization

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

Option Position Information (USER_DATA) › Request Weight

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

Learn more in the Rate limits section.

IP Weight5

Option Position Information (USER_DATA) › Headers

X-MBX-APIKEY

string · required

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

Example: API_KEY

Option Position Information (USER_DATA) › Query Parameters

timestamp

integer · int64 · required

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

Example: 1770736694138

symbol

string

Option trading pair.

Example: BTC-200730-9000-C

recvWindow

integer · int64

Recv Window.

Example: 5000

Option Position Information (USER_DATA) › Responses

200

Option Position Information

object

entryPrice

string

Average entry price

Example: 1000

symbol

string

Option trading pair

Example: BTC-200730-9000-C

side

string

Position direction

Example: SHORT

quantity

string

Number of positions (positive numbers represent long positions, negative number represent short positions)

Example: -0.1

markValue

string

Current market value

Example: 105.00138

unrealizedPNL

string

Unrealized profit/loss

Example: -5.00138

markPrice

string

Mark price

Example: 1050.0138

strikePrice

string

Strike price

Example: 9000

expiryDate

integer · int64

Exercise time

Example: 1593511200000

priceScale

integer · int64

price Scale

Example: 2

quantityScale

integer · int64

quantity Scale

Example: 2

optionSide

string

option type

Example: CALL

quoteAsset

string

quote asset

Example: USDT

time

integer · int64

last update time

Example: 1762872654561

bidQuantity

string

buy order qty

Example: 0.0000

askQuantity

string

sell order qty

Example: 0.0000

Query Current Open Option Orders (USER_DATA)

Query current all open orders, status: ACCEPTED PARTIALLY_FILLED

GET

/eapi/v1/openOrders

https://eapi.binance.com

Query Current Open Option Orders (USER_DATA) › Authorization

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

Query Current Open Option Orders (USER_DATA) › Request Weight

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

Learn more in the Rate limits section.

IP Weight

1 for a single symbol; 40 when the symbol parameter is omitted

Query Current Open Option Orders (USER_DATA) › Headers

X-MBX-APIKEY

string · required

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

Example: API_KEY

Query Current Open Option Orders (USER_DATA) › Query Parameters

timestamp

integer · int64 · required

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

Example: 1770736694138

symbol

string

Option trading pair.

Example: BTC-200730-9000-C

orderId

integer · int64

Order ID.

Example: 4611875134427365000

startTime

integer · int64

Start Time, e.g 1593511200000

Example: 1623319461670

endTime

integer · int64

End Time, e.g 1593512200000

Example: 1641782889000

recvWindow

integer · int64

Recv Window.

Example: 5000

Query Current Open Option Orders (USER_DATA) › Responses

200

Current Open Option Orders

object

orderId

integer · int64

System order number

Example: 4611875134427365000

symbol

string

Option trading pair

Example: BTC-200730-9000-C

price

string

Order Price

Example: 100

quantity

string

Order Quantity

Example: 1

executedQty

string

Number of completed trades

Example: 0

side

string

Buy/sell direction

Example: BUY

type

string

Order type

Example: LIMIT

timeInForce

string

Time in force method

Example: GTC

reduceOnly

boolean

Order is reduce only Y/N

Example: false

createTime

integer · int64

Order Time

Example: 1592465880683

updateTime

integer · int64

Update Time

Example: 1592465880683

status

string

Order status

Example: NEW

avgPrice

string

Average price of completed trade

Example: 0

clientOrderId

string

Client order ID

Example:

priceScale

integer · int64

price Scale

Example: 2

quantityScale

integer · int64

quantity Scale

Example: 2

optionSide

string

option Side

Example: CALL

quoteAsset

string

quote Asset

Example: USDT

mmp

boolean

mmp

Example: false

selfTradePreventionMode

string

Example: EXPIRE_MAKER

Query Option Order History (TRADE)

Query all finished orders within 5 days, finished status: CANCELLED FILLED REJECTED.

GET

/eapi/v1/historyOrders

https://eapi.binance.com

Query Option Order History (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

Query Option Order History (TRADE) › 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 Weight3

Query Option Order History (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

Query Option Order History (TRADE) › Query Parameters

symbol

string · required

Option trading pair.

Example: BTC-200730-9000-C

timestamp

integer · int64 · required

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

Example: 1770736694138

orderId

integer · int64

Order ID.

Example: 4611875134427365000

startTime

integer · int64

Start Time, e.g 1593511200000

Example: 1623319461670

endTime

integer · int64

End Time, e.g 1593512200000

Example: 1641782889000

limit

integer · int64 · max: 1000

Number of result sets returned

Example: 20

Default: 100

recvWindow

integer · int64

Recv Window.

Example: 5000

Query Option Order History (TRADE) › Responses

200

Option Order History

object

orderId

integer · int64

order Id

Example: 4611875134427365000

symbol

string

symbol

Example: BTC-200730-9000-C

price

string

price

Example: 100

quantity

string

quantity

Example: 1

executedQty

string

executed Qty

Example: 0

side

string

side

Example: BUY

type

string

type

Example: LIMIT

timeInForce

string

time In Force

Example: GTC

reduceOnly

boolean

reduce Only

Example: false

createTime

integer · int64

create Time

Example: 1592465880683

updateTime

integer · int64

update Time

Example: 1592465880683

status

string

status

Example: ACCEPTED

avgPrice

string

avg Price

Example: 0

clientOrderId

string

client Order Id

Example:

priceScale

integer · int64

price Scale

Example: 2

quantityScale

integer · int64

quantity Scale

Example: 2

optionSide

string

option Side

Example: CALL

quoteAsset

string

quote Asset

Example: USDT

mmp

boolean

mmp

Example: false

TradFi Options Contract (USER_DATA)

Sign TradFi Options agreement contract

POST

/eapi/v1/stock/contract

https://eapi.binance.com

TradFi Options Contract (USER_DATA) › Authorization

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

TradFi Options Contract (USER_DATA) › Request Weight

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

Learn more in the Rate limits section.

IP Weight50

TradFi Options Contract (USER_DATA) › Headers

X-MBX-APIKEY

string · required

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

Example: API_KEY

TradFi Options Contract (USER_DATA) › 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

Example: 5000

TradFi Options Contract (USER_DATA) › Responses

200

TradFi Options Contract

code

integer · int64

Example: 200

msg

string

Example: success

User Commission (USER_DATA)

Get account commission.

GET

/eapi/v1/commission

https://eapi.binance.com

User Commission (USER_DATA) › Authorization

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

User Commission (USER_DATA) › Request Weight

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

Learn more in the Rate limits section.

IP Weight5

User Commission (USER_DATA) › Headers

X-MBX-APIKEY

string · required

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

Example: API_KEY

User Commission (USER_DATA) › Query Parameters

timestamp

integer · int64 · required

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

Example: 1770736694138

recvWindow

integer · int64

Recv Window.

Example: 5000

User Commission (USER_DATA) › Responses

200

User Commission

object[]

commissions

underlying

string

underlying

Example: BTCUSDT

makerFee

string

maker Fee

Example: 0.000240

takerFee

string

taker Fee

Example: 0.000240

User Exercise Record (USER_DATA)

Get account exercise records.

GET

/eapi/v1/exerciseRecord

https://eapi.binance.com

User Exercise Record (USER_DATA) › Authorization

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

User Exercise Record (USER_DATA) › Request Weight

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

Learn more in the Rate limits section.

IP Weight5

User Exercise Record (USER_DATA) › Headers

X-MBX-APIKEY

string · required

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

Example: API_KEY

User Exercise Record (USER_DATA) › Query Parameters

timestamp

integer · int64 · required

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

Example: 1770736694138

symbol

string

Option trading pair.

Example: BTC-200730-9000-C

startTime

integer · int64

Start Time, e.g 1593511200000

Example: 1623319461670

endTime

integer · int64

End Time, e.g 1593512200000

Example: 1641782889000

limit

integer · int64 · max: 1000

Number of result sets returned.

Example: 20

Default: 1000

recvWindow

integer · int64

Recv Window.

Example: 5000

User Exercise Record (USER_DATA) › Responses

200

User Exercise Record

object

id

string

Example: 1125899906842624042

currency

string

currency

Example: USDT

symbol

string

symbol

Example: BTC-220721-25000-C

exercisePrice

string

exercise Price

Example: 25000.00000000

quantity

string

quantity

Example: 1.00000000

amount

string

amount

Example: 0.00000000

fee

string

fee

Example: 0.00000000

createDate

integer · int64

create Date

Example: 1658361600000

priceScale

integer · int64

price Scale

Example: 2

quantityScale

integer · int64

quantity Scale

Example: 2

optionSide

string

option Side

Example: CALL

positionSide

string

position Side

Example: LONG

quoteAsset

string

quote Asset

Example: USDT