API Management

Endpoint

Add IP Restriction for Sub-Account API key (For Master Account)

Add IP Restriction for Sub-Account API key

POST

/sapi/v2/sub-account/subAccountApi/ipRestriction

https://api.binance.com

Add IP Restriction for Sub-Account API key (For Master Account) › 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

Add IP Restriction for Sub-Account API key (For Master Account) › Request Weight

This endpoint consumes account (UID)-based request weight. Heavier endpoints consume more of your account rate limit capacity.

Learn more in the Rate limits section.

Account Weight3000

Add IP Restriction for Sub-Account API key (For Master Account) › 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

Add IP Restriction for Sub-Account API key (For Master Account) › Request Body

email

string · required

Example: 123@test.com

subAccountApiKey

string · required

Example: k5V49ldtn4tszj6W3hystegdfvmGbqDzjmkCtpTvC0G74WhK7yd4rfCTo4lShf

status

integer · int64 · required

IP Restriction status. 1 = IP Unrestricted. 2 = Restrict access to trusted IPs only.

Example: 1

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

ipAddress

string

Insert static IP in batch, separated by commas.

Example: 69.210.67.14

recvWindow

integer · int64 · max: 60000

Example: 5000

Add IP Restriction for Sub-Account API key (For Master Account) › Responses

200

Add IP Restriction for Sub-Account API key

status

string

Example: 2

ipList

string[]

updateTime

integer · int64

Example: 1636371437000

apiKey

string

Example: k5V49ldtn4tszj6W3hystegdfvmGbqDzjmkCtpTvC0G74WhK7yd4rfCTo4lShf

POST/sapi/v2/sub-account/subAccountApi/ipRestriction

curl --request POST \
  --url https://api.binance.com/sapi/v2/sub-account/subAccountApi/ipRestriction \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --header 'X-MBX-APIKEY: <string>' \
  --data email=123@test.com \
  --data subAccountApiKey=k5V49ldtn4tszj6W3hystegdfvmGbqDzjmkCtpTvC0G74WhK7yd4rfCTo4lShf \
  --data status=1 \
  --data timestamp=1770736694138

Example Request Body

{
  "email": "123@test.com",
  "subAccountApiKey": "k5V49ldtn4tszj6W3hystegdfvmGbqDzjmkCtpTvC0G74WhK7yd4rfCTo4lShf",
  "status": 1,
  "timestamp": 1770736694138
}

json

Example Responses

{
  "status": "2",
  "ipList": [
    "69.210.67.14"
  ],
  "updateTime": 1636371437000,
  "apiKey": "k5V49ldtn4tszj6W3hystegdfvmGbqDzjmkCtpTvC0G74WhK7yd4rfCTo4lShf"
}

json

application/json

Delete IP List For a Sub-account API Key (For Master Account)

Delete IP List For a Sub-account API Key

DELETE

/sapi/v1/sub-account/subAccountApi/ipRestriction/ipList

https://api.binance.com

Delete IP List For a Sub-account API Key (For Master Account) › Authorization

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

Delete IP List For a Sub-account API Key (For Master Account) › Request Weight

This endpoint consumes account (UID)-based request weight. Heavier endpoints consume more of your account rate limit capacity.

Learn more in the Rate limits section.

Account Weight3000

Delete IP List For a Sub-account API Key (For Master Account) › Headers

X-MBX-APIKEY

string · required

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

Example: API_KEY

Delete IP List For a Sub-account API Key (For Master Account) › Query Parameters

email

string · required

Example: 123@test.com

subAccountApiKey

string · required

Example: k5V49ldtn4tszj6W3hystegdfvmGbqDzjmkCtpTvC0G74WhK7yd4rfCTo4lShf

ipAddress

string · required

IPs to be deleted. Can be added in batches, separated by commas

Example: 69.210.67.14

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

Delete IP List For a Sub-account API Key (For Master Account) › Responses

200

Delete IP List For a Sub-account API Key

ipRestrict

string

Example: true

ipList

string[]

updateTime

integer · int64

Example: 1636371437000

apiKey

string

Example: k5V49ldtn4tszj6W3hystegdfvmGbqDzjmkCtpTvC0G74WhK7yd4rfCTo4lShf

Get IP Restriction for a Sub-account API Key (For Master Account)

Get IP Restriction for a Sub-account API Key

GET

/sapi/v1/sub-account/subAccountApi/ipRestriction

https://api.binance.com

Get IP Restriction for a Sub-account API Key (For Master Account) › 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 IP Restriction for a Sub-account API Key (For Master Account) › Request Weight

This endpoint consumes account (UID)-based request weight. Heavier endpoints consume more of your account rate limit capacity.

Learn more in the Rate limits section.

Account Weight3000

Get IP Restriction for a Sub-account API Key (For Master Account) › 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 IP Restriction for a Sub-account API Key (For Master Account) › Query Parameters

email

string · required

Example: 123@test.com

subAccountApiKey

string · required

Example: k5V49ldtn4tszj6W3hystegdfvmGbqDzjmkCtpTvC0G74WhK7yd4rfCTo4lShf

timestamp

integer · int64 · required

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

Example: 1770736694138

recvWindow

integer · int64 · max: 60000

Example: 5000

Get IP Restriction for a Sub-account API Key (For Master Account) › Responses

200

Get IP Restriction for a Sub-account API Key

ipRestrict

string

Example: true

ipList

string[]

updateTime

integer · int64

Example: 1636371437000

apiKey

string

Example: k5V49ldtn4tszj6W3hystegdfvmGbqDzjmkCtpTvC0G74WhK7yd4rfCTo4lShf

