Developer Reference

bykaranteli-mcp is an official MCP (Model Context Protocol) server that exposes this API as 45 tools inside Claude, Cursor and any other MCP-capable assistant: market indices, funding heatmap and arbitrage, pressure scores, top movers, the symbols board, daily liquidations and cascades, ETF flows, COT positioning, options snapshot and tape, Coinbase premium, flow toxicity, slippage ladders, FOMC impact, open interest, whale tape, lead-lag, correlations, IV surface, macro liquidity, network health, new listings, venue markets, quantum exposure, the LiqMap liquidation clusters and more. Free, no API key, Node 18+.

claude mcp add bykaranteli -- npx -y bykaranteli-mcp

{
  "mcpServers": {
    "bykaranteli": { "command": "npx", "args": ["-y", "bykaranteli-mcp"] }
  }
}

Source and docs: github.com/bykarantelicom/bykaranteli-mcp · npmjs.com/package/bykaranteli-mcp

Everything above stays free. These endpoints go deeper and price each call in USDC over the x402 protocol, so an autonomous agent can buy one answer without an account, an API key or a subscription. Payment settles onchain per request; there is nothing to sign up for on either side.

# 1. Ask without payment: the endpoint answers 402 with machine-readable terms
curl -i https://bykaranteli.com/api/x402/flow-vpin

# 2. Any x402 client pays and retries automatically
npm i @x402/fetch @x402/core @x402/svm
# wrapFetchWithPayment(fetch, client) -> 200 + data, settled in USDC

Prices are per successful response: a failed request settles nothing. What you pay for is depth and history, never access: every live snapshot above stays free and unmetered.

Symbols board: recorded 24h ticker, funding rate, open interest change and the derivatives pressure score for every tracked Binance USDT-M perpetual.

curl -s 'https://bykaranteli.com/api/public/symbols?sort=change&top=20' | jq '.symbols[:5]'

{
  "generatedAt": "2026-09-05T09:00:00.000Z",
  "sort": "volume",
  "totalSymbols": 512,
  "symbols": [
    {
      "symbol": "BTCUSDT", "lastPrice": 109412.5, "change24hPct": 1.84,
      "quoteVolume24h": 21874112034.1, "fundingRatePct": 0.0081,
      "openInterestUsd": 12041233810.4, "oi24hPct": 2.1,
      "pressureScore": 61, "pressureDirection": "LONG",
      "pressureUpdatedAt": "2026-09-05T08:45:12.000Z"
    }
  ]
}

Composite 0-100 derivatives pressure score for every tracked Binance USDT-M perpetual (OI delta 1h/4h/24h + funding rate + basis). Direction-aware regimes.

curl -s 'https://bykaranteli.com/api/public/pressure?limit=20&side=long' | jq '.items[:5]'

{
  "generatedAt": "2026-04-23T20:47:28.616Z",
  "count": 60,
  "items": [
    {
      "symbol": "BARDUSDT",
      "score": 45, "direction": "SHORT", "regime": "SHORT_RAMP",
      "regimeLabel": "Net short bias building",
      "components": { "oi24hPct": -8.7, "oi4hPct": 1.5, "oi1hPct": 0.1, "fundingRatePct": -0.037, "basisPct": -0.19 },
      "explainer": [ "Open interest down 8.7% over 24h", "Funding rate -0.037% per interval" ]
    },
    …
  ]
}

Per-symbol pressure snapshot with live refresh if cache stale.

curl -s https://bykaranteli.com/api/public/pressure/BTCUSDT

Cross-exchange funding rate spread for top symbols across 6 exchanges (Binance, OKX, Bybit, Gate, HTX, BingX) with net-of-cost annualized APR.

curl -s https://bykaranteli.com/api/public/funding-arb | jq '.rows[:5]'

Public LiqMap snapshot (24H): multi-exchange liquidation-level estimate for 100 major perpetuals (Binance + Bybit + OKX + Gate + HTX + Hyperliquid) with real liquidations overlaid. ?symbol=BTC..OP.

curl -s 'https://bykaranteli.com/api/liqmap/public?symbol=BTC' | jq '.real_levels.totals'

