API Overview
Overview of the ChartInspect v1 API for accessing on-chain metrics and market indicators.
The ChartInspect API provides programmatic access to on-chain blockchain metrics and market-wide indicators. All endpoints are served under the v1 namespace.
#Base URL
https://chartinspect.com/api/v1#Authentication
Most endpoints require authentication via the x-api-key header. On-chain and market indicator endpoints require an active Pro subscription. Free-tier keys can access crypto prices and economic indicators.
curl -H "x-api-key: YOUR_API_KEY" \
https://chartinspect.com/api/v1/onchain/mvrv?chain=bitcoinPublic endpoints (such as /api/v1/chains) do not require an API key.
#Response Format
All endpoints return JSON with a consistent structure:
{
"success": true,
"data": [ ... ],
"metadata": { ... }
}When an error occurs, the response includes an error message:
{
"success": false,
"error": "Description of what went wrong"
}#Available Endpoints
| Method | Endpoint | Auth Required | Description |
|---|---|---|---|
GET | /api/v1/chains | No | List all supported blockchains |
GET | /api/v1/onchain/status?chain=X | Yes (Pro) | List available metrics for a chain |
GET | /api/v1/onchain/{metric}?chain=X | Yes (Pro) | Fetch on-chain metric data |
GET | /api/v1/crypto/prices/{symbol} | Yes (Free) | Fetch cryptocurrency price history |
GET | /api/v1/economic/{indicator} | Yes (Free) | Fetch economic indicator data |
GET | /api/v1/market-indicators/{indicator} | Yes (Pro) | Fetch market-wide indicators |
GET | /api/v1/exchange-etf/{dataset} | Yes (Pro) | Fetch exchange and ETF flow data |
GET | /api/v1/derivatives/{metric} | Yes (Pro) | Fetch derivatives market data |
WS | wss://chartinspect.com/socket.io/ | Yes (Pro) | Real-time price WebSocket |
#Common Query Parameters
These query parameters are supported across data-fetching endpoints:
| Parameter | Type | Description |
|---|---|---|
chain | string | Blockchain to query. Defaults to bitcoin. Options: bitcoin, ethereum, cardano, dogecoin, litecoin, chainlink |
days | number | Return only the last N days of data |
startDate | string | Start of date range in YYYY-MM-DD format |
endDate | string | End of date range in YYYY-MM-DD format |
limit | number | Maximum number of data points to return (max 10,000) |
fields | string | Comma-separated list of field names to include in the response |
format | string | Response format: json (default) or csv |
#Rate Limits
| Tier | Requests per Hour | Requests per Day |
|---|---|---|
| Pro | 1,000 | 20,000 |
| Free | 100 | 1,000 |
Rate limits are tracked per user ID. Each response includes headers with your remaining quota:
X-RateLimit-Remaining-Hourly: 982
X-RateLimit-Remaining-Daily: 19450
X-RateLimit-Reset-Hourly: 2026-03-16T13:00:00.000Z
X-RateLimit-Reset-Daily: 2026-03-17T00:00:00.000ZIf you exceed either limit, you will receive a 429 Too Many Requests response. On-chain data updates every 10 minutes, so there is no benefit to polling more frequently.
#Next Steps
- List supported chains to see which blockchains are available.
- Discover metrics to find out what on-chain data you can query.
- Fetch on-chain data to start pulling on-chain metrics.
- Crypto prices for historical OHLC price data (Free tier).
- Economic indicators for macro data like interest rates, CPI, GDP (Free tier).
- Market indicators for altcoin season, market breadth, risk metrics.
- Exchange & ETF data for exchange reserves and ETF holdings.
- Derivatives for futures open interest and funding rates.
- WebSocket API for real-time price streaming.