Get series

Address · Reads onchain state

Returns time series for an address: price candles, balance history, and portfolio value over time, bucketed for charting. Which groups a bucket carries follows what was asked for, so the same surface serves a price chart, a balance sparkline, or a full portfolio curve. Values arrive in the units the display layer expects, with the bucketing already done server side. Reach for it any time a number needs to become a line: charting a holding, showing portfolio drift, or feeding a strategy the recent history of what it manages.

Send a request

Response

{
    links: {
        self: string
        prev: string | undefined
        next: string | undefined
    } | undefined
    headers: unknown | undefined
    data: ({
        timestamp: number
        balance: {
            int: string | undefined
            float: string | undefined
            value: string | undefined
        } | undefined
        price: {
            open: string | undefined
            high: string | undefined
            low: string | undefined
            close: string | undefined
            change: string | undefined
        } | undefined
        position: {
            deposit_value: string | undefined
            debt_value: string | undefined
            assets: Record<string, Record<string, string>> | undefined
        } | undefined
        portfolio: {
            value: string | undefined
        } | undefined
    })[] | null
}

Code samples

Language

Prompt

Call the Plug API endpoint "Get series".

## Endpoint
GET /address/{address}/history
Base URL: https://api.plug.to

## Description
Returns time series for an address: price candles, balance history, and portfolio value over time, bucketed for charting.

Which groups a bucket carries follows what was asked for, so the same surface serves a price chart, a balance sparkline, or a full portfolio curve. Values arrive in the units the display layer expects, with the bucketing already done server side.

Reach for it any time a number needs to become a line: charting a holding, showing portfolio drift, or feeding a strategy the recent history of what it manages.

## Path Parameters
- address (string, required) — The EVM address to get information for. In the case that you request an address we have never indexed, we will immediately index it.
  Current value: 0x62180042606624f02d8a130da8a3171e9b33894d

## Query Parameters
- filter[address] (string, optional) — Token or contract address for token/collectible history.
- filter[token_id] (string, optional) — Token ID for collectible history.
- filter[chain_id] (integer, optional) — Chain ID to query. Defaults to mainnet.
- time[before] (integer, optional) — Upper bound unix timestamp for the time window.
- time[from] (integer, optional) — Start unix timestamp. Defaults to 24h before to.
- time[to] (integer, optional) — End unix timestamp. Defaults to now.
- time[resolution] (string, optional) — Time bucket resolution (e.g., 1h, 1d, all). Auto-selected if omitted.
- sort[direction] (string, optional) — Sort direction for results. [asc, desc]
- limit[count] (integer, optional) — Maximum number of results to return (max 500).
- limit[offset] (integer, optional) — Number of results to skip for pagination.

## Headers
- Accept (string, required) — For a typical single-time JSON response, set this to application/json. To receive realtime updates through a stream, set this to text/event-stream. (default: application/json) [application/json, text/event-stream]
  Current value: application/json

## Response Schema
- links (object, optional)
  - self (string, required)
  - prev (string, optional)
  - next (string, optional)
- headers (unknown, optional)
- data (array
  - timestamp (integer, required)
  - balance (object, optional)
    - int (string, optional) — Raw balance in base units.
    - float (string, optional) — Balance scaled by the token's decimals.
    - value (string, optional) — Balance valued in USD.
  - price (object, optional)
    - open (string, optional)
    - high (string, optional)
    - low (string, optional)
    - close (string, optional)
    - change (string, optional)
  - position (object, optional)
    - deposit_value (string, optional) — USD value supplied to the position.
    - debt_value (string, optional) — USD value borrowed against it.
    - assets (Record<string, Record<string, string>>, optional) — Per-asset attributes keyed by asset address.
  - portfolio (object, optional)
    - value (string, optional) — Total portfolio value in USD., optional)

## Example Request
GET https://api.plug.to/address/0x62180042606624f02d8a130da8a3171e9b33894d/history

Get activity

Get context

Back