Developer Reference

Send your account key on the handshake as Authorization: Bearer bk_... or x-api-key: bk_... (the same key as the REST API). Keys in the query string are refused. Free and Terminal keys get 403 plan_required.

bykaranteli-mcp is an official MCP (Model Context Protocol) server that exposes this API as 68 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 account key (BYKARANTELI_API_KEY), Node 18+. Beyond the boards: get_series returns any recorded series by metric, symbol and period, parse_alert_text turns a sentence such as "BTC funding above 0.05%" into an alert, and the account tools list and change your own alerts and watchlist with the same key (the tools that change something are marked as writes, count on your plan and are recorded on your account). Every market answer carries a provenance block: the venues behind the number, full or sampled coverage, freshness and the proof page.

claude mcp add bykaranteli -e BYKARANTELI_API_KEY=bk_... -- 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

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. A paid call reads the whole archive at the route's own row cap for $0.10. Builder keys and above run the same routes unpaid on the plan: Builder 1,000 catalog calls a month over the last 90 days at up to 5,000 rows a call, summary series only; Business 10,000 a month over the last 365 days at up to 20,000 rows, raw records included; Scale and Enterprise with no ceiling over the whole archive. The window counts from 00:00 UTC of its first day, and each included call also counts as 10 requests of the plan's monthly fair use. Raw records (individual liquidation events and the largest-print ranking, whale prints, Hyperliquid position events and hourly position records, order book snapshots, minute bars and per-venue market snapshots: liquidations-raw, liquidation-leaderboard-history, hl-whale-events, hl-positions-history, orderbook-history, spot-microstructure, venue-markets-history, whale-trades-raw) are included from Business up. A route's history_since is its first recorded row; an included call reads from the plan's window start (x-history-window-days). Past the ceiling (x402_allowance_used, HTTP 402), before the window (history_window, HTTP 403) or on a raw record route below Business (raw_tier_required, HTTP 403), the call is paid per call: send the account key as Authorization: Bearer with a prepaid key in x-api-key, or send the call without the account key and pay the 402 with a wallet. Bulk exports are on Business and above, outside the ceiling, and list the months that reach into the plan's window.

# 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 with an account key, within your plan's limits.

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

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" '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"
    }
  ]
}

Market Profile of one Binance USDT-M perpetual from our own minute bars, one row per closed UTC day, newest first: poc (the price bucket with the most TPO marks), val and vah (the 70% value area), ib_low and ib_high (the first hour UTC), vpoc (the bucket with the most quote volume), open, high, low, close, tpo_total and periods. naked_pocs lists the points of control of the last 60 recorded days that no later closed day has traded through; profile_latest gives the latest day's [price, tpo, volume_usd] per bucket. 30-minute TPO periods, buckets of 0.05% of the day's open. Any key gets 30 days; up to 400 is member depth (a Terminal session or a Builder key and above). A symbol without recorded minute bars answers 404 no_profile. Every day's levels are in the market-profile-daily dataset; each day's full profile is on the paid route /api/x402/market-profile-history.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/market-profile?symbol=BTC&days=5' | jq '{symbol, recorded_since, latest: .days[0], naked_pocs}'

Weekend and overnight gaps of the stock, index and commodity perpetuals against our own record of the US cash close: the reference is the median venue price in the last 10-minute snapshot before 16:00 New York. window=weekend (default, the last 12 weekends: sat_12, sun_12, sun_20, pre_open, open) or night (the last 20 nights after a Monday to Thursday close: utc_04, pre_open, open); open is the first snapshot after 09:30 New York. Each checkpoint carries price (the venue median), venues, spread_pct (highest minus lowest venue over the median), gap_pct, lo_pct and hi_pct against the reference. Without symbol: kpis, summary per underlying (median absolute gap at the lead point and at the open, same_direction_pct once 5 windows hold both readings, median spread) and latest, the newest window with every underlying; with symbol=TSLA: that underlying's summary and every window. Recorded since 2026-08-25; no holiday calendar. Every window and checkpoint is in the tradfi-gaps dataset; the raw 10-minute venue snapshots are on the paid route /api/x402/venue-markets-history.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/tradfi-gaps?window=weekend&symbol=TSLA' | jq '.summary, .windows[0].symbols[0].points'

