账户

端点

下载Schema

账户API交易状态 (USER_DATA)

获取 api 账户交易状态详情。

GET

/sapi/v1/account/apiTradingStatus

https://api.binance.com

账户API交易状态 (USER_DATA) › 授权

这是一个签名端点，必须在请求参数中包含签名。了解如何生成有效签名，请参考端点安全类型

账户API交易状态 (USER_DATA) › 请求权重

此端点消耗基于IP的请求权重。较重的端点会消耗更多您的IP速率限制容量。

请在限速说明章节中了解更多信息。

IP 权重1

账户API交易状态 (USER_DATA) › 请求头

X-MBX-APIKEY

string · 必须

访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。

示例： API_KEY

账户API交易状态 (USER_DATA) › 查询参数

timestamp

integer · int64 · 必须

用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.

示例： 1770736694138

recvWindow

integer · int64 · max: 60000

示例： 5000

账户API交易状态 (USER_DATA) › 响应

200

账户 API 交易状态

object

isLocked

boolean

示例： false

plannedRecoverTime

integer · int64

示例： 0

object

GCR

integer · int64

示例： 150

IFER

integer · int64

示例： 150

UFR

integer · int64

示例： 300

updateTime

integer · int64

示例： 1547630471725

帐户信息 (USER_DATA)

获取帐户信息详情。

GET

/sapi/v1/account/info

https://api.binance.com

帐户信息 (USER_DATA) › 授权

这是一个签名端点，必须在请求参数中包含签名。了解如何生成有效签名，请参考端点安全类型

帐户信息 (USER_DATA) › 请求权重

此端点消耗基于IP的请求权重。较重的端点会消耗更多您的IP速率限制容量。

请在限速说明章节中了解更多信息。

IP 权重1

帐户信息 (USER_DATA) › 请求头

X-MBX-APIKEY

string · 必须

访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。

示例： API_KEY

帐户信息 (USER_DATA) › 查询参数

timestamp

integer · int64 · 必须

用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.

示例： 1770736694138

recvWindow

integer · int64 · max: 60000

示例： 5000

帐户信息 (USER_DATA) › 响应

200

账户信息

vipLevel

integer · int64

示例： 0

isMarginEnabled

boolean

示例： true

isFutureEnabled

boolean

示例： true

isOptionsEnabled

boolean

示例： true

isPortfolioMarginRetailEnabled

boolean

示例： true

账户状态 (USER_DATA)

账户状态(USER_DATA)

GET

/sapi/v1/account/status

https://api.binance.com

账户状态 (USER_DATA) › 授权

这是一个签名端点，必须在请求参数中包含签名。了解如何生成有效签名，请参考端点安全类型

账户状态 (USER_DATA) › 请求权重

此端点消耗基于IP的请求权重。较重的端点会消耗更多您的IP速率限制容量。

请在限速说明章节中了解更多信息。

IP 权重1

账户状态 (USER_DATA) › 请求头

X-MBX-APIKEY

string · 必须

访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。

示例： API_KEY

账户状态 (USER_DATA) › 查询参数

timestamp

integer · int64 · 必须

用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.

示例： 1770736694138

recvWindow

integer · int64 · max: 60000

示例： 5000

账户状态 (USER_DATA) › 响应

200

账户状态

data

string

示例： Normal

查询每日资产快照 (USER_DATA)

查询每日资产快照

GET

/sapi/v1/accountSnapshot

https://api.binance.com

查询每日资产快照 (USER_DATA) › 授权

这是一个签名端点，必须在请求参数中包含签名。了解如何生成有效签名，请参考端点安全类型

查询每日资产快照 (USER_DATA) › 请求权重

此端点消耗基于IP的请求权重。较重的端点会消耗更多您的IP速率限制容量。

请在限速说明章节中了解更多信息。

IP 权重2400

查询每日资产快照 (USER_DATA) › 请求头

X-MBX-APIKEY

string · 必须

访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。

示例： API_KEY

查询每日资产快照 (USER_DATA) › 查询参数

type

string · enum · 必须

枚举值:

SPOT

MARGIN

FUTURES

示例： SPOT

timestamp

integer · int64 · 必须

用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.

示例： 1770736694138

startTime

integer · int64

示例： 1623319461670

endTime

integer · int64

