Skip to main content
GET
GET /v1/wallet/equity/history · 5 credits Total wallet value (USD) as a time series over a chosen window - the equity curve behind every portfolio chart.
currentValueUsd is the latest total value; points is the equity curve (at in ms, valueUsd), its last point being the current value. from and to are rounded down to the minute; meta.asOf is the moment the curve was computed.

Window and point spacing

  • Without from: the last 30 days. A window is at most 90 days: a longer one returns its last 90 days.
  • Point spacing follows the window length:
  • meta.historyFrom (ms) is the first instant the curve covers. When from is earlier, the curve starts at historyFrom.

Limits

A wallet that touched more than 10,000 tokens over the window (held at the start, or moved inside it) answers 422 TOO_MUCH_DATA with details.what: "tokens", details.count and details.limit: the curve of such a bot is not computed in one call. Ask for a shorter window. The call is not billed. See Errors.

Authorizations

Authorization
string
header
required

Your raw API key (not needed on the demo server).

Query Parameters

chain
string
required

Public chain id - evm:<id> or solana.

wallet
string
required

Wallet address.

from
integer

Unix MILLISECONDS, default 30 days before to. A value in seconds is rejected (400).

Required range: x >= 0
to
integer

Unix MILLISECONDS, default now. A value in seconds is rejected (400).

Required range: x >= 0

Response

200

Standard { data, meta } envelope.