Certified Chart Datasets

GET /api/v1/charts/{chartId}

The chart dataset API exposes server-backed chart contracts beyond the generic data categories. It requires a Pro key with chart-data permission.

Only certified contracts appear in the API catalog. A chart that exists in the UI but has no certified server contract is excluded from discovery and returns 409 if requested directly. This prevents renderer-only configuration from being mistaken for an attributable API dataset.

#Discovery

Find valid chartId values in:

1. GET /api/public/catalog, under Chart Datasets.
2. Authenticated GET /api/v1/endpoints.
3. The Full Endpoint Reference.
4. The Chart Datasets tab in the Playground.

#Request

curl -H "x-api-key: YOUR_API_KEY" \
  "https://chartinspect.com/api/v1/charts/mvrv-z-score?days=365&limit=1000"

Parameters are defined per contract. Common options include days, limit, startDate, endDate, timeframe, format, and source-specific inputs. OpenAPI and the generated reference advertise the exact set for each chart.

#JSON Response

{
  "success": true,
  "chart": {
    "id": "mvrv-z-score",
    "label": "MVRV Z-Score",
    "category": "onchain"
  },
  "count": 365,
  "data": [],
  "metadata": {
    "apiVersion": "v1",
    "fields": ["date", "price", "mvrv_z_score"],
    "params": ["days", "limit", "startDate", "endDate", "format"]
  }
}

The route fetches the authoritative source, applies the chart contract's transformation and dependencies, then applies the caller's range and limit. It returns 404 when no rows match and 502 when a required source is unavailable.

#CSV

When format is listed for a chart, append ?format=csv to receive text/csv with a private, no-store response.