Skip to content

Latest commit

 

History

History
236 lines (207 loc) · 5.33 KB

TRADING_QUICK_REF.md

File metadata and controls

236 lines (207 loc) · 5.33 KB

Quick Reference: Binance.US Trading Tools

Fast reference for all trading tools with minimal examples.

Standard Orders

Place Order

binance_us_new_order
├── symbol: "BTCUSDT" (required)
├── side: "BUY" | "SELL" (required)
├── type: "LIMIT" | "MARKET" | "STOP_LOSS" | "STOP_LOSS_LIMIT" | "TAKE_PROFIT" | "TAKE_PROFIT_LIMIT" | "LIMIT_MAKER"
├── quantity: 0.001
├── price: 50000 (for LIMIT)
├── stopPrice: 48000 (for STOP_* types)
├── timeInForce: "GTC" | "IOC" | "FOK"
├── quoteOrderQty: 100 (alternative to quantity for MARKET)
├── newClientOrderId: "myOrder1"
├── selfTradePreventionMode: "EXPIRE_TAKER" | "EXPIRE_MAKER" | "EXPIRE_BOTH" | "NONE"
└── recvWindow: 5000

Test Order (No Execution)

binance_us_test_order
└── (same params as new_order)

Get Order Status

binance_us_get_order
├── symbol: "BTCUSDT" (required)
├── orderId: 123456 (one required)
├── origClientOrderId: "myOrder1" (one required)
└── recvWindow: 5000

Cancel Order

binance_us_cancel_order
├── symbol: "BTCUSDT" (required)
├── orderId: 123456 (one required)
├── origClientOrderId: "myOrder1" (one required)
├── newClientOrderId: "cancelOrder1"
└── recvWindow: 5000

Cancel & Replace (Atomic)

binance_us_cancel_replace
├── symbol: "BTCUSDT" (required)
├── side: "BUY" | "SELL" (required)
├── type: "LIMIT" | "MARKET" | etc.
├── cancelReplaceMode: "STOP_ON_FAILURE" | "ALLOW_FAILURE"
├── cancelOrderId: 123456 (one required)
├── cancelOrigClientOrderId: "oldOrder" (one required)
├── quantity: 0.002
├── price: 51000
└── timeInForce: "GTC"

Cancel All Open Orders

binance_us_cancel_all_open_orders
├── symbol: "BTCUSDT" (required)
└── recvWindow: 5000

List Open Orders

binance_us_open_orders
├── symbol: "BTCUSDT" (optional, omit for all symbols)
└── recvWindow: 5000

Query Order History

binance_us_all_orders
├── symbol: "BTCUSDT" (required)
├── orderId: 100000 (start from this ID)
├── startTime: 1704067200000
├── endTime: 1704153600000
├── limit: 500 (max 1000)
└── recvWindow: 5000

OCO Orders

Place OCO

binance_us_new_oco
├── symbol: "BTCUSDT" (required)
├── side: "BUY" | "SELL" (required)
├── quantity: 0.001 (required)
├── price: 55000 (limit price, required)
├── stopPrice: 48000 (stop trigger, required)
├── stopLimitPrice: 47900 (limit after stop)
├── stopLimitTimeInForce: "GTC" | "IOC" | "FOK"
├── listClientOrderId: "myOco1"
├── limitClientOrderId: "myLimitOrder"
├── stopClientOrderId: "myStopOrder"
└── recvWindow: 5000

Get OCO Status

binance_us_get_oco
├── orderListId: 12345 (one required)
├── origClientOrderId: "myOco1" (one required)
└── recvWindow: 5000

Cancel OCO

binance_us_cancel_oco
├── symbol: "BTCUSDT" (required)
├── orderListId: 12345 (one required)
├── listClientOrderId: "myOco1" (one required)
├── newClientOrderId: "cancelOco1"
└── recvWindow: 5000

List Open OCOs

binance_us_open_oco
└── recvWindow: 5000

Query OCO History

binance_us_all_oco_orders
├── fromId: 10000 (start from this list ID)
├── startTime: 1704067200000
├── endTime: 1704153600000
├── limit: 500 (max 1000)
└── recvWindow: 5000

Quick Examples

Buy $100 of BTC at Market

binance_us_new_order
  symbol: "BTCUSDT"
  side: "BUY"
  type: "MARKET"
  quoteOrderQty: 100

Sell 0.01 BTC with Limit

binance_us_new_order
  symbol: "BTCUSDT"
  side: "SELL"
  type: "LIMIT"
  quantity: 0.01
  price: 55000
  timeInForce: "GTC"

Set Stop-Loss at $48,000

binance_us_new_order
  symbol: "BTCUSDT"
  side: "SELL"
  type: "STOP_LOSS"
  quantity: 0.01
  stopPrice: 48000

Bracket Order (OCO)

Sell at $55k (take profit) or $48k (stop loss):

binance_us_new_oco
  symbol: "BTCUSDT"
  side: "SELL"
  quantity: 0.01
  price: 55000
  stopPrice: 48000
  stopLimitPrice: 47900
  stopLimitTimeInForce: "GTC"

Check and Cancel if Unfilled

1. binance_us_get_order
     symbol: "BTCUSDT"
     orderId: 123456
   
2. If status != "FILLED":
   binance_us_cancel_order
     symbol: "BTCUSDT"
     orderId: 123456

Modify Order Price

binance_us_cancel_replace
  symbol: "BTCUSDT"
  side: "BUY"
  type: "LIMIT"
  cancelReplaceMode: "STOP_ON_FAILURE"
  cancelOrderId: 123456
  quantity: 0.01
  price: 49500
  timeInForce: "GTC"

Emergency: Cancel Everything

binance_us_cancel_all_open_orders
  symbol: "BTCUSDT"

Order Status Values

Status Meaning
NEW Accepted, awaiting fill
PARTIALLY_FILLED Partially executed
FILLED Completely executed
CANCELED Canceled by user
PENDING_CANCEL Cancel in progress
REJECTED Order rejected
EXPIRED TimeInForce expired

Common Errors & Fixes

Error Fix
-1121 Invalid symbol Use uppercase: BTCUSDT
-2010 Order rejected Check balance, quantity
-2011 Cancel rejected Already filled
-2013 Order not found Check orderId
-1022 Invalid signature Check API secret
-9003 MIN_NOTIONAL Order too small ($10 min)