API Reference

Create a new free-tier API key. The full key is only shown once.

curl -X POST "https://cryptodataapi.com/api/v1/auth/keys" \
  -H "Content-Type: application/json" \
  -d '{"email": "[email protected]"}'

Revoke the current API key. 7-day cooldown before new key creation.

curl -X DELETE "https://cryptodataapi.com/api/v1/auth/keys" \
  -H "X-API-Key: cdk_live_your_key"

Get information about the current API key.

curl "https://cryptodataapi.com/api/v1/auth/keys/me" \
  -H "X-API-Key: cdk_live_your_key"

Rotate the current API key. Invalidates the old key.

curl -X POST "https://cryptodataapi.com/api/v1/auth/keys/rotate" \
  -H "X-API-Key: cdk_live_your_key"

List all coins, paginated by market cap rank.

curl "https://cryptodataapi.com/api/v1/coins?page=1&per_page=50" \
  -H "X-API-Key: cdk_live_your_key"

Search coins by name or symbol.

curl "https://cryptodataapi.com/api/v1/coins/search" \
  -H "X-API-Key: cdk_live_your_key"

Get top N coins by market cap.

curl "https://cryptodataapi.com/api/v1/coins/top?limit=20" \
  -H "X-API-Key: cdk_live_your_key"

Get all unique coin categories.

curl "https://cryptodataapi.com/api/v1/coins/categories" \
  -H "X-API-Key: cdk_live_your_key"

Curated coin-category themes — 20+ major categories spanning AI, Layer-1 & Layer-2, DeFi, DEX, lending, liquid staking, stablecoins, exchange tokens, meme, privacy, RWA, NFT, gaming, metaverse, DePIN, oracles, interoperability, storage, Bitcoin/Solana/Cosmos ecosystems, PoW and derivatives. Each group carries a plain-English description and its resolved coin list (live price, market cap, rank, 24h/7d change), sorted by market-cap rank. Unlike /coins/categories (raw CoinGecko tag names), this is an editorial set powering the Coin Categories page. Query param: limit (max coins per group, default 25).

curl "https://cryptodataapi.com/api/v1/coins/category-groups?limit=25" \
  -H "X-API-Key: cdk_live_your_key"

Get a single coin profile by symbol (e.g., BTC, ETH).

curl "https://cryptodataapi.com/api/v1/coins/BTC" \
  -H "X-API-Key: cdk_live_your_key"

Full dual-score market health result with all 11 components. **`indicators` contract** Top-level `indicators` is a flat denormalization of the most-filtered values from `components.<x>.details`. Keys are **omitted entirely** when the source value is unavailable (never null) so consumers can safely use `dict.get(key, default)` for fallbacks. Committed key set: - `long_short_ratio` (float) — BTC long/short ratio (Binance perps) - `funding_rate` (float, %) — avg funding rate (aliased from `avg_funding_rate`) - `buy_ratio` (float, 0–1) — weighted taker-buy ratio across top spot pairs - `fear_greed_value` (int, 0–100) — averaged Fear & Greed index - `breadth_pct` (float, %) — share of top-30 coins above their 200D MA - `pct_from_200ma` (float, %) — BTC distance from 200D MA - `cross_status` (str) — Golden | Death | Neutral - `stablecoin_change_7d` (float) — 7-day stablecoin market-cap change Health is computed cross-exchange (CoinGlass aggregate + Binance) and is not scoped by any per-exchange filter. The `long_short_ratio` is BTC-on-Binance, used as a market-wide sentiment signal.

curl "https://cryptodataapi.com/api/v1/market-health" \
  -H "X-API-Key: cdk_live_your_key"

Scores + sentiment only (lightweight).

curl "https://cryptodataapi.com/api/v1/market-health/summary" \
  -H "X-API-Key: cdk_live_your_key"

All 11 component details.

curl "https://cryptodataapi.com/api/v1/market-health/components" \
  -H "X-API-Key: cdk_live_your_key"

Get a single component by name.

curl "https://cryptodataapi.com/api/v1/market-health/component/price_trend" \
  -H "X-API-Key: cdk_live_your_key"

Health score history from database.

curl "https://cryptodataapi.com/api/v1/market-health/history?days=365" \
  -H "X-API-Key: cdk_live_your_key"

Altcoin breadth - % of coins above their MA with per-coin detail.

curl "https://cryptodataapi.com/api/v1/market-health/altcoin-breadth?ma_period=200" \
  -H "X-API-Key: cdk_live_your_key"

Force recalculate health score (Pro and Pro Plus tiers).

curl -X POST "https://cryptodataapi.com/api/v1/market-health/refresh" \
  -H "X-API-Key: cdk_live_your_key"

Fear & Greed index (multi-source averaged).

curl "https://cryptodataapi.com/api/v1/sentiment/fear-greed" \
  -H "X-API-Key: cdk_live_your_key"

Macro indicators: EUR/USD, gold, treasury yields.

curl "https://cryptodataapi.com/api/v1/sentiment/macro" \
  -H "X-API-Key: cdk_live_your_key"

Stablecoin market cap + 14d/90d flows.

curl "https://cryptodataapi.com/api/v1/sentiment/stablecoins" \
  -H "X-API-Key: cdk_live_your_key"

Daily stablecoin mcap + inflows from remote source.

curl "https://cryptodataapi.com/api/v1/sentiment/stablecoins/remote-history?days=90" \
  -H "X-API-Key: cdk_live_your_key"

Raw stablecoin market cap history timeseries.

curl "https://cryptodataapi.com/api/v1/sentiment/stablecoins/history" \
  -H "X-API-Key: cdk_live_your_key"

Binance perpetual funding rate history.

curl "https://cryptodataapi.com/api/v1/derivatives/binance/funding-rates?symbol=BTCUSDT&limit=30" \
  -H "X-API-Key: cdk_live_your_key"

Binance open interest + 30-day trend.

curl "https://cryptodataapi.com/api/v1/derivatives/binance/open-interest?symbol=BTCUSDT" \
  -H "X-API-Key: cdk_live_your_key"

Binance long/short account ratio.

curl "https://cryptodataapi.com/api/v1/derivatives/binance/long-short-ratio?symbol=BTCUSDT" \
  -H "X-API-Key: cdk_live_your_key"

All-in-one Binance derivatives summary.

curl "https://cryptodataapi.com/api/v1/derivatives/binance/summary?symbol=BTCUSDT" \
  -H "X-API-Key: cdk_live_your_key"

Daily derivatives data (funding, OI, L/S) from remote source.

curl "https://cryptodataapi.com/api/v1/derivatives/binance/history?days=30" \
  -H "X-API-Key: cdk_live_your_key"

Funding rates across Binance + Hyperliquid.

curl "https://cryptodataapi.com/api/v1/derivatives/funding-rates?coin=BTC" \
  -H "X-API-Key: cdk_live_your_key"

Open interest across Binance + Hyperliquid.

curl "https://cryptodataapi.com/api/v1/derivatives/open-interest?coin=BTC" \
  -H "X-API-Key: cdk_live_your_key"

Combined cross-exchange derivatives overview.

curl "https://cryptodataapi.com/api/v1/derivatives/summary?coin=BTC" \
  -H "X-API-Key: cdk_live_your_key"

Exchange metadata: assets, max leverage, specs.

curl "https://cryptodataapi.com/api/v1/hyperliquid/meta" \
  -H "X-API-Key: cdk_live_your_key"

All mid prices across Hyperliquid assets.

curl "https://cryptodataapi.com/api/v1/hyperliquid/prices" \
  -H "X-API-Key: cdk_live_your_key"

Current + historical funding rates for a coin.

curl "https://cryptodataapi.com/api/v1/hyperliquid/funding-rates?coin=BTC&limit=20" \
  -H "X-API-Key: cdk_live_your_key"

Open interest across all Hyperliquid assets.

curl "https://cryptodataapi.com/api/v1/hyperliquid/open-interest" \
  -H "X-API-Key: cdk_live_your_key"

OHLCV candles for a coin.

curl "https://cryptodataapi.com/api/v1/hyperliquid/candles?coin=BTC&interval=1h&limit=200" \
  -H "X-API-Key: cdk_live_your_key"

L2 order book snapshot.

curl "https://cryptodataapi.com/api/v1/hyperliquid/l2-book?coin=BTC" \
  -H "X-API-Key: cdk_live_your_key"

All-in-one perp data for a coin.

curl "https://cryptodataapi.com/api/v1/hyperliquid/summary?coin=BTC" \
  -H "X-API-Key: cdk_live_your_key"

Current per-coin depth/spread snapshot for the tracked universe (top-25 HL perps by 24h volume). Each record includes bid/ask depth at {10, 25, 50, 100}bps, spread in bps, book imbalance within 10bps, and joined open interest.

curl "https://cryptodataapi.com/api/v1/liquidity/depth" \
  -H "X-API-Key: cdk_live_your_key"

Per-coin OI vs price change across 1h/4h/24h windows, ranked by 4h divergence (oi_change_4h_pct − price_change_4h_pct). Positive divergence = OI rising faster than price = fragile positioning.

curl "https://cryptodataapi.com/api/v1/liquidity/oi-divergence" \
  -H "X-API-Key: cdk_live_your_key"

Per-coin regime label (deep_book / oi_price_divergence / depth_withdrawal / post_cascade_impaired / neutral) + market-wide aggregate + composite fragility score (0-100; higher = healthier). Pro and Pro Plus.

curl "https://cryptodataapi.com/api/v1/liquidity/regime" \
  -H "X-API-Key: cdk_live_your_key"

Composite liquidity fragility score (0-100) + sentiment band (healthy / leaning_healthy / neutral / leaning_fragile / fragile) + regime aggregate. Trimmed companion to /liquidity/regime — same composite, no per-coin list. Pro and Pro Plus.

curl "https://cryptodataapi.com/api/v1/liquidity/regime/score" \
  -H "X-API-Key: cdk_live_your_key"

Per-coin rolling depth history (up to 24h of 1-min samples). BTC on any tier; the full universe requires Pro.

curl "https://cryptodataapi.com/api/v1/liquidity/depth/BTC?minutes=60" \
  -H "X-API-Key: cdk_live_your_key"

Per-asset realized-vol regime (compressed / expanding / vol_shock / mean_reverting / normal) across the SIGNUM_RGG universe. Each entry carries 7d/30d vol (close-to-close, Parkinson, Garman-Klass), the 90d vol percentile and z-score (rv_z_30 / rv_z_7), term structure (7d/30d), a vol-target position-size multiplier, and a regime run-length (days_in_regime + prev_regime + regime_changed) so a strategy can detect the cross into a new regime point-in-time. Pegged tokens carry an is_stable data-quality flag. Backfillable from daily klines. Screen with ?regime=compressed&sort=days_compressed or ?sort=vol_target_multiplier&order=desc.

curl "https://cryptodataapi.com/api/v1/volatility/regime?regime=compressed&sort=days_compressed&order=desc" \
  -H "X-API-Key: cdk_live_your_key"

Market-wide volatility-stress composite (0-100; higher = more stress, size down) + sentiment band (stressed / elevated / normal / calm / dormant) + median 30d vol percentile + regime aggregate. Also carries a universe-wide gross_exposure_multiplier (0.5–1.0; the market-wide analog of the per-asset vol-target multiplier) and the target_vol numerator. Trimmed companion to /volatility/regime — no per-coin list.

curl "https://cryptodataapi.com/api/v1/volatility/regime/score" \
  -H "X-API-Key: cdk_live_your_key"

Per-asset Volatility regime detail with 60d daily history (close, 30d close-to-close vol, 30d Garman-Klass vol) for sparkline rendering. Pro / Pro Plus only.

curl "https://cryptodataapi.com/api/v1/volatility/regime/BTC" \
  -H "X-API-Key: cdk_live_your_key"

Force recompute the Volatility regime cache across the full universe. Pro / Pro Plus only.

curl -X POST "https://cryptodataapi.com/api/v1/volatility/regime/refresh" \
  -H "X-API-Key: cdk_live_your_key"

Whole-market regime (label + calibrated confidence + candles-in-regime) and probability buckets for direction (5 buckets), volatility, liquidation risk, funding, breadth, open interest and regime transitions at the requested horizon. The market liquidation_risk bucket is depth-aware — it reads live order-book fragility (thin book + wide spread → higher forced-liquidation odds), not just realized volatility; explain.heads_provenance tags the source (e.g. depth_fragility:thin). The 24h horizon adds seeded Monte Carlo tomorrow stats (return quantiles, P(visit vol_spike), P(drawdown>5%)). The explain block exposes feature z-scores, raw state posteriors, the hysteresis rule state and raw-vs-calibrated confidence. Pro tier (market-wide; per-coin data is Pro Plus).

curl "https://cryptodataapi.com/api/v1/quant/market?horizon=24h" \
  -H "X-API-Key: cdk_live_your_key"

Trimmed regime summary for every active Hyperliquid perp (~200+): regime + confidence, p_direction_up, most likely transition, current OI, and data-quality flags (insufficient_history under 60d, warming_up under 30d, new_listing under 7d). This is the heatmap feed; full probability matrices live at /quant/coins/{symbol}. Pro.

curl "https://cryptodataapi.com/api/v1/quant/coins?regime=squeeze&sort=oi" \
  -H "X-API-Key: cdk_live_your_key"

One call that batches /quant/coins/{symbol} and /volatility/regime/{symbol} across the whole quant universe — majors (BTC/ETH/SOL) included. Each item: regime + confidence, the volatility / liquidation_risk / funding / open_interest probability buckets (verbatim from the per-coin endpoint), the vol-sizing fields (vol_target_multiplier, vol_pctile_30, rv_24h), and a meta block flagging insufficient_history / new_listing. Purpose-built so consumers don't fan out ~2 calls per perp. Values match the per-symbol endpoints for the same symbol/horizon. Pro.

curl "https://cryptodataapi.com/api/v1/quant/coins/risk?horizon=24h" \
  -H "X-API-Key: cdk_live_your_key"

Full per-coin probability object, conditioned on the whole-market regime: the coin's transition matrix is the market-posterior-weighted mixture (inspect explain.transition_mixture_weights — SOL can read squeeze while the market reads range). Includes the explain block and recent_regimes (last ~48 inference rows for sparklines). Coins under 60d of history return the object flagged insufficient_history rather than 404. Pro.

curl "https://cryptodataapi.com/api/v1/quant/coins/SOL" \
  -H "X-API-Key: cdk_live_your_key"

Point-in-time record of every probability the engine emitted — the verification surface. Each row carries backfilled (live 15-min inference vs retro-computed 1h history) and model_version, so you can audit our calls against what actually happened. Flattened numeric columns; format=csv streams CSV. Pro Plus only.

curl "https://cryptodataapi.com/api/v1/quant/history?scope=BTC&start=2026-06-01&format=csv" \
  -H "X-API-Key: cdk_live_your_key"

Bulk download of the full market 6-regime history as a Parquet file (returns a pre-signed URL). One hourly row per bar from 2020 to yesterday, each carrying the full distribution over all 6 regimes at three horizons — now, 4h, 24h (columns p_now_0..5, p_4h_0..5, p_24h_0..5, keyed by regime id; see regime_map). The deep history is labeled by the same model that serves live, run over the public Binance archive it trained on (no hindsight); the source column marks the Binance-archive vs live-Hyperliquid seam. Use this for backtesting instead of paginating /quant/history. Rebuilt daily. Pro Plus only.

curl "https://cryptodataapi.com/api/v1/quant/regimes/history" \
  -H "X-API-Key: cdk_live_your_key"
# -> { "download_url": "https://...signed...", "expires_in": 3600,
#      "rows": 56480, "model_version": "2.0.0",
#      "horizons": ["now","4h","24h"],
#      "regime_map": {"0":"strong_trend_bull", ...} }

Daily market regime label from 2019 to now, produced by running the live model over its full training history — the COVID crash, 2021 bull, LUNA/FTX bear and 2024 ETF bull, labeled by the same model with no hindsight relabeling. Regenerated on every retrain. Pro Plus only.

curl "https://cryptodataapi.com/api/v1/quant/timeline?start=2022-01-01" \
  -H "X-API-Key: cdk_live_your_key"

Per-coin long/short/net/gross notional split by trader type — market_maker, whale, other, all — across the full Hyperliquid account universe (every account ≥ $100k holding a position, ~5-min fresh). Trader type comes from a behavioral classifier (monthly turnover, market breadth, leverage, PnL consistency, curated known-MM/vault list); each bucket reports its distinct account count. The market_maker bucket is the basis for /quant/gex. Pro.

curl "https://cryptodataapi.com/api/v1/quant/positioning?symbol=BTC" \
  -H "X-API-Key: cdk_live_your_key"

Dealer positioning / Gamma Exposure — the perpetuals analog of options GEX, built from market-maker accounts. Per coin: mm_net_delta (dealer inventory long/short), gamma_profile (MM liquidation-density by price = where forced unwinds cluster) and gamma_flip (the inflection where MM long-liq-below crosses short-liq-above). Each coin also carries a composite regime flag — amplify (crowded book + dense clusters near mark → forced flow follows through), dampen (balanced, mean-reverting) or transitional (on the flip line) — joining funding skew, OI rate-of-change, the realized-liquidation cascade signal and dist_to_flip_pct, with every sub-signal in regime.inputs. regime.confidence (0–1) scales with the MM account count + gross book behind the read so thin-sample regimes can be down-weighted. gamma_flip is capped to within ±30% of mark and returns null when there is no in-band liquidation crossover (rather than a far-away stale level). Top-level funding_rate/oracle_price/premium/open_interest and a meta.maintenance_margin_tiers ladder are included too. Each coin also carries distribution_context — trailing-30-day percentile ranks of the near-mark cluster density, |distance to flip|, normalized MM skew (mm_net_delta/mm_gross), regime score and funding rate (e.g. “fuel density at the 92nd percentile of 30d”), with history_days/sample_count/status honesty fields; every *_pctile is null while status is warming (<2 days of hourly samples — the history is forward-only) and meta.distribution_legend documents each field. The full per-coin map (incl. distribution_context) is archived at 5-min cadence as the gamma_exposure snapshot type for backtesting. Honest framing: perps have no literal options gamma — this is a behavioral analog from MM inventory + liquidation-driven forced flow, with a heuristic MM set. Full universe on Pro and Pro Plus.

curl "https://cryptodataapi.com/api/v1/quant/gex?symbol=BTC" \
  -H "X-API-Key: cdk_live_your_key"

Hyperliquid whale activity — the entire ≥$100k account universe (the same ~5-min-fresh set behind /quant/positioning and /quant/gex) rolled up into one read. summary: accounts tracked, the behavioral-class split (market_maker / whale / other), aggregate long vs short notional, the long/short ratio and the whole-book net_bias (risk-on/risk-off). top_coins: the cryptos whales hold the most by total notional — per coin the long_usd/short_usd/net_usd/gross_usd, distinct account counts, dominant side and directional_net_usd (net excluding market-maker liquidity = the conviction read). Scope is Hyperliquid perpetuals (the whale margin book); meta.segment is perp and meta.spot_status flags that spot-wallet balances are not yet collected. Crypto-only (no tokenized equities). Full universe on Pro and Pro Plus.

curl "https://cryptodataapi.com/api/v1/quant/whales" \
  -H "X-API-Key: cdk_live_your_key"

Daily time-series of aggregate whale positioning — per UTC day the total long_usd/short_usd/net_usd/gross_usd across the ≥$100k book, plus the day's top coins by net. Full-universe collection is recent, so the earlier portion is modeled: each point carries source (seed | live) and estimated, a seeded baseline anchored to the first live reading that is replaced by observed snapshots as they accrue. meta.seeded_count/live_count report the split. Pro Plus only.

curl "https://cryptodataapi.com/api/v1/quant/whales/history?days=180" \
  -H "X-API-Key: cdk_live_your_key"

Full model transparency on any valid key: version, family, feature lists, raw state counts, walk-forward validation metrics straight from the artifact, artifact sha256, human approval stamp, and live runtime health (universe coverage, log-likelihood drift vs the training baseline, last inference). loaded: false means the data endpoints are 503 (no model deployed yet).

curl "https://cryptodataapi.com/api/v1/quant/model" \
  -H "X-API-Key: cdk_live_your_key"

The 6-regime vocabulary used by every quant endpoint: id, label, display name, description and the suggested algo-basket stance per regime (e.g. squeeze → "breakout algos primed, sizing up"). Open to any valid key.

curl "https://cryptodataapi.com/api/v1/quant/regimes" \
  -H "X-API-Key: cdk_live_your_key"

Force an immediate inference cycle instead of waiting for the next 15-minute tick. Pro Plus only.

curl -X POST "https://cryptodataapi.com/api/v1/quant/refresh" \
  -H "X-API-Key: cdk_live_your_key"

The 10-state long-horizon taxonomy (regimes: id 1–10, machine regime id, name, description, typical duration, directional bias) plus current — the live regime with a plain-English rationale, the inspectable signals that drove it, and an internal stage (Distribution: early_distribution / active_deleveraging) or euphoria_score (Speculative Euphoria: alt_expansion vs blow_off). Open to any valid key.

curl "https://cryptodataapi.com/api/v1/regimes" \
  -H "X-API-Key: cdk_live_your_key"

Just the current long-horizon regime — machine id, name, rationale, optional stage / euphoria_score, the classifier signals and an as_of timestamp. The trimmed companion to /regimes. Open to any valid key.

curl "https://cryptodataapi.com/api/v1/regimes/current" \
  -H "X-API-Key: cdk_live_your_key"

The 50 top-level strategy meta-baskets across 6 groups (A–F). Returns groups (each with id, name and its baskets) plus group_count and basket_count; every basket has a stable slug, name and one-line description. Pro tier.

curl "https://cryptodataapi.com/api/v1/trading-strategy-baskets" \
  -H "X-API-Key: cdk_live_your_key"

Per-asset meme lifecycle regime (euphoric / distribution / ignition / bleeding / dormant) across the curated meme-perp universe. Each entry carries 1d/7d/30d returns, a volume-spike ratio, 30d realized-vol percentile, SMA-20 extension, a regime run-length (days_in_regime + prev_regime + regime_changed, to catch the cross into ignition point-in-time), the exact Hyperliquid hl_symbol join key, and live funding / open interest. Price/vol features are backfillable; funding_rate / oi_usd are live-only (so distribution, and the run-length of any funding-gated state, only resolve live). Screen with ?regime=ignition&sort=vol_spike or ?regime=euphoric&sort=ret_7d&order=desc.

curl "https://cryptodataapi.com/api/v1/meme/regime?regime=ignition&sort=vol_spike&order=desc" \
  -H "X-API-Key: cdk_live_your_key"

Market-wide meme-hype composite (0-100; higher = frothier) + sentiment band (euphoric / heating / neutral / cooling / dormant) + cross-meme co-movement correlation + a meme_season flag (broad heating + correlated pack move) + live median funding + regime aggregate. Also carries a live fresh_issuance froth gauge (DEX-promotion breadth/spend + GoPlus rug density) alongside the backfillable composite. Trimmed companion to /meme/regime — no per-coin list.

curl "https://cryptodataapi.com/api/v1/meme/regime/score" \
  -H "X-API-Key: cdk_live_your_key"

Per-asset Meme regime detail with 60d daily history (close, 30d Garman-Klass vol) for sparkline rendering. Pro / Pro Plus only.

curl "https://cryptodataapi.com/api/v1/meme/regime/WIF" \
  -H "X-API-Key: cdk_live_your_key"

Force recompute the Meme regime cache across the full meme universe. Pro / Pro Plus only.

curl -X POST "https://cryptodataapi.com/api/v1/meme/regime/refresh" \
  -H "X-API-Key: cdk_live_your_key"

Forward catalyst calendar — every dated catalyst in the next window_days (default 7) with its type, date, days-until, affected symbol(s), directional bias, and magnitude, plus the market-wide Event Risk score and band. The main Event/Catalyst payload; use /event/calendar for richer filtering and /event/regime/score for the composite alone.

curl "https://cryptodataapi.com/api/v1/event/regime?window_days=7" \
  -H "X-API-Key: cdk_live_your_key"

Market-wide Event Risk composite (0-100, baseline 0) + band (dormant / quiet / elevated / heavy / critical) + the unlock / macro / depeg sub-scores. Composite = 0.40·unlock + 0.25·macro + 0.35·depeg, re-normalized over available feeds (partial / inputs_available flag which were live). Carries a live-only sector_rotation (CoinGecko categories) sidecar, excluded from the composite so live and backfilled scores stay comparable.

curl "https://cryptodataapi.com/api/v1/event/regime/score" \
  -H "X-API-Key: cdk_live_your_key"

The queryable forward calendar (up to 30d out). Narrow by catalyst type, affected symbol, bias, min_magnitude, and window_days.

curl "https://cryptodataapi.com/api/v1/event/calendar?type=unlock&window_days=30" \
  -H "X-API-Key: cdk_live_your_key"

Per-symbol catalyst overlay — pending catalysts for a coin in the next 7d, its net bias, net magnitude, nearest-event days, and the exact Hyperliquid hl_symbol join key. Pro / Pro Plus only.

curl "https://cryptodataapi.com/api/v1/event/regime/ARB" \
  -H "X-API-Key: cdk_live_your_key"

Force recompute the Event / Catalyst regime cache. Pro / Pro Plus only.

curl -X POST "https://cryptodataapi.com/api/v1/event/regime/refresh" \
  -H "X-API-Key: cdk_live_your_key"

Recent security events — confirmed hacks/exploits and live stablecoin depegs in the last window_days (default 10), each with affected symbol(s), severity, and acute short bias, plus the market-wide Security Stress score and band. Use /security/regime/score for the composite alone.

curl "https://cryptodataapi.com/api/v1/security/regime?window_days=10" \
  -H "X-API-Key: cdk_live_your_key"

Market-wide Security Stress composite (0-100, baseline 0) + band + the hack / flow / depeg sub-scores, the largest in-window hack, and the worst flow symbol/z-score. Composite = 0.45·hack + 0.30·flow + 0.25·depeg, re-normalized over available feeds (partial / inputs_available). Carries a live-only security_headlines sidecar (classified rekt.news / SlowMist RSS), excluded from the composite.

curl "https://cryptodataapi.com/api/v1/security/regime/score" \
  -H "X-API-Key: cdk_live_your_key"

The queryable recent security-events list (up to 10d back). Narrow by event type, affected symbol, and min_severity.

curl "https://cryptodataapi.com/api/v1/security/events?type=hack" \
  -H "X-API-Key: cdk_live_your_key"

Per-symbol security overlay — the security events implicating a coin, its acute bias, max severity, and the exact Hyperliquid hl_symbol join key. Pro / Pro Plus only.

curl "https://cryptodataapi.com/api/v1/security/regime/ETH" \
  -H "X-API-Key: cdk_live_your_key"

Force recompute the Security / Black Swan regime cache. Pro / Pro Plus only.

curl -X POST "https://cryptodataapi.com/api/v1/security/regime/refresh" \
  -H "X-API-Key: cdk_live_your_key"

Policy Risk score + signed policy_tilt (pro-crypto vs restrictive) + the upcoming rate catalysts (FOMC decisions) within window_days. Use /policy/regime/score for the full sub-score breakdown and /policy/headlines for the live US-regulatory feed.

curl "https://cryptodataapi.com/api/v1/policy/regime" \
  -H "X-API-Key: cdk_live_your_key"

Market-wide Policy Risk composite (0-100, baseline 0) + band + signed policy_tilt + the gdelt / cross_asset / rate sub-scores (with the raw GDELT volume z-score & tone). Composite = 0.40·gdelt + 0.35·cross_asset + 0.25·rate, re-normalized over available feeds. Carries a live-only policy_headlines (Federal Register / SEC / CFTC) sidecar, excluded from the composite.

curl "https://cryptodataapi.com/api/v1/policy/regime/score" \
  -H "X-API-Key: cdk_live_your_key"

The live breaking-news sidecar — recent US-regulatory headlines (Federal Register / SEC / CFTC) classified pro-crypto vs restrictive, with an aggregate regulatory_pressure magnitude and a signed headline_tilt. Live-only; not part of any backfillable composite.

curl "https://cryptodataapi.com/api/v1/policy/headlines" \
  -H "X-API-Key: cdk_live_your_key"

Force recompute the Geopolitical / Policy Shock regime cache. Pro / Pro Plus only.

curl -X POST "https://cryptodataapi.com/api/v1/policy/regime/refresh" \
  -H "X-API-Key: cdk_live_your_key"

OHLCV klines from Binance Spot.

curl "https://cryptodataapi.com/api/v1/market-data/klines?symbol=BTCUSDT&interval=1d&limit=200" \
  -H "X-API-Key: cdk_live_your_key"

24hr ticker stats from Binance Spot.

curl "https://cryptodataapi.com/api/v1/market-data/ticker/24hr?symbol=BTCUSDT" \
  -H "X-API-Key: cdk_live_your_key"

Current price from Binance Spot.

curl "https://cryptodataapi.com/api/v1/market-data/ticker/price?symbol=BTCUSDT" \
  -H "X-API-Key: cdk_live_your_key"

BTC price history with 200D MA.

curl "https://cryptodataapi.com/api/v1/market-data/btc-price-history?days=365" \
  -H "X-API-Key: cdk_live_your_key"

Daily volume + buy ratio from remote source.

curl "https://cryptodataapi.com/api/v1/market-data/volume-history?days=30" \
  -H "X-API-Key: cdk_live_your_key"

Short-term BTC price momentum metrics (on-demand computation).

curl "https://cryptodataapi.com/api/v1/market-data/short-term-price" \
  -H "X-API-Key: cdk_live_your_key"

Exchange pair info from Binance Spot.

curl "https://cryptodataapi.com/api/v1/market-data/exchange-info?symbol=BTCUSDT" \
  -H "X-API-Key: cdk_live_your_key"

Trending DEX pools across chains. High-frequency discovery data for meme coin alpha.

curl "https://cryptodataapi.com/api/v1/dex/trending" \
  -H "X-API-Key: cdk_live_your_key"

Newest DEX pools — early discovery of new token launches.

curl "https://cryptodataapi.com/api/v1/dex/new-pools" \
  -H "X-API-Key: cdk_live_your_key"

Token info + top pools for a specific token on a chain.

curl "https://cryptodataapi.com/api/v1/dex/token/solana/So11111111111111111111111111111111" \
  -H "X-API-Key: cdk_live_your_key"

Recently promoted/boosted tokens — marketing spend signal.

curl "https://cryptodataapi.com/api/v1/dex/promoted" \
  -H "X-API-Key: cdk_live_your_key"

Top promoted tokens ranked by promotion spend.

curl "https://cryptodataapi.com/api/v1/dex/promoted/top" \
  -H "X-API-Key: cdk_live_your_key"

Token security report — rug detection, honeypot check, risk scoring.

curl "https://cryptodataapi.com/api/v1/dex/security/solana/So11111111111111111111111111111111" \
  -H "X-API-Key: cdk_live_your_key"

Full daily snapshot of all current (non-history) data in one response. Excludes Binance spot prices and Hyperliquid data which are available via dedicated ``/daily/prices`` and ``/daily/hyperliquid`` endpoints. **Market health block (`market_health`)** Dual-score architecture: 4 long-term components (Price Trend, Market Breadth, Stablecoin Flow 90d, Macro/DXY) + 7 short-term components (Volume Quality, Fear & Greed, Derivatives, Market Breadth Short, Volatility, Short-Term Price, Stablecoin Flow 14d). Combined score = 0.5·LT + 0.5·ST. - `market_health.total_score` / `long_term_score` / `short_term_score`: int 0–100 - `market_health.sentiment` / `long_term_sentiment` / `short_term_sentiment`: BULLISH | NEUTRAL | BEARISH - `market_health.components`: `{name: {score, weight}}` (per-component details are stripped from `/daily`; hit `/market-health` for component `.details`) - `market_health.indicators`: flat denormalization for quick consumption (below) **`market_health.indicators` contract** A flat dict of the most-filtered values from `components.<x>.details`. Keys are **omitted entirely** when the source value is unavailable (never null) so consumers can safely use `dict.get(key, default)` for fallbacks. Committed key set: - `long_short_ratio` (float) — BTC long/short ratio (Binance perps) - `funding_rate` (float, %) — avg funding rate (aliased from `avg_funding_rate`; CoinGlass cross-exchange when available, Binance fallback) - `buy_ratio` (float, 0–1) — weighted taker-buy ratio across top spot pairs - `fear_greed_value` (int, 0–100) — averaged Fear & Greed index - `breadth_pct` (float, %) — share of top-30 coins above their 200D MA - `pct_from_200ma` (float, %) — BTC distance from 200D MA - `cross_status` (str) — Golden | Death | Neutral - `stablecoin_change_7d` (float) — 7-day stablecoin market-cap change **Cross-exchange scope** `market_health` is computed cross-exchange (CoinGlass aggregate + Binance) and is **not** scoped by the `exchange` query param. The `exchange` filter only trims the `coins`, `coinglass.funding`, and `coinglass.liquidations` lists. In particular `indicators.long_short_ratio` is BTC-on-Binance, used as a market-wide sentiment signal — not a per-exchange Hyperliquid metric. **Payload trimming and filter-source readiness** To keep responses small, `coinglass.funding` and `coinglass.liquidations` are always capped at the top 100 entries (sorted by max absolute funding rate and 24h liquidation USD respectively) regardless of the `exchange` filter. The full long tail is available at the dedicated `/market-intelligence/funding-rates` and `/market-intelligence/liquidations` endpoints. When `exchange` is set to a specific venue whose coin set has not yet loaded after server start, this endpoint returns `503` rather than silently emitting the unfiltered payload.

curl "https://cryptodataapi.com/api/v1/daily?exchange=hyperliquid" \
  -H "X-API-Key: cdk_live_your_key"

All Binance spot price pairs (~2,500 symbols).

curl "https://cryptodataapi.com/api/v1/daily/prices" \
  -H "X-API-Key: cdk_live_your_key"

Hyperliquid perpetuals: prices, funding rates, and open interest (~230 assets). Each entry in ``funding_oi`` contains both raw and derived fields: - ``funding_rate`` — Hyperliquid's own funding rate, per HL funding interval (1h on HL by default). Negative values indicate shorts paying longs. This is **Hyperliquid-specific**; cross-exchange averaged funding lives in ``/market-health`` and ``/market-intelligence/funding-rates``. - ``open_interest`` — **in base-coin units** (number of contracts), mirroring the Hyperliquid API. For BTC this might be ``28846.42`` meaning ~28.8K BTC. Use this when comparing across exchanges that quote OI in the same units. - ``open_interest_usd`` — derived notional in USD = ``open_interest * mark_price``. Use this for "is this market large enough to trade?" thresholds. - ``mark_price`` / ``oracle_price`` — both USD. - ``day_ntl_vlm`` — 24h notional volume, **already USD-denominated**. Coverage: every active HL perp (~230). Refresh cadence: 1 minute. Note that thinly-traded perps may emit ``open_interest = 0`` legitimately when no positions are open.

curl "https://cryptodataapi.com/api/v1/daily/hyperliquid" \
  -H "X-API-Key: cdk_live_your_key"

Top trader leaderboard, wallet positions, and tracking metadata.

curl "https://cryptodataapi.com/api/v1/daily/hl-traders" \
  -H "X-API-Key: cdk_live_your_key"

Basic health check endpoint (no auth required).

curl "https://cryptodataapi.com/api/v1/health"

Basic health check endpoint (no auth required).

curl -X HEAD "https://cryptodataapi.com/api/v1/health"

SIGNUM_RGG trend radar across all Hyperliquid perps + top 100 Binance USDT pairs. Each asset gets a daily RED/GREY/GREEN color from ADX(14)+DMI with hysteresis, plus days-in-color, flip date, % change since flip, and (for grey) the 20-day consolidation range.

curl "https://cryptodataapi.com/api/v1/indicators/signum-rgg?sort=days_in_color&order=desc&limit=250" \
  -H "X-API-Key: cdk_live_your_key"

Per-asset SIGNUM_RGG detail with the last 60 days of color history.

curl "https://cryptodataapi.com/api/v1/indicators/signum-rgg/BTC" \
  -H "X-API-Key: cdk_live_your_key"

Force recompute the SIGNUM_RGG cache (Pro tier).

curl -X POST "https://cryptodataapi.com/api/v1/indicators/signum-rgg/refresh" \
  -H "X-API-Key: cdk_live_your_key"

Technical / Structural regime overlay (Regime #14, Pro tier). Per-asset price-structure state across the SIGNUM_RGG universe: SMA-50/100/200 + last cross, Bollinger-band squeeze + 90d bandwidth percentile, 20d range position, and RSI(14) extremes on daily + 1h. Combine filters: ?bb=in_squeeze&sort=squeeze_days&order=desc, ?ma_state=reclaim_200, ?rsi=oversold&min_days_in_state=2.

curl "https://cryptodataapi.com/api/v1/indicators/technical?bb=in_squeeze&sort=squeeze_days&order=desc&limit=50" \
  -H "X-API-Key: cdk_live_your_key"

Per-asset Technical / Structural detail with 60d daily history (close, RSI-14, BB bandwidth, SMA-200, above_200) for sparkline rendering.

curl "https://cryptodataapi.com/api/v1/indicators/technical/BTC" \
  -H "X-API-Key: cdk_live_your_key"

Force recompute the Technical / Structural cache (Pro tier).

curl -X POST "https://cryptodataapi.com/api/v1/indicators/technical/refresh" \
  -H "X-API-Key: cdk_live_your_key"

Scored leaderboard of top traders filtered by performance criteria.

curl "https://cryptodataapi.com/api/v1/hyperliquid/top-traders" \
  -H "X-API-Key: cdk_live_your_key"

Current positions for tracked wallets. For non-tracked addresses, queries Hyperliquid on-demand.

curl "https://cryptodataapi.com/api/v1/hyperliquid/wallet-positions" \
  -H "X-API-Key: cdk_live_your_key"

Position change signals: entries, exits, size increases/decreases.

curl "https://cryptodataapi.com/api/v1/hyperliquid/wallet-signals?minutes=10" \
  -H "X-API-Key: cdk_live_your_key"

Trade profiles with win rate, PnL, classification, and edges.

curl "https://cryptodataapi.com/api/v1/hyperliquid/trader-profiles" \
  -H "X-API-Key: cdk_live_your_key"

Force a synchronous refresh of trade profiles for all tracked wallets. Pro Plus tier — expensive (~15-30s, sequential Hyperliquid calls). Use after a deploy or when cached profiles look stale; the daily 19:00 UTC scheduled refresh covers normal operation.

curl -X POST "https://cryptodataapi.com/api/v1/hyperliquid/trader-profiles/refresh" \
  -H "X-API-Key: cdk_live_your_key"

Force a synchronous refresh of the Hyperliquid leaderboard cache. Pro Plus tier — fetches a ~28 MB payload and takes ~25-30s. Use when /copy-signals or /wallets/search return 0 results and you suspect the in-memory leaderboard is empty (e.g. a startup fetch timed out). The 2-min position refresh job will also auto-recover an empty leaderboard; this endpoint is for forcing it sooner.

curl -X POST "https://cryptodataapi.com/api/v1/hyperliquid/leaderboard/refresh" \
  -H "X-API-Key: cdk_live_your_key"

Search the cached top-leaderboard pool for wallets matching arbitrary gates. Read-only — does not modify the watchlist. Pool is the same ~50-wallet set that auto-watchlist evaluation considers. Refreshed daily at 19:00 UTC.

curl "https://cryptodataapi.com/api/v1/hyperliquid/wallets/search?min_score=0&limit=50" \
  -H "X-API-Key: cdk_live_your_key"

List all watchlisted wallet addresses.

curl "https://cryptodataapi.com/api/v1/hyperliquid/watchlist" \
  -H "X-API-Key: cdk_live_your_key"

Add wallet addresses to the watchlist. Automatically starts tracking for signals.

curl -X POST "https://cryptodataapi.com/api/v1/hyperliquid/watchlist" \
  -H "X-API-Key: cdk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"email": "[email protected]"}'

Remove wallet addresses from the watchlist.

curl -X DELETE "https://cryptodataapi.com/api/v1/hyperliquid/watchlist" \
  -H "X-API-Key: cdk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"email": "[email protected]"}'

Get current auto-managed watchlist configuration and status.

curl "https://cryptodataapi.com/api/v1/hyperliquid/watchlist/auto" \
  -H "X-API-Key: cdk_live_your_key"

Auto-populate watchlist from top traders based on configurable criteria.

curl -X POST "https://cryptodataapi.com/api/v1/hyperliquid/watchlist/auto" \
  -H "X-API-Key: cdk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"email": "[email protected]"}'

Disable auto-management and remove all auto-managed entries.

curl -X DELETE "https://cryptodataapi.com/api/v1/hyperliquid/watchlist/auto" \
  -H "X-API-Key: cdk_live_your_key"

Top traders with their recent signals in a single response. Replaces the 3-step workflow (top-traders → watchlist → signals) with one call. Only returns traders that have signals in the given time window. Profile filters (min_win_rate, min_profit_factor, min_trades_30d, min_avg_duration_hours, exclude_types) are optional and only applied when passed — preserves backward compatibility. Recommended: pass min_trades_30d=30 to drop tiny-sample wallets.

curl "https://cryptodataapi.com/api/v1/hyperliquid/copy-signals?min_score=80&minutes=60" \
  -H "X-API-Key: cdk_live_your_key"

On-demand trade profile for ANY Hyperliquid address. Fetches fill history and computes stats.

curl "https://cryptodataapi.com/api/v1/hyperliquid/trader-profile/So11111111111111111111111111111111?days=30" \
  -H "X-API-Key: cdk_live_your_key"

Historical trades for any Hyperliquid address with summary statistics.

curl "https://cryptodataapi.com/api/v1/hyperliquid/wallet-trades/So11111111111111111111111111111111?days=30" \
  -H "X-API-Key: cdk_live_your_key"

All 8 BTC cycle indicators.

curl "https://cryptodataapi.com/api/v1/market-intelligence/btc/cycle-indicators?days=30" \
  -H "X-API-Key: cdk_live_your_key"

Single BTC cycle indicator by name.

curl "https://cryptodataapi.com/api/v1/market-intelligence/btc/cycle-indicators/puell_multiple?days=30" \
  -H "X-API-Key: cdk_live_your_key"

BTC ETF total assets under management.

curl "https://cryptodataapi.com/api/v1/market-intelligence/etf/btc/aum" \
  -H "X-API-Key: cdk_live_your_key"

BTC, ETH, SOL, or XRP ETF flow history.

curl "https://cryptodataapi.com/api/v1/market-intelligence/etf/btc/flows" \
  -H "X-API-Key: cdk_live_your_key"

Cross-exchange liquidation data. Defaults to Hyperliquid perps coins only. **Filter semantics:** ``exchange=`` is a **coin-set filter**, not an exchange-data filter. With ``exchange=hyperliquid`` you get the coins listed on Hyperliquid, but the liquidation values inside each entry are CoinGlass cross-exchange aggregates (Binance, OKX, Bybit, …). For Hyperliquid's own per-asset trading data use ``/daily/hyperliquid``.

curl "https://cryptodataapi.com/api/v1/market-intelligence/liquidations?exchange=hyperliquid&type=perps&limit=250" \
  -H "X-API-Key: cdk_live_your_key"

BTC options data (OI, volume, max pain).

curl "https://cryptodataapi.com/api/v1/market-intelligence/options" \
  -H "X-API-Key: cdk_live_your_key"

Exchange BTC balance and flow data.

curl "https://cryptodataapi.com/api/v1/market-intelligence/exchange-balance" \
  -H "X-API-Key: cdk_live_your_key"

Coinbase premium index.

curl "https://cryptodataapi.com/api/v1/market-intelligence/coinbase-premium" \
  -H "X-API-Key: cdk_live_your_key"

Cross-exchange funding rates. Defaults to Hyperliquid perps coins only. **Filter semantics:** ``exchange=`` is a **coin-set filter**, not an exchange-data filter. With ``exchange=hyperliquid`` you get the coins listed on Hyperliquid, but each entry's ``stablecoin_margin_list`` / ``token_margin_list`` still shows funding rates from every exchange (Binance, OKX, Bybit, …). For Hyperliquid's own per-asset funding rate use ``/daily/hyperliquid``.

curl "https://cryptodataapi.com/api/v1/market-intelligence/funding-rates?exchange=hyperliquid&type=perps&limit=250" \
  -H "X-API-Key: cdk_live_your_key"

Cross-exchange open interest. Returns multi-symbol data (top ~25 perps) when available, falling back to BTC-only from the fast-refresh cache. **Filter semantics:** ``exchange=`` is a **coin-set filter**, not an exchange-data filter. With ``exchange=hyperliquid`` you get the coins listed on Hyperliquid, but each entry's ``exchange_list`` still aggregates open interest across all CEXes. For Hyperliquid's own per-asset OI use ``/daily/hyperliquid`` — note that ``open_interest`` there is in base-coin units, with ``open_interest_usd`` as a derived USD notional.

curl "https://cryptodataapi.com/api/v1/market-intelligence/open-interest?exchange=hyperliquid&type=perps&limit=250" \
  -H "X-API-Key: cdk_live_your_key"

Grayscale fund holdings.

curl "https://cryptodataapi.com/api/v1/market-intelligence/grayscale/holdings" \
  -H "X-API-Key: cdk_live_your_key"

Grayscale BTC premium/discount history. **Note:** GBTC converted from a closed-end fund to a spot Bitcoin ETF on 2024-01-11. CoinGlass stopped updating premium data after conversion, so this endpoint returns historical data only (through ~Jan 2024).

curl "https://cryptodataapi.com/api/v1/market-intelligence/grayscale/premium" \
  -H "X-API-Key: cdk_live_your_key"

Taker buy/sell volume ratio by exchange, per coin (4h window).

curl "https://cryptodataapi.com/api/v1/market-intelligence/taker-buy-sell" \
  -H "X-API-Key: cdk_live_your_key"

Liquidations broken down by exchange (BTC, 4h).

curl "https://cryptodataapi.com/api/v1/market-intelligence/liquidations/by-exchange" \
  -H "X-API-Key: cdk_live_your_key"

Margin borrow interest rate history (BTC, Binance, 4h).

curl "https://cryptodataapi.com/api/v1/market-intelligence/borrow-interest" \
  -H "X-API-Key: cdk_live_your_key"

Fear & Greed index history with dated entries.

curl "https://cryptodataapi.com/api/v1/market-intelligence/fear-greed-history" \
  -H "X-API-Key: cdk_live_your_key"

Stablecoin market cap history timeseries.

curl "https://cryptodataapi.com/api/v1/market-intelligence/stablecoin-history" \
  -H "X-API-Key: cdk_live_your_key"

Market intelligence collector status and rate usage.

curl "https://cryptodataapi.com/api/v1/market-intelligence/status" \
  -H "X-API-Key: cdk_live_your_key"

CEX stablecoin reserves across ETH/Tron/BSC. Aggregate USDT/USDC/etc. balances held in known hot/cold wallets of the top-5 centralized exchanges. Rising = dry powder accumulating (bullish); falling = capital deployed.

curl "https://cryptodataapi.com/api/v1/on-chain/stablecoin-reserves" \
  -H "X-API-Key: cdk_live_your_key"

Dry-powder signal: z-score of current CEX stablecoin reserves vs trailing 30-day baseline. Returns "accumulating" (z > +1), "neutral", or "depleting" (z < -1). Returns "unknown" until ≥8 historical snapshots collected.

curl "https://cryptodataapi.com/api/v1/on-chain/stablecoin-reserves/dry-powder" \
  -H "X-API-Key: cdk_live_your_key"

Net Transfer flow to/from CEX wallets for a symbol, summed across all chains the symbol exists on. Coverage: ETH (50 ERC-20s + native ETH via balance-delta polling), BSC (9 tokens), Tron (USDT, USDC), and Solana (13 via Helius enhanced API). Returns 1h/6h/24h/7d windows, per-exchange 24h breakdown (binance, coinbase, kraken, bybit, okx), and rolling z-scores. Positive net = deposits (often bearish). Negative net = withdrawals (often bullish). 90d historical depth via /backtesting/daily-snapshots with per-chain breakdown under exchange_flows.by_chain.<chain>.

Caveats: (1) Solana SPL/SOL inflow numbers are systematically low (withdrawals-only bias from CEX-deposit-account model — outflow numbers are accurate). EVM chains unaffected. (2) Native ETH symbol (vs wrapped WETH) is live-only — no historical backfill, accumulates forward from collector start.

curl "https://cryptodataapi.com/api/v1/on-chain/exchange-flows/USDT" \
  -H "X-API-Key: cdk_live_your_key"

Recent large transfers (≥ min_amount, default $1M) to/from tracked CEX wallets. Useful for catching whale-sized deposits in real time across ETH and BSC chains.

curl "https://cryptodataapi.com/api/v1/on-chain/exchange-flows/spike-alerts?min_amount=5000000" \
  -H "X-API-Key: cdk_live_your_key"

BTC miner pool reserves + 24h/7d/30d net flow per pool. Tracks reward addresses for Foundry USA, AntPool, F2Pool, ViaBTC, and Binance Pool. Negative net = miner selling pressure; positive net = miner accumulation.

curl "https://cryptodataapi.com/api/v1/on-chain/miners/reserves" \
  -H "X-API-Key: cdk_live_your_key"

Hash Ribbon indicator: 30dMA vs 60dMA of BTC hashrate. States: "capitulation" (30dMA < 60dMA), "recovery" (just crossed back above within 14d — strongest BTC bottom signal historically), or "normal". Sourced from mempool.space hashrate index (3y daily history).

curl "https://cryptodataapi.com/api/v1/on-chain/miners/hash-ribbon" \
  -H "X-API-Key: cdk_live_your_key"

BTC supply-shock / dormancy signals via CoinMetrics Community API. Returns MVRV with zone classification (capitulation < 1.0, accumulation 1.0-1.5, neutral 1.5-2.5, elevated 2.5-3.5, euphoria > 3.5), active addresses, issuance USD, and chain-wide exchange flow USD as a cross-check on QuickNode ERC-20 flows.

curl "https://cryptodataapi.com/api/v1/on-chain/dormancy/btc" \
  -H "X-API-Key: cdk_live_your_key"

🚧 Coming soon — temporarily disabled (currently returns HTTP 503). Top-100 non-CEX holders across USDT, USDC, WBTC, and WETH on Ethereum. CEX wallets and contract addresses are filtered out so the remaining set represents genuine large economic holders.

curl "https://cryptodataapi.com/api/v1/on-chain/whales" \
  -H "X-API-Key: cdk_live_your_key"

🚧 Coming soon — temporarily disabled (currently returns HTTP 503). Top non-CEX holders of one ERC-20 (USDT, USDC, WBTC, WETH) with 24h/7d/30d aggregate balance deltas. Includes top-5 holder list and the discrete accumulation_signal field (accumulating / neutral / distributing / unknown).

curl "https://cryptodataapi.com/api/v1/on-chain/whales/USDT" \
  -H "X-API-Key: cdk_live_your_key"

🚧 Coming soon — temporarily disabled (currently returns HTTP 503). Aggregate whale accumulation verdict across all tracked ERC-20s. Counts how many tokens are accumulating, neutral, distributing, or unknown and emits a single directional signal.

curl "https://cryptodataapi.com/api/v1/on-chain/whales/accumulation-score" \
  -H "X-API-Key: cdk_live_your_key"

🚧 Coming soon — temporarily disabled (currently returns HTTP 503). Whale accumulation signal for a single ERC-20 token with full 7d/30d delta payload.

curl "https://cryptodataapi.com/api/v1/on-chain/whales/accumulation-score/USDT" \
  -H "X-API-Key: cdk_live_your_key"

Composite 0-100 on-chain health score with per-component breakdown. Synthesizes Hash Ribbon, MVRV zone, stablecoin dry-powder, whale accumulation, exchange-flow direction, and miner net flow into a single directional read. Sentiment bands: bullish (≥70), leaning_bullish (55-69), neutral (45-54), leaning_bearish (30-44), bearish (<30).

curl "https://cryptodataapi.com/api/v1/on-chain/score" \
  -H "X-API-Key: cdk_live_your_key"

Query historical 1-minute OHLCV klines for backtesting.

curl "https://cryptodataapi.com/api/v1/backtesting/klines?exchange=binance&limit=1000&format=json" \
  -H "X-API-Key: cdk_live_your_key"

Query historical funding rates and open interest.

curl "https://cryptodataapi.com/api/v1/backtesting/funding?exchange=hyperliquid&limit=1000" \
  -H "X-API-Key: cdk_live_your_key"

Query historical liquidation data.

curl "https://cryptodataapi.com/api/v1/backtesting/liquidations?limit=1000" \
  -H "X-API-Key: cdk_live_your_key"

Query historical JSON snapshots for a data type. The response is streamed row-by-row (bounded server memory), so large limit=1000 pulls are safe and start returning immediately. For bulk multi-day/-week history, prefer /api/v1/backtesting/archives/download — it returns pre-signed links to pre-built daily files on object storage (one file per data_type per day), which is far cheaper than paginating this endpoint. Perp-regime types: gamma_exposure (MM-lens dealer-gamma, byte-parity with live /quant/gex; includes the per-coin distribution_context percentile block from 2026-07-10), liquidation_map (full-universe density + composite regime per coin) and liquidation_levels (raw per-account liquidation ladders), all at 5-min cadence. Call /backtesting/snapshots/types for the full list with per-type coverage ranges.

curl "https://cryptodataapi.com/api/v1/backtesting/snapshots?limit=100" \
  -H "X-API-Key: cdk_live_your_key"

List all available snapshot data types with row counts and date ranges.

curl "https://cryptodataapi.com/api/v1/backtesting/snapshots/types" \
  -H "X-API-Key: cdk_live_your_key"

List all tracked symbols with available date ranges.

curl "https://cryptodataapi.com/api/v1/backtesting/symbols" \
  -H "X-API-Key: cdk_live_your_key"

Get backtesting storage statistics.

curl "https://cryptodataapi.com/api/v1/backtesting/status" \
  -H "X-API-Key: cdk_live_your_key"

Export kline data as streaming CSV download.

curl "https://cryptodataapi.com/api/v1/backtesting/export?exchange=binance" \
  -H "X-API-Key: cdk_live_your_key"

Return the backtesting archive index — a compact summary of all available data types, symbols, exchanges, and date ranges. Consumers should call this once to discover what's available, then use ``/archives/download`` to fetch specific files.

curl "https://cryptodataapi.com/api/v1/backtesting/archives/index" \
  -H "X-API-Key: cdk_live_your_key"

List archived files available for download from cold storage. Use ``data_type=daily`` for consolidated Parquet files containing all symbols for an exchange in a single file (recommended for bulk downloads). Deep cold tiers: data_type=klines_deep (coarse OHLCV, interval 1h/4h/1d) and data_type=funding_deep (hourly funding_rate only) expose the deep monthly Hyperliquid history — one Parquet per symbol per month, reaching far past the rolling daily files (1d klines back to HL's 2023 launch, 4h to ~2024, 1h to ~7 months; funding_rate to ~2024). Deep 1m klines and historical open_interest/mark_price do not exist from any HL source. See the coverage table in the /api/v1/backtesting/archives/index response and docs/backtester-hl-history.md.

curl "https://cryptodataapi.com/api/v1/backtesting/archives?data_type=klines" \
  -H "X-API-Key: cdk_live_your_key"

Generate pre-signed download URLs for archived files. Use ``data_type=daily`` for consolidated Parquet files (one per exchange) instead of individual per-symbol files. Deep cold tiers: data_type=klines_deep (with interval 1h/4h/1d) and data_type=funding_deep serve the deep monthly Hyperliquid history — one Parquet per symbol per month, reaching far past the rolling daily files. For the deep tiers, start/end match the file's YYYY-MM token, so pass month-granular bounds (e.g. start=2023-06).

curl "https://cryptodataapi.com/api/v1/backtesting/archives/download?data_type=klines_deep&exchange=hyperliquid&symbol=BTC&interval=1d&start=2023-01" \
  -H "X-API-Key: cdk_live_your_key"

List dates (YYYY-MM-DD) for which an archived daily snapshot is available. Snapshots are produced once per day at 20:00 UTC (plus on server startup) and contain everything /api/v1/daily returns, including the composite on-chain health score with per-component breakdown — ideal for time-series regime tagging in backtests.

curl "https://cryptodataapi.com/api/v1/backtesting/daily-snapshots" \
  -H "X-API-Key: cdk_live_your_key"

Retrieve an archived daily snapshot for `date` (YYYY-MM-DD UTC). Returns the full snapshot identical in shape to /api/v1/daily — coin profiles, health score, derivatives, sentiment, macro, on-chain components, and the composite onchain_health_score field.

curl "https://cryptodataapi.com/api/v1/backtesting/daily-snapshots/2026-05-28" \
  -H "X-API-Key: cdk_live_your_key"

Headline NFT trade volume — total + per-chain / per-tier / per-category series, top collections, marketplaces.

curl "https://cryptodataapi.com/api/v1/nfts/overview?days=90" \
  -H "X-API-Key: cdk_live_your_key"

Seeded NFT collection taxonomy — slug, name, chain, category, tier, launch month.

curl "https://cryptodataapi.com/api/v1/nfts/collections" \
  -H "X-API-Key: cdk_live_your_key"

Per-collection daily volume time-series.

curl "https://cryptodataapi.com/api/v1/nfts/collections/{slug}?days=365" \
  -H "X-API-Key: cdk_live_your_key"

Chain breakdown — each chain plus the count of seeded collections on it.

curl "https://cryptodataapi.com/api/v1/nfts/chains" \
  -H "X-API-Key: cdk_live_your_key"

Category taxonomy — fixed buckets (pfp/art/gaming/collectible/music/domain/metaverse/ordinal/other).

curl "https://cryptodataapi.com/api/v1/nfts/categories" \
  -H "X-API-Key: cdk_live_your_key"

Daily NFT volume buckets — choose `by=chain|tier|category|collection`. Pro tier. The collection breakdown can return many series; consumers should expect a wide list when calling with `by=collection`.

curl "https://cryptodataapi.com/api/v1/nfts/volume?by=chain&granularity=daily" \
  -H "X-API-Key: cdk_live_your_key"

Pearson correlation of daily NFT total volume vs daily log-returns of vs= assets. Pro Plus tier. Window is a trailing window ending today. Returns one coefficient per asset plus the number of overlapping days actually used.

curl "https://cryptodataapi.com/api/v1/nfts/correlations?vs=btc,eth,sol&window_days=90" \
  -H "X-API-Key: cdk_live_your_key"

Return plan pricing and supported networks. No auth required.

curl "https://cryptodataapi.com/api/v1/payments/plans"

Subscribe to a pro plan via x402 payment. Flow: 1. If active subscription with >7 days remaining → return it (no charge). 2. If no x-payment header → return 402 with payment options. 3. If x-payment header → verify, settle, upgrade key, create subscription + invoice.

curl -X POST "https://cryptodataapi.com/api/v1/payments/subscribe" \
  -H "X-API-Key: cdk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"email": "[email protected]"}'

Check a discount code and get the discounted USD price per plan. Returns {"valid": false} for any unknown, expired, or exhausted code. To redeem, pass the same code as discount_code in the subscribe / agent-subscribe request body (both calls) — the 402 quote and settlement then use the discounted amount.

curl -X POST "https://cryptodataapi.com/api/v1/payments/validate-code" \
  -H "Content-Type: application/json" \
  -d '{"code": "CDA-XXXXXXXX"}'

Return current subscription status.

curl "https://cryptodataapi.com/api/v1/payments/subscription" \
  -H "X-API-Key: cdk_live_your_key"

List all invoices for this API key's email.

curl "https://cryptodataapi.com/api/v1/payments/invoices" \
  -H "X-API-Key: cdk_live_your_key"

Get a single invoice. JSON by default, ?format=html for printable, ?format=pdf for download.

curl "https://cryptodataapi.com/api/v1/payments/invoices/{number}?format=json" \
  -H "X-API-Key: cdk_live_your_key"

Gasless one-shot onboarding for AI agents. Pay with USDC on Base via x402 -- no ETH gas needed. **How it works (2 HTTP calls):** 1. **Call with no payment header** -- receive 402 with payment options (facilitator URL, price, networks). 2. **Sign the USDC payment with your wallet** (off-chain EIP-712 signature, zero gas). 3. **Call again with `x-payment` header** -- facilitator settles on-chain, you get an API key + PRO subscription. **Supported networks:** Base (USDC), Ethereum (USDC), Solana (USDC). Recommended: **Base** for lowest settlement cost. **Pricing:** - Pro: Monthly $49 USDC (real-time data, derivatives, on-chain analytics) - Pro Plus: Monthly $199 USDC (adds quant/regime engine, historical data & Parquet downloads) **Key resolution on repeat calls:** - Include `X-API-Key` header to renew that key's subscription. - No key header: looks up existing key by your wallet address, or creates a new one. - New API keys are returned **once** -- save it immediately.

curl -X POST "https://cryptodataapi.com/api/v1/payments/agent-subscribe" \
  -H "Content-Type: application/json" \
  -d '{"email": "[email protected]"}'

List all registered webhook endpoints.

curl "https://cryptodataapi.com/api/v1/webhooks" \
  -H "X-API-Key: cdk_live_your_key"

Register a new webhook endpoint with optional address and event filters.

curl -X POST "https://cryptodataapi.com/api/v1/webhooks" \
  -H "X-API-Key: cdk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"email": "[email protected]"}'

Update a webhook endpoint by label.

curl -X PATCH "https://cryptodataapi.com/api/v1/webhooks/{label}" \
  -H "X-API-Key: cdk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"email": "[email protected]"}'

Delete a webhook endpoint by label.

curl -X DELETE "https://cryptodataapi.com/api/v1/webhooks/{label}" \
  -H "X-API-Key: cdk_live_your_key"

Generate an EIP-191 sign-in challenge for a wallet address.

curl -X POST "https://cryptodataapi.com/api/v1/wallet/challenge" \
  -H "Content-Type: application/json" \
  -d '{"email": "[email protected]"}'

Verify an EIP-191 signature and return/create an API key.

curl -X POST "https://cryptodataapi.com/api/v1/wallet/verify" \
  -H "Content-Type: application/json" \
  -d '{"email": "[email protected]"}'

Get wallet session info for the current API key.

curl "https://cryptodataapi.com/api/v1/wallet/session" \
  -H "X-API-Key: cdk_live_your_key"

Verify a USDC transfer on-chain and upgrade the API key to pro.

curl -X POST "https://cryptodataapi.com/api/v1/wallet/upgrade" \
  -H "X-API-Key: cdk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"email": "[email protected]"}'

List all invoices for the current wallet.

curl "https://cryptodataapi.com/api/v1/wallet/invoices" \
  -H "X-API-Key: cdk_live_your_key"

Download a single invoice as PDF.

curl "https://cryptodataapi.com/api/v1/wallet/invoices/{number}" \
  -H "X-API-Key: cdk_live_your_key"

Return public wallet config (treasury addresses, supported networks).

curl "https://cryptodataapi.com/api/v1/wallet/config"

Build a Solana SPL USDC transfer transaction and return base64 bytes. Creates a payment intent binding the sender to the caller's API key. The frontend passes these bytes to Phantom which deserializes, simulates, and signs using its own @solana/web3.js — avoiding cross-module issues.

curl -X POST "https://cryptodataapi.com/api/v1/wallet/create-solana-tx" \
  -H "X-API-Key: cdk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"email": "[email protected]"}'

Proxy: get latest Solana blockhash (avoids CORS issues with public RPCs).

curl "https://cryptodataapi.com/api/v1/wallet/solana-blockhash"

Proxy: check Solana transaction confirmation status.

curl "https://cryptodataapi.com/api/v1/wallet/solana-confirm/{signature}"

User dashboard — API key management, usage stats, invoices.

curl "https://cryptodataapi.com/dashboard"

Pricing plans page.

curl "https://cryptodataapi.com/pricing"

SIGNUM RGG trend radar for the top 100 Binance coins.

curl "https://cryptodataapi.com/signum-rgg-coin-trend-indicator"

NFT trade-volume tracker with BTC/ETH/SOL price overlay.

curl "https://cryptodataapi.com/nft-trends"