API Management

Endpoint

Download schema

Add IP Restriction for Sub-Account API key (For Master Account)

Add IP Restriction for Sub-Account API key

POST

/sapi/v2/sub-account/subAccountApi/ipRestriction

https://api.binance.com

Add IP Restriction for Sub-Account API key (For Master Account) › 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

Add IP Restriction for Sub-Account API key (For Master Account) › Request Weight

This endpoint consumes account (UID)-based request weight. Heavier endpoints consume more of your account rate limit capacity.

Learn more in the Rate limits section.

Account Weight3000

Add IP Restriction for Sub-Account API key (For Master Account) › 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

Add IP Restriction for Sub-Account API key (For Master Account) › Request Body

email

string · required

Example: 123@test.com

subAccountApiKey

string · required

Example: k5V49ldtn4tszj6W3hystegdfvmGbqDzjmkCtpTvC0G74WhK7yd4rfCTo4lShf

status

integer · int64 · required

IP Restriction status. 1 = IP Unrestricted. 2 = Restrict access to trusted IPs only.

Example: 1

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

ipAddress

string

Insert static IP in batch, separated by commas.

Example: 69.210.67.14

recvWindow

integer · int64 · max: 60000

Example: 5000

Add IP Restriction for Sub-Account API key (For Master Account) › Responses

200

Add IP Restriction for Sub-Account API key

status

string

Example: 2

ipList

string[]

updateTime

integer · int64

Example: 1636371437000

apiKey

string

Example: k5V49ldtn4tszj6W3hystegdfvmGbqDzjmkCtpTvC0G74WhK7yd4rfCTo4lShf

POST/sapi/v2/sub-account/subAccountApi/ipRestriction

curl --request POST \
  --url https://api.binance.com/sapi/v2/sub-account/subAccountApi/ipRestriction \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --header 'X-MBX-APIKEY: <string>' \
  --data email=123@test.com \
  --data subAccountApiKey=k5V49ldtn4tszj6W3hystegdfvmGbqDzjmkCtpTvC0G74WhK7yd4rfCTo4lShf \
  --data status=1 \
  --data timestamp=1770736694138

Example Request Body

{
  "email": "123@test.com",
  "subAccountApiKey": "k5V49ldtn4tszj6W3hystegdfvmGbqDzjmkCtpTvC0G74WhK7yd4rfCTo4lShf",
  "status": 1,
  "timestamp": 1770736694138
}

json

Example Responses

{
  "status": "2",
  "ipList": [
    "69.210.67.14"
  ],
  "updateTime": 1636371437000,
  "apiKey": "k5V49ldtn4tszj6W3hystegdfvmGbqDzjmkCtpTvC0G74WhK7yd4rfCTo4lShf"
}

json

application/json

Delete IP List For a Sub-account API Key (For Master Account)

Delete IP List For a Sub-account API Key

DELETE

/sapi/v1/sub-account/subAccountApi/ipRestriction/ipList

https://api.binance.com

Delete IP List For a Sub-account API Key (For Master Account) › Authorization

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

Delete IP List For a Sub-account API Key (For Master Account) › Request Weight

This endpoint consumes account (UID)-based request weight. Heavier endpoints consume more of your account rate limit capacity.

Learn more in the Rate limits section.

Account Weight3000

Delete IP List For a Sub-account API Key (For Master Account) › Headers

X-MBX-APIKEY

string · required

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

Example: API_KEY

Delete IP List For a Sub-account API Key (For Master Account) › Query Parameters

email

string · required

Example: 123@test.com

subAccountApiKey

string · required

Example: k5V49ldtn4tszj6W3hystegdfvmGbqDzjmkCtpTvC0G74WhK7yd4rfCTo4lShf

ipAddress

string · required

IPs to be deleted. Can be added in batches, separated by commas

Example: 69.210.67.14

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

Delete IP List For a Sub-account API Key (For Master Account) › Responses

200

Delete IP List For a Sub-account API Key

ipRestrict

string

Example: true

ipList

string[]

updateTime

integer · int64

Example: 1636371437000

apiKey

string

Example: k5V49ldtn4tszj6W3hystegdfvmGbqDzjmkCtpTvC0G74WhK7yd4rfCTo4lShf

Get IP Restriction for a Sub-account API Key (For Master Account)

Get IP Restriction for a Sub-account API Key

GET

/sapi/v1/sub-account/subAccountApi/ipRestriction

https://api.binance.com

Get IP Restriction for a Sub-account API Key (For Master Account) › 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 IP Restriction for a Sub-account API Key (For Master Account) › Request Weight

This endpoint consumes account (UID)-based request weight. Heavier endpoints consume more of your account rate limit capacity.

Learn more in the Rate limits section.

Account Weight3000

Get IP Restriction for a Sub-account API Key (For Master Account) › 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 IP Restriction for a Sub-account API Key (For Master Account) › Query Parameters

email

string · required

Example: 123@test.com

subAccountApiKey

string · required

Example: k5V49ldtn4tszj6W3hystegdfvmGbqDzjmkCtpTvC0G74WhK7yd4rfCTo4lShf

timestamp

integer · int64 · required

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

Example: 1770736694138

recvWindow

integer · int64 · max: 60000

Example: 5000

Get IP Restriction for a Sub-account API Key (For Master Account) › Responses

200

Get IP Restriction for a Sub-account API Key

ipRestrict

string

Example: true

ipList

string[]

updateTime

integer · int64

Example: 1636371437000

apiKey

string

Example: k5V49ldtn4tszj6W3hystegdfvmGbqDzjmkCtpTvC0G74WhK7yd4rfCTo4lShf