Funding rate heatmap snapshot: current rate, next settlement, and 24h history buckets for every tracked Binance USDT-M perpetual.

curl -s https://bykaranteli.com/api/public/heatmap | jq '.rows[:5]'

24h top gainers and losers across tracked perpetuals with price, volume, and open interest deltas.

curl -s https://bykaranteli.com/api/public/top-movers | jq '.gainers[:5]'

Altcoin Season Index: live reading, strongest and weakest large alts, recorded daily history.

curl -s https://bykaranteli.com/api/public/altseason | jq '.value'

Eight equal-weight narrative indices (AI, RWA, DePIN, meme, L1, L2, DeFi, quantum) with fixed baskets and daily points since 2025-01-01; add ?points=0 for the scoreboard only.

curl -s https://bykaranteli.com/api/public/themes | jq '.themes[] | {key, last, ret_30d_pct}'

Factor board: every recorded metric in its historical band with the median 7-day BTC move that followed versus the base rate.

curl -s https://bykaranteli.com/api/public/factors | jq '.rows[:5]'

Margin borrow rates: the latest annualised rate per venue and asset (USDT, USDC, BTC, ETH and major alts; Binance and OKX today), 30 days of hourly series for the stablecoins and majors, and the funding minus borrow carry per venue. Recorded hourly. CC0.

curl -s 'https://bykaranteli.com/api/public/borrow-rates' | jq '.latest[:5], .carry[:3]'

Trading fee schedules: base tier maker and taker per venue and market type (median across pairs where the venue prices per pair), read daily from each exchange's own fee endpoint, plus the fee change log. CC0.

curl -s 'https://bykaranteli.com/api/public/fees' | jq '.median_taker_perp, .rows[:5]'

Expiry calendar and settlement prices: the next 60 days of dated future and option expiries across 54 venues' market lists, grouped by date, venue and underlying, plus the settlement prices recorded as dated futures deliver (OKX, HTX, Crypto.com today). CC0.

curl -s 'https://bykaranteli.com/api/public/settlements' | jq '.next_7d, .upcoming[:5], .recorded[:3]'

One exchange, everything we record about it: contracts on file by type, basket open interest and average funding from the 10-minute venue recorder, leverage ladder summary, deposit and withdrawal network counts, base fee schedule, status uptime and the recent event log. ?venue=bybit; without a venue, the list of recorded venue ids. The JSON behind /venues/<venue>. CC0.

curl -s 'https://bykaranteli.com/api/public/venues/profile?venue=bybit' | jq '.instruments, .status, .events[:3]'

Deposit and withdrawal networks on every venue we record (20+ exchanges), recorded daily as slowly changing rows: per asset and network the deposit flag, withdrawal flag, withdrawal fee and minimum, plus the log of suspensions and resumptions. Without filters: withdrawals paused right now, ranked. ?asset=USDT: every venue and network for that asset; ?venue=kucoin narrows. CC0.

curl -s 'https://bykaranteli.com/api/public/withdrawals?asset=USDT' | jq '.rows[:5]'

Leverage ladders per perpetual on every venue we record (Bybit, OKX, Gate, HTX, Bitget, MEXC and more), recorded daily as slowly changing rows: tier, notional floor and cap, maximum leverage, maintenance margin rate, plus the change log of leverage cuts and raises. ?symbol=BTC narrows to one base asset, ?venue=okx to one exchange; without filters you get the cross-venue overview. CC0.

curl -s 'https://bykaranteli.com/api/public/leverage-tiers?symbol=SOL' | jq '.rows[:5]'

Venue layer aggregates across 56 feeds on 43 exchanges: total perp OI, DEX share, funding range, spot dispersion, stablecoin pegs; ?symbol=BTC for one coin's rows.

curl -s https://bykaranteli.com/api/public/venues/markets | jq '.symbols[:3]'

Who moves first: one-minute return cross-correlations per venue pair and UTC day with the lead asymmetry.

curl -s https://bykaranteli.com/api/public/venues/lead-lag | jq '.pairs[] | {id, summary}'

