Market Maker Block Trade

Endpoint

Query Block Trade Details (USER_DATA)

Query block trade details; returns block trade details from counterparty's perspective.

GET

/eapi/v1/block/order/execute

https://eapi.binance.com

Query Block Trade Details (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 Block Trade Details (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

Query Block Trade Details (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 Block Trade Details (USER_DATA) › Query Parameters

blockOrderMatchingKey

string · required

Block trade matching key.

Example: 12b96c28-ba05-8906-c89t-703215cfb2e6

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

Recv Window.

Example: 5000

Query Block Trade Details (USER_DATA) › Responses

200

Block Trade Details

blockTradeSettlementKey

string

block Trade Settlement Key

Example: 12b96c28-ba05-8906-c89t-703215cfb2e6

expireTime

integer · int64

expire Time

Example: 1730171860460

liquidity

string

liquidity

Example: MAKER

status

string

status

Example: RECEIVED

createTime

integer · int64

create Time

Example: 1730170060462

object[]

legs

symbol

string

symbol

Example: BNB-241101-700-C

side

string

side

Example: SELL

quantity

string

quantity

Example: 1.66

price

string

price

Example: 20

Accept Block Trade Order (TRADE)

Accept a block trade order

POST

/eapi/v1/block/order/execute

https://eapi.binance.com

Accept Block Trade 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

Accept Block Trade 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 Weight5

Accept Block Trade 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

Accept Block Trade Order (TRADE) › Request Body

blockOrderMatchingKey

string · required

Example: 7d046e6e-a429-4335-ab9d-6a681febcde5

timestamp

integer · int64 · required

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

Example: 1770736694138

recvWindow

integer · int64 · max: 60000

Example: 5000

Accept Block Trade Order (TRADE) › Responses

200

Accept Block Trade Order

blockTradeSettlementKey

string

block Trade Settlement Key

Example: 7d046e6e-a429-4335-ab9d-6a681febcde5

expireTime

integer · int64

expire Time

Example: 1730172115801

liquidity

string

liquidity

Example: MAKER

status

string

status

Example: ACCEPTED

createTime

integer · int64

create Time

Example: 1730170315803

object[]

legs

symbol

string

symbol

Example: BNB-241101-700-C

side

string

side

Example: SELL

quantity

string

quantity

Example: 1.2

price

string

price

Example: 2.8

POST/eapi/v1/block/order/execute

curl --request POST \
  --url https://eapi.binance.com/eapi/v1/block/order/execute \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --header 'X-MBX-APIKEY: <string>' \
  --data blockOrderMatchingKey=7d046e6e-a429-4335-ab9d-6a681febcde5 \
  --data timestamp=1770736694138

Example Request Body

{
  "blockOrderMatchingKey": "7d046e6e-a429-4335-ab9d-6a681febcde5",
  "timestamp": 1770736694138
}

json

Example Responses

{
  "blockTradeSettlementKey": "7d046e6e-a429-4335-ab9d-6a681febcde5",
  "expireTime": 1730172115801,
  "liquidity": "MAKER",
  "status": "ACCEPTED",
  "createTime": 1730170315803,
  "legs": [
    {
      "symbol": "BNB-241101-700-C",
      "side": "SELL",
      "quantity": "1.2",
      "price": "2.8"
    }
  ]
}

json

application/json

Account Block Trade List (USER_DATA)

Gets block trades for a specific account.

GET

/eapi/v1/block/user-trades

https://eapi.binance.com

Account Block 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 Block 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 Block 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 Block Trade List (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

endTime

integer · int64

End Time, e.g 1593512200000

Example: 1641782889000

startTime

integer · int64

Start Time, e.g 1593511200000

Example: 1623319461670

underlying

string

Underlying asset.

Example: BTCUSDT

recvWindow

integer · int64 · max: 60000

Recv Window.

Example: 5000

Account Block Trade List (USER_DATA) › Responses

200

Account Block Trade List

object

parentOrderId

string

parent Order Id

Example: 4675011431944499201

crossType

string

cross Type

Example: USER_BLOCK

object[]

legs

createTime

integer · int64

create Time

Example: 1730170445600

updateTime

integer · int64

update Time

Example: 1730170445600

symbol

string

symbol

Example: BNB-241101-700-C

orderId

string

order Id

Example: 4675011431944499203

orderPrice

number · float

order Price

Example: 2.8

orderQuantity

number · float

order Quantity

Example: 1.2

orderStatus

string

order Status

Example: FILLED

executedQty

number · float

executed Qty

Example: 1.2

executedAmount

number · float

executed Amount

Example: 3.36

fee

number · float

fee

Example: 0.336

orderType

string

order Type

Example: PREV_QUOTED

orderSide

string

order Side

Example: BUY

id

string

Example: 1125899906900937837

tradeId

integer · int64

trade Id

Example: 1

tradePrice

number · float

trade Price

Example: 2.8

tradeQty

number · float

trade Qty

Example: 1.2

tradeTime

integer · int64

trade Time

Example: 1730170445600

liquidity

string

liquidity

Example: TAKER

commission

number · float

commission

Example: 0.336

blockTradeSettlementKey

string

block Trade Settlement Key

Example: 7d085e6e-a229-2335-ab9d-6a581febcd25

GET/eapi/v1/block/user-trades

curl --request GET \
  --url 'https://eapi.binance.com/eapi/v1/block/user-trades?timestamp=%3Cnumber%3E' \
  --header 'X-MBX-APIKEY: <string>'

Example Responses

[
  {
    "parentOrderId": "4675011431944499201",
    "crossType": "USER_BLOCK",
    "legs": [
      {
        "createTime": 1730170445600,
        "updateTime": 1730170445600,
        "symbol": "BNB-241101-700-C",
        "orderId": "4675011431944499203",
        "orderPrice": 2.8,
        "orderQuantity": 1.2,
        "orderStatus": "FILLED",
        "executedQty": 1.2,
        "executedAmount": 3.36,
        "fee": 0.336,
        "orderType": "PREV_QUOTED",
        "orderSide": "BUY",
        "id": "1125899906900937837",
        "tradeId": 1,
        "tradePrice": 2.8,
        "tradeQty": 1.2,
        "tradeTime": 1730170445600,
        "liquidity": "TAKER",
        "commission": 0.336
      }
    ],
    "blockTradeSettlementKey": "7d085e6e-a229-2335-ab9d-6a581febcd25"
  }
]

json

application/json

Extend Block Trade Order (TRADE)

Extends a block trade expire time by 30 mins from the current time.

PUT

/eapi/v1/block/order/create

https://eapi.binance.com

Extend Block Trade 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

Extend Block Trade 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 Weight5

Extend Block Trade 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

Extend Block Trade Order (TRADE) › Request Body

blockOrderMatchingKey

string · required

Example: 3668822b8-1baa-6a2f-adb8-d3de6289b361

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

Extend Block Trade Order (TRADE) › Responses

200

Extend Block Trade Order

blockTradeSettlementKey

string

block Trade Settlement Key

Example: 3668822b8-1baa-6a2f-adb8-d3de6289b361

expireTime

integer · int64

expire Time

Example: 1730172007000

liquidity

string

liquidity

Example: TAKER

status

string

status

Example: RECEIVED

createTime

integer · int64

create Time

Example: 1730170088111

object[]

legs

symbol

string

symbol

Example: BNB-241101-700-C

side

string

side

Example: BUY

quantity

string

quantity

Example: 1.2

price

string

price

Example: 2.8

PUT/eapi/v1/block/order/create

curl --request PUT \
  --url https://eapi.binance.com/eapi/v1/block/order/create \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --header 'X-MBX-APIKEY: <string>' \
  --data blockOrderMatchingKey=3668822b8-1baa-6a2f-adb8-d3de6289b361 \
  --data timestamp=1770736694138

Example Request Body

{
  "blockOrderMatchingKey": "3668822b8-1baa-6a2f-adb8-d3de6289b361",
  "timestamp": 1770736694138
}

json

Example Responses

{
  "blockTradeSettlementKey": "3668822b8-1baa-6a2f-adb8-d3de6289b361",
  "expireTime": 1730172007000,
  "liquidity": "TAKER",
  "status": "RECEIVED",
  "createTime": 1730170088111,
  "legs": [
    {
      "symbol": "BNB-241101-700-C",
      "side": "BUY",
      "quantity": "1.2",
      "price": "2.8"
    }
  ]
}

json

application/json

New Block Trade Order (TRADE)

Send in a new block trade order.

POST

/eapi/v1/block/order/create

https://eapi.binance.com

New Block Trade 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 Block Trade 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 Weight5

New Block Trade 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 Block Trade Order (TRADE) › Request Body

liquidity

string · enum · required

Enum values:

MAKER

TAKER

Example: TAKER

object[] · required

Max 1 (only single leg supported), list of legs parameters in JSON; example: eapi/v1/block/order/create?orders=[{"symbol":"BTC-210115-35000-C", "price":"100","quantity":"0.0002","side":"BUY","type":"LIMIT"}]

symbol

string · required

Option trading pair

Example: BTC-210115-35000-C

side

string · enum · required

Buy/sell direction

Enum values:

BUY

SELL

Example: BUY

type

string · enum · required

Order type

Enum values:

LIMIT

Example: LIMIT

quantity

string · required

Order quantity

Example: 0.0002

price

string

Order price

Example: 100

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

New Block Trade Order (TRADE) › Responses

200

New Block Trade Order

blockTradeSettlementKey

string

block Trade Settlement Key

Example: 3668822b8-1baa-6a2f-adb8-d3de6289b361

expireTime

integer · int64

expire Time

Example: 1730171888109

liquidity

string

liquidity

Example: TAKER

status

string

status

Example: RECEIVED

object[]

legs

symbol

string

symbol

Example: BNB-241101-700-C

side

string

side

Example: BUY

quantity

string

quantity

Example: 1.2

price

string

price

Example: 2.8

POST/eapi/v1/block/order/create

curl --request POST \
  --url https://eapi.binance.com/eapi/v1/block/order/create \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --header 'X-MBX-APIKEY: <string>' \
  --data liquidity=TAKER \
  --data 'legs={"symbol":"BTC-210115-35000-C","side":"BUY","type":"LIMIT","quantity":"0.0002"}' \
  --data timestamp=1770736694138

Example Request Body

{
  "liquidity": "TAKER",
  "legs": [
    {
      "symbol": "BTC-210115-35000-C",
      "side": "BUY",
      "type": "LIMIT",
      "quantity": "0.0002"
    }
  ],
  "timestamp": 1770736694138
}

json

Example Responses

{
  "blockTradeSettlementKey": "3668822b8-1baa-6a2f-adb8-d3de6289b361",
  "expireTime": 1730171888109,
  "liquidity": "TAKER",
  "status": "RECEIVED",
  "legs": [
    {
      "symbol": "BNB-241101-700-C",
      "side": "BUY",
      "quantity": "1.2",
      "price": "2.8"
    }
  ]
}

json

application/json

Cancel Block Trade Order (TRADE)

Cancel a block trade order.

DELETE

/eapi/v1/block/order/create

https://eapi.binance.com

Cancel Block Trade 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 Block Trade 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 Weight5

Cancel Block Trade 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 Block Trade Order (TRADE) › Query Parameters

blockOrderMatchingKey

string · required

Block trade matching key.

Example: 7d046e6e-a429-4335-ab9d-6a681febcde5

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

Recv Window.

Example: 5000

Cancel Block Trade Order (TRADE) › Responses

200

No data returned

Query Block Trade Order (TRADE)

Check block trade order status.

GET

/eapi/v1/block/order/orders

https://eapi.binance.com

Query Block Trade 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 Block Trade 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 Weight5

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

blockOrderMatchingKey

string

If specified, returns the specific block trade associated with the blockOrderMatchingKey

Example: 7d046e6e-a429-4335-ab9d-6a681febcde5

endTime

integer · int64

End Time, e.g 1593512200000

Example: 1641782889000

startTime

integer · int64

Start Time, e.g 1593511200000

Example: 1623319461670

underlying

string

Underlying asset.

Example: BTCUSDT

recvWindow

integer · int64 · max: 60000

Recv Window.

Example: 5000

Query Block Trade Order (TRADE) › Responses

200

Block Trade Order

object

blockTradeSettlementKey

string

block Trade Settlement Key

Example: 7d046e6e-a429-4335-ab9d-6a681febcde5

expireTime

integer · int64

expire Time

Example: 1730172115801

liquidity

string

liquidity

Example: TAKER

status

string

status

Example: RECEIVED

createTime

integer · int64

create Time

Example: 1730170315803

object[]

legs

symbol

string

symbol

Example: BNB-241101-700-C

side

string

side

Example: BUY

quantity

string

quantity

Example: 1.2

price

string

price

Example: 2.8

Market Maker Block Trade

Endpoint

Download schema

Query Block Trade Details (USER_DATA)

Query block trade details; returns block trade details from counterparty's perspective.

GET

/eapi/v1/block/order/execute

https://eapi.binance.com

Query Block Trade Details (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 Block Trade Details (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

Query Block Trade Details (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 Block Trade Details (USER_DATA) › Query Parameters

blockOrderMatchingKey

string · required

Block trade matching key.

Example: 12b96c28-ba05-8906-c89t-703215cfb2e6

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

Recv Window.

Example: 5000

Query Block Trade Details (USER_DATA) › Responses

200

Block Trade Details

blockTradeSettlementKey

string

block Trade Settlement Key

Example: 12b96c28-ba05-8906-c89t-703215cfb2e6

expireTime

integer · int64

expire Time

Example: 1730171860460

liquidity

string

liquidity

Example: MAKER

status

string

status

Example: RECEIVED

createTime

integer · int64

create Time

Example: 1730170060462

object[]

legs

symbol

string

symbol

Example: BNB-241101-700-C

side

string

side

Example: SELL

quantity

string

quantity

Example: 1.66

price

string

price

Example: 20

Accept Block Trade Order (TRADE)

Accept a block trade order

POST

/eapi/v1/block/order/execute

https://eapi.binance.com

Accept Block Trade 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

Accept Block Trade 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 Weight5

Accept Block Trade 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

Accept Block Trade Order (TRADE) › Request Body

blockOrderMatchingKey

string · required

Example: 7d046e6e-a429-4335-ab9d-6a681febcde5

timestamp

integer · int64 · required

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

Example: 1770736694138

recvWindow

integer · int64 · max: 60000

Example: 5000

Accept Block Trade Order (TRADE) › Responses

200

Accept Block Trade Order

blockTradeSettlementKey

string

block Trade Settlement Key

Example: 7d046e6e-a429-4335-ab9d-6a681febcde5

expireTime

integer · int64

expire Time

Example: 1730172115801

liquidity

string

liquidity

Example: MAKER

status

string

status

Example: ACCEPTED

createTime

integer · int64

create Time

Example: 1730170315803

object[]

legs

symbol

string

symbol

Example: BNB-241101-700-C

side

string

side

Example: SELL

quantity

string

quantity

Example: 1.2

price

string

price

Example: 2.8

POST/eapi/v1/block/order/execute

curl --request POST \
  --url https://eapi.binance.com/eapi/v1/block/order/execute \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --header 'X-MBX-APIKEY: <string>' \
  --data blockOrderMatchingKey=7d046e6e-a429-4335-ab9d-6a681febcde5 \
  --data timestamp=1770736694138

Example Request Body

{
  "blockOrderMatchingKey": "7d046e6e-a429-4335-ab9d-6a681febcde5",
  "timestamp": 1770736694138
}

json

Example Responses

{
  "blockTradeSettlementKey": "7d046e6e-a429-4335-ab9d-6a681febcde5",
  "expireTime": 1730172115801,
  "liquidity": "MAKER",
  "status": "ACCEPTED",
  "createTime": 1730170315803,
  "legs": [
    {
      "symbol": "BNB-241101-700-C",
      "side": "SELL",
      "quantity": "1.2",
      "price": "2.8"
    }
  ]
}

json

application/json

Account Block Trade List (USER_DATA)

Gets block trades for a specific account.

GET

/eapi/v1/block/user-trades

https://eapi.binance.com

Account Block 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 Block 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 Block 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 Block Trade List (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

endTime

integer · int64

End Time, e.g 1593512200000

Example: 1641782889000

startTime

integer · int64

Start Time, e.g 1593511200000

Example: 1623319461670

underlying

string

Underlying asset.

Example: BTCUSDT

recvWindow

integer · int64 · max: 60000

Recv Window.

Example: 5000

Account Block Trade List (USER_DATA) › Responses

200

Account Block Trade List

object

parentOrderId

string

parent Order Id

Example: 4675011431944499201

crossType

string

cross Type

Example: USER_BLOCK

object[]

legs

createTime

integer · int64

create Time

Example: 1730170445600

updateTime

integer · int64

update Time

Example: 1730170445600

symbol

string

symbol

Example: BNB-241101-700-C

orderId

string

order Id

Example: 4675011431944499203

orderPrice

number · float

order Price

Example: 2.8

orderQuantity

number · float

order Quantity

Example: 1.2

orderStatus

string

order Status

Example: FILLED

executedQty

number · float

executed Qty

Example: 1.2

executedAmount

number · float

executed Amount

Example: 3.36

fee

number · float

fee

Example: 0.336

orderType

string

order Type

Example: PREV_QUOTED

orderSide

string

order Side

Example: BUY

id

string

Example: 1125899906900937837

tradeId

integer · int64

trade Id

Example: 1

tradePrice

number · float

trade Price

Example: 2.8

tradeQty

number · float

trade Qty

Example: 1.2

tradeTime

integer · int64

trade Time

Example: 1730170445600

liquidity

string

liquidity

Example: TAKER

commission

number · float

commission

Example: 0.336

blockTradeSettlementKey

string

block Trade Settlement Key

Example: 7d085e6e-a229-2335-ab9d-6a581febcd25

GET/eapi/v1/block/user-trades

curl --request GET \
  --url 'https://eapi.binance.com/eapi/v1/block/user-trades?timestamp=%3Cnumber%3E' \
  --header 'X-MBX-APIKEY: <string>'

Example Responses

[
  {
    "parentOrderId": "4675011431944499201",
    "crossType": "USER_BLOCK",
    "legs": [
      {
        "createTime": 1730170445600,
        "updateTime": 1730170445600,
        "symbol": "BNB-241101-700-C",
        "orderId": "4675011431944499203",
        "orderPrice": 2.8,
        "orderQuantity": 1.2,
        "orderStatus": "FILLED",
        "executedQty": 1.2,
        "executedAmount": 3.36,
        "fee": 0.336,
        "orderType": "PREV_QUOTED",
        "orderSide": "BUY",
        "id": "1125899906900937837",
        "tradeId": 1,
        "tradePrice": 2.8,
        "tradeQty": 1.2,
        "tradeTime": 1730170445600,
        "liquidity": "TAKER",
        "commission": 0.336
      }
    ],
    "blockTradeSettlementKey": "7d085e6e-a229-2335-ab9d-6a581febcd25"
  }
]

json

application/json

Extend Block Trade Order (TRADE)

Extends a block trade expire time by 30 mins from the current time.

PUT

/eapi/v1/block/order/create

https://eapi.binance.com

Extend Block Trade 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

Extend Block Trade 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 Weight5

Extend Block Trade 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

Extend Block Trade Order (TRADE) › Request Body

blockOrderMatchingKey

string · required

Example: 3668822b8-1baa-6a2f-adb8-d3de6289b361

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

Extend Block Trade Order (TRADE) › Responses

200

Extend Block Trade Order

blockTradeSettlementKey

string

block Trade Settlement Key

Example: 3668822b8-1baa-6a2f-adb8-d3de6289b361

expireTime

integer · int64

expire Time

Example: 1730172007000

liquidity

string

liquidity

Example: TAKER

status

string

status

Example: RECEIVED

createTime

integer · int64

create Time

Example: 1730170088111

object[]

legs

symbol

string

symbol

Example: BNB-241101-700-C

side

string

side

Example: BUY

quantity

string

quantity

Example: 1.2

price

string

price

Example: 2.8

PUT/eapi/v1/block/order/create

curl --request PUT \
  --url https://eapi.binance.com/eapi/v1/block/order/create \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --header 'X-MBX-APIKEY: <string>' \
  --data blockOrderMatchingKey=3668822b8-1baa-6a2f-adb8-d3de6289b361 \
  --data timestamp=1770736694138

Example Request Body

{
  "blockOrderMatchingKey": "3668822b8-1baa-6a2f-adb8-d3de6289b361",
  "timestamp": 1770736694138
}

json

Example Responses

{
  "blockTradeSettlementKey": "3668822b8-1baa-6a2f-adb8-d3de6289b361",
  "expireTime": 1730172007000,
  "liquidity": "TAKER",
  "status": "RECEIVED",
  "createTime": 1730170088111,
  "legs": [
    {
      "symbol": "BNB-241101-700-C",
      "side": "BUY",
      "quantity": "1.2",
      "price": "2.8"
    }
  ]
}

json

application/json

New Block Trade Order (TRADE)

Send in a new block trade order.

POST

/eapi/v1/block/order/create

https://eapi.binance.com

New Block Trade 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 Block Trade 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 Weight5

New Block Trade 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 Block Trade Order (TRADE) › Request Body

liquidity

string · enum · required

Enum values:

MAKER

TAKER

Example: TAKER

object[] · required

symbol

string · required

Option trading pair

Example: BTC-210115-35000-C

side

string · enum · required

Buy/sell direction

Enum values:

BUY

SELL

Example: BUY

type

string · enum · required

Order type

Enum values:

LIMIT

Example: LIMIT

quantity

string · required

Order quantity

Example: 0.0002

price

string

Order price

Example: 100

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

New Block Trade Order (TRADE) › Responses

200

New Block Trade Order

blockTradeSettlementKey

string

block Trade Settlement Key

Example: 3668822b8-1baa-6a2f-adb8-d3de6289b361

expireTime

integer · int64

expire Time

Example: 1730171888109

liquidity

string

liquidity

Example: TAKER

status

string

status

Example: RECEIVED

object[]

legs

symbol

string

symbol

Example: BNB-241101-700-C

side

string

side

Example: BUY

quantity

string

quantity

Example: 1.2

price

string

price

Example: 2.8

POST/eapi/v1/block/order/create

curl --request POST \
  --url https://eapi.binance.com/eapi/v1/block/order/create \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --header 'X-MBX-APIKEY: <string>' \
  --data liquidity=TAKER \
  --data 'legs={"symbol":"BTC-210115-35000-C","side":"BUY","type":"LIMIT","quantity":"0.0002"}' \
  --data timestamp=1770736694138

Example Request Body

{
  "liquidity": "TAKER",
  "legs": [
    {
      "symbol": "BTC-210115-35000-C",
      "side": "BUY",
      "type": "LIMIT",
      "quantity": "0.0002"
    }
  ],
  "timestamp": 1770736694138
}

json

Example Responses

{
  "blockTradeSettlementKey": "3668822b8-1baa-6a2f-adb8-d3de6289b361",
  "expireTime": 1730171888109,
  "liquidity": "TAKER",
  "status": "RECEIVED",
  "legs": [
    {
      "symbol": "BNB-241101-700-C",
      "side": "BUY",
      "quantity": "1.2",
      "price": "2.8"
    }
  ]
}

json

application/json

Cancel Block Trade Order (TRADE)

Cancel a block trade order.

DELETE

/eapi/v1/block/order/create

https://eapi.binance.com

Cancel Block Trade 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 Block Trade 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 Weight5

Cancel Block Trade 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 Block Trade Order (TRADE) › Query Parameters

blockOrderMatchingKey

string · required

Block trade matching key.

Example: 7d046e6e-a429-4335-ab9d-6a681febcde5

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

Recv Window.

Example: 5000

Cancel Block Trade Order (TRADE) › Responses

200

No data returned

Query Block Trade Order (TRADE)

Check block trade order status.

GET

/eapi/v1/block/order/orders

https://eapi.binance.com

Query Block Trade 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 Block Trade 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 Weight5

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

blockOrderMatchingKey

string

If specified, returns the specific block trade associated with the blockOrderMatchingKey

Example: 7d046e6e-a429-4335-ab9d-6a681febcde5

endTime

integer · int64

End Time, e.g 1593512200000

Example: 1641782889000

startTime

integer · int64

Start Time, e.g 1593511200000

Example: 1623319461670

underlying

string

Underlying asset.

Example: BTCUSDT

recvWindow

integer · int64 · max: 60000

Recv Window.

Example: 5000

Query Block Trade Order (TRADE) › Responses

200

Block Trade Order

object

blockTradeSettlementKey

string

block Trade Settlement Key

Example: 7d046e6e-a429-4335-ab9d-6a681febcde5

expireTime

integer · int64

expire Time

Example: 1730172115801

liquidity

string

liquidity

Example: TAKER

status

string

status

Example: RECEIVED

createTime

integer · int64

create Time

Example: 1730170315803

object[]

legs

symbol

string

symbol

Example: BNB-241101-700-C

side

string

side

Example: BUY

quantity

string

quantity

Example: 1.2

price

string

price

Example: 2.8