
API
Everything on this site is available as JSON. No key, no sign-up. Responses may be cached for 15 seconds; please do not poll faster than the data changes, which is once a minute.
By market cap
Base address
https://coinsprey.com/api/v1
curl https://coinsprey.com/api/v1/coins/btc-bitcoin
All endpoints are read-only GET requests and answer with JSON. Lists come as an object with data, total, page and per_page. Unknown ids answer 404.
| Endpoint | Returns | Parameters |
|---|---|---|
/global | Totals: market cap, 24h volume, BTC dominance, number of coins, markets and exchanges. | — |
/coins | Coins ranked by market cap, with 7-day sparklines. | page, per_page (max 250), sort = rank | symbol | price | change_1h | change_24h | change_7d | change_30d | change_1y | volume | market_cap | confidence | markets, dir = asc | desc, min_volume (USD), min_confidence (0-100), kind = tokenized (tokenized stocks, funds and currency pairs instead of coins) |
/coins/{id} | One coin with description, links, token contracts and quality: how its price was formed and how far it can be trusted. id is like btc-bitcoin; a bare ticker works too. | — |
/map | Every coin with a market cap in one light answer (no history): price, 24h change, volume, market cap. | — |
/global/chart | Market cap and 24h volume of the whole market over time, as [unix ms, USD] pairs. | range = 24h | 7d | 30d | 1y | max |
/coins/{id}/chart | Price history as [unix ms, price] pairs. | range = 24h | 7d | 30d | 1y | max |
/coins/{id}/markets | Every market of the coin with its weight in the price, deviation, bid/ask spread, order book depth within 2%, 5% and 10% of the best prices and, when it is not counted, the reason. | — |
/coins/{id}/sources | The markets a past price was made of, with weights and exclusion reasons. Recorded hourly, kept 90 days. | at = RFC 3339 time (default: now) |
/coins/{id}/posts | What the project published itself on its own channels (Telegram channel, Medium, GitHub releases), newest first. Its words, not ours. | — |
/highlights | Top gainers, top losers and the most traded coins of the last 24 hours. | limit (max 100) |
/exchanges | Exchanges with their 24h volume, number of markets, market data quality (score and its parts), whether they count towards prices (counted) and the measurements that decide it (evidence). verified is the old name of counted. | — |
/exchanges/{id}/markets | Markets of one exchange. Each market carries real_volume_usd (our estimate), contradictions, patterns and the figures of its tape. | page, per_page (max 250) |
/exchanges/{id}/chart | Hourly 24h volume of one exchange over the last 30 days, as [unix ms, USD] pairs. | — |
/search | Coins and exchanges by ticker or name. | q |
/news | News stories and listing notices, newest first. | page, per_page, kind = article | listing, coin |
/status | Age of the prices and of the last read of every exchange. Answers 503 when prices are older than three minutes. | — |
/news/top | The most important stories of the last 36 hours. | — |
Good to know
Prices are in US dollars. market_cap_estimated: true means the market cap is computed from the total supply because the circulating supply is not known. A coin has two ids: id is readable and follows the name, asset_id never changes. Both work in the address; store asset_id. The API is at version 1 and young: fields can still be added.


