ASasksurf
Token

Token Unlock Schedule

Returns token unlock time-series with cumulative amounts, allocation breakdowns, total supply denominator, and unlocked-supply percentage.

Lookup: by project UUID (id) or token symbol. Filter by date range with from/to — defaults to the current calendar month when omitted.

Important: unlock_amount is a legacy alias for cumulative_unlocked_amount; it is already cumulative at each timestamp and must not be summed across rows. Use unlocked_percentage_of_total_supply for the unlock ratio.

Returns 404 if no token found.

get/gateway/v1/token/tokenomics

Request

  • Base URL
    https://api.asksurf.ai
  • Auth
    HTTP bearer

Query parameters

idstring

Surf project UUID. PREFERRED — always use this when available from a previous response. Takes priority over symbol.

Example:25c6612a-395c-4974-94eb-3b5f9f4b2ed7
symbolstring

Token symbol like ARB, OP, or APT

Example:ARB
fromstring

Start of time range. Accepts Unix seconds (1704067200) or date string (2024-01-01)

Example:2024-01-01
tostring

End of time range. Accepts Unix seconds (1735689600) or date string (2025-01-01)

Example:2025-01-01

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

Example response

{
  "$schema": "https://example.com/schemas/DataResponseTokenUnlockPoint.json"
}

Changes

No recorded changes to this operation across all 12 revisions of this API.