Market Maker Endpoints

Endpoint

Auto-Cancel All Open Orders (Kill-Switch) Heartbeat (TRADE)

This endpoint resets the time from which the countdown will begin to the time this messaged is received. It should be called repeatedly as heartbeats. Multiple heartbeats can be updated at once by specifying the underlying symbols as a list (ex. BTCUSDT,ETHUSDT) in the underlyings parameter.

POST

/eapi/v1/countdownCancelAllHeartBeat

https://eapi.binance.com

Auto-Cancel All Open Orders (Kill-Switch) Heartbeat (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

Auto-Cancel All Open Orders (Kill-Switch) Heartbeat (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 Weight10

Auto-Cancel All Open Orders (Kill-Switch) Heartbeat (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

Auto-Cancel All Open Orders (Kill-Switch) Heartbeat (TRADE) › Request Body

underlyings

string · required

Example: BTCUSDT,ETHUSDT

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

Auto-Cancel All Open Orders (Kill-Switch) Heartbeat (TRADE) › Responses

200

Auto-Cancel All Open Orders

underlyings

string[]

underlyings

Get Auto-Cancel All Open Orders (Kill-Switch) Config (TRADE)

This endpoint returns the auto-cancel parameters for each underlying symbol. Note only active auto-cancel parameters will be returned, if countdownTime is set to 0 (ie. countdownTime has been turned off), the underlying symbol and corresponding countdownTime parameter will not be returned in the response.

GET

/eapi/v1/countdownCancelAll

https://eapi.binance.com

Get Auto-Cancel All Open Orders (Kill-Switch) Config (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

Get Auto-Cancel All Open Orders (Kill-Switch) Config (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

Get Auto-Cancel All Open Orders (Kill-Switch) Config (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

Get Auto-Cancel All Open Orders (Kill-Switch) Config (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

underlying

string

Underlying asset.

Example: BTCUSDT

recvWindow

integer · int64

Recv Window.

Example: 5000

Get Auto-Cancel All Open Orders (Kill-Switch) Config (TRADE) › Responses

200

Get Auto-Cancel All Open Orders

underlying

string

underlying

Example: ETHUSDT

countdownTime

integer · int64

countdown Time

Example: 100000

Set Auto-Cancel All Open Orders (Kill-Switch) Config (TRADE)

This endpoint sets the parameters of the auto-cancel feature which cancels all open orders (both market maker protection and non market maker protection order types) of the underlying symbol at the end of the specified countdown time period if no heartbeat message is sent. After the countdown time period, all open orders will be cancelled and new orders will be rejected with error code -2010 until either a heartbeat message is sent or the auto-cancel feature is turned off by setting countdownTime to 0.

POST

/eapi/v1/countdownCancelAll

https://eapi.binance.com

Set Auto-Cancel All Open Orders (Kill-Switch) Config (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

Set Auto-Cancel All Open Orders (Kill-Switch) Config (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

Set Auto-Cancel All Open Orders (Kill-Switch) Config (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

Set Auto-Cancel All Open Orders (Kill-Switch) Config (TRADE) › Request Body

underlying

string · required

Example: BTCUSDT

countdownTime

integer · int64 · required

Countdown time in milliseconds (ex. 1,000 for 1 second). 0 to disable the timer. Negative values (ex. -10000) are not accepted. Minimum acceptable value is 5,000

Example: 5000

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

Set Auto-Cancel All Open Orders (Kill-Switch) Config (TRADE) › Responses

200

Set Auto-Cancel All Open Orders

underlying

string

underlying

Example: ETHUSDT

countdownTime

integer · int64

countdown Time

Example: 100000

Get Market Maker Protection Config (TRADE)

Get config for MMP.

GET

/eapi/v1/mmp

https://eapi.binance.com

Get Market Maker Protection Config (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

Get Market Maker Protection Config (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

Get Market Maker Protection Config (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

Get Market Maker Protection Config (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

Get Market Maker Protection Config (TRADE) › Responses

200

Get Market Maker Protection Config

underlyingId

integer · int64

underlying Id

Example: 2

underlying

string

underlying

Example: BTCUSDT

windowTimeInMilliseconds

integer · int64

window Time In Milliseconds

Example: 3000

frozenTimeInMilliseconds

integer · int64

frozen Time In Milliseconds

Example: 300000

qtyLimit

string

qty Limit

Example: 2

deltaLimit

string

delta Limit

Example: 2.3

lastTriggerTime

integer · int64

last Trigger Time

Example: 0

Reset Market Maker Protection Config (TRADE)

Reset MMP, start MMP order again.

POST

/eapi/v1/mmpReset

https://eapi.binance.com

Reset Market Maker Protection Config (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

Reset Market Maker Protection Config (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

Reset Market Maker Protection Config (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

Reset Market Maker Protection Config (TRADE) › Request Body

underlying

string · required

Example: BTCUSDT

timestamp

integer · int64 · required

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

Example: 1770736694138

recvWindow

integer · int64

Example: 5000

Reset Market Maker Protection Config (TRADE) › Responses

200

Reset Market Maker Protection Config

underlyingId

integer · int64

underlying Id

Example: 2

underlying

string

underlying

Example: BTCUSDT

windowTimeInMilliseconds

integer · int64

window Time In Milliseconds

Example: 3000

frozenTimeInMilliseconds

integer · int64

frozen Time In Milliseconds

Example: 300000

qtyLimit

string

qty Limit

Example: 2

deltaLimit

string

delta Limit

Example: 2.3

lastTriggerTime

integer · int64

last Trigger Time

Example: 0

Set Market Maker Protection Config (TRADE)

Set config for MMP. Market Maker Protection(MMP) is a set of protection mechanism for option market maker, this mechanism is able to prevent mass trading in short period time. Once market maker's account branches the threshold, the Market Maker Protection will be triggered. When Market Maker Protection triggers, all the current MMP orders will be canceled, new MMP orders will be rejected. Market maker can use this time to reevaluate market and modify order price.

POST

/eapi/v1/mmpSet

https://eapi.binance.com

Set Market Maker Protection Config (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

Set Market Maker Protection Config (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

Set Market Maker Protection Config (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

Set Market Maker Protection Config (TRADE) › Request Body

underlying

string · required

Example: BTCUSDT

windowTimeInMilliseconds

integer · int64 · min: 0 · max: 5000 · required

MMP Interval in milliseconds

Example: 1000

frozenTimeInMilliseconds

integer · int64 · required

MMP frozen time in milliseconds, if set to 0 manual reset is required

Example: 1000

qtyLimit

number · float · required

quantity limit

Example: 1.0

deltaLimit

number · float · required

net delta limit

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

recvWindow

integer · int64

Example: 5000

Set Market Maker Protection Config (TRADE) › Responses

200

Set Market Maker Protection Config

underlyingId

integer · int64

underlying Id

Example: 2

underlying

string

underlying

Example: BTCUSDT

windowTimeInMilliseconds

integer · int64

window Time In Milliseconds

Example: 3000

frozenTimeInMilliseconds

integer · int64

frozen Time In Milliseconds

Example: 300000

qtyLimit

string

qty Limit

Example: 2

deltaLimit

string

delta Limit

Example: 2.3

lastTriggerTime

integer · int64

last Trigger Time

Example: 0

POST/eapi/v1/mmpSet

curl --request POST \
  --url https://eapi.binance.com/eapi/v1/mmpSet \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --header 'X-MBX-APIKEY: <string>' \
  --data underlying=BTCUSDT \
  --data windowTimeInMilliseconds=1000 \
  --data frozenTimeInMilliseconds=1000 \
  --data qtyLimit=1.0 \
  --data deltaLimit=1.0 \
  --data timestamp=1770736694138

Example Request Body

{
  "underlying": "BTCUSDT",
  "windowTimeInMilliseconds": 1000,
  "frozenTimeInMilliseconds": 1000,
  "qtyLimit": "1.0",
  "deltaLimit": "1.0",
  "timestamp": 1770736694138
}

json

Example Responses

{
  "underlyingId": 2,
  "underlying": "BTCUSDT",
  "windowTimeInMilliseconds": 3000,
  "frozenTimeInMilliseconds": 300000,
  "qtyLimit": "2",
  "deltaLimit": "2.3",
  "lastTriggerTime": 0
}

json

application/json

Market Maker Endpoints

Endpoint

Download schema

Auto-Cancel All Open Orders (Kill-Switch) Heartbeat (TRADE)

POST

/eapi/v1/countdownCancelAllHeartBeat

https://eapi.binance.com

Auto-Cancel All Open Orders (Kill-Switch) Heartbeat (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

Auto-Cancel All Open Orders (Kill-Switch) Heartbeat (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 Weight10

Auto-Cancel All Open Orders (Kill-Switch) Heartbeat (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

Auto-Cancel All Open Orders (Kill-Switch) Heartbeat (TRADE) › Request Body

underlyings

string · required

Example: BTCUSDT,ETHUSDT

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

Auto-Cancel All Open Orders (Kill-Switch) Heartbeat (TRADE) › Responses

200

Auto-Cancel All Open Orders

underlyings

string[]

underlyings

Get Auto-Cancel All Open Orders (Kill-Switch) Config (TRADE)

GET

/eapi/v1/countdownCancelAll

https://eapi.binance.com

Get Auto-Cancel All Open Orders (Kill-Switch) Config (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

Get Auto-Cancel All Open Orders (Kill-Switch) Config (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

Get Auto-Cancel All Open Orders (Kill-Switch) Config (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

Get Auto-Cancel All Open Orders (Kill-Switch) Config (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

underlying

string

Underlying asset.

Example: BTCUSDT

recvWindow

integer · int64

Recv Window.

Example: 5000

Get Auto-Cancel All Open Orders (Kill-Switch) Config (TRADE) › Responses

200

Get Auto-Cancel All Open Orders

underlying

string

underlying

Example: ETHUSDT

countdownTime

integer · int64

countdown Time

Example: 100000

Set Auto-Cancel All Open Orders (Kill-Switch) Config (TRADE)

POST

/eapi/v1/countdownCancelAll

https://eapi.binance.com

Set Auto-Cancel All Open Orders (Kill-Switch) Config (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

Set Auto-Cancel All Open Orders (Kill-Switch) Config (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

Set Auto-Cancel All Open Orders (Kill-Switch) Config (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

Set Auto-Cancel All Open Orders (Kill-Switch) Config (TRADE) › Request Body

underlying

string · required

Example: BTCUSDT

countdownTime

integer · int64 · required

Countdown time in milliseconds (ex. 1,000 for 1 second). 0 to disable the timer. Negative values (ex. -10000) are not accepted. Minimum acceptable value is 5,000

Example: 5000

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

Set Auto-Cancel All Open Orders (Kill-Switch) Config (TRADE) › Responses

200

Set Auto-Cancel All Open Orders

underlying

string

underlying

Example: ETHUSDT

countdownTime

integer · int64

countdown Time

Example: 100000

Get Market Maker Protection Config (TRADE)

Get config for MMP.

GET

/eapi/v1/mmp

https://eapi.binance.com

Get Market Maker Protection Config (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

Get Market Maker Protection Config (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

Get Market Maker Protection Config (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

Get Market Maker Protection Config (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

Get Market Maker Protection Config (TRADE) › Responses

200

Get Market Maker Protection Config

underlyingId

integer · int64

underlying Id

Example: 2

underlying

string

underlying

Example: BTCUSDT

windowTimeInMilliseconds

integer · int64

window Time In Milliseconds

Example: 3000

frozenTimeInMilliseconds

integer · int64

frozen Time In Milliseconds

Example: 300000

qtyLimit

string

qty Limit

Example: 2

deltaLimit

string

delta Limit

Example: 2.3

lastTriggerTime

integer · int64

last Trigger Time

Example: 0

Reset Market Maker Protection Config (TRADE)

Reset MMP, start MMP order again.

POST

/eapi/v1/mmpReset

https://eapi.binance.com

Reset Market Maker Protection Config (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

Reset Market Maker Protection Config (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

Reset Market Maker Protection Config (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

Reset Market Maker Protection Config (TRADE) › Request Body

underlying

string · required

Example: BTCUSDT

timestamp

integer · int64 · required

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

Example: 1770736694138

recvWindow

integer · int64

Example: 5000

Reset Market Maker Protection Config (TRADE) › Responses

200

Reset Market Maker Protection Config

underlyingId

integer · int64

underlying Id

Example: 2

underlying

string

underlying

Example: BTCUSDT

windowTimeInMilliseconds

integer · int64

window Time In Milliseconds

Example: 3000

frozenTimeInMilliseconds

integer · int64

frozen Time In Milliseconds

Example: 300000

qtyLimit

string

qty Limit

Example: 2

deltaLimit

string

delta Limit

Example: 2.3

lastTriggerTime

integer · int64

last Trigger Time

Example: 0

Set Market Maker Protection Config (TRADE)

POST

/eapi/v1/mmpSet

https://eapi.binance.com

Set Market Maker Protection Config (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

Set Market Maker Protection Config (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

Set Market Maker Protection Config (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

Set Market Maker Protection Config (TRADE) › Request Body

underlying

string · required

Example: BTCUSDT

windowTimeInMilliseconds

integer · int64 · min: 0 · max: 5000 · required

MMP Interval in milliseconds

Example: 1000

frozenTimeInMilliseconds

integer · int64 · required

MMP frozen time in milliseconds, if set to 0 manual reset is required

Example: 1000

qtyLimit

number · float · required

quantity limit

Example: 1.0

deltaLimit

number · float · required

net delta limit

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

recvWindow

integer · int64

Example: 5000

Set Market Maker Protection Config (TRADE) › Responses

200

Set Market Maker Protection Config

underlyingId

integer · int64

underlying Id

Example: 2

underlying

string

underlying

Example: BTCUSDT

windowTimeInMilliseconds

integer · int64

window Time In Milliseconds

Example: 3000

frozenTimeInMilliseconds

integer · int64

frozen Time In Milliseconds

Example: 300000

qtyLimit

string

qty Limit

Example: 2

deltaLimit

string

delta Limit

Example: 2.3

lastTriggerTime

integer · int64

last Trigger Time

Example: 0

POST/eapi/v1/mmpSet

curl --request POST \
  --url https://eapi.binance.com/eapi/v1/mmpSet \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --header 'X-MBX-APIKEY: <string>' \
  --data underlying=BTCUSDT \
  --data windowTimeInMilliseconds=1000 \
  --data frozenTimeInMilliseconds=1000 \
  --data qtyLimit=1.0 \
  --data deltaLimit=1.0 \
  --data timestamp=1770736694138

Example Request Body

{
  "underlying": "BTCUSDT",
  "windowTimeInMilliseconds": 1000,
  "frozenTimeInMilliseconds": 1000,
  "qtyLimit": "1.0",
  "deltaLimit": "1.0",
  "timestamp": 1770736694138
}

json

Example Responses

{
  "underlyingId": 2,
  "underlying": "BTCUSDT",
  "windowTimeInMilliseconds": 3000,
  "frozenTimeInMilliseconds": 300000,
  "qtyLimit": "2",
  "deltaLimit": "2.3",
  "lastTriggerTime": 0
}

json

application/json