示例： 1641782889000

limit

integer · int64 · min: 7 · max: 30

示例： 7

默认值： 7

recvWindow

integer · int64 · max: 60000

示例： 5000

查询每日资产快照 (USER_DATA) › 响应

200

每日账户快照

code

integer · int64

示例： 200

msg

string

示例：

object[]

object

object[]

asset

string

示例： BTC

free

string

示例： 0.09905021

locked

string

示例： 0.00000000

totalAssetOfBtc

string

示例： 0.09942700

marginLevel

string

示例： 2748.02909813

totalLiabilityOfBtc

string

示例： 0.00000100

totalNetAssetOfBtc

string

示例： 0.00274750

object[]

asset

string

示例： XRP

borrowed

string

示例： 0.00000000

free

string

示例： 1.00000000

interest

string

示例： 0.00000000

locked

string

示例： 0.00000000

netAsset

string

示例： 1.00000000

object[]

asset

string

示例： USDT

marginBalance

string

示例： 118.99782335

walletBalance

string

示例： 120.23811389

object[]

entryPrice

string

示例： 7130.41000000

markPrice

string

示例： 7257.66239673

positionAmt

string

示例： 0.01000000

symbol

string

示例： BTCUSDT

unRealizedProfit

string

示例： 1.24029054

type

string

示例： spot

updateTime

integer · int64

示例： 1576281599000

GET/sapi/v1/accountSnapshot

curl --request GET \
  --url 'https://api.binance.com/sapi/v1/accountSnapshot?type=%3Cstring%3E&timestamp=%3Cnumber%3E' \
  --header 'X-MBX-APIKEY: <string>'

示例响应

{
  "code": 200,
  "msg": "",
  "snapshotVos": [
    {
      "data": {
        "balances": [
          {
            "asset": "BTC",
            "free": "0.09905021",
            "locked": "0.00000000"
          }
        ],
        "totalAssetOfBtc": "0.09942700",
        "marginLevel": "2748.02909813",
        "totalLiabilityOfBtc": "0.00000100",
        "totalNetAssetOfBtc": "0.00274750",
        "userAssets": [
          {
            "asset": "XRP",
            "borrowed": "0.00000000",
            "free": "1.00000000",
            "interest": "0.00000000",
            "locked": "0.00000000",
            "netAsset": "1.00000000"
          }
        ],
        "assets": [
          {
            "asset": "USDT",
            "marginBalance": "118.99782335",
            "walletBalance": "120.23811389"
          }
        ],
        "position": [
          {
            "entryPrice": "7130.41000000",
            "markPrice": "7257.66239673",
            "positionAmt": "0.01000000",
            "symbol": "BTCUSDT",
            "unRealizedProfit": "1.24029054"
          }
        ]
      },
      "type": "spot",
      "updateTime": 1576281599000
    }
  ]
}

json

application/json

关闭站内划转 (USER_DATA)

关闭站内划转

POST

/sapi/v1/account/disableFastWithdrawSwitch

https://api.binance.com

关闭站内划转 (USER_DATA) › 授权

这是一个签名端点，必须在请求参数中包含签名。了解如何生成有效签名，请参考端点安全类型

关闭站内划转 (USER_DATA) › 请求权重

此端点消耗基于IP的请求权重。较重的端点会消耗更多您的IP速率限制容量。

请在限速说明章节中了解更多信息。

IP 权重1

关闭站内划转 (USER_DATA) › 请求头

X-MBX-APIKEY

string · 必须

访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。

示例： API_KEY

关闭站内划转 (USER_DATA) › 请求体

timestamp

integer · int64 · 必须

用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.

示例： 1770736694138

recvWindow

integer · int64 · max: 60000

示例： 5000

关闭站内划转 (USER_DATA) › 响应

200

成功

无返回数据

开启站内划转 (USER_DATA)

开启站内划转(USER_DATA)

POST

/sapi/v1/account/enableFastWithdrawSwitch

https://api.binance.com

开启站内划转 (USER_DATA) › 授权

这是一个签名端点，必须在请求参数中包含签名。了解如何生成有效签名，请参考端点安全类型

开启站内划转 (USER_DATA) › 请求权重

此端点消耗基于IP的请求权重。较重的端点会消耗更多您的IP速率限制容量。

