Binance Spot REST API¶

来源: https://github.com/binance/binance-spot-api-docs/blob/master/rest-api.md

General API Information¶

• Base Endpoints:
• https://api.binance.com
• https://api-gcp.binance.com
• **https://api1.binance.com**~**https://api4.binance.com**(性能更好但稳定性稍低)
• 纯行情数据:https://data-api.binance.vision
• 默认返回 JSON 格式，支持 SBE 格式
• 数据按时间顺序返回（除非另有说明）
• 所有时间戳字段默认为**毫秒**，可通过 X-MBX-TIME-UNIT:MICROSECOND header 切换为微秒
• 时间戳参数（如 startTime、endTime、timestamp）可传毫秒或微秒
• 支持 HMAC、RSA、Ed25519 密钥
• API 请求处理超时为 10 秒

HTTP Return Codes¶

• 4XX - 请求格式错误（客户端问题）
• 403 - WAF 规则触发
• 409 - cancelReplace 订单部分成功
• 429 - 超出请求频率限制
• 418 - IP 被自动封禁（持续发送请求后）
• 5XX - 服务器内部错误（执行状态未知）

Endpoint 参数规则¶

• GET 请求：参数以 query string 发送
• POST、PUT、DELETE：参数可通过 query string 或 request body (application/x-www-form-urlencoded)
• 参数可任意顺序发送
• query string 和 body 同时存在同名参数时，query string 优先

频率限制 (Rate Limits)¶

IP 限制¶

• 响应头 X-MBX-USED-WEIGHT-(intervalNum)(intervalLetter) 显示当前已用权重
• 每个路由有不同的 weight
• 超出返回 429，持续违规返回 418（IP 封禁 2 分钟到 3 天）
• Retry-After 响应头告知等待秒数

下单频率限制¶

• 响应头 X-MBX-ORDER-COUNT-(intervalNum)(intervalLetter) 显示已下单数
• 已成交订单会释放计数，详见 order_count_decrement

Request Security¶

SIGNED 请求¶

• 需要额外的 signature 参数
• 需要 timestamp 参数（毫秒或微秒）
• 可选 recvWindow 参数（默认 5000ms，最大 60000ms）

Public API Endpoints¶

General Endpoints¶

Test Connectivity¶

GET /api/v3/ping

• Weight:**1 |**Security: NONE

Response:

{}

Check Server Time¶

GET /api/v3/time

• Weight:**1 |**Security: NONE

Response:

{ "serverTime": 1499827319559 }

Exchange Information¶

GET /api/v3/exchangeInfo

• Weight:**20 |**Security: NONE

Parameters: | Name | Type | Mandatory | Description | |------|------|-----------|-------------| | symbol | STRING | NO | 单个交易对 | | symbols | ARRAY OF STRING | NO | 多个交易对 | | permissions | ENUM | NO | 按权限筛选，不能与 symbol/symbols 同时使用 | | showPermissionSets | BOOLEAN | NO | 是否填充 permissionSets 字段，默认 true | | symbolStatus | ENUM | NO | 按交易状态筛选: TRADING, HALT, BREAK |

Response:

{
  "timezone": "UTC",
  "serverTime": 1565246363776,
  "rateLimits": [],
  "exchangeFilters": [],
  "symbols": [
    {
      "symbol": "ETHBTC",
      "status": "TRADING",
      "baseAsset": "ETH",
      "baseAssetPrecision": 8,
      "quoteAsset": "BTC",
      "quoteAssetPrecision": 8,
      "orderTypes": ["LIMIT", "LIMIT_MAKER", "MARKET", "STOP_LOSS", "STOP_LOSS_LIMIT", "TAKE_PROFIT", "TAKE_PROFIT_LIMIT"],
      "icebergAllowed": true,
      "ocoAllowed": true,
      "otoAllowed": true,
      "quoteOrderQtyMarketAllowed": true,
      "allowTrailingStop": false,
      "cancelReplaceAllowed": false,
      "isSpotTradingAllowed": true,
      "isMarginTradingAllowed": true,
      "filters": [],
      "permissionSets": [["SPOT", "MARGIN"]],
      "defaultSelfTradePreventionMode": "NONE",
      "allowedSelfTradePreventionModes": ["NONE"]
    }
  ],
  "sors": [
    { "baseAsset": "BTC", "symbols": ["BTCUSDT", "BTCUSDC"] }
  ]
}

Market Data Endpoints¶

Order Book¶

GET /api/v3/depth

• Weight: 按 limit 调整: 1-100=5, 101-500=25, 501-1000=50, 1001-5000=250

Response:

{
  "lastUpdateId": 1027024,
  "bids": [["4.00000000", "431.00000000"]],
  "asks": [["4.00000200", "12.00000000"]]
}

Recent Trades List¶

GET /api/v3/trades

• Weight:**25 |**Security: NONE

Response:

[
  {
    "id": 28457,
    "price": "4.00000100",
    "qty": "12.00000000",
    "quoteQty": "48.000012",
    "time": 1499865549590,
    "isBuyerMaker": true,
    "isBestMatch": true
  }
]

Old Trade Lookup¶

