Introduction

Get started with the ChartInspect API for on-chain analytics data.

The ChartInspect API provides programmatic access to on-chain analytics data across multiple blockchains. With a Pro subscription, you can access 540+ metrics covering valuation, supply dynamics, momentum indicators, mining statistics, and profit/loss analysis. A free tier is also available with access to crypto prices and economic indicators.

#Base URL

All API requests are made to:

https://chartinspect.com/api/v1

#Free vs. Pro

	Free	Pro
Crypto prices	Yes	Yes
Economic indicators	Yes	Yes
On-chain metrics	No	Yes
Market indicators	No	Yes
Hourly rate limit	100 requests	1,000 requests
Daily rate limit	1,000 requests	20,000 requests

#Quick Start

Here is your first API call to list available chains:

bash

curl -H "x-api-key: YOUR_API_KEY" \
  https://chartinspect.com/api/v1/chains

Response:

json

{
  "success": true,
  "chains": [
    { "id": "bitcoin", "symbol": "BTC", "name": "Bitcoin", "metrics": 117 },
    { "id": "ethereum", "symbol": "ETH", "name": "Ethereum", "metrics": 89 },
    { "id": "cardano", "symbol": "ADA", "name": "Cardano", "metrics": 106 },
    { "id": "dogecoin", "symbol": "DOGE", "name": "Dogecoin", "metrics": 121 },
    { "id": "litecoin", "symbol": "LTC", "name": "Litecoin", "metrics": 110 },
    { "id": "chainlink", "symbol": "LINK", "name": "Chainlink", "metrics": 90 }
  ],
  "total": 6
}

#Discovering Available Metrics

To see all available metrics for a specific chain, use the status endpoint:

bash

Try in Playground

curl -H "x-api-key: YOUR_API_KEY" \
  "https://chartinspect.com/api/v1/onchain/status?chain=bitcoin"

Response:

json

{
  "success": true,
  "chain": "bitcoin",
  "totalMetrics": 117,
  "metrics": [
    { "metric": "mvrv", "fields": ["btc_price", "mvrv"], "file": "mvrv.json" },
    { "metric": "nupl", "fields": ["btc_price", "nupl"], "file": "nupl.json" },
    { "metric": "sopr", "fields": ["btc_price", "sopr", "asopr"], "file": "sopr.json" }
  ]
}

This returns every metric available for the chain, along with the field names you can expect in the data. You can also browse the full metric lists in the chain reference pages.

#Fetching Metric Data

Once you know which metrics are available, fetch data with:

bash

Try in Playground

curl -H "x-api-key: YOUR_API_KEY" \
  "https://chartinspect.com/api/v1/onchain/mvrv?chain=bitcoin&days=30"

#Response Format

All responses follow a consistent JSON structure:

json

{
  "success": true,
  "metric": "mvrv",
  "chain": "bitcoin",
  "count": 30,
  "data": [
    { "date": "2026-02-14", "mvrv": 2.34, "btc_price": 97500 }
  ],
  "metadata": {
    "processingTime": 45,
    "timestamp": "2026-03-16T12:00:00.000Z",
    "tier": "pro",
    "dataUpdateInterval": "10 minutes"
  }
}

Rate limit headers are included in every response:

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.000Z

#Next Steps

Authentication: Set up your API key
Rate Limits: Understand usage limits
Supported Chains: Explore available blockchains

Was this page helpful?

PreviousPlayground

NextAuthentication