请在限速说明章节中了解更多信息。

IP 权重1

开启站内划转 (USER_DATA) › 请求头

X-MBX-APIKEY

string · 必须

访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。

示例： API_KEY

开启站内划转 (USER_DATA) › 请求体

timestamp

integer · int64 · 必须

用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.

示例： 1770736694138

recvWindow

integer · int64 · max: 60000

示例： 5000

开启站内划转 (USER_DATA) › 响应

200

成功

无返回数据

查询用户API Key权限 (USER_DATA)

查询用户 API Key 权限

GET

/sapi/v1/account/apiRestrictions

https://api.binance.com

查询用户API Key权限 (USER_DATA) › 授权

这是一个签名端点，必须在请求参数中包含签名。了解如何生成有效签名，请参考端点安全类型

查询用户API Key权限 (USER_DATA) › 请求权重

此端点消耗基于IP的请求权重。较重的端点会消耗更多您的IP速率限制容量。

请在限速说明章节中了解更多信息。

IP 权重1

查询用户API Key权限 (USER_DATA) › 请求头

X-MBX-APIKEY

string · 必须

访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。

示例： API_KEY

查询用户API Key权限 (USER_DATA) › 查询参数

timestamp

integer · int64 · 必须

用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.

示例： 1770736694138

recvWindow

integer · int64 · max: 60000

示例： 5000

查询用户API Key权限 (USER_DATA) › 响应

200

查询 API Key 权限

ipRestrict

boolean

示例： false

createTime

integer · int64

示例： 1623840271000

enableReading

boolean

示例： true

enableWithdrawals

boolean

示例： false

enableInternalTransfer

boolean

示例： true

enableMargin

boolean

示例： false

enableFutures

boolean

示例： false

permitsUniversalTransfer

boolean

示例： true

enableVanillaOptions

boolean

示例： false

enableFixApiTrade

boolean

示例： false

enableFixReadOnly

boolean

示例： true

enableSpotAndMarginTrading

boolean

示例： false

enablePortfolioMarginTrading

boolean

示例： true

账户

端点

下载Schema

账户API交易状态 (USER_DATA)

获取 api 账户交易状态详情。

GET

/sapi/v1/account/apiTradingStatus

https://api.binance.com

账户API交易状态 (USER_DATA) › 授权

这是一个签名端点，必须在请求参数中包含签名。了解如何生成有效签名，请参考端点安全类型

账户API交易状态 (USER_DATA) › 请求权重

此端点消耗基于IP的请求权重。较重的端点会消耗更多您的IP速率限制容量。

请在限速说明章节中了解更多信息。

IP 权重1

账户API交易状态 (USER_DATA) › 请求头

X-MBX-APIKEY

string · 必须

访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。

示例： API_KEY

账户API交易状态 (USER_DATA) › 查询参数

timestamp

integer · int64 · 必须

用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.

示例： 1770736694138

recvWindow

integer · int64 · max: 60000

示例： 5000

账户API交易状态 (USER_DATA) › 响应

200

账户 API 交易状态

object

isLocked

boolean

示例： false

plannedRecoverTime

integer · int64

示例： 0

object

GCR

integer · int64

示例： 150

IFER

integer · int64

示例： 150

UFR

integer · int64

示例： 300

updateTime

integer · int64

示例： 1547630471725

帐户信息 (USER_DATA)

获取帐户信息详情。

GET

/sapi/v1/account/info

https://api.binance.com

帐户信息 (USER_DATA) › 授权

这是一个签名端点，必须在请求参数中包含签名。了解如何生成有效签名，请参考端点安全类型

帐户信息 (USER_DATA) › 请求权重

此端点消耗基于IP的请求权重。较重的端点会消耗更多您的IP速率限制容量。

请在限速说明章节中了解更多信息。

IP 权重1

帐户信息 (USER_DATA) › 请求头

X-MBX-APIKEY

string · 必须

访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。

示例： API_KEY

帐户信息 (USER_DATA) › 查询参数

timestamp

integer · int64 · 必须

用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.

示例： 1770736694138

recvWindow

integer · int64 · max: 60000

示例： 5000

帐户信息 (USER_DATA) › 响应

200

账户信息

vipLevel

integer · int64

示例： 0

isMarginEnabled

boolean

示例： true

isFutureEnabled