GET /api/v3/historicalTrades

• Weight: 25

Compressed/Aggregate Trades List¶

GET /api/v3/aggTrades

• Weight: 4

Response:

[
  {
    "a": 26129,         // Aggregate tradeId
    "p": "0.01633102",  // Price
    "q": "4.70443515",  // Quantity
    "f": 27781,         // First tradeId
    "l": 27781,         // Last tradeId
    "T": 1498793709153, // Timestamp
    "m": true,          // Is the buyer the maker?
    "M": true           // Was the trade the best price match?
  }
]

Kline/Candlestick Data¶

GET /api/v3/klines

• Weight: 2

支持的 Kline 间隔: | 周期 | 值 | |------|-----| | 秒 | 1s | | 分钟 | 1m, 3m, 5m, 15m, 30m | | 小时 | 1h, 2h, 4h, 6h, 8h, 12h | | 天 | 1d, 3d | | 周 | 1w | | 月 | 1M |

Response:

[
  [
    1499040000000,      // Kline open time
    "0.01634790",       // Open price
    "0.80000000",       // High price
    "0.01575800",       // Low price
    "0.01577100",       // Close price
    "148976.11427815",  // Volume
    1499644799999,      // Kline close time
    "2434.19055334",    // Quote asset volume
    308,                // Number of trades
    "1756.87402397",    // Taker buy base asset volume
    "28.46694368",      // Taker buy quote asset volume
    "0"                 // Unused field, ignore
  ]
]

UIKlines¶

GET /api/v3/uiKlines

• Weight: 2

Current Average Price¶

GET /api/v3/avgPrice

• Weight: 2

Response:

{
  "mins": 5,
  "price": "9.35751834",
  "closeTime": 1694061154503
}

24hr Ticker Price Change Statistics¶

GET /api/v3/ticker/24hr

• Weight: symbol=1 时为 2，省略时为 80

Response (FULL):

{
  "symbol": "BNBBTC",
  "priceChange": "-94.99999800",
  "priceChangePercent": "-95.960",
  "weightedAvgPrice": "0.29628482",
  "prevClosePrice": "0.10002000",
  "lastPrice": "4.00000200",
  "lastQty": "200.00000000",
  "bidPrice": "4.00000000",
  "bidQty": "100.00000000",
  "askPrice": "4.00000200",
  "askQty": "100.00000000",
  "openPrice": "99.00000000",
  "highPrice": "100.00000000",
  "lowPrice": "0.10000000",
  "volume": "8913.30000000",
  "quoteVolume": "15.30000000",
  "openTime": 1499783499040,
  "closeTime": 1499869899040,
  "firstId": 28385,
  "lastId": 28460,
  "count": 76
}

Symbol Price Ticker¶

GET /api/v3/ticker/price

• Weight: symbol=1 时为 2，省略时为 4

Response:

{ "symbol": "LTCBTC", "price": "4.00000200" }

Symbol Order Book Ticker¶

GET /api/v3/ticker/bookTicker

• Weight: symbol=1 时为 2，省略时为 4

Response:

{
  "symbol": "LTCBTC",
  "bidPrice": "4.00000000",
  "bidQty": "431.00000000",
  "askPrice": "4.00000200",
  "askQty": "9.00000000"
}

Rolling Window Price Change Statistics¶

GET /api/v3/ticker

Trading Endpoints¶

New Order (TRADE)¶

POST /api/v3/order

• Weight:**1 |**Unfilled Order Count: 1

Parameters: | Name | Type | Mandatory | Description | |------|------|-----------|-------------| | symbol | STRING | YES | | | side | ENUM | YES | BUY / SELL | | type | ENUM | YES | 订单类型 | | timeInForce | ENUM | NO | GTC / IOC / FOK | | quantity | DECIMAL | NO | | | quoteOrderQty | DECIMAL | NO | | | price | DECIMAL | NO | | | newClientOrderId | STRING | NO | 自定义订单 ID | | strategyId | LONG | NO | | | strategyType | INT | NO | 不能小于 1000000 | | stopPrice | DECIMAL | NO | 用于 STOP_LOSS, TAKE_PROFIT 等 | | trailingDelta | LONG | NO | 追踪止损 | | icebergQty | DECIMAL | NO | 冰山订单数量 | | newOrderRespType | ENUM | NO | ACK, RESULT, FULL | | selfTradePreventionMode | ENUM | NO | STP 模式 | | pegPriceType | ENUM | NO | PRIMARY_PEG / MARKET_PEG | | pegOffsetValue | INT | NO | 挂钩价格偏移 (max: 100) | | pegOffsetType | ENUM | NO | 仅支持 PRICE_LEVEL | | recvWindow | DECIMAL | NO | 最大 60000 | | timestamp | LONG | YES | |

