binance_get_allocations
Retrieve per-symbol Smart Order Routing (SOR) fills for a specific order, including price, quantity, and commission, with optional 24-hour time or order ID filtering.
Instructions
List Smart Order Routing (SOR) allocations — the per-symbol fills behind an SOR order.
Calls GET /api/v3/myAllocations (SIGNED, USER_DATA). IP weight 20 per call.
When to Use:
To see how an SOR order (
binance_place_sor_order) was actually filled across symbols, with per-allocation price/qty/commission.To page through allocations for a specific order via
order_id.
When NOT to Use:
For regular (non-SOR) trade fills — use
binance_get_my_trades.
Returns:
A markdown list (or JSON) of allocations: allocationId, orderId/orderListId,
symbol, side (isBuyer), qty/price/quoteQty (via fmt_num), commission +
commissionAsset, maker/allocator flags, and time. Display is capped at
MAX_DISPLAY_ROWS (50); JSON mode returns {count, truncated, displayLimit, items} rather than a bare array, so truncation stays valid JSON.
Windows:
start_time/end_time (epoch ms or ISO-8601) accept a span of at most 24 h
— enforced locally with a readable Error: before the call reaches Binance,
since Binance would otherwise answer -1127.
Examples: params = {"symbol": "BTCUSDT"} params = {"symbol": "BTCUSDT", "start_time": "2024-01-01T00:00:00Z", "end_time": "2024-01-01T12:00:00Z"} params = {"symbol": "BTCUSDT", "order_id": 12345}
Error Handling: -1127 means the requested window is too wide (should not happen — the 24 h cap is enforced before the request). -1121 means an invalid symbol.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |