One coin
get/v1/market/coins/{asset}
https://data.decryptr.ai/v1/market/coins/{asset}
- API planDeveloper, and every plan above it. Data is 60 minutes behind live on this plan.
- Scope
coins:read - Cost1 unit, also when not found. How units are counted
- CreditCoin list and trending coins include data from CoinGecko.
Rate limits by plan
| Plan | Units a month | Per second | Per minute | Most per request |
|---|---|---|---|---|
| Developer | 1,000 | 2 | 20 | 10 |
| Starter | 50,000 | 5 | 60 | 25 |
| Pro | 300,000 | 15 | 300 | 50 |
| Business | 1,500,000 | 40 | 900 | 100 |
| Enterprise | Agreed | Agreed | Agreed | Agreed |
A 429 carries the full rate-limit header set and a Retry-After. Rate limits
Errors
- 400The request was refused before any data was read. Nothing is charged.
- 401No usable key. Nothing is charged.
- 402The account cannot use the API until billing is sorted. Nothing is charged.
- 403The key may not use this endpoint. Nothing is charged.
- 404No such item. A lookup is still charged what it asked for.
- 429A limit was reached (units or streams). Nothing was read and nothing is charged. Wait Retry-After seconds, back off with jitter, or ask for fewer items.
- 500Something failed on our side. Nothing is charged. Retry with backoff.
- 503The API is switched off, busy, or a query ran too long. Nothing is charged. Retry after Retry-After seconds.
Errors follow RFC 9457. Every error code
One coin from Decryptr's coin list by symbol. When several coins share a symbol, the one with the best market-cap rank is returned. Not found when the symbol is not in the list.
Served during Decryptr's friends-only testing: the exchange, CoinGecko and Coinalyze data behind it is used on Decryptr's own risk acceptance of those sources' terms, so this endpoint may be restricted or withdrawn before general availability. Keep the attribution line and meta.source with the data.
Cost: 1 unit, also when not found.
Needs scope coins:read and the developer plan or above.
AuthorizationBearer <dcr_live_<8 hex>_<43 base64url> or dcr_test_...>Your API key as a Bearer token: Authorization: Bearer dcr_live_....
asset*stringAsset symbol, letters and digits, case-insensitive.
^[A-Za-z0-9]{1,15}$OK.
application/json- response
data*A coin in the Decryptr coin list.
as_of*stringWhen the response was made.
date-timeattribution*stringAttribution you must keep with this data.
disclaimer*stringPlain-language notice. Information only, not financial advice.
meta*Where the figures come from.
curl -X GET 'https://data.decryptr.ai/v1/market/coins/BTC'{ "data": { "asset": "BTC", "coin_id": "bitcoin", "name": "Bitcoin", "coingecko_id": "bitcoin", "hyperliquid_symbol": "BTC", "binance_symbol": "BTCUSDT", "market_cap_rank": 1, "curated": true, "updated_at": "2026-10-23T12:00:00.000Z" }, "as_of": "2026-10-23T12:12:30.000Z", "attribution": "Coin list and trending coins include data from CoinGecko.", "disclaimer": "Information only, not financial advice.", "meta": { "source": "CoinGecko coin list, as stored by Decryptr" }}Coin list GET
Decryptr's coin list: the CoinGecko id, name and market-cap rank of each coin and the symbol it trades under on Hyperliquid and Binance USD-M. Ordered by coin_id; follow next_cursor for the next page. Served during Decryptr's friends-only testing: the exchange, CoinGecko and Coinalyze data behind it is used on Decryptr's own risk acceptance of those sources' terms, so this endpoint may be restricted or withdrawn before general availability. Keep the attribution line and meta.source with the data. Cost: 1 unit per item returned, at least one item's worth. The request first reserves limit x 1 unit (and is refused with 429 if that many are not available), then pays only for what came back. Needs scope `coins:read` and the developer plan or above.
Tickers for several assets GET
The latest Hyperliquid ticker for several assets at once, from Decryptr's 15 minute samples: mark and oracle price, the 24 hour open, high, low and change, day volume, funding rate, premium and open interest. Samples older than 2 hours are not shown. Assets with no ticker come back in missing and are still charged. On the developer plan tickers are 60 minutes late. Served during Decryptr's friends-only testing: the exchange, CoinGecko and Coinalyze data behind it is used on Decryptr's own risk acceptance of those sources' terms, so this endpoint may be restricted or withdrawn before general availability. Keep the attribution line and meta.source with the data. Cost: 1 unit per id asked for, found or not. Needs scope `coins:read` and the developer plan or above.