Built for developers
Live & historical data
Current prices plus up to a year of history, volatility, and drawdown for every token.
Simple REST + JSON
Plain HTTP endpoints, predictable JSON responses, no SDK required.
Key-based auth
Every request is scoped to your own API key, so you can track and control your own usage.
Free to start
Spin up a key in seconds and start querying — upgrade only if you outgrow the free tier.
Get started in 3 steps
Get a free API key
Enter your email and we'll send your key right away.
Free tier: 3 requests/hour per endpoint. No credit card required.
Authentication
Send your API key in the x-api-key header on every request.
Base URL: https://www.thecoinanalysis.com/api/public/v1
curl "https://www.thecoinanalysis.com/api/public/v1/prices/BTC" \
-H "x-api-key: YOUR_KEY"Endpoints
Three endpoints cover everything: listing, single-token detail, and history.
Prefer to explore it live? Open the interactive Swagger docs →
/pricesPaginated list of live token prices.
| page | Page number (default 1) |
| perPage | Results per page, max 250 (default 50) |
| order | market_cap | price | volume | change24h | name | symbol | updated_at | rank |
| dir | asc | desc (default desc) |
| search | Filter by symbol/name/slug |
| symbols | Comma-separated symbols, e.g. BTC,ETH |
Request
curl "https://www.thecoinanalysis.com/api/public/v1/prices?perPage=2&order=market_cap" \
-H "x-api-key: YOUR_KEY"Response
{
"meta": { "page": 1, "perPage": 2, "total": 220, "order": "market_cap", "dir": "desc" },
"data": [
{
"id": 1, "slug": "bitcoin", "name": "bitcoin", "symbol": "BTC",
"priceUsd": 67669, "change24hPct": 0.0541, "marketCapUsd": 1350778158790,
"volume24hUsd": 45848733262, "athUsd": 126080, "rank": 1,
"updatedAt": "2026-02-25T16:14:24.000Z"
}
]
}/prices/:symbolLive price detail for a single token.
| symbol | Token symbol, e.g. BTC (in the URL path) |
Request
curl "https://www.thecoinanalysis.com/api/public/v1/prices/BTC" \
-H "x-api-key: YOUR_KEY"Response
{
"id": "bitcoin", "name": "bitcoin", "symbol": "BTC",
"priceUsd": 67669, "change24hPct": 0.0541, "change7dPct": 0.0001,
"change30dPct": -0.227, "marketCapUsd": 1350778158790,
"volume24hUsd": 45848733262, "athUsd": 126080,
"athDate": "2025-10-06T18:57:43.000Z", "rank": 1,
"updatedAt": "2026-02-25T16:14:24.000Z"
}/prices/:symbol/historyHistorical price series for a single token.
| symbol | Token symbol, e.g. BTC (in the URL path) |
| days | Days of history, max 365 (default 30) |
| maxPoints | Max data points, max 500 (default 100) |
Request
curl "https://www.thecoinanalysis.com/api/public/v1/prices/BTC/history?days=7" \
-H "x-api-key: YOUR_KEY"Response
{
"meta": { "symbols": ["BTC"], "days": 7, "maxPoints": 100 },
"data": {
"BTC": {
"history": [{ "ts": "2026-02-19T00:00:00.000Z", "price": 66210, "pctChange": 0 }],
"volatility": 2.14, "maxDrawdown": 46.3, "athUsd": 126080, "currentPrice": 67669
}
}
}Pricing
Start free. Upgrade only when you outgrow the free tier.
Free
0€
3 req/hour/endpoint
free forever
- All 3 endpoints
- Live + historical data
- Community support
Starter
9€/month
100 req/hour/endpoint
A small hobby project
- All 3 endpoints
- Live + historical data
- Email support
Pro
29€/month
1000 req/hour/endpoint
A production app with real traffic
- All 3 endpoints
- Live + historical data
- Priority email support
Business
79€/month
5000 req/hour/endpoint
Heavier commercial usage
- All 3 endpoints
- Live + historical data
- Priority support + manual limit tuning
Paid tiers aren't self-serve yet — get in touch to upgrade a key.
The free tier allows 3 requests/hour per API key, per endpoint. Exceeding it returns an HTTP 429 response for that endpoint until the window resets.
Interactive docs
Try every endpoint live (paste your key in the "Authorize" button) at /api/public/v1/docs.
Frequently asked questions
Is the API really free?+
Yes. The free tier gives you 3 requests/hour per endpoint, with no credit card required — enough to try everything.
What data can I query?+
Live and historical prices, market cap, 24h/7d/30d change, volume, and all-time high for 300+ tokens.
What happens if I go over my rate limit?+
You'll get an HTTP 429 response for that endpoint until its one-hour window resets — other endpoints keep working, no charges, just a wait.
Can I upgrade to a paid tier?+
Yes, though it isn't self-serve yet. Reach out via the contact form and we'll upgrade your key manually.
Do I need an SDK or library?+
No — every endpoint is plain HTTP + JSON. Any language that can send an HTTP request with a header can use it.
