Everything TokenSonar tracks, free to use: institutional adoption scores and grades, the ETF tracker, weekly price predictions, every institutional news item we have classified, and the full daily history behind all of it. The API is plain JSON files on a CDN: no sign-up, no key, and open CORS, so it works from a browser, a script or a spreadsheet.
Endpoints
Base URL: https://tokensonar.com. Every response carries updatedAt, license and a link back to these docs.
| Path | What you get | |
|---|---|---|
/data/v1/index.json | Catalog: every endpoint, coverage dates, coin list and history file links. | Open |
/data/v1/scores.json | Current institutional adoption score, rank, grade, archetype, ETF status, price, market cap, RWA, TVL, key institutions and key facts for every coin. | Open |
/data/v1/history/{id}.json | Daily history per coin: score, rank, grade, price, market cap, RWA, TVL, ETF and license counts. Also every weekly prediction revision. | Open |
/data/v1/etfs.json | Every spot ETF and ETP in our tracker: coin, fund, ticker, issuer, region, exchange, status, AUM, first seen. | Open |
/data/v1/etf-events.json | Tracker changes over time: funds added or removed, filed to live. | Open |
/data/v1/predictions.json | Current price predictions: 12 monthly and 5 yearly points per coin, each with bear, base and bull. | Open |
/data/v1/adoption-timeline.json | Full adoption timeline: when each coin is projected to reach early, mainstream, broad and full institutional adoption, with early and late dates. Revised weekly. | Open |
/data/v1/news/latest.json | Latest 200 institutional news items, plus links to every monthly archive. | Open |
/data/v1/news/{YYYY-MM}.json | Every institutional news item we classified that month. | Open |
/data/v1/index-history.json | TokenSonar Institutional Adoption Index and Crypto Fear & Greed, by day. | Open |
Quick start
JavaScript (browser or Node):
const res = await fetch('https://tokensonar.com/data/v1/scores.json');
const { coins } = await res.json();
for (const c of coins) console.log(c.rank, c.ticker, c.score);Python:
import requests
h = requests.get('https://tokensonar.com/data/v1/history/btc.json').json()
for row in h['daily'][-7:]:
print(row['d'], row['score'], row['price'])Command line:
curl -s https://tokensonar.com/data/v1/predictions.jsonDaily history fields
Each /data/v1/history/{id}.json file has a daily array with one row per day, oldest first. It also has a predictions array with one row per weekly forecast revision (m3, m6, m12, y2 and y5 base cases, the 12-month range, and the news signal). A field is null on days we did not collect it.
| Field | Meaning |
|---|---|
d | UTC date (YYYY-MM-DD); the last pipeline run of that day |
score | Institutional adoption score, 0-100 |
rank | Rank among tracked coins (1 = most adopted) |
grade | Data tier / grade label at the time |
archetype | asset | rail | infrastructure |
scoringVersion | Scoring method version; scores are only directly comparable within one version |
price | Spot price in USD |
marketCap | Market capitalisation in USD |
rwaUSD | Tokenized real-world assets distributed on the chain, USD |
tvlUSD | Protocol TVL in USD (protocol tokens only) |
etfStatus | none | filed | live |
etfsLive | Number of live ETFs/ETPs in our tracker |
etfsFiled | Number of filed ETFs/ETPs in our tracker |
keyInstitutions | Number of named key institutions |
licenses | Number of tracked regulatory licenses/approvals |
Coin ids: ada algo apt avax btc canton doge dot eth hbar hype inj link ltc mkr ondo pendle plume pol qnt sol sui trx ustb xdc xlm xrp
Updates, limits and stability
Refresh. Twice daily (about 04:40 and 15:40 UTC). Predictions and the adoption timeline are revised weekly. Files are cached for up to 30 minutes, so polling more often than that gains nothing.
Limits. There is no key and no hard rate limit. Please cache responses and be reasonable. Abusive traffic may be blocked.
Stability. Within v1, fields are only added, never renamed or removed. A breaking change would ship as v2 alongside v1.
Scoring versions. Our scoring method has changed over time. Each history row records its scoringVersion, so compare scores within one version. Price, market cap and the counts are comparable across versions.
License and attribution
Free for commercial and non-commercial use under CC BY 4.0. Please credit TokenSonar with a link to tokensonar.com wherever you show the data. News items link to the original reporting. Headlines and summaries are written by TokenSonar.