IV surface by expiry and moneyness, per-expiry ATM / 25-delta put and call IV, skew and butterfly, constant-30d history; ?currency=BTC|ETH.

curl -s https://bykaranteli.com/api/public/options/surface?currency=BTC | jq '{atm_30d, skew25_30d_pp}'

Deribit options snapshot: OI walls, dealer gamma exposure, zero-gamma level, DVOL, term structure.

curl -s https://bykaranteli.com/api/public/options | jq '.BTC.snap | {spot, call_wall, put_wall}'

Deribit + OKX options tape recorded every 15 minutes: premium, strikes, put/call, block trades, venue per print.

curl -s https://bykaranteli.com/api/public/options-flow | jq '.summary'

US spot BTC, ETH and SOL ETF flows: today's provisional aggregate with the per-fund table, the last 30 finalized trading days, and the IBIT issuer check (BlackRock shares outstanding x NAV vs the tape).

curl -s https://bykaranteli.com/api/public/etf | jq '{btc: .assets.BTC.latest_finalized, issuer: .issuer_check}'

Order-flow toxicity (VPIN) computed from taker prints, 120 days of history.

curl -s https://bykaranteli.com/api/public/flow | jq '.latest'

Coinbase premium versus Binance and cash-and-carry basis, daily history back to 2017; Kimchi premium (Upbit, Bithumb, Coinone) and Turkey premium (BtcTurk) since 2026-08-21.

curl -s https://bykaranteli.com/api/public/premium | jq '.latest'

CFTC Commitments of Traders for Bitcoin futures, weekly, backfilled to 2018.

curl -s https://bykaranteli.com/api/public/cot | jq '.latest'

FOMC meetings with the measured 5, 30 and 60-minute BTC reaction (CPI and jobs report join once the release calendar is connected).

curl -s https://bykaranteli.com/api/public/events | jq '.reactions[-3:]'

Live execution slippage ladders by order size from real order books, recorded hourly.

curl -s https://bykaranteli.com/api/public/slippage | jq '.live'

Whale tape: $1M+ aggressive market prints from our own sockets with 24h aggregates and buy share.

curl -s https://bykaranteli.com/api/public/whales | jq '.aggregates'

Bitcoin cycle indicators recomputed nightly from a first-party close record since 2012: Pi Cycle Top (with cross dates), Mayer Multiple, 200-week and 2-year MAs, golden ratio multiple, profitable days, stock-to-flow, Puell Multiple from our own node, Bitfinex margin positioning. ?days= window, ?points=0 for latest only.

curl -s 'https://bykaranteli.com/api/public/indicators?points=0' | jq '.latest, .pi_cycle_crosses'

RSI heatmap: Wilder RSI(14) on eight intervals (15m to 1M) for ~580 Binance USDT perpetuals, crypto top-400 by volume plus every TradFi perp, with overbought and oversold counts per interval. ?symbol=, ?kind=crypto|tradfi and ?sort=<interval> filter and order.

curl -s 'https://bykaranteli.com/api/public/rsi?sort=4h' | jq '.summary, .rows[:5]'

Multi-venue open interest history: hourly sum of perp open interest across every venue in our registry at the hour's last 10-minute snapshot (whitebit and bitmart excluded), the DEX share (Hyperliquid, dYdX, Aster, Paradex, Lighter, GMX) and the current OI-weighted funding. ?days=1..90, default 30; recorded since 2026-08-21.

curl -s 'https://bykaranteli.com/api/public/venues/oi-history?days=7' | jq '.oi_weighted_funding_pct, .points[-1]'

Coverage registry derived live: liquidation feeds per venue with kind (full, sampled, delayed, shadow, none), since date, 24h events and last record; 10-minute snapshot feeds per venue and market with symbol counts and last bucket; funding arbitrage legs, positioning sources, whale tape, spot minutes and the Hyperliquid whale scan with freshness.

curl -s https://bykaranteli.com/api/public/coverage | jq '.totals, .liquidations[:3]'

Recorded time series behind the SuperChart, one shape for every metric: price candles (own minute recorder), volume, perp and spot CVD, open interest, funding, liquidation prints (signed), long/short and top-trader ratios, RSI, Coinbase premium, US spot ETF net flow and Hyperliquid whale net. Parameters: metric, symbol (BTCUSDT), period (15m, 1h, 4h, 1d; 5m for signed-in accounts), limit (300 anonymous, 5000 signed in), to (ISO). Every response names its source. Add venue=<id> (bybit, okx, gate, hyperliquid and every venue in the recorder) for price, open interest and funding from that exchange; Binance stays the default.

curl -s 'https://bykaranteli.com/api/series?metric=oi&symbol=BTCUSDT&period=1h&limit=200' | jq '.source, .points[-3:]'

Spot order book depth for BTC, ETH, SOL, XRP, DOGE, ADA, LINK, AVAX, LTC and BNB: the books of Binance, Coinbase, Kraken, Bybit and OKX binned into 0.1% buckets within 20% of mid (USD notional, bids and asks arrays), the largest walls with venue split, 2% depth and book reach per venue; ?hours=1..24 adds the summed 5-minute history. Raw per-venue snapshots on the paid route /api/x402/orderbook-history.

curl -s 'https://bykaranteli.com/api/public/orderbook?symbol=BTC&hours=6' | jq '.walls[:5], .venues'

Positioning board for the 30 most traded Binance USDT perps: Binance global and top-trader long/short account and position ratios and taker buy/sell ratio, Bybit share of accounts long, OKX long/short ratio, top-trader position ratio and taker volume, plus CVD series (24h at 5m, 7d at 1h) for BTC, ETH and SOL. Hourly history on the paid route /api/x402/positioning-history.

curl -s 'https://bykaranteli.com/api/public/positioning?symbol=BTCUSDT' | jq '.rows[0]'

Jupiter Perps (Solana) board: exact long and short open interest per market (SOL, ETH, BTC) from the on-chain custody state, pool utilization and hourly borrow rates, JLP AUM and APR, 24h volume, the week's top traders by realized PnL. ?base=SOL&days=7 adds hourly OI history (max 30 days).

curl -s 'https://bykaranteli.com/api/public/jupiter?base=SOL&days=1' | jq '.markets[0], .history.points[-1]'

Hyperliquid whale tracker: the 300 largest accounts by equity scanned every 5 minutes, long vs short notional per coin with the largest position on each side, every open position, and with events=1 the last 200 position changes (opened, closed, increased, reduced, flipped). Paid full event history on /api/x402/hl-whale-events.

curl -s 'https://bykaranteli.com/api/public/hyperliquid-whales?coin=BTC&events=1' | jq '.by_coin, .events[:5]'

TradFi perpetuals board: every Binance stock, index and commodity perp with funding, basis, open interest, 24h volume and liquidations, which other venues list it, and the trading-session state. ?market= and ?symbol= filter.

curl -s 'https://bykaranteli.com/api/public/tradfi?market=EQUITY' | jq '.rows[:5]'

Recorded 24h liquidations by side, symbol and venue, the coverage kind of every venue, and a coverage-adjusted market estimate with its inputs.

curl -s https://bykaranteli.com/api/public/liquidations | jq '{recorded, market_estimate, by_exchange}'

Auto-detected liquidation cascades with size, side, coins and price path.

curl -s https://bykaranteli.com/api/public/incidents | jq '.[0]'

Open interest leaderboard: intraday OI gainers and losers.

curl -s https://bykaranteli.com/api/public/oi | jq '.gainers[:5]'

30-day rolling Pearson correlation matrix of daily returns across the top perps.

curl -s https://bykaranteli.com/api/public/correlations | jq '.symbols'

PsiCharge liquidity-state model: score, state and the published year-by-year scorecard.

curl -s https://bykaranteli.com/api/public/charge | jq '{score, state}'

Quantum-exposed Bitcoin supply measured daily from our own node, with provenance hashes.

curl -s https://bykaranteli.com/api/public/quantum | jq '{exposed_btc, base_height}'

Macro liquidity series: Fed funds, 10-year yield, Fed balance sheet, reverse repo and stablecoin supply; ?days=365.

curl -s https://bykaranteli.com/api/public/macro | jq '.latest'