boolean

示例： true

isOptionsEnabled

boolean

示例： true

isPortfolioMarginRetailEnabled

boolean

示例： true

账户状态 (USER_DATA)

账户状态(USER_DATA)

GET

/sapi/v1/account/status

https://api.binance.com

账户状态 (USER_DATA) › 授权

这是一个签名端点，必须在请求参数中包含签名。了解如何生成有效签名，请参考端点安全类型

账户状态 (USER_DATA) › 请求权重

此端点消耗基于IP的请求权重。较重的端点会消耗更多您的IP速率限制容量。

请在限速说明章节中了解更多信息。

IP 权重1

账户状态 (USER_DATA) › 请求头

X-MBX-APIKEY

string · 必须

访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。

示例： API_KEY

账户状态 (USER_DATA) › 查询参数

timestamp

integer · int64 · 必须

用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.

示例： 1770736694138

recvWindow

integer · int64 · max: 60000

示例： 5000

账户状态 (USER_DATA) › 响应

200

账户状态

data

string

示例： Normal

查询每日资产快照 (USER_DATA)

查询每日资产快照

GET

/sapi/v1/accountSnapshot

https://api.binance.com

查询每日资产快照 (USER_DATA) › 授权

这是一个签名端点，必须在请求参数中包含签名。了解如何生成有效签名，请参考端点安全类型

查询每日资产快照 (USER_DATA) › 请求权重

此端点消耗基于IP的请求权重。较重的端点会消耗更多您的IP速率限制容量。

请在限速说明章节中了解更多信息。

IP 权重2400

查询每日资产快照 (USER_DATA) › 请求头

X-MBX-APIKEY

string · 必须

访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。

示例： API_KEY

查询每日资产快照 (USER_DATA) › 查询参数

type

string · enum · 必须

枚举值:

SPOT

MARGIN

FUTURES

示例： SPOT

timestamp

integer · int64 · 必须

用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.

示例： 1770736694138

startTime

integer · int64

示例： 1623319461670

endTime

integer · int64

示例： 1641782889000

limit

integer · int64 · min: 7 · max: 30

示例： 7

默认值： 7

recvWindow

integer · int64 · max: 60000

示例： 5000

查询每日资产快照 (USER_DATA) › 响应

200

每日账户快照

code

integer · int64

示例： 200

msg

string

示例：

object[]

object

object[]

asset

string

示例： BTC

free

string

示例： 0.09905021

locked

string

示例： 0.00000000

totalAssetOfBtc

string

示例： 0.09942700

marginLevel

string

示例： 2748.02909813

totalLiabilityOfBtc

string

示例： 0.00000100

totalNetAssetOfBtc

string

示例： 0.00274750

object[]

asset

string

示例： XRP

borrowed

string

示例： 0.00000000

free

string

示例： 1.00000000

interest

string

示例： 0.00000000

locked

string

示例： 0.00000000

netAsset

string

示例： 1.00000000

object[]

asset

string

示例： USDT

marginBalance

string

示例： 118.99782335

walletBalance

string

示例： 120.23811389

object[]

entryPrice

string

示例： 7130.41000000

markPrice

string

示例： 7257.66239673

positionAmt

string

示例： 0.01000000

symbol

string

示例： BTCUSDT

unRealizedProfit

string

示例： 1.24029054

type

string

示例： spot

updateTime

integer · int64

示例： 1576281599000

GET/sapi/v1/accountSnapshot

curl --request GET \
  --url 'https://api.binance.com/sapi/v1/accountSnapshot?type=%3Cstring%3E&timestamp=%3Cnumber%3E' \
  --header 'X-MBX-APIKEY: <string>'

示例响应

{
  "code": 200,
  "msg": "",
  "snapshotVos": [
    {
      "data": {
        "balances": [
          {
            "asset": "BTC",
            "free": "0.09905021",
            "locked": "0.00000000"
          }
        ],
        "totalAssetOfBtc": "0.09942700",
        "marginLevel": "2748.02909813",
        "totalLiabilityOfBtc": "0.00000100",
        "totalNetAssetOfBtc": "0.00274750",
        "userAssets": [
          {
            "asset": "XRP",
            "borrowed": "0.00000000",
            "free": "1.00000000",
            "interest": "0.00000000",
            "locked": "0.00000000",
            "netAsset": "1.00000000"
          }
        ],
        "assets": [
          {
            "asset": "USDT",
            "marginBalance": "118.99782335",
            "walletBalance": "120.23811389"
          }
        ],
        "position": [
          {
            "entryPrice": "7130.41000000",
            "markPrice": "7257.66239673",
            "positionAmt": "0.01000000",
            "symbol": "BTCUSDT",
            "unRealizedProfit": "1.24029054"
          }
        ]
      },
      "type": "spot",
      "updateTime": 1576281599000
    }
  ]
}

