Parameters
Only return balances at or above this value, in the same raw units as
balance. The default includes balances that have dropped to zero. Set min_balance=1 to leave them out.Return the latest balance Goldsky recorded at or before this Polygon block. It isn’t an exact reconstruction of the chain at that block: events Goldsky processed late or out of order may not be reflected.
block_timestamp_desc, most recently changed first, or balance_desc, largest first. Ties are broken by token_id, ascending.Rows per page, up to
500. See pagination.Response
How the data behaves
- A balance isn’t a position.
balanceis what the wallet holds onchain. Positions returns the net position from trades, which can differ, because splits, merges, redeems, and plain transfers move tokens without a trade. - Balances are raw strings. Divide
balanceby 1,000,000 before you show it. - Caching follows the block. Responses carry
Cache-Control: public, max-age=2. Withas_of_block, they carrypublic, max-age=86400, immutable.
Errors
This endpoint returns the same errors as the other feeds. It returns400 BAD_REQUEST when address is missing, when address or contract_address isn’t 40 hex characters, when sort isn’t one of the values above, or when cursor was issued for a different sort.