Asset

Endpointhttps://api.binance.com

Futures Transfer for Link Sub Account (For Master Account) (USER_DATA)

Futures Transfer for Link Sub Account

POST

/sapi/v1/broker/futures/accountTransfer

https://api.binance.com

Futures Transfer for Link Sub Account (For Master Account) (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

Futures Transfer for Link Sub Account (For Master Account) (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 Weight1

Futures Transfer for Link Sub Account (For Master Account) (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

Futures Transfer for Link Sub Account (For Master Account) (USER_DATA) › Request Body

subAccountId

string · required

Example: 1

asset

string · required

The asset being transferred, e.g., USDT

Example: USDT

amount

number · float · required

The amount to be transferred

Example: 1

type

integer · int64 · required

1: transfer from subaccount's spot account to its USDT-margined futures account 2: transfer from subaccount's USDT-margined futures account to its spot account 3: transfer from subaccount's spot account to its COIN-margined futures account 4 from subaccount's COIN-margined futures account to its spot account

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

recvWindow

integer · int64 · max: 60000

Example: 5000

Futures Transfer for Link Sub Account (For Master Account) (USER_DATA) › Responses

200

Futures Transfer for Link Sub Account

txnId

string

Example: 2966662589

Get Sub Account Deposit History

GET

/sapi/v1/broker/subAccount/depositHist

https://api.binance.com

Get Sub Account Deposit History › Authorization

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

Get Sub Account Deposit History › Request Weight

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

Learn more in the Rate limits section.

IP Weight10

Get Sub Account Deposit History › 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

subAccountId

string

Example: 1

coin

string

Example: USDT

status

integer · int64

0(0,6: credited but cannot withdraw, 1)

Example: 0

startTime

integer · int64

Default: 7 days from current timestamp

Example: 1623319461670

endTime

integer · int64

Default: present timestamp

Example: 1641782889000

limit

integer · int64 · max: 500

Example: 50

Default: 500

offset

integer · int64

Example: 0

Default: 0

recvWindow

integer · int64 · max: 60000

Request validity window in milliseconds

Example: 5000

Get Sub Account Deposit History › Responses

200

Get Sub Account Deposit History

object

depositId

integer · int64

Example: 1234567890123

subAccountId

string

Example: 1

address

string

Example: 0xddc66e4313fd6c737b6cae67cad90bb4e0ac7092

addressTag

string

Example:

amount

string

Example: 139.04370000

coin

string

Example: USDT

insertTime

integer · int64

Example: 1566791463000

transferType

integer · int64

Example: 0

network

string

Example: ETH

status

integer · int64

Example: 1

txId

string

Example: 0x5759dfe9983a4c7619bce9bc736bb6c26f804091753bf66fa91e7cd5cfeebafd

sourceAddress

string

Example: xxxxxxxxxxxxxx

confirmTimes

string

Example: 12/12

selfReturnStatus

integer · int64

Example: 0

travelRuleStatus

integer · int64

0: travel rule not required or information already provided and funds are ready to use, 1: travel rule requires additional deposit information

Example: 0

Get Sub Account Deposit History V2

GET

/sapi/v2/broker/subAccount/depositHist

https://api.binance.com

Get Sub Account Deposit History V2 › 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 Sub Account Deposit History V2 › 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

Get Sub Account Deposit History V2 › Query Parameters

depositId

string · required

Example: 1

subAccountId

string · required

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

limit

integer · int64 · max: 500

Example: 50

Default: 50

offset

integer · int64

Example: 0

Default: 0

recvWindow

integer · int64 · max: 60000

Request validity window in milliseconds

Example: 5000

Get Sub Account Deposit History V2 › Responses

200

Get Sub Account Deposit History V2

object

depositId

integer · int64

Example: 1234567890123

subAccountId

string

Example: 1

address

string

Example: 0xddc66e4313fd6c737b6cae67cad90bb4e0ac7092

addressTag

string

Example:

amount

string

Example: 139.04370000

coin

string

Example: USDT

insertTime

integer · int64

Example: 1566791463000

transferType

integer · int64

Example: 0

network

string

Example: ETH

status

integer · int64

Example: 3

txId

string

Example: 0x5759dfe9983a4c7619bce9bc736bb6c26f804091753bf66fa91e7cd5cfeebafd

sourceAddress

string

Source address of the deposit

Example: xxxxxxxxxxxxxx

confirmTimes

string

Example: 12/12

selfReturnStatus

integer · int64

Example: 0

travelRuleStatus

integer · int64

Example: 0

Query Sub Account Futures Asset Info (V3)

Query Sub Account Futures Asset Info

GET

/sapi/v3/broker/subAccount/futuresSummary

https://api.binance.com

Query Sub Account Futures Asset Info (V3) › 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 Sub Account Futures Asset Info (V3) › 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 Weight60

Query Sub Account Futures Asset Info (V3) › Query Parameters

futuresType

integer · int64 · required

1 Futures, 2: Coin Futures

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

subAccountId

string

Example: 1

page

integer · int64

Example: 1

Default: 1

size

integer · int64 · max: 20

Example: 10

Default: 10

recvWindow

integer · int64 · max: 60000

Request validity window in milliseconds

Example: 5000

Query Sub Account Futures Asset Info (V3) › Responses

200

Sub Account Futures Asset Info

object[]

subAccountId

string

Example: 1

totalInitialMargin

string

Example: 0.0000000000

totalMaintenanceMargin

string

Example: 0.0000000000

totalWalletBalance

string

Example: 577.6799732808

totalUnrealizedProfit

string

Example: 0.0000000000

totalMarginBalance

string

Example: 577.6799732808

totalPositionInitialMargin

string

Example: 0.0000000000

totalOpenOrderInitialMargin

string

Example: 0.0000000000

futuresEnable

boolean

Example: true

asset

string

Example: USD

totalWalletBalanceOfUsdt

string

Example: 6.73252085685700

totalUnrealizedProfitOfUsdt

string

Example: 0.00000000000000

totalMarginBalanceOfUsdt

string

Example: 6.73252085685700

timestamp

integer · int64

Example: 1583127900000

GET/sapi/v3/broker/subAccount/futuresSummary

curl --request GET \
  --url 'https://api.binance.com/sapi/v3/broker/subAccount/futuresSummary?futuresType=%3Cnumber%3E&timestamp=%3Cnumber%3E'

Example Responses

{
  "data": [
    {
      "subAccountId": "1",
      "totalInitialMargin": "0.0000000000",
      "totalMaintenanceMargin": "0.0000000000",
      "totalWalletBalance": "577.6799732808",
      "totalUnrealizedProfit": "0.0000000000",
      "totalMarginBalance": "577.6799732808",
      "totalPositionInitialMargin": "0.0000000000",
      "totalOpenOrderInitialMargin": "0.0000000000",
      "futuresEnable": true,
      "asset": "USD",
      "totalWalletBalanceOfUsdt": "6.73252085685700",
      "totalUnrealizedProfitOfUsdt": "0.00000000000000",
      "totalMarginBalanceOfUsdt": "6.73252085685700"
    }
  ],
  "timestamp": 1583127900000
}

json

application/json

Query Sub Account Margin Asset Info

GET

/sapi/v1/broker/subAccount/marginSummary

https://api.binance.com

Query Sub Account Margin Asset Info › 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 Sub Account Margin Asset Info › 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

subAccountId

string

Example: 1

page

integer · int64

Example: 1

Default: 1

size

integer · int64 · max: 20

Example: 10

Default: 10

recvWindow

integer · int64 · max: 60000

Request validity window in milliseconds

Example: 5000

Query Sub Account Margin Asset Info › Responses

200

Sub Account Margin Asset Info

object[]

marginEnable

boolean

Example: true

subAccountId

string

Example: 367537027503425913

totalAssetOfBtc

string

Example: 0.03558520

totalLiabilityOfBtc

string

Example: 0.34585210

totalNetAssetOfBtc

string

Example: 0.23334213

marginLevel

string

Example: 0.009

timestamp

integer · int64

Example: 1583127900000

Query Sub Account Spot Asset Info

GET

/sapi/v1/broker/subAccount/spotSummary

https://api.binance.com

Query Sub Account Spot Asset Info › 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 Sub Account Spot Asset Info › 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

Query Sub Account Spot Asset Info › 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

subAccountId

string

Example: 1

page

integer · int64

Example: 1

Default: 1

size

integer · int64 · max: 20

Example: 10

Default: 10

recvWindow

integer · int64 · max: 60000

Request validity window in milliseconds

Example: 5000

Query Sub Account Spot Asset Info › Responses

200

Sub Account Spot Asset Info

object[]

subAccountId

string

Example: 367537027503425913

totalBalanceOfBtc

string

Example: 0.0355852154360000

timestamp

integer · int64

Example: 1583432900000

Query Sub Account Transfer History（FUTURES）

GET

/sapi/v1/broker/transfer/futures

https://api.binance.com

Query Sub Account Transfer History（FUTURES） › 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 Sub Account Transfer History（FUTURES） › Query Parameters

subAccountId

string · required

Example: 1

futuresType

integer · int64 · required

1 Futures, 2: Coin Futures

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

clientTranId

string

Example: 1

startTime

integer · int64

Default: 30 days from current timestamp

Example: 1623319461670

endTime

integer · int64

Default: present timestamp

Example: 1641782889000

page

integer · int64

Example: 1

Default: 1

limit

integer · int64 · max: 500

Example: 50

Default: 50

recvWindow

integer · int64 · max: 60000

Request validity window in milliseconds

Example: 5000

Query Sub Account Transfer History（FUTURES） › Responses

200

Sub Account Transfer History（FUTURES）

success

boolean

Example: true

futuresType

integer · int64

Example: 2

object[]

from

string

Example:

to

string

Example: 2

asset

string

Example: BTC

qty

string

Example: 1

tranId

string

Example: 12137888538

clientTranId

string

Example: a123

time

integer · int64

Example: 1544433328000

fromId

string

Example: 1

toId

string

Example: 2

Sub Account Transfer（FUTURES）

POST

/sapi/v1/broker/transfer/futures

https://api.binance.com

Sub Account Transfer（FUTURES） › 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

Sub Account Transfer（FUTURES） › Request Body

futuresType

integer · int64 · required

1 Futures,2: COIN Futures

Example: 1

asset

string · required

Example: BTCUSDT

amount

number · float · required

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

fromId

string

Example: 1

toId

string

Example: 1

clientTranId

string · maxLength: 32

Client transfer ID

Example: 1

recvWindow

integer · int64 · max: 60000

Example: 5000

Sub Account Transfer（FUTURES） › Responses

200

Sub Account Transfer（FUTURES）

success

boolean

Example: true

txnId

string

Example: 2966662589

clientTranId

string

Example: a123

Query Sub Account Transfer History（SPOT）

GET

/sapi/v1/broker/transfer

https://api.binance.com

Query Sub Account Transfer History（SPOT） › 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 Sub Account Transfer History（SPOT） › 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

fromId

string

Example: 1

toId

string

Example: 1

clientTranId

string

Client transfer ID

Example: 1

showAllStatus

boolean

Example: true

startTime

integer · int64

Default: 7 days from current timestamp

Example: 1623319461670

endTime

integer · int64

Default: present timestamp

Example: 1641782889000

page

integer · int64

Example: 1

Default: 1

limit

integer · int64 · max: 500

Example: 50

Default: 500

recvWindow

integer · int64 · max: 60000

Request validity window in milliseconds

Example: 5000

Query Sub Account Transfer History（SPOT） › Responses

200

Sub Account Transfer History（SPOT）

object

fromId

string

Example: 1

toId

string

Example: 2

asset

string

Example: BTC

qty

string

Example: 1

time

integer · int64

Example: 1544433328000

txnId

string

Example: 2966662589

clientTranId

string

Example: abc

status

string

Example: SUCCESS

Sub Account Transfer（SPOT）

POST

/sapi/v1/broker/transfer

https://api.binance.com

Sub Account Transfer（SPOT） › 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

Sub Account Transfer（SPOT） › Request Body

asset

string · required

Example: BTCUSDT

amount

number · float · required

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

fromId

string

Example: 1

toId

string

Example: 1

clientTranId

string · maxLength: 32

Client transfer ID. Must be unique.

Example: 1

recvWindow

integer · int64 · max: 60000

Example: 5000

Sub Account Transfer（SPOT） › Responses

200

Sub Account Transfer（SPOT）

txnId

string

Example: 2966662589

clientTranId

string

Example: abc

Query Universal Transfer History

GET

/sapi/v1/broker/universalTransfer

https://api.binance.com

Query Universal Transfer History › Authorization

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

Query Universal Transfer History › 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

fromId

string

Example: 1

toId

string

Example: 1

clientTranId

string

Client transfer ID

Example: 1

startTime

integer · int64

Default: 7 days from current timestamp

Example: 1623319461670

endTime

integer · int64

Default: present timestamp

Example: 1641782889000

page

integer · int64

Example: 1

Default: 1

limit

integer · int64 · max: 500

Example: 50

Default: 500

showAllStatus

boolean

Example: true

recvWindow

integer · int64 · max: 60000

Request validity window in milliseconds

Example: 5000

Query Universal Transfer History › Responses

200

Universal Transfer History

object

toId

string

Example: 444016824578949121

asset

string

Example: BTC

qty

string

Example: 0.1

time

integer · int64

Example: 1544433328000

status

string

Example: SUCCESS

txnId

string

Example: 12831078279

clientTranId

string

Example: abc

fromAccountType

string

Example: SPOT

toAccountType

string

Example: USDT_FUTURE

Universal Transfer

POST

/sapi/v1/broker/universalTransfer

https://api.binance.com

Universal Transfer › 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

Universal Transfer › Request Body

fromAccountType

string · enum · required

Enum values:

SPOT

USDT_FUTURE

COIN_FUTURE

Example: SPOT

toAccountType

string · enum · required

Enum values:

SPOT

USDT_FUTURE

COIN_FUTURE

Example: SPOT

asset

string · required

Example: BTCUSDT

amount

number · float · required

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

fromId

string

Example: 1

toId

string

Example: 1

clientTranId

string · maxLength: 32

Client transfer ID. Must be unique.

Example: 1

recvWindow

integer · int64 · max: 60000

Example: 5000

Universal Transfer › Responses

200

Universal Transfer

txnId

integer · int64

Example: 12831061179

clientTranId

string

Example: abc