binance_get_transfer_history
List past Binance wallet transfers in one direction (e.g., Spot to Funding) to reconcile balances or trace Funding-wallet activity. Specify the transfer type to see history.
Instructions
List past transfers between the account's own wallets, one direction at a time.
Calls GET /sapi/v1/asset/transfer (SIGNED, IP weight 1). Unlike the POST that
performs a transfer, this read does not need the key's "Permits Universal
Transfer" flag.
type is mandatory and Binance offers no "all directions" value: MAIN_FUNDING and
FUNDING_MAIN are two separate queries, so a full Spot⇄Funding picture costs two
calls. MAIN_FUNDING / FUNDING_MAIN is also the closest proxy to a Binance Card
top-up log, since the card was funded out of the Funding wallet.
When to Use:
To reconcile where a balance went between wallets.
To reconstruct Funding-wallet activity that Pay/fiat history does not explain.
When NOT to Use:
For deposits/withdrawals to and from other platforms — use
binance_get_deposit_history/binance_get_withdraw_history(wallet_capital.py).To perform a transfer — that is
binance_transfer_between_wallets.
Returns:
Binance's {total, rows} rendered as a markdown table of time / asset / amount /
type / status / tranId, with the page position and the per-asset totals of the rows
shown, or the raw envelope with response_format="json".
Pagination:
page → Binance's current (1-based), limit → Binance's size (max 100, Binance
default 10). total in the response is the full count for the filter, so
page * limit < total means there is more.
Windows:
Binance "supports query within the last 6 months only" and defaults to the last 7
days when start_time/end_time are omitted — so an empty result with no window
given usually means "nothing in the last week", not "never". Pass start_time to
look further back.
Examples: params = {"type": "MAIN_FUNDING"} params = {"type": "FUNDING_MAIN", "start_time": "2026-03-01", "limit": 100}
Error Handling: -2015 means the key lacks Reading permission or this IP is not allowlisted. Dates more than 6 months old simply return nothing.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |