Docs
⌘ K

Historical Native Balances

GET/v1/evm/balances/historical/native

Returns wallet Native balance changes over time in OHLCV format.

OHLCV historical depth is subject to plan restrictions.

Query Parameters

ParameterDescriptionValue
network
string

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

  • Accepted values: arbitrum-one, avalanche, base, bsc, mainnet, optimism, polygon, unichain
Required
mainnet
address
string

Filter by address

    		Required
    interval
    string

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

    • Default value: 1d
    • Accepted values: 1h, 4h, 1d, 1w
    1d
    start_time
    string

    UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).

      end_time
      string

      UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).

        limit
        integer

        Number of items* returned in a single request.
        *Plan restricted.

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

        Page number to fetch.
        Empty data array signifies end of results.

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

        Potential Responses

        StatusDescription
        200

        Successful Response

        400

        Client side error

        401

        Authentication failed

        403

        Forbidden

        404

        Not found

        500

        Server side error