Skip to main content
GET
Get Token Economic History
For a stablecoin or RWA (USDC, USDT, PYUSD, DAI, tokenized treasuries, gold), this endpoint omits peg and structural risk. Use RWA Risk (v3) for structural health and the Depeg Monitor for peg deviation instead.

Authorizations

x-api-key
string
header
required

Path Parameters

tokenAddress
string
required

Address of the token to analyze

Query Parameters

chain
enum<string>
required

Blockchain network of the token. Supported chains for token analysis include Ethereum, Base, Binance Smart Chain, Polygon, Optimism, Arbitrum, and Solana Blockchain networks supported for token analysis, pools, and market data operations via CoinGecko integration.

Available options:
eth,
base,
bsc,
pol,
opt,
arb,
sol,
sei,
btc,
sui
metrics-date
string
required

The specific date for which to retrieve token metrics data in DD-MM-YYYY format

Response

Success - Returns token economics data, risk analysis, and metadata for the specified date

Audit-trail fields on risk responses: which check this was, when it was served, and how fresh the data is.

metrics
object
required

Historical market data for the specified date

risk
object
required

Risk assessment data for the token

check_id
string<uuid>
required

Id of this check. Same value as the X-Request-Id response header. Keep it with the result as an audit reference.

Example:

"3f1c2b9e-7a4d-4e1b-9c55-0d6a2f8e4b71"

checked_at
string<date-time>
required

When this response was served (ISO 8601, UTC). A cached result is served now, so this is the time of your request.

Example:

"2026-11-03T14:02:11.482Z"

data_as_of
string<date-time> | null
required

When the result was computed (ISO 8601, UTC). Earlier than checked_at when the result came from cache. null when the compute time is unknown, for example on a pending (202) answer.

Example:

"2026-11-02T09:30:00.000Z"

metadata
object

Token metadata information including name, symbol, links, and other details