各订单类型必需参数: | Type | 必需参数 | 说明 | |------|----------|------| | LIMIT | timeInForce, quantity, price | | | MARKET | quantity 或 quoteOrderQty | 按市价买卖 | | STOP_LOSS | quantity, stopPrice/trailingDelta | 达到条件时执行 MARKET 订单 | | STOP_LOSS_LIMIT | timeInForce, quantity, price, stopPrice/trailingDelta | | | TAKE_PROFIT | quantity, stopPrice/trailingDelta | 达到条件时执行 MARKET 订单 | | TAKE_PROFIT_LIMIT | timeInForce, quantity, price, stopPrice/trailingDelta | | | LIMIT_MAKER | quantity, price | POST-ONLY 订单 |

Response (FULL):

{
  "symbol": "BTCUSDT",
  "orderId": 28,
  "orderListId": -1,
  "clientOrderId": "6gCrw2kRUAF9CvJDGP16IP",
  "transactTime": 1507725176595,
  "price": "0.00000000",
  "origQty": "10.00000000",
  "executedQty": "10.00000000",
  "cummulativeQuoteQty": "10.00000000",
  "status": "FILLED",
  "timeInForce": "GTC",
  "type": "MARKET",
  "side": "SELL",
  "workingTime": 1507725176595,
  "selfTradePreventionMode": "NONE",
  "fills": [
    {
      "price": "4000.00000000",
      "qty": "1.00000000",
      "commission": "4.00000000",
      "commissionAsset": "USDT",
      "tradeId": 56
    }
  ]
}

Test New Order (TRADE)¶

POST /api/v3/order/test

• Weight: 无 computeCommissionRates 时为 1，有时为 20

Cancel Order (TRADE)¶

DELETE /api/v3/order

• Weight: 1

Cancel All Open Orders on a Symbol (TRADE)¶

DELETE /api/v3/openOrders

• Weight: 1

Cancel Replace Order (TRADE)¶

POST /api/v3/order/cancelReplace

• Weight: 1

Order Amend Keep Priority (TRADE)¶

PUT /api/v3/order/amend/keepPriority

• Weight:**4 |**Unfilled Order Count: 0

New Order using SOR (TRADE)¶

POST /api/v3/sor/order

• Weight: 1

Test New Order using SOR (TRADE)¶

POST /api/v3/sor/order/test

Account Endpoints¶

Account Information (USER_DATA)¶

GET /api/v3/account

• Weight: 20

Response:

{
  "makerCommission": 15,
  "takerCommission": 15,
  "commissionRates": {
    "maker": "0.00150000",
    "taker": "0.00150000",
    "buyer": "0.00000000",
    "seller": "0.00000000"
  },
  "canTrade": true,
  "canWithdraw": true,
  "canDeposit": true,
  "accountType": "SPOT",
  "balances": [
    { "asset": "BTC", "free": "4723846.89208129", "locked": "0.00000000" },
    { "asset": "LTC", "free": "4763368.68006011", "locked": "0.00000000" }
  ],
  "permissions": ["SPOT"],
  "uid": 354937868
}

Query Order (USER_DATA)¶

GET /api/v3/order

• Weight: 4

Current Open Orders (USER_DATA)¶

GET /api/v3/openOrders

• Weight: 单交易对为 6，省略为 80

All Orders (USER_DATA)¶

GET /api/v3/allOrders

• Weight: 20

Query Order List (USER_DATA)¶

GET /api/v3/orderList

• Weight: 4

Query All Order Lists (USER_DATA)¶

GET /api/v3/allOrderList

• Weight: 20

Query Open Order Lists (USER_DATA)¶

GET /api/v3/openOrderList

• Weight: 6

Account Trade List (USER_DATA)¶

GET /api/v3/myTrades

• Weight: 无 orderId 为 20，有 orderId 为 5

Response:

[
  {
    "symbol": "BNBBTC",
    "id": 28457,
    "orderId": 100234,
    "orderListId": -1,
    "price": "4.00000100",
    "qty": "12.00000000",
    "quoteQty": "48.000012",
    "commission": "10.10000000",
    "commissionAsset": "BNB",
    "time": 1499865549590,
    "isBuyer": true,
    "isMaker": false,
    "isBestMatch": true
  }
]

Query Unfilled Order Count (USER_DATA)¶

GET /api/v3/rateLimit/order

• Weight: 40

Query Prevented Matches (USER_DATA)¶

GET /api/v3/myPreventedMatches

• Weight: 按 preventedMatchId 查询为 2，按 orderId 查询为 20

Query Allocations (USER_DATA)¶

GET /api/v3/myAllocations

• Weight: 20

Query Commission Rates (USER_DATA)¶

GET /api/v3/account/commission

• Weight: 20

Response:

{
  "symbol": "BTCUSDT",
  "standardCommission": { "maker": "0.00000010", "taker": "0.00000020", "buyer": "0.00000030", "seller": "0.00000040" },
  "taxCommission": { "maker": "0.00000112", "taker": "0.00000114", "buyer": "0.00000118", "seller": "0.00000116" },
  "discount": {
    "enabledForAccount": true,
    "enabledForSymbol": true,
    "discountAsset": "BNB",
    "discount": "0.75000000"
  }
}

Query Order Amendments (USER_DATA)¶

GET /api/v3/order/amendments

• Weight: 4

Query Relevant Filters (USER_DATA)¶

GET /api/v3/myFilters

• Weight: 40

API Endpoints 汇总表¶