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", ...).

    • Default value: 2015-01-01
    end_time
    string

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

    • Default value: 2050-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