Skip to main content

Get balance by wallet, token, and block number or timestamp.

GET 
/:network/balance/single

Get balance by wallet, token, and block number or timestamp.

Request​

Path Parameters

    network stringrequired

    Blockchain network name or chain id

Query Parameters

    holder stringrequired

    The wallet address or ENS name of the user.

    token_address stringrequired

    The unique identifier (contract address) of the token.

    block_height number

    Optional block number for which the balance is requested. Provide only block height or timestamp you want to check for.

    date string

    Optional Date timestamp for which the balance is requested (ISO 8601 format). Provide only block height or timestamp you want to check for.

    projectId stringrequired

    The id of your project. Can be found in your Histori dashboard.

Responses​

The balance data for a specific block or timestamp.

Schema

    network_name stringrequired

    Blockchain network name For the requested query

    chain_id numberrequired

    The chain ID of the network.

    token_address stringrequired

    The contract address of the token in hexadecimal format.

    token_name stringrequired

    The name of the token.

    token_symbol stringrequired

    The symbol of the token.

    token_type stringrequired

    The ERC standard of the Token (erc20 or erc777)

    holder stringrequired

    The address of the token holder.

    balance stringrequired

    The balance amount of the holder for the token in wei.

    balance_eth stringrequired

    The balance amount of the holder for the token denominated in ether.

    checked_at_block numberrequired

    The block number for which the balance is requested.

    checked_at_date stringrequired

    Timestamp for which the balance is queried (ISO 8601 format).

Loading...