Features

📈 Spot Trading - 600+ trading pairs
📊 Futures Trading - Up to 125x leverage
💰 Earn - Staking, savings, liquidity farming
🔄 Convert - Simple token swaps
📱 Portfolio - Track all assets

API Base URLs

Spot: https://api.binance.com
Futures: https://fapi.binance.com
Testnet: https://testnet.binance.vision

Authentication

API_KEY="${BINANCE_API_KEY}"
SECRET="${BINANCE_SECRET}"

# Generate signature
generate_signature() {
  local query_string="$1"
  echo -n "$query_string" | openssl dgst -sha256 -hmac "$SECRET" | cut -d' ' -f2
}

TIMESTAMP=$(date +%s%3N)

Get Account Info

QUERY="timestamp=${TIMESTAMP}"
SIGNATURE=$(generate_signature "$QUERY")

curl -s "https://api.binance.com/api/v3/account?${QUERY}&signature=${SIGNATURE}" \
  -H "X-MBX-APIKEY: ${API_KEY}" | jq '{
    balances: [.balances[] | select(.free != "0.00000000" or .locked != "0.00000000")]
  }'

Get Price

SYMBOL="BTCUSDT"

curl -s "https://api.binance.com/api/v3/ticker/price?symbol=${SYMBOL}" | jq '.'

Get Order Book

curl -s "https://api.binance.com/api/v3/depth?symbol=${SYMBOL}&limit=10" | jq '{
  bids: .bids[:5],
  asks: .asks[:5]
}'

Place Spot Order

SYMBOL="BTCUSDT"
SIDE="BUY"  # BUY or SELL
TYPE="LIMIT"  # LIMIT, MARKET, STOP_LOSS, etc.
QUANTITY="0.001"
PRICE="40000"

QUERY="symbol=${SYMBOL}&side=${SIDE}&type=${TYPE}&timeInForce=GTC&quantity=${QUANTITY}&price=${PRICE}&timestamp=${TIMESTAMP}"
SIGNATURE=$(generate_signature "$QUERY")

curl -s -X POST "https://api.binance.com/api/v3/order?${QUERY}&signature=${SIGNATURE}" \
  -H "X-MBX-APIKEY: ${API_KEY}" | jq '.'

Place Market Order

SYMBOL="ETHUSDT"
SIDE="BUY"
QUANTITY="0.1"

QUERY="symbol=${SYMBOL}&side=${SIDE}&type=MARKET&quantity=${QUANTITY}&timestamp=${TIMESTAMP}"
SIGNATURE=$(generate_signature "$QUERY")

curl -s -X POST "https://api.binance.com/api/v3/order?${QUERY}&signature=${SIGNATURE}" \
  -H "X-MBX-APIKEY: ${API_KEY}" | jq '.'

Get Open Orders

QUERY="timestamp=${TIMESTAMP}"
SIGNATURE=$(generate_signature "$QUERY")

curl -s "https://api.binance.com/api/v3/openOrders?${QUERY}&signature=${SIGNATURE}" \
  -H "X-MBX-APIKEY: ${API_KEY}" | jq '.[] | {symbol: .symbol, side: .side, price: .price, quantity: .origQty, status: .status}'

Cancel Order

SYMBOL="BTCUSDT"
ORDER_ID="12345678"

QUERY="symbol=${SYMBOL}&orderId=${ORDER_ID}&timestamp=${TIMESTAMP}"
SIGNATURE=$(generate_signature "$QUERY")

curl -s -X DELETE "https://api.binance.com/api/v3/order?${QUERY}&signature=${SIGNATURE}" \
  -H "X-MBX-APIKEY: ${API_KEY}" | jq '.'

Get Trade History

SYMBOL="BTCUSDT"

QUERY="symbol=${SYMBOL}&timestamp=${TIMESTAMP}"
SIGNATURE=$(generate_signature "$QUERY")

curl -s "https://api.binance.com/api/v3/myTrades?${QUERY}&signature=${SIGNATURE}" \
  -H "X-MBX-APIKEY: ${API_KEY}" | jq '.[-10:] | .[] | {symbol: .symbol, price: .price, qty: .qty, time: .time}'

Futures: Get Position

QUERY="timestamp=${TIMESTAMP}"
SIGNATURE=$(generate_signature "$QUERY")

curl -s "https://fapi.binance.com/fapi/v2/positionRisk?${QUERY}&signature=${SIGNATURE}" \
  -H "X-MBX-APIKEY: ${API_KEY}" | jq '.[] | select(.positionAmt != "0") | {symbol: .symbol, positionAmt: .positionAmt, entryPrice: .entryPrice, unrealizedProfit: .unRealizedProfit}'

Convert (Simple Swap)

FROM_ASSET="USDT"
TO_ASSET="BTC"
FROM_AMOUNT="100"

# Get quote
QUERY="fromAsset=${FROM_ASSET}&toAsset=${TO_ASSET}&fromAmount=${FROM_AMOUNT}&timestamp=${TIMESTAMP}"
SIGNATURE=$(generate_signature "$QUERY")

curl -s -X POST "https://api.binance.com/sapi/v1/convert/getQuote?${QUERY}&signature=${SIGNATURE}" \
  -H "X-MBX-APIKEY: ${API_KEY}" | jq '.'

Popular Trading Pairs

Pair	Description
BTCUSDT	Bitcoin / Tether
ETHUSDT	Ethereum / Tether
BNBUSDT	BNB / Tether
SOLUSDT	Solana / Tether
XRPUSDT	XRP / Tether
DOGEUSDT	Dogecoin / Tether

Order Types

Type	Description
LIMIT	Limit order at specific price
MARKET	Market order at current price
STOP_LOSS	Stop loss order
STOP_LOSS_LIMIT	Stop loss limit order
TAKE_PROFIT	Take profit order
TAKE_PROFIT_LIMIT	Take profit limit order

Safety Rules

ALWAYS display order details before execution
VERIFY trading pair and amount
CHECK account balance before trading
WARN about leverage risks in futures
NEVER execute without user confirmation

Error Handling

Error	Cause	Solution
`-1013`	Invalid quantity	Check lot size filters
`-2010`	Insufficient balance	Check account balance
`-1021`	Timestamp outside recvWindow	Sync system time

Features

API Base URLs

Authentication

Get Account Info

Get Price

Get Order Book

Place Spot Order

Place Market Order

Get Open Orders

Cancel Order

Get Trade History

Futures: Get Position

Convert (Simple Swap)

Popular Trading Pairs

Order Types

Safety Rules

Error Handling

Links

Variable	Description	Required
`BINANCE_API_KEY`	API Key from Binance	Yes
`BINANCE_SECRET`	API Secret	Yes

binance

Binance 🟡

Environment Variables

💎 Referral Configuration