Token market
Returns a lightweight, uncached market snapshot for commit-time checks.
GET /v1/agent/token/{address}/market · Price: $0.005
Inputs
| Name | In | Required | Values |
|---|---|---|---|
address | Path | Yes | EVM address (0x plus 40 hexadecimal characters) |
chain | Query | No | base (default), robinhood, ethereum |
Response
| Field | Description |
|---|---|
chain, token_address | Requested market. |
fdv_usd, price_usd, liquidity_usd | Current values when fresh evidence exists. |
observed_at, data_freshness_ms | Timestamp and age of the evidence used. |
source | token_state, score_snapshot, computed_fallback, or unavailable. |
market_path | Bounded FDV history with classification, coverage, summary metrics, and timestamped points. |
This endpoint bypasses the response cache used by deeper analysis. It prefers coherent live evidence, may fill missing values from a fresh durable snapshot, and does not reuse stale market values. A known token can therefore return null market fields with source: "unavailable"; an unknown token returns 404. market_path can be null where the selected market cannot be represented by the standard path model.