Quick Start

Prerequisites

1. A Binance account with SAPI access. If you don't have one, start at the root Quick Start.
2. An API key + secret with Enable Trading permission for the endpoints that require TRADE authority; USER_DATA permission suffices for query-only endpoints.

Sign a Request

All trade endpoints require an HMAC-SHA256 or Ed25519 signature over the query string, identical to other SAPI endpoints. See the root General Info for the signing procedure.

Place a Limit Buy Order (curl example)

Code
BASE_URL="https://api.binance.com"
API_KEY="<your api key>"
SECRET="<your 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}"

Sample response:

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

Next Steps

• Read General Info for URL prefix, symbol format, default quote asset, and the UPPERCASE enum contract.
• Read Common Definition for the full enum sets (side / orderType / orderStatus / tradingSession / …).
• Read Error Code for how errors from this module are structured.