Share of each counted liquidation venue (Binance, Bybit, OKX, Gate, HTX, dYdX, Aster, Lighter, Kraken Futures, GMX and Deribit) in the recorded total over days=1 (default), 7 or 30: usd, long_usd, short_usd, events, share_pct, long_share_pct, since (the venue's first counted day when it falls in the window) and trend_pp (the share over the last 7 days minus the 7 before, null when the venue was not counted for the whole earlier span). daily is a day by venue share table for the last 30 UTC days (today partial); oi gives each venue's share of perp open interest in the latest hour and over 7 days. Shadow venues and venues without a public feed are not in the total. The day rows are the venue-share-daily dataset; hourly rows per venue with each hour's total are on the paid route /api/x402/venue-share-history.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/venue-share?days=7' | jq '{total_usd, venues: [.venues[] | {exchange, share_pct, trend_pp}]}'

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 -H "Authorization: Bearer $BYKARANTELI_API_KEY" '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 -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/pressure/BTCUSDT

Cross-exchange funding rate spread for top symbols across 33 exchanges (Binance, OKX, Bybit, Gate.io, HTX, BingX, Bitget, MEXC, Kraken Futures, Hyperliquid, Aster, dYdX, ApeX, Backpack, Bitfinex, Bitmart, BloFin, BTSE, Crypto.com, Delta Exchange, Deribit, DigiFinex, Extended, HashKey, KuCoin, Lighter, Paradex, Phemex, Toobit, WEEX, WhiteBIT, WOO X and XT) with net-of-cost annualized APR.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/funding-arb | jq '.rows[:5]'

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

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/liqmap/public?symbol=BTC' | jq '.real_levels.totals'

Funding snapshot for a fixed set of large Binance USDT-M perpetuals: per symbol the current funding rate, the 24h open interest change and the 24h price change; ?format=csv returns the same rows as CSV.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/heatmap | jq '.rows[:5]'

Top movers of the pressure board: the perpetuals with the largest absolute 24h open interest change (biggestOi24h), the most extreme funding rate (extremeFunding), the widest basis (widestBasis) and the highest pressure score (highestStress), each with its direction. ?format=csv returns the four lists as one CSV.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/top-movers | jq '.biggestOi24h[:5]'

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

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 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 -H "Authorization: Bearer $BYKARANTELI_API_KEY" 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 -H "Authorization: Bearer $BYKARANTELI_API_KEY" 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 on every venue whose borrow history we can read), 30 days of hourly series for the stablecoins and majors, and the funding minus borrow carry per venue. Recorded hourly.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" '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.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" '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 53 venues' market lists, grouped by date, venue and underlying, plus the settlement prices recorded as dated futures deliver; recorded_venues counts the venues with a recorded price.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" '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>.

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

Deposit and withdrawal networks on every venue we record, 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.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/withdrawals?asset=USDT' | jq '.rows[:5]'

Leverage ladders per perpetual on every venue whose ladders we read, 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.

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

Venue layer aggregates across every perpetual and spot feed we poll (listed in coverage): total perp OI, DEX share, funding range, spot dispersion, stablecoin pegs; ?symbol=BTC for one coin's rows. The venues in oi_excluded_venues (WhiteBIT, BitMart) are listed but left out of the OI totals and the DEX share.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 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 -H "Authorization: Bearer $BYKARANTELI_API_KEY" 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 -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/options/surface?currency=BTC' | jq '{atm_30d, skew25_30d_pp}'

Options snapshot across Deribit, Bybit, Binance, OKX and Delta Exchange: OI walls, dealer gamma exposure, zero-gamma level, term structure, and each venue's share in venues_included. DVOL is Deribit's index.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" "https://bykaranteli.com/api/public/options?venue=all" | jq '.assets.BTC | {venues_included, call_wall, put_wall}'

Hourly options chain across Deribit, Bybit, Binance, OKX and Delta Exchange, recorded since 2026-09-30: per expiry the open interest in coins and USD with its 1 hour and 24 hour change, the ATM IV and its 24 hour change and max pain; per contract the open interest and its changes, the mark IV and its 24 hour change and Deribit's mark, bid and ask in coins; and the hourly ATM IV path of one expiry over the last 24 hours. A change counts only the venues present in both hours. Any key gets the 40 contracts with the largest open interest; strikes=all returns every contract with member depth (a Terminal session or a Builder key and above).

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/options/chain?currency=BTC&venue=all' | jq '{hour, spot, front_expiry, expiries: .expiries[:3], strikes: .strikes[:3]}'

Deribit and OKX options tape recorded every 15 minutes: premium, strikes, put/call, block trades, venue per print; windows (1h, 4h and 24h bought, sold and signed net premium per option type), by_expiry, by_strike, by_venue and the latest multi-leg structures with their legs and a structure label.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/options-flow | jq '.assets.BTC | {prints_24h, call_premium_bought_24h_usd, put_premium_bought_24h_usd, block_share_24h}'

US spot BTC, ETH, SOL and XRP 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 -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/etf | jq '{btc: .assets.BTC.latest_finalized, issuer: .issuer_check}'

Order-flow toxicity (VPIN) per major perp from taker-signed minute bars: the current reading, its percentile over the last 90 days with the 90th percentile threshold, the 24h average and the bucket size. The daily history is on the paid route /api/x402/flow-vpin.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/flow | jq '.symbols.BTCUSDT | {vpin, percentile_90d, avg_24h}'

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 -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/premium | jq '.assets.BTC | {date, premium_pct, avg7_pct}'

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

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/cot | jq '.assets.BTC | {report_date, hedge_funds_net_contracts, institutions_net_contracts}'

Measured 5, 30 and 60-minute BTC reactions to FOMC statements (top level) and to CPI and jobs report releases (cpi, nfp), each with the next scheduled date, plus the dated macro calendar under events.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/events | jq '{fomc: .recent_reactions[:3], cpi_next: .cpi.next_release, nfp_next: .nfp.next_release}'

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

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/slippage | jq '.ladders[:3]'

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

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/whales | jq '.window_24h'

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 -H "Authorization: Bearer $BYKARANTELI_API_KEY" '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 the top-400 Binance USDT crypto perpetuals 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 -H "Authorization: Bearer $BYKARANTELI_API_KEY" '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 most complete 10-minute snapshot (whitebit and bitmart excluded), the DEX share (the on-chain venues listed in dex_venues) and the current OI-weighted funding. ?days=1..90, default 30; recorded since 2026-08-21.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" '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 -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/coverage | jq '.totals, .liquidations[:3]'

Recorded time series behind the SuperChart, one shape for every metric. Parameters: metric (price, volume, cvd_perp, cvd_spot, oi, funding, funding_agg, liquidations, long_short, top_traders, rsi, premium, etf_flow, borrow, whale_net), symbol (BTCUSDT), period (15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1M; 1m, 3m, 5m, 10m with member depth), limit (up to 300 bars; up to 5,000 with member depth), to (ISO). Member depth comes with a Builder key or above, or with a Terminal membership signed in on the site; a Free or Terminal key gets the default depth and 403 on 1m, 3m, 5m, 10m. Without member depth, to works inside the newest 300 bars; an older to answers 403 history_member_only, except daily and coarser price bars. 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 -H "Authorization: Bearer $BYKARANTELI_API_KEY" '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, OKX, Gate, MEXC, HTX, Bitget, Bitstamp, Gemini, Bitfinex, BingX, Crypto.com, Backpack, Binance US, Poloniex, LBank, Bitrue, XT, HashKey, DigiFinex, Bullish, WEEX, Deribit, Aster, Bitvavo, Independent Reserve and BtcTurk 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. Each venue row carries in_aggregate: false marks a book we record but hold out of the sums and walls because its size is not corroborated; held_out lists those venues and aggregate_venues counts the summed ones. Raw per-venue snapshots on the paid route /api/x402/orderbook-history.

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

Positioning board for the 30 most traded Binance USDT perps: each venue's own published long/short account and position ratios and taker flow on Binance, Bybit, OKX, Gate, HTX, Bitget and Kraken Futures, plus Bitfinex long and short margin position sizes on its spot margin book (margin borrowers, not perpetual accounts), GMX and Jupiter Perps long and short open interest in dollars (pool-based perpetual DEXes: a side split, not an account ratio), and 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 -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/positioning?symbol=BTCUSDT' | jq '.rows[0]'