Bitcoin network health from our own node: hashrate, difficulty, fees, mempool; ?days=365.

curl -s https://bykaranteli.com/api/public/network | jq '.latest'

New and delisted perpetual contracts across six exchanges, scanned hourly; ?days=30.

curl -s https://bykaranteli.com/api/public/listings | jq '.listed[:5]'

Band-conditioned context for any recorded metric: where today sits and what followed; ?metric=coinbase_premium_pct.

curl -s https://bykaranteli.com/api/public/context | jq '.interpretationEn'

Smart-money read for one symbol from recorded positioning.

curl -s https://bykaranteli.com/api/public/smart-money/BTCUSDT | jq '.'

19 CC0 datasets as CSV or JSON: market history, symbol board, listings, liquidations, ETF flows (total + by fund), COT, premium, DVOL, options chain + flow, metrics, quantum, theme indices, venue markets, whale trades, stablecoin pegs, basis, slippage. Full catalog at /data. Daily CSV mirrors: github.com/bykarantelicom/crypto-datasets

curl -s https://bykaranteli.com/api/v1/public/datasets/daily-market.csv | head -5

All market indices in one payload: Retail Euphoria Index (proprietary) + Fear & Greed (alternative.me) + CoinGecko global + DeFiLlama stablecoin flow + the Altcoin Season Index (top-50 alts vs BTC, 90d).

curl -s https://bykaranteli.com/api/public/indices | jq '.euphoria.score, .fearGreed.today.valueRaw'

Retail Euphoria Index standalone. Composite of F&G + trending memes + BTC dominance + top-30 crowd positioning.

curl -s https://bykaranteli.com/api/public/euphoria | jq '{score, regime, explainer}'

Embeddable HTML widget showing current pressure score for a symbol. Use in iframe. Dark theme, no tracking.

<iframe src="https://bykaranteli.com/embed/pressure/BTCUSDT" width="340" height="200" style="border:0"></iframe>

Embeddable 24h liquidations widget: long/short totals, event count, top symbols, largest print. Gallery and terms at /widgets.

<iframe src="https://bykaranteli.com/embed/liquidations" width="100%" height="300" style="border:0"></iframe>

Embeddable spot order book depth widget for one of the ten tracked coins: 2% depth, imbalance, walls, mirrored bin strip.

<iframe src="https://bykaranteli.com/embed/orderbook/BTC" width="100%" height="380" style="border:0"></iframe>

Embeddable long/short positioning widget for one perp (Binance, Bybit, OKX ratios and taker flow).

<iframe src="https://bykaranteli.com/embed/positioning/BTC" width="100%" height="200" style="border:0"></iframe>

Embeddable Hyperliquid whales widget: long versus short notional of the top-300 accounts per coin.

<iframe src="https://bykaranteli.com/embed/whales" width="100%" height="330" style="border:0"></iframe>

Embeddable RSI(14) breadth widget: overbought/oversold counts per interval plus the extremes on ?interval.

<iframe src="https://bykaranteli.com/embed/rsi?interval=4h" width="100%" height="340" style="border:0"></iframe>

<div id="bk-movers"></div>
<script>
  (async () => {
    const r = await fetch('https://bykaranteli.com/api/public/symbols?sort=change&top=5');
    const j = await r.json();
    document.getElementById('bk-movers').innerHTML =
      j.symbols.map((s) => `${s.symbol} ${s.change24hPct >= 0 ? '+' : ''}${s.change24hPct.toFixed(2)}%`).join(' · ')
      + ` · <a href="https://bykaranteli.com/symbols">source</a>`;
  })();
</script>

• Rate limit is 20 requests per minute per IP, as fair use. There is no hard gate today; clients far above it get blocked.
• Data is read-only. No PII or trading actions exposed.
• Attribution: a visible link back to bykaranteli.com or the source page (e.g. /symbols) is appreciated when embedding.
• Commercial use is allowed. Rebranding our numbers as your own in-house backtest is not.
• Scraping internal routes (/dashboard/*, /api/admin/*, /api/member/*) is blocked and monitored. Stick to /api/public/*.