Madjik API documentation
Crypto market metrics computed by the Black Belt Labs engine: REST, MCP, SDKs, webhooks and A2A.
Welcome to the Madjik API documentation. The Madjik API serves crypto market metrics computed by the Black Belt Labs engine — classical (SQL), AI (machine learning) and quantum-computed (Qiskit simulators, hardware-ready) — with full history, provenance and freshness on every payload.
Quick start
curl -H "X-API-Key: YOUR_API_KEY" \
"https://api.madjik.io/v1/catalog"Base URL: https://api.madjik.io/v1. Get a key at
madjik.io/pricing; it arrives by email after checkout.
What you get
- 144 live metrics across 19 categories (146 in the catalog: 2 further metrics are dormant while their data baselines mature — see the catalog).
- Real-time and historical values with per-point provenance labels.
- Variant grid per metric: change variants (absval / abschg / relchg) × time variants (now, past1h … past30d, and forecast horizons where the forecast passed its quality gate).
- Multiple computation methods side by side — classical, AI and quantum computations of the same metric are stored and labeled separately.
- REST API, MCP, SDKs, webhooks and A2A — use whichever fits: the REST API, the MCP server for AI assistants, the Python/TypeScript/Sheets SDKs, and more in the integration guides.
Migrating from the old docs? Metric ids changed:
the legacy
ME10001…ME10052 scheme is retired. Current ids look like
M10004 or M50031 and are assigned sequentially — they carry no meaning.
The metrics catalog is the authoritative list.Metric categories
| Category | Metrics | Computation |
|---|---|---|
| AI | 3 | AI-Enhanced (Gemini), Classical (SQL) |
| Analytics | 2 | AI-Enhanced (Gemini), Classical (Python) |
| QC | 4 | Quantum (Qiskit simulator) |
| defi | 6 | Classical (SQL) |
| derivatives | 18 | Classical (SQL) |
| exchange | 4 | Classical (SQL) |
| gaming | 1 | Classical (SQL) |
| macro | 9 | Classical (SQL) |
| market | 2 | Classical (SQL) |
| nft | 1 | Classical (SQL) |
| onchain | 21 | Classical (SQL) |
| personal | 21 | Classical (SQL), Classical (SQL/Python) |
| regulatory | 4 | Classical (SQL) |
| sentiment | 4 | Classical (SQL) |
| social | 2 | Classical (SQL) |
| stablecoin | 13 | Classical (SQL) |
| tether | 21 | Classical (SQL) |
| volatility | 1 | Classical (SQL) |
| volume | 9 | Classical (SQL) |
Start here
- Getting started — authentication, plans and limits, response format
- API reference — every endpoint with examples
- MCP — give AI assistants tool access to Madjik
- SDKs — Python, TypeScript and Google Sheets, with limits and webhooks handled
- Metrics catalog — all 146 metrics, one page each
- Data provenance — how to read provenance labels
Support
madjik.featurebase.app · live freshness: status page · interactive OpenAPI docs: api.madjik.io/docs