Crypto assets
Crypto asset metadata and supply; trading pairs remain separate instruments with base/quote IDs. One row per coin with a profile (name, links, supply, market capitalization, and for tokens their network and contract): one source's supply and market capitalization are read daily for every coin it prices (about nine in ten listed pairs), the other's profile of the leading coins weekly, and the newest observation is served, with market_cap and fully_diluted_market_cap carried to the latest daily close in between. A pair whose coin neither source profiles is in /v1/tickers and /v1/eod but not here. Default order: id ascending. Omitting entity selectors returns the entitled universe; explicit unauthorized selectors return 403. Data is delivered from validated canonical batches; a connected dataset with nothing published for the key's markets yet returns 503. Access requires the operation capability on the API key.
/v1/crypto/assets- Required capability
- crypto.read
- Data timing
- As published by the source
- Credits
- 5 credits per request.
Parameters
instrument_idsstringoptional · query- Crypto asset IDs: a coin's ID, which is a pair's base_instrument_id; a pair's own instrument_id matches no row.
effective_datestringoptional · query- Effective date, defaults to the UTC date of as_of. Returns the latest eligible snapshot on or before this date; response retains its actual snapshot date.
as_ofstringoptional · query- Knowledge cutoff as a UTC date (YYYY-MM-DD): the response reflects what was known by the end of that day. Defaults to now; cannot be in the future. A date from before the dataset's knowledge history returns 422 point-in-time-unavailable naming the earliest one, which GET /v1/datasets lists as earliest_as_of.
known_fromstringoptional · query- First UTC date (YYYY-MM-DD, inclusive) on which a revision became known.
known_tostringoptional · query- Last UTC date (YYYY-MM-DD, inclusive) on which a revision became known; on or after known_from.
orderstringoptional · query- Direction on id; ties use ID ascending.
Default:ascdescasc limitintegeroptional · query- Maximum records per page.Default:
100 cursorstringoptional · query- Opaque cursor, expires after one hour; binds filters, order, resolved as_of, account/key and entitlement. Repeat the original query unchanged.
formatstringoptional · query- Response format. csv returns the data rows with a header row, for spreadsheet functions such as IMPORTDATA; nested fields become dotted columns and lists one JSON array cell, the next page cursor is returned in X-Next-Cursor and meta.errors in X-Meta-Errors. A result without rows is the header row alone, listing the documented fields of a row. Default json, or csv when format is omitted and the Accept header ranks text/csv above JSON; a format the Accept header does not admit returns 406 not-acceptable.
jsoncsv
Response fields
Returns data as an array of records. All example values are illustrative.
idstring- Record identifier, stable across revisions.
instrument_idstring- Opaque stable public identifier; never an internal database key.
namestring- Asset name.
codestring- Native asset code.
networkstring · null- Name of the network a token is issued on (Ethereum for an ERC-20 token); null for a coin native to its own chain and where no source names one.
contract_addressstring · null- Contract address of the token on network; null for a native coin and where no source gives one.
website_urlstring · null- website url
whitepaper_urlstring · null- whitepaper url
circulating_supplystring · null- Circulating native units; null when the source reports no circulating supply (or zero) for the asset.
total_supplystring · null- Total issued native units.
max_supplystring · null- Maximum supply; null if unknown or unbounded.
market_capstring · null- Market capitalization in US dollars on observed_on: circulating supply at the USD price. Between a source's reads OHLC carries it to each day's close, the supply as last read.
fully_diluted_market_capstring · null- Market capitalization in US dollars on observed_on if the maximum (else total) supply were circulating.
observed_onstring- observed on
Response metadata
Responses include meta.timezone. Dataset responses include next_cursor; health and exports have their own metadata. Request tracing uses the X-Request-ID header.
When something goes wrong
An empty data: [] is a successful query with no matching records. Invalid symbols, permissions and malformed parameters produce an RFC 9457 problem with an actionable detail.
Plans
Requires crypto.read. Access, recency and history depth come from the plan definitions the API enforces.
| Plan | Access | Recency | History |
|---|---|---|---|
| Free | Not included | — | — |
| Developer | Not included | — | — |
| Pro | Included | As published | 15 years |
| Commercial | Included | As published | Full history |
| Scale | Included | As published | Full history |
History is how far back a plan may request. How far records actually go for a symbol is history_from in dataset coverage. Nothing is real-time. Compare plans