binance_get_asset_dividends
List airdrops, rebates, and interest credited to your Binance account to explain balance increases that did not come from trades.
Instructions
List asset distributions credited to the account (airdrops, rebates, interest).
Calls GET /sapi/v1/asset/assetDividend (SIGNED, IP weight 10). This is Binance's
"asset dividend record": savings interest, BNB fee rebates, airdrops, referral
payouts and similar credits, each with the reason in enInfo.
When to Use:
To explain a balance that grew without a trade or a deposit.
To total up rebates/airdrops over a period.
When NOT to Use:
For Simple Earn positions and their APR — use the earn tools (simple_earn.py).
For trades — use
binance_get_my_trades(trade_history.py).
Returns:
A markdown table of time / asset / amount / description / tranId, capped at 50 rows,
plus per-asset totals of the rows shown, or the raw envelope with
response_format="json".
Windows:
start_time..end_time must span at most 180 days — Binance rejects anything
wider, and this is checked locally before the call. Omit both for Binance's own
default window.
Examples: params = {"asset": "BNB", "limit": 100} params = {"start_time": "2026-01-01", "end_time": "2026-06-01"}
Error Handling:
A window wider than 180 days is rejected locally with an Error: naming the cap,
instead of round-tripping to Binance. -2015 means the key lacks Reading permission
or this IP is not allowlisted.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |