binance_get_my_trades
Retrieve your executed spot trades (fills) for a single trading pair, with optional filtering by order, time range, or trade ID. See exact price, quantity, fees, and your buy/sell side.
Instructions
Fetch YOUR executed trades (fills) for one symbol.
Calls GET /api/v3/myTrades (signed; IP weight 20, or 5 when order_id is
given). symbol is mandatory — Binance has no endpoint that returns trades across
every symbol, which is what binance_get_all_my_trades exists to work around.
Unlike the public trade endpoints, isBuyer here is your own side of the fill
(public trades expose isBuyerMaker, the aggressor's side, instead).
When to Use:
To see the fills of one pair, or of one order (
order_id).To check the exact price, fee and fee asset of a known trade.
When NOT to Use:
For the whole account's history — use
binance_get_all_my_trades.For orders that never filled — use
binance_get_all_orders(spot_orders).For anonymous market trades — use
binance_get_recent_trades(market_data).
Returns: Markdown: a table of up to 100 fills (time, side, price, qty, quote qty, commission, maker/taker) plus totals for the page — bought/sold base and quote, and fees broken down by fee asset. JSON: the full page plus the same totals.
Pagination / Windows:
Binance accepts only these combinations: symbol; symbol+order_id;
symbol+from_id; symbol+start_time; symbol+end_time;
symbol+start_time+end_time; symbol+order_id+from_id. start_time and
end_time are each legal on their own — only together do they have to span at
most 24 hours, and a wider window is rejected here with no call spent. To page,
re-call with from_id = the last id + 1.
Examples: params = {"symbol": "BTCUSDT", "limit": 100} params = {"symbol": "BTCUSDT", "order_id": 987654321} params = {"symbol": "ETHUSDT", "start_time": "2024-01-01T00:00:00Z", "end_time": "2024-01-01T23:59:59Z"} params = {"symbol": "ETHUSDT", "from_id": 4211999}
Error Handling:
An over-wide window or an illegal combination is refused locally with an Error: …
string and no API call. -2015 means the key lacks Reading or the IP is not
allowlisted; -1121 means the symbol does not exist.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |