Skip to main content

Get Account Token Balances

GET 
/api/v1/accounts/balances/historical

Free [3 Credits]

Get Account Token Balances


Request​

Query Parameters

    tokenType stringrequired

    Token type: 'KAIA' for native Kaia token, 'TOKEN' for ERC-20 token

    contractAddress string

    ERC-20 token contract address (required when tokenType is 'TOKEN')

    accountAddress stringrequired

    Account address to check balance

    filterType stringrequired

    Filter by 'date' or 'blockNumber'

    date string

    Date for the snapshot (MM/dd/yyyy format, e.g., 12/03/2025). Required when filterType is 'date'

    blockNumber int64

    Block number for the snapshot. Required when filterType is 'blockNumber'

Responses​

OK

Schema

    result

    object

    required

    account_address Account Address (string)required
    block_number int64required
    balance Balance (string)required
    token_name Token Name (string)required
    token_symbol Token Symbol (string)required
    token_logo Token Logo (string)required
    contract_address Contract Address (string)required
    snapshot_date Snapshot Date (MM/dd/yyyy) (string)required
Loading...