快速开始

准备工作

1. 已开通 SAPI 权限的 Binance 账号。如无，请先阅读根级 快速开始。
2. 一对 API Key + Secret，且对需要 TRADE 权限的接口开启"启用交易"；仅调用 USER_DATA 查询类接口只需 USER_DATA 权限即可。

请求签名

所有交易接口都需要对 query string 做 HMAC-SHA256 或 Ed25519 签名，方式与其他 SAPI 接口完全一致。签名细节参见根级 基本信息。

限价买入示例（curl）

Code
BASE_URL="https://api.binance.com"
API_KEY="<你的 api key>"
SECRET="<你的 api secret>"
TIMESTAMP=$(($(date +%s%N)/1000000))

QUERY="symbol=AAPL&side=BUY&orderType=LIMIT&price=180.50&quantity=1&tradingSession=RTH&timeInForce=DAY&timestamp=${TIMESTAMP}"
SIGNATURE=$(echo -n "$QUERY" | openssl dgst -sha256 -hmac "$SECRET" | awk '{print $2}')

curl -X POST \
  -H "X-MBX-APIKEY: $API_KEY" \
  "${BASE_URL}/sapi/v1/equity/order/place?${QUERY}&signature=${SIGNATURE}"

响应示例：

Code
{
  "status": "S",
  "orderId": "c3c58f49-7b0d-4b9e-a2db-1a2f9a3b8c71",
  "clientOrderId": "web_2c9c92b74f1e4a7c8f3b9e1a2d3c4b5a"
}

下一步

• 阅读 基本信息，了解 URL 前缀、Symbol 格式、默认报价资产、枚举 UPPERCASE 契约。
• 阅读 通用枚举定义，查看完整的枚举值集合（side / orderType / orderStatus / tradingSession 等）。
• 阅读 错误代码，了解本模块的错误码层次。