Docs
⌘ K

Historical Balances

GET/historical/balances/evm/{address}

Provides historical ERC-20 & Native balances by wallet address.

Path Parameters

ParameterDescriptionValue
address
string

Filter by address

    		Required

    Query Parameters

    ParameterDescriptionValue
    network_id
    string

    The Graph Network ID for EVM networks https://thegraph.com/networks

    • Default value: mainnet
    • Accepted values: arbitrum-one, avalanche, base, bsc, mainnet, matic, optimism, unichain
    		Required
    mainnet
    interval

    The interval for which to aggregate price data (hourly, 4-hours, daily or weekly).

      contracts
      array
      • Default value:
      startTime
      integer

      UNIX timestamp in seconds.

      • Default value: 1735689600
      • Minimum value: -9007199254740991
      • Maximum value: 9007199254740991
      endTime
      integer

      UNIX timestamp in seconds.

      • Default value: 9999999999
      • Minimum value: -9007199254740991
      • Maximum value: 9007199254740991
      limit
      integer

      The maximum number of items returned in a single request.

      • Default value: 10
      • Minimum value: 1
      • Maximum value: 1000
      page
      integer

      The page number of the results to return.

      • Default value: 1
      • Minimum value: 1
      • Maximum value: 767465558638

      Potential Responses

      StatusDescription
      200Successful Response
      400Client side error
      401Authentication failed
      403Forbidden
      404Not found
      500Server side error