Cryptarista Data API
Cryptarista runs a live derivatives research desk and ships its output as production infrastructure. The system collects funding rates, liquidations, open interest, and crowding data from Binance and Bybit, then layers evidence-linked news signals — structured events traceable from raw source to derived signal. Subscribe to fund the research. Consume it through REST, MCP, or Python SDK.
1.Market Failure
Crypto derivatives data is fragmented across exchanges with proprietary schemas and rate limits. Aggregators consolidate it but charge $299/month for commercial access and restrict redistribution. The gap they leave: no one offers evidence-linked event intelligence — structured signals traceable to the source article, extraction logic, and market context that produced them. Technical buyers do not purchase transport. They purchase interpretation, confidence, and auditability.
2.Signal Wedge
The news signal pipeline is the primary differentiator. Raw articles and social posts are ingested, classified, and processed through event extraction that identifies regulatory actions, exchange incidents, and macroeconomic signals. Related events are clustered temporally, and each cluster produces a derived signal enriched with market context from the derivatives layer.
Every signal maintains a complete evidence chain: the raw source URL, the extracted event payload, the clustering rationale, and the market data snapshot at signal generation time. Consuming systems can audit signal provenance rather than treating signals as opaque inputs.
3.Endpoint Surface
Eight endpoint families cover derivatives market data, news-derived signals, and computed features. All endpoints return JSON with consistent pagination and error schemas.
| Endpoint | Data | Update Frequency | History Depth |
|---|---|---|---|
| /v1/snapshots/derivatives | Composite snapshot | Real-time | Current |
| /v1/history/funding | Funding rates | 8h settlements | 3 years |
| /v1/history/oi | Open interest | 15 min | 3 years |
| /v1/history/long-short | Long/short ratios | 15 min | 3 years |
| /v1/events/liquidations | Liquidation events | Real-time | 90 days |
| /v1/news/signals | News event signals | Event-driven | 90 days |
| /v1/news/events | Clustered news events | Event-driven | 90 days |
| /v1/features/crowding | Crowding score | 15 min | 90 days |
4.Delivery Modes
The same research surface is available through REST, an MCP server for AI agent frameworks, and a Python SDK. Authentication is via API key (X-API-Key header). MCP supports both stdio (local agents) and SSE (remote). TypeScript SDK planned for Q3 2026.
from cryptarista import CryptaristaClient client = CryptaristaClient(api_key="cda_live_...") snapshot = client.snapshots.derivatives(symbol="BTCUSDT") signals = client.news.active_signals(asset="BTC")
Tool: get_derivatives_snapshot
Input: {"venue": "binance", "symbol": "BTCUSDT"}
Returns: funding_rate, open_interest, crowding_score, regime5.Access Model
Subscription is the primary commercial path — recurring users fund the ongoing research desk. Credits handle burst workloads without plan changes. Optional x402 pay-per-use covers low-volume agent-native calls.
| Access Path | Price | Best For | What You Get |
|---|---|---|---|
| Preview | $0 | Evaluation | BTC derivatives, 7-day history, 100 calls/day — enough to inspect the surface before paying |
| Research Subscription | $49/mo | Production use | Commercial access, MCP, evidence-linked news signals, BTC + ETH (expanding), 3-year history |
| Credits | $25+ | Burst workloads | Replay jobs, premium queries, overages — flexible spend without a larger recurring commitment |
| x402 / Pay-per-use | Per request | Agent automation | On-demand calls for automated workflows that don’t need standing account access |
The hierarchy is intentional: subscription is the business, credits are the pressure valve, x402 is the edge case.
6.System Architecture
The system runs a three-stage pipeline: collection, storage, and serving. Exchange collectors normalize data from Binance and Bybit into a unified schema and write to ClickHouse. A parallel news pipeline extracts structured events from unstructured sources and attaches evidence lineage. Both paths converge at the serving layer.
References
- Model Context Protocol Specification, Anthropic, 2024. modelcontextprotocol.io
- CoinGlass API Documentation. coinglass.com/api
- Binance Futures API. binance-docs.github.io