Tokens

Changed on

Get historical price snapshots for a token, newest first. Resolve by symbol (optionally scoped to a chainId) or by exact chainId+address. Snapshots are stored on change, so pass fill=carry-forward for one row per day of the range.

get/v4/tokens/prices/history

Request

  • Base URL: https://api.merkl.xyz (the document declares no server; this is the origin it was published from)
  • URL: https://api.merkl.xyz/v4/tokens/prices/history
  • Auth: apiKey (a scheme the document does not define)

Query parameters

symbolstring

Token symbol (case-insensitive). Matches symbol or displaySymbol.

addressstring

Token address. Requires chainId for a unique result.

string numeric
OR
number

Chain ID. Required alongside address for a unique result; optional when using symbol.

string integer
OR
integer

Start day as Unix day integer (days since 1970-01-01 UTC). Defaults to today - 365 days.

string integer
OR
integer

End day as Unix day integer (days since 1970-01-01 UTC). Defaults to today UTC.

fillstring

Emit one row per day of the range, each carrying the newest price at or before it (anchored on the last row before from). Snapshots are stored on change only, so an absent day means 'unchanged' — use this to average or plot a range without re-deriving that. Days before the token's first snapshot stay absent.

Response

Response for status 200

opennumber required
closenumber required
minnumber required
maxnumber required
avgnumber nullable required

Mean of the day's samples. Null for a row written before grains.

sourcestring nullable required

Changes

  • c51d2a5209b9Revision changes
    • info

      added the new optional query request parameter fill

    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status