Desk notes, newest first: short dated observations the desk writer (an AI model) wrote from ByKaranteli's own recorded derivatives data and checked against it before publishing, each with its publish time in UTC, the card's data time, the desk's 0 to 10 news value, the board it reads from, the coins it names and a permanent URL. Default the last 24 hours; ?day=YYYY-MM-DD for one UTC day, ?since=<iso> for up to 7 days back, ?type=<card> for one card type, ?lang=zh|ru|ko for a translation (a note without one comes back in English and says so), ?limit=1..100. The archive across days and languages is on /api/x402/desk-notes-history; the English text per note is in the free dataset desk-notes; RSS at /desk/feed.xml.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/desk?limit=5' | jq '.notes[] | {published_at, type, headline, url}'

Turkey premium board: five TRY and USDT reference prices built every minute from Turkish spot venues (median mid of eligible books), each venue's book status, spread and depth, and the premium in bps (TRY pairs via USDT/TRY against the Binance global price; USDT/TRY against the ECB fix). ?pair=BTC-TRY&days=1..30 adds 15-minute history; free daily CSV at /api/v1/public/datasets/turkey-premium-daily.csv; minute rows on /api/x402/turkey-premium-history. The index block is the Turkey Premium Index: BTC-TRY total premium against the ECB USD/TRY fix in bps with its dollar and crypto legs, a 0-100 score (50 = world price), the regime, 24h and 7d averages and the same-sign streak; every pair carries index_bps and every venue implied_index_bps. index.reference_state says whether the USD/TRY reference is live this minute: fresh (an intraday quote younger than 30 minutes, FX market open), carried (FX market closed from Friday 22:00 to Sunday 22:00 UTC, or the live source down for less than 24 hours of open FX market; the last quote is used) or stale (older than 24 hours of open FX market); score and regime are null unless fresh, with score_paused_reason, and daily rows carry minutes_fresh, minutes_carried, minutes_stale and index_live_close (the last fresh minute's index against the live quote); the daily CSV appends minutes_fresh and index_live_close as its last two columns.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/turkey-premium?pair=BTC-TRY&days=1' | jq '{index: (.index | {value_bps, score, regime, dollar_leg_bps, crypto_leg_bps}), btc_try: (.pairs["BTC-TRY"] | {price, status, eligible})}'

Proof API of the BYK Data Layer (beta): every five minutes our derived data (composite funding, aggregate open interest, 5-minute liquidations, depth, premiums, pressure score) is sealed into a Merkle root, signed and written to Solana, once a day to Base. No key needed. The index lists the newest epochs with their chain links; /genesis, /authorization-log, /epochs/{sequence}, /epochs/{sequence}/records, /proofs/{sequence|latest}/{feed}/{asset} (leaf, audit path, manifest, signature, anchors), /witness-keys/{kind}/{n}, /documents/{hash} and /catalog return the exact bytes a verifier needs. Human page with an in-browser verifier: /proof. Data responses of /api/public/pressure, /api/public/premium (the Upbit kimchi rows), /api/public/orderbook and /api/public/turkey-premium carry byk_proof: the newest sealed record of the same computation (sequence, proof_url, sealed_value) and matches_this_value, which says whether the number next to it is the sealed one. The one-file independent verifier, which reads only Solana and Base: /byk-verify.mjs.

curl -s 'https://bykaranteli.com/api/v1/proof/proofs/latest/BYK.FUNDING.COMPOSITE.B/BTC' | jq '{sequence, result, value: .decoded.value_decimal, unit: .decoded.unit, leaf_index, path: (.audit_path | length), solana: .anchors.solana[0].links.explorer}'

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 -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/jupiter?base=SOL&days=1' | jq '.markets[0], .history.points[-1]'

Solana Perps board: every Solana perpetual venue we read (Jupiter, Pacifica, Phoenix, GM Trade, Velocity, Bullet), refreshed every 10 minutes. venues gives one-sided open interest (oi_usd, with oi_long_usd and oi_short_usd on the pool venues), 24h volume, market count, the median hourly rate with rate_kind (Jupiter: borrow_hourly, the pool's hourly borrow fee; every other venue: funding_hourly) and as_of, plus stale: true when a failed feed shows its last good reading; totals sums them; markets lists every market of every venue largest open interest first (instrument_type, mark, 24h change, open interest in USD with both sides where published, 24h volume, hourly rate in percent of position; null when the venue does not publish a number). ?venue=jupiter|pacifica|phoenix|gmtrade|velocity|bullet filters the markets; &symbol=SOL&days=1..30 adds the hourly history of one market on every venue but Jupiter (Jupiter history stays on /api/public/jupiter). Any key gets 7 days of history; more than 7 is member depth (a Terminal session or a Builder key and above). The full hourly set is on the paid route /api/x402/solana-perps-history, the midnight rows in the solana-perps-daily dataset.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/solana-perps?venue=phoenix&symbol=SOL&days=1' | jq '.totals, .venues, .markets[0], .history.points[-1]'

Hyperliquid whale tracker: the 1000 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); address=0x... keeps one account. Paid full event history on /api/x402/hl-whale-events.

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