json

application/json

关闭站内划转 (USER_DATA)

关闭站内划转

POST

/sapi/v1/account/disableFastWithdrawSwitch

https://api.binance.com

关闭站内划转 (USER_DATA) › 授权

这是一个签名端点，必须在请求参数中包含签名。了解如何生成有效签名，请参考端点安全类型

关闭站内划转 (USER_DATA) › 请求权重

此端点消耗基于IP的请求权重。较重的端点会消耗更多您的IP速率限制容量。

请在限速说明章节中了解更多信息。

IP 权重1

关闭站内划转 (USER_DATA) › 请求头

X-MBX-APIKEY

string · 必须

访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。

示例： API_KEY

关闭站内划转 (USER_DATA) › 请求体

timestamp

integer · int64 · 必须

用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.

示例： 1770736694138

recvWindow

integer · int64 · max: 60000

示例： 5000

关闭站内划转 (USER_DATA) › 响应

200

成功

无返回数据

开启站内划转 (USER_DATA)

开启站内划转(USER_DATA)

POST

/sapi/v1/account/enableFastWithdrawSwitch

https://api.binance.com

开启站内划转 (USER_DATA) › 授权

这是一个签名端点，必须在请求参数中包含签名。了解如何生成有效签名，请参考端点安全类型

开启站内划转 (USER_DATA) › 请求权重

此端点消耗基于IP的请求权重。较重的端点会消耗更多您的IP速率限制容量。

请在限速说明章节中了解更多信息。

IP 权重1

开启站内划转 (USER_DATA) › 请求头

X-MBX-APIKEY

string · 必须

访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。

示例： API_KEY

开启站内划转 (USER_DATA) › 请求体

timestamp

integer · int64 · 必须

用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.

示例： 1770736694138

recvWindow

integer · int64 · max: 60000

示例： 5000

开启站内划转 (USER_DATA) › 响应

200

成功

无返回数据

查询用户API Key权限 (USER_DATA)

查询用户 API Key 权限

GET

/sapi/v1/account/apiRestrictions

https://api.binance.com

查询用户API Key权限 (USER_DATA) › 授权

这是一个签名端点，必须在请求参数中包含签名。了解如何生成有效签名，请参考端点安全类型

查询用户API Key权限 (USER_DATA) › 请求权重

此端点消耗基于IP的请求权重。较重的端点会消耗更多您的IP速率限制容量。

请在限速说明章节中了解更多信息。

IP 权重1

查询用户API Key权限 (USER_DATA) › 请求头

X-MBX-APIKEY

string · 必须

访问此接口需要 API Key，并且必须在请求头中携带。关于如何创建 API Key，请参考：https://www.binance.com/cn/support/faq/detail/360002502072。

示例： API_KEY

查询用户API Key权限 (USER_DATA) › 查询参数

timestamp

integer · int64 · 必须

用于请求签名的 Unix 时间戳，单位为毫秒. 该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验.

示例： 1770736694138

recvWindow

integer · int64 · max: 60000

示例： 5000

查询用户API Key权限 (USER_DATA) › 响应

200

查询 API Key 权限

ipRestrict

boolean

示例： false

createTime

integer · int64

示例： 1623840271000

enableReading

boolean

示例： true

enableWithdrawals

boolean

示例： false

enableInternalTransfer

boolean

示例： true

enableMargin

boolean

示例： false

enableFutures

boolean

示例： false

permitsUniversalTransfer

boolean

示例： true

enableVanillaOptions

boolean

示例： false

enableFixApiTrade

boolean

示例： false

enableFixReadOnly

boolean

示例： true

enableSpotAndMarginTrading

boolean

示例： false

enablePortfolioMarginTrading

boolean

示例： true