Hyperliquid liquidation price map of one coin: the open positions of the 1000 largest accounts by equity placed at the liquidation price Hyperliquid reports for each, in bands of 0.25% of the mark. long (below the mark) and short (above) list the bands nearest first with price, notional_usd, positions and signed distance_pct; totals count every position, with without_liq_px for the cross margin positions that have no liquidation price; largest is the biggest band per side; model_comparison sets the LiqMap model's nearest cluster on each side next to the nearest tracked band (null off the LiqMap universe); coverage says how many of the 1000 accounts answered and when; history gives hourly long and short notional recorded since 2026-09-30. Per position rows on /api/x402/hl-positions-history.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/hyperliquid-positions?coin=BTC' | jq '{coin, mark, coverage, largest, model_comparison, nearest_long: .long[:3], nearest_short: .short[:3]}'

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 -H "Authorization: Bearer $BYKARANTELI_API_KEY" '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 -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/liquidations | jq '{recorded, market_estimate, by_exchange}'

Largest single liquidation prints of the last 24h, 7d or 30d across the counted venues (rank, symbol, venue, side, price, quantity, notional, time) and a 30-day session heatmap: weekday by UTC hour cells, hour and weekday totals, Asia, Europe and US shares.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/liquidation-leaderboard?window=7d&limit=10' | jq '{window, largest: .largest[:3], sessions: .sessions.sessions}'

Tokenized stocks: onchain wrappers of xStocks, Robinhood Stock Tokens, Coinbase Tokenized Stocks, Binance bStocks, Ondo Stocks, Backpack Securities, Reality (Bitget), Superstate Opening Bell, Figure, Dinari dShares and Securitize (Exodus) per underlying (issuer, chain, price, premium to the real share, DEX liquidity and 24h volume, supply, holders, status), tokenized spot pairs on exchanges, the reference price and its session, the perp cross and board totals, refreshed every 10 minutes. Wrappers come from issuer sources only: Backed public API (xStocks), Robinhood assets API, Coinbase Tokenized Stocks API, Binance coin list plus contract fingerprint (bStocks), Ondo address CSV plus contract fingerprint, Jupiter verified token list (Backpack), Gate spot market list (gStocks, exchange only), Reality API plus identity check, Superstate API, Provenance restricted share marker (Figure), Dinari factory membership check (dShares) and Algorand asset record (Exodus share token, transfer agent Securitize). Each wrapper's price_source names the price that valued its supply dollars (reference: the share's reference price; issuer_oracle: the issuer's own price for the token; wrapper: its own pool or exchange price; null: no dollars) and totals.priced_by counts wrappers per level, unpriced included. ?underlying=TSLA, ?issuer=xstocks | robinhood | coinbase | bstocks | ondo | backpack | gstocks | reality | superstate | figure | dinari | securitize, ?chain=solana, ?top=1..200 (default 50); daily CSV tokenized-stocks-daily, hourly rows per wrapper on /api/x402/tokenized-stocks-history.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/tokenized-stocks?top=5' | jq '{supply_usd: .totals.supply_usd, premium_median_pct: .totals.premium_median_pct, rows: [.rows[] | {underlying, supply_usd, wrappers: [.wrappers[] | {issuer, chain, price, premium_pct}]}]}'

Exchange insurance funds on Binance, Bybit, OKX, Gate, MEXC, Bitfinex, Crypto.com, Delta Exchange, dYdX and Paradex: the latest hourly reading per venue (USD total, per asset, 24h and 7d change, the fund against the venue's perpetual open interest), every pool, and daily closes per venue. ?venue=binance | bybit | okx | gate | mexc | bitfinex | cryptocom | delta | dydx | paradex, ?days=1..366, ?pools=0 drops the pool rows; daily CSV insurance-funds-daily, hourly pool rows on /api/x402/insurance-fund-history. A venue that stops publishing is carried at its last reading for up to 48 hours and named in stale_venues, then dropped from the total and named in missing_venues; a total needs Binance, Bybit, OKX and Gate.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/insurance-funds?days=7&pools=0' | jq '{total_usd, change_24h_pct, venues: [.venues[] | {venue, total_usd, coverage_pct}]}'

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

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/incidents | jq '.incidents[0]'

Open interest board for 10 major perps at 5-minute resolution: per symbol the OI in USD, the 24h change in open interest and in price, and the regime read (longs_building, shorts_building, deleverage_down, deleverage_up, quiet); last_bar_utc stamps the newest bar.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/oi | jq '.symbols[:5]'

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

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/correlations | jq '.symbols'

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

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/charge | jq '{score, state}'

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

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/quantum | jq '.latest | {exposed_btc, base_height}'

The macro set from official sources through FRED: policy rates, inflation and jobs, central bank balance sheets, the Treasury curve and the Fed broad dollar index, plus our global liquidity composite (formula under composite) and stablecoin supply; latest, series, groups and definitions (label, unit, cadence, source); ?days=365.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/macro?days=30' | jq '{composite: .composite.formula, liquidity: .latest.global_liquidity_busd, cpi: .latest.fred_cpi_yoy_pct, groups: [.groups[] | .key]}'

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

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/network | jq '.latest'

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

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" 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 -H "Authorization: Bearer $BYKARANTELI_API_KEY" 'https://bykaranteli.com/api/public/context?metric=coinbase_premium_pct' | jq '{metric, today_value, interpretation}'

Smart-money read for one symbol from recorded positioning.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/public/smart-money/BTCUSDT | jq '.'

43 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 -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/v1/public/datasets/daily-market.csv | head -5

What the calling key's account has used against its plan, the same figures the x-quota headers carry: plan (tier, label), rate.per_minute, monthly (limit, used, remaining, reset, state: ok, slow_lane, refused_until_reset or unlimited), today (calls on every key of the account), keys (active, limit) and x402 (included_calls_per_month, included_used_this_month, applies, requests_per_call, history_days with null for the whole archive, rows_per_call, raw_records_included; when applies is false, requests_per_call, history_days and rows_per_call are null and raw_records_included is false). Needs an account key: a call with none answers 401 key_required.

curl -s -H "Authorization: Bearer $BYKARANTELI_API_KEY" https://bykaranteli.com/api/v1/usage | jq '{plan, monthly, today}'

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 -H "Authorization: Bearer $BYKARANTELI_API_KEY" 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 -H "Authorization: Bearer $BYKARANTELI_API_KEY" 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-1000 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>

<iframe src="https://bykaranteli.com/embed/liquidations" width="100%" height="300" style="border:0;border-radius:12px;background:#0b0e14" loading="lazy" title="Liquidations 24h"></iframe>

• Rate limit is 30 requests per minute per key on the Free API plan (60 on Terminal, 300, 1,200 and 3,000 on Builder, Business and Scale), plus 15,000 requests per calendar month on free keys and 150,000 on Terminal keys (429 monthly_quota_exceeded past it from 2026-09-25). Builder, Business and Scale carry fair-use ceilings of 1,000,000, 3,000,000 and 10,000,000 a month: past them a paid key is never stopped and answers at the Free rate (30 a minute) until the month resets. Every keyed response on a plan with a monthly figure carries x-quota-limit, x-quota-used and x-quota-reset; x-quota-state: slow marks an answer from the slow lane. An included x402 catalog call counts as 10 requests here, next to the plan's catalog ceiling (1,000 a month on Builder, 10,000 on Business, none on Scale and above). Browsers on the site are limited per IP. Above the limit you get 429 with retry-after.
• 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.
• Personal and research use with attribution is free. Commercial use of the data we compute needs the Business plan; derived redistribution needs Scale; raw records and other third-party data are for your own use on every plan. Rebranding our numbers as your own in-house backtest is never allowed.
• Scraping internal routes (/dashboard/*, /api/admin/*, /api/member/*) is blocked and monitored. Stick to /api/public/*.