com.bykaranteli/mcp

Official67 toolsLive

by bykarantelicom · TypeScript

Crypto derivatives data: funding, OI, liquidations, options, ETF flows. Free account key required.

bykaranteli/mcp — Live Crypto Derivatives Data (MCP)

This MCP (Model Context Protocol) server provides live crypto derivatives metrics, including funding rates, cross-exchange funding arbitrage, open interest (OI) pressure, Fear & Greed, and BTC dominance. It exposes data through a free, no-auth public JSON API with 34 read-only tools and no API key, account, or rate-limit registration.

🛠️ Key Features

Live crypto derivatives data: funding rates and funding arbitrage
Open interest pressure and Fear & Greed
BTC dominance and a “verified signal track record”
34 read-only tools via the bykaranteli.com free public JSON API

🚀 Use Cases

Monitor funding rate conditions in Binance USDT-M perpetuals
Compare cross-exchange funding arbitrage (OKX, Bybit, Gate, HTX, BingX, Kraken, MEXC, Bitget)
Incorporate Fear & Greed and dominance into research or alerts

⚡ Developer Benefits

No API key required; no account needed
Read-only tool access (toolCount: 45)
Supports MCP integration for LLM tools (topics include model-context-protocol, llm-tools, mcp)

⚠️ Limitations

Data coverage is described for Binance USDT-M perpetuals; arbitrage additionally compares multiple listed exchanges
Hosted endpoint only is indicated (“Paste https://mcp.bykaranteli.c…”); full installation details are not provided

Topics

binanceclaudecryptoderivativesfear-and-greedfunding-ratellm-toolsmcpmodel-context-protocolopen-interest

Captured live from the server via tools/list.

get_market_indices

Call this when the user asks about overall crypto market sentiment or macro state: the Fear & Greed index (today and yesterday), Bitcoin dominance percentage, total market cap, or the Retail Euphoria composite. Live values refreshed about every 30 minutes.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_liquidations

Call this when the user asks how much was liquidated in crypto futures, whether longs or shorts got flushed, or for liquidation history. Returns daily long and short liquidation totals in USD per symbol and exchange, recorded from ByKaranteli's own stream collectors on every liquidation venue it counts, listed on bykaranteli.com/coverage (recorded events, a floor, not estimates). One row per finalized UTC day, symbol and exchange; history begins 2026-07-30 and grows daily.

Parameters2

symbol	string	optional	Optional symbol filter like BTCUSDT or ETHUSDT. Omit for all symbols.
days	integer	optional	How many most recent days to return (default 7).

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "description": "Optional symbol filter like BTCUSDT or ETHUSDT. Omit for all symbols.",
      "type": "string",
      "pattern": "^[A-Z0-9]{2,20}$"
    },
    "days": {
      "description": "How many most recent days to return (default 7).",
      "type": "integer",
      "minimum": 1,
      "maximum": 90
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_etf_flows

Call this when the user asks about Bitcoin, Ethereum or Solana spot ETF flows: daily net inflows or outflows, cumulative flow since launch, or total net assets of the US spot ETFs (IBIT, FBTC, ETHA and the rest). Returns one row per finalized US trading day and asset with net inflow, total net assets, cumulative inflow and value traded, all in USD. About 14 months of history.

Parameters2

asset	string	optional	Filter to one asset (BTC, ETH or SOL, SOL since 2026-09-02). Omit for all.
days	integer	optional	How many most recent trading days to return (default 10).

Raw schema

{
  "type": "object",
  "properties": {
    "asset": {
      "description": "Filter to one asset (BTC, ETH or SOL, SOL since 2026-09-02). Omit for all.",
      "type": "string",
      "enum": [
        "BTC",
        "ETH",
        "SOL"
      ]
    },
    "days": {
      "description": "How many most recent trading days to return (default 10).",
      "type": "integer",
      "minimum": 1,
      "maximum": 400
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_funding_heatmap

Call this when the user asks for the full current funding table across the ~30 most traded Binance perps (28-30 rows; contracts without a live funding print are skipped), or the funding rate of one specific coin. For a pre-ranked top-10 of the most extreme funding rates, use get_top_movers instead. Returns per-symbol funding rate (per settlement interval), 24h open interest change and 24h price change for the most traded Binance USDT-M perpetuals. Positive funding means longs pay shorts.

Parameters1

symbol

string

optional

Optional. Filter to one symbol, e.g. BTCUSDT or just BTC. Omit to get all 30 rows.

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "description": "Optional. Filter to one symbol, e.g. BTCUSDT or just BTC. Omit to get all 30 rows.",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_funding_arbitrage

Call this when the user asks about funding arbitrage, funding rate differences between exchanges, or delta-neutral carry trades. Compares funding across every venue on the board, from Binance, OKX and Bybit to Hyperliquid, dYdX and the smaller perp venues fed by the venue snapshot, for 12 major perps and returns the best long/short venue per symbol with gross and net annualized APR (net of taker fees and weekly rebalance cost).

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_pressure_scores

Call this when the user asks which coins are crowded or over-leveraged, or asks for the pressure/derivatives-stress score of specific coins. For a quick top-10 ranking of the highest-stress coins right now, use get_top_movers instead. Each symbol gets a 0-100 composite score built from funding rate, 1h/4h/24h open interest deltas and basis, with a LONG/SHORT/NEUTRAL direction and a plain-language regime label.

Parameters2

symbol	string	optional	Optional. Return only this symbol, e.g. BTCUSDT or BTC.
limit	integer	optional	Optional. Max rows to return when no symbol filter is set (default 20, sorted by score).

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "description": "Optional. Return only this symbol, e.g. BTCUSDT or BTC.",
      "type": "string"
    },
    "limit": {
      "description": "Optional. Max rows to return when no symbol filter is set (default 20, sorted by score).",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_top_movers

Call this when the user asks what is moving in crypto derivatives right now, which coins have the biggest open interest changes, the most extreme funding, the widest basis, or the highest derivatives stress. Returns four top-10 lists in one call.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_cot_positioning

Call this when the user asks how hedge funds or institutions are positioned in Bitcoin or Ethereum, or about the CFTC Commitments of Traders report. Returns net positions in contracts, week-over-week changes, open interest and notable extremes/streaks, from official CFTC data updated every Friday. Note: a large share of hedge fund shorts is the market-neutral basis trade, so the weekly change carries more signal than the level.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_options_snapshot

Call this when the user asks where the big options bets sit, about call/put walls, gamma exposure (GEX), the zero-gamma level, implied volatility (DVOL) or the IV term structure for Bitcoin or Ethereum, across options venues or on one venue. Daily snapshot of the listed option chains of every options venue we record, summed by default or one venue with venue: the call wall (largest call open interest above spot) and put wall (largest put open interest below spot), the largest bars on the whole axis, top strikes by open interest, put/call ratio, dealer hedging map, ATM IV by expiry (calls and puts interpolated at the money, iv_source names the venue whose quotes price the chain), each venue's open interest (venues_included), and per expiry the open interest by side, the max pain strike (where the open contracts as a group pay out the least at settlement, not a price target) and the one-sigma implied move the ATM IV prices (expiries). DVOL is Deribit's index whatever the venue.

Parameters1

venue

string

optional

all (default) sums every options venue; or one venue id: deribit, bybit, binance, okx or delta (Delta Exchange India).

Raw schema

{
  "type": "object",
  "properties": {
    "venue": {
      "description": "all (default) sums every options venue; or one venue id: deribit, bybit, binance, okx or delta (Delta Exchange India).",
      "type": "string",
      "enum": [
        "all",
        "deribit",
        "bybit",
        "binance",
        "okx",
        "delta"
      ]
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_coinbase_premium

Call this when the user asks whether US investors are buying or selling Bitcoin or Ethereum, about the Coinbase Premium, or what the cash-and-carry basis trade pays. Returns the latest daily premium in percent, 7-day average, same-sign streak, the last 30 days, and annualized quarterly carry yields. History since 2017; positive premium = US buying pressure.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_flow_toxicity

Call this when the user asks whether informed or toxic order flow is building, about VPIN, or whether market makers are under pressure in Bitcoin, Ethereum or Solana. Returns the current VPIN (0 = balanced, 1 = fully one-sided), its 90-day percentile, the danger threshold and the 24h average. Elevated readings historically precede volatility; VPIN says nothing about direction.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_options_flow

Call this when the user asks what big options players are buying, about block trades, or whether call or put premium dominates today. Returns 24h call vs put premium bought (net of the sold legs of the same multi-leg block or combo, so a spread counts its net premium), the block-trade share, the multi-leg structure count, and the largest prints of the last 48 hours with strikes, premium, IV, structure id and venue (Deribit or OKX). Updated every 15 minutes.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_slippage

Call this when the user asks how much slippage a trade of a given size would face, how thick the books are, or which major perp market is thinnest right now. Returns live cost ladders in basis points for $10K to $5M market orders across 8 major perpetuals, both sides, from the full visible order book. Excludes fees; null = the book cannot absorb that size.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_fomc_impact

Call this when the user asks what Bitcoin does on Fed days, how FOMC statements move crypto, or when the next FOMC meeting is. Returns per-statement 5/30/60-minute BTC reactions measured from a minute-resolution record, the average move versus a normal half hour, the up/down split (near a coin flip), and the next meeting date. Description, not prediction.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_liquidation_cascades

Call this when the user asks what caused a recent crash or flush, about liquidation cascades, or who got liquidated. Returns auto-detected cascade incidents: when, total notional flushed, long/short split, which coins led, and BTC's move during the window. Totals are an honestly-labeled lower bound from a real liquidation tape.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_liquidation_leaderboard

Call this when the user asks for the biggest liquidation today or this week, who got liquidated for the most, the largest single liquidation print, or when in the day or week liquidations cluster (Asia, Europe or US hours, weekday by UTC hour). Returns the largest single liquidation prints of the last 24h, 7d or 30d (rank, symbol, venue, side where SELL means a long was liquidated, price, quantity, notional, millisecond time) recorded from the counted venues' public feeds, plus a 30-day weekday by UTC hour heatmap with hour, weekday and session totals. Binance publishes at most one print per second per symbol, so its rows are a floor.

Parameters3

window	string	optional	Ranking window: 24h (default), 7d or 30d.
limit	integer	optional	Rows to return (default 25, max 100).
days	integer	optional	Days folded into the session heatmap (default 30).

Raw schema

{
  "type": "object",
  "properties": {
    "window": {
      "description": "Ranking window: 24h (default), 7d or 30d.",
      "type": "string",
      "enum": [
        "24h",
        "7d",
        "30d"
      ]
    },
    "limit": {
      "description": "Rows to return (default 25, max 100).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "days": {
      "description": "Days folded into the session heatmap (default 30).",
      "type": "integer",
      "minimum": 7,
      "maximum": 90
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_insurance_funds

Call this when the user asks how big an exchange's insurance fund is, whether a fund is shrinking or was used after a crash, how much exchanges hold to absorb bankrupt liquidations, or how a fund compares with the venue's open interest. Returns the latest hourly reading per covered venue (every exchange the insurance fund board lists): the fund in USD (OKX's own published total, the sum of priced pools elsewhere), per asset, 24h and 7d change, the fund as a percent of the venue's perpetual open interest on the coins ByKaranteli tracks, and daily closes per venue. Set pools to include every pool row (the contracts it covers, asset, balance, USD). A fund is a balance the venue reports, not an audit of its reserves.

Parameters3

venue	string	optional	One venue; omit for every covered venue.
history_days	integer	optional	Days of daily closes (default 30, max 366).
pools	boolean	optional	Include every pool row (large for Binance and Bybit). Default false.

Raw schema

{
  "type": "object",
  "properties": {
    "venue": {
      "description": "One venue; omit for every covered venue.",
      "type": "string",
      "enum": [
        "binance",
        "bybit",
        "okx",
        "gate"
      ]
    },
    "history_days": {
      "description": "Days of daily closes (default 30, max 366).",
      "type": "integer",
      "minimum": 1,
      "maximum": 366
    },
    "pools": {
      "description": "Include every pool row (large for Binance and Bybit). Default false.",
      "type": "boolean"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_tokenized_stocks

Call this when the user asks about tokenized stocks or stock tokens (xStocks, Ondo, Robinhood stock tokens, Coinbase tokenized stocks on Base, Binance bStocks, Backpack, Gate gStocks, Reality, Superstate, Figure, Dinari dShares, Securitize): how much of a stock exists onchain, which issuer or chain holds the most, whether a wrapper trades above or below the real share, which DEX pools or exchanges trade it. Returns the board ByKaranteli refreshes every 10 minutes: per underlying the reference share price and its session, each wrapper (issuer, chain, price, premium_pct against a fresh reference, DEX liquidity and 24h volume from admitted pools, supply in shares and dollars, holders, status), tokenized spot pairs on the exchanges the board lists, the perpetual futures cross, and totals (supply by issuer and chain, DEX volume, median premium). 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 the counted wrappers per level, unpriced included. Wrappers come from issuer sources only, never from a name search.

Parameters4

underlying	string	optional	Stock ticker, e.g. TSLA; omit for the whole board.
issuer	string	optional	One issuer: xstocks, robinhood, coinbase, bstocks, ondo, backpack, gstocks, reality, superstate, figure, dinari or securitize; omit for every issuer.
chain	string	optional	One chain, e.g. solana, base, bnb, robinhood, ethereum, ton, all (xStocks circulating) or cex (exchange pairs).
top	integer	optional	Rows by supply (default 20, max 200).

Raw schema

{
  "type": "object",
  "properties": {
    "underlying": {
      "description": "Stock ticker, e.g. TSLA; omit for the whole board.",
      "type": "string",
      "pattern": "^[A-Za-z0-9.]{1,16}$"
    },
    "issuer": {
      "description": "One issuer: xstocks, robinhood, coinbase, bstocks, ondo, backpack, gstocks, reality, superstate, figure, dinari or securitize; omit for every issuer.",
      "type": "string",
      "enum": [
        "xstocks",
        "robinhood",
        "coinbase",
        "bstocks",
        "ondo",
        "backpack",
        "gstocks",
        "reality",
        "superstate",
        "figure",
        "dinari",
        "securitize"
      ]
    },
    "chain": {
      "description": "One chain, e.g. solana, base, bnb, robinhood, ethereum, ton, all (xStocks circulating) or cex (exchange pairs).",
      "type": "string",
      "pattern": "^[a-z]{2,12}$"
    },
    "top": {
      "description": "Rows by supply (default 20, max 200).",
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_open_interest

Call this when the user asks whether leverage is entering or leaving the market, about open interest changes, or whether longs or shorts are building in a major coin. Returns 5-minute-resolution OI with 24h OI and price deltas and a four-regime read per symbol: longs building, shorts building, long squeeze, short squeeze, or quiet.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_psi_charge

Call this when the user asks about the market's hidden liquidity state, PsiCharge, or whether parked money is deploying or stress is unwinding. Returns the current Psi score (0-100), state (superposition = charge building, collapse = low-stress discharge, purge = high-stress discharge and historically the most consistent risk-off state, ground = ordinary), stress locality, recent alarms and the year-split measured scorecard. Inputs are proprietary; outcomes are always published. Not a trade signal, not a crash predictor.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_altseason

Call this when the user asks whether it is altseason, how altcoins are doing against Bitcoin, or about market rotation. Returns the live Altcoin Season Index (share of the top 50 Binance perpetual altcoins beating BTC over the trailing 90 days; >=75 altseason, <=25 bitcoin season), the strongest and weakest large alts, and the recorded daily history (never reconstructed).

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_quantum_exposure

Call this when the user asks how much Bitcoin is vulnerable to a quantum computer, about quantum-exposed supply, P2PK coins, or Satoshi-era exposure. Returns the latest daily measurement from ByKaranteli's own Bitcoin Core node: exposed BTC and its share of held value and UTXO count, composition by script family, dormancy cohorts, the dormant-P2PK watch set, and provenance hashes (base_height, base_hash, txoutset_hash) so any figure can be re-verified against any node.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_metric_context

Call this when the user asks whether a metric's current reading is high or low, or what happened after similar readings. Buckets today's value against the metric's own recorded daily history and returns the median forward BTC return and up-share per bucket at +1/+3/+7 days, with the all-days base rate alongside. Honesty rules: buckets under 30 days are suppressed, and most metrics do NOT separate from the base rate; the interpretation says so plainly. History, not a forecast. Metrics include coinbase_premium_pct, kraken_btc_premium_pct, dvol_btc, fear_greed, funding_btc_daily_pct, etf_btc_net_flow_usd, vpin_btc, altseason_index, stablecoin_total_mcap_busd, fred_dff, fred_dgs10, fred_walcl_busd, fred_rrp_busd and the btc_* network series.

Parameters1

metric

string

required

Metric key, e.g. coinbase_premium_pct, fear_greed, altseason_index, stablecoin_total_mcap_busd.

Raw schema

{
  "type": "object",
  "properties": {
    "metric": {
      "type": "string",
      "pattern": "^[a-z0-9_]{2,50}$",
      "description": "Metric key, e.g. coinbase_premium_pct, fear_greed, altseason_index, stablecoin_total_mcap_busd."
    }
  },
  "required": [
    "metric"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_theme_indices

Call this when the user asks which crypto narrative or sector is leading, about rotation between AI, RWA, DePIN, memecoins, layer 1, layer 2, DeFi or quantum coins, or for a theme index. Returns eight equal-weight fixed-basket indices rebased to 100 on 2025-01-01 with 1d/7d/30d/90d/YTD returns, vs BTC, and the member lists; daily points are omitted unless include_points is true.

Parameters1

include_points

boolean

optional

boolean, optional: include the daily index points (large)

Raw schema

{
  "type": "object",
  "properties": {
    "include_points": {
      "description": "boolean, optional: include the daily index points (large)",
      "type": "boolean"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_factor_board

Call this when the user asks which indicators currently sit in an unusual band, whether a metric's current level historically preceded BTC moves, or for a cross-metric conditional overview. Returns every recorded metric in its historical band with the median 7-day BTC move that followed versus the base rate, with an n >= 30 gate; distributions, not forecasts.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_borrow_rates

Call this when the user asks what it costs to borrow USDT, USDC, BTC, ETH or a major alt on an exchange, which venue has the cheapest borrow, whether stablecoin borrow cost is spiking, or what the carry of a basis trade is on a venue (funding minus borrow). Returns the latest annualised rate per venue and asset, 30 days of hourly series for the stablecoins and majors, and the carry table. Recorded hourly by ByKaranteli (Binance and OKX today).

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_fee_table

Call this when the user asks what an exchange charges to trade, how maker and taker fees compare across venues, whether a venue changed its fees, or what a round trip costs on a given notional. Returns base tier maker and taker per venue and market type (median across pairs where the venue prices per pair) and the fee change log, read daily by ByKaranteli from each venue's own fee endpoint.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_settlements

Call this when the user asks what futures or options expire soon, when the next quarterly expiry is on an exchange, how many contracts settle this week, or at what price a dated future settled. Returns the next 60 days of dated future and option expiries grouped by date, venue and underlying from 54 venues' market lists, plus the settlement prices recorded as dated futures deliver.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_venue_profile

Call this when the user asks about a specific exchange (Bybit, OKX, Gate, KuCoin, HTX, Bitget, MEXC, BitMEX, Hyperliquid ...): how many contracts it lists, its perp open interest and average funding, its leverage ladders, deposit and withdrawal networks and how many are paused, its base fee schedule, its status uptime and the recent event log (listings, delistings, leverage cuts, withdrawal pauses, incidents). Without venue returns the list of recorded venues.

Parameters1

venue

string

optional

string, optional venue id, e.g. bybit

Raw schema

{
  "type": "object",
  "properties": {
    "venue": {
      "description": "string, optional venue id, e.g. bybit",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_withdrawal_status

Call this when the user asks whether an exchange has paused withdrawals or deposits, which networks are open for an asset, what the withdrawal fee or minimum is on each venue, or which venue is cheapest to withdraw from. Without arguments returns the overview (withdrawals paused right now, ranked, plus recent suspension and resumption events). Pass asset (e.g. USDT) for every venue and network of that asset, and venue (e.g. kucoin) to narrow. Recorded daily by ByKaranteli from 20+ venues' public currency lists.

Parameters2

asset	string	optional	string, optional asset code, e.g. USDT
venue	string	optional	string, optional venue id, e.g. kucoin

Raw schema

{
  "type": "object",
  "properties": {
    "asset": {
      "description": "string, optional asset code, e.g. USDT",
      "type": "string"
    },
    "venue": {
      "description": "string, optional venue id, e.g. kucoin",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_leverage_tiers

Call this when the user asks how much leverage an exchange allows on a coin, what the maintenance margin or risk limit ladder is, which venue offers the highest leverage for a symbol, or whether an exchange recently cut leverage. Returns the current ladder per venue (tier, notional floor and cap, max leverage, maintenance margin rate) recorded daily by ByKaranteli, plus a change log. Pass symbol for one base asset (e.g. SOL) and venue for one exchange (bybit, okx, gate, htx, bitget, mexc).

Parameters2

symbol	string	optional	string, optional base asset, e.g. BTC
venue	string	optional	string, optional venue id, e.g. bybit

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "description": "string, optional base asset, e.g. BTC",
      "type": "string"
    },
    "venue": {
      "description": "string, optional venue id, e.g. bybit",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_venue_markets

Call this when the user asks about total open interest across exchanges, which venues hold the most OI, DEX versus CEX share, funding dispersion between venues, or stablecoin pegs. Returns the latest 10-minute snapshot aggregates across every perpetual and spot feed we poll (the coverage field lists them); pass symbol for one coin's per-venue rows.

Parameters2

symbol	string	optional	string, optional base asset, e.g. BTC
history_days	integer	optional	Return the hourly multi-venue open interest history (total, DEX share, OI-weighted funding) for this many days instead of the snapshot

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "description": "string, optional base asset, e.g. BTC",
      "type": "string"
    },
    "history_days": {
      "description": "Return the hourly multi-venue open interest history (total, DEX share, OI-weighted funding) for this many days instead of the snapshot",
      "type": "integer",
      "minimum": 1,
      "maximum": 90
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_lead_lag

Call this when the user asks which exchange leads price discovery or whether spot or perp moves first. Returns per-pair daily cross-correlations of one-minute returns at lags -3..+3 and the lead asymmetry, with the share of days each venue led.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_iv_surface

Call this when the user asks about implied volatility by strike or expiry, skew, put versus call IV, term structure of IV, or whether downside protection is expensive. Returns the IV surface (expiry x moneyness), per-expiry ATM / 25-delta put and call IV, skew and butterfly, and the constant-30d history, from the daily Deribit chain.

Parameters1

currency

string

optional

BTC or ETH, default BTC

Raw schema

{
  "type": "object",
  "properties": {
    "currency": {
      "description": "BTC or ETH, default BTC",
      "type": "string",
      "enum": [
        "BTC",
        "ETH"
      ]
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_whale_tape

Call this when the user asks about whale trades, large market orders, or whether big players are buying or selling right now. Returns recent $1M+ aggressive prints recorded live from our own sockets and 24h aggregates with the buy share.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_correlations

Call this when the user asks how correlated two coins are, for decorrelated pairs, or how tightly alts track BTC. Returns the 30-day rolling Pearson correlation matrix of daily returns across the top perpetuals.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_new_listings

Call this when the user asks what new perpetuals were listed, which exchange listed a coin first, or about delistings. Returns listings and delistings across every exchange the hourly scan covers.

Parameters1

days

integer

optional

Window in days, 1-30 (default 30). Longer listing history is the listings dataset at bykaranteli.com/data.

Raw schema

{
  "type": "object",
  "properties": {
    "days": {
      "description": "Window in days, 1-30 (default 30). Longer listing history is the listings dataset at bykaranteli.com/data.",
      "type": "integer",
      "minimum": 1,
      "maximum": 30
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_macro_liquidity

Call this when the user asks about macro liquidity, the Fed balance sheet, reverse repo, rates or stablecoin supply in relation to crypto. Returns the recorded daily series and latest values.

Parameters1

days

integer

optional

Window in days, 30-4000 (default 365); the route clamps to that range.

Raw schema

{
  "type": "object",
  "properties": {
    "days": {
      "description": "Window in days, 30-4000 (default 365); the route clamps to that range.",
      "type": "integer",
      "minimum": 30,
      "maximum": 4000
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_network_health

Call this when the user asks about Bitcoin hashrate, difficulty or block fees (our node runs blocksonly, so there is no mempool series). Returns the recorded daily series and latest values measured on ByKaranteli's own node.

Parameters1

days

integer

optional

Window in days, 30-4000 (default 365); the route clamps to that range.

Raw schema

{
  "type": "object",
  "properties": {
    "days": {
      "description": "Window in days, 30-4000 (default 365); the route clamps to that range.",
      "type": "integer",
      "minimum": 30,
      "maximum": 4000
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_liqmap

Call this when the user asks where liquidation clusters or liquidity pools sit for a perpetual, where leveraged longs/shorts would get liquidated, or for a liquidation heatmap reading. Returns the LiqMap snapshot for one symbol: modeled liquidation levels by price, zone aggregates and real liquidation prints from every liquidation venue ByKaranteli counts (listed on bykaranteli.com/coverage). Without an account key (or on the Free plan) the 24h view; with a Builder or higher key (BYKARANTELI_API_KEY) every timeframe from 1h to 30d.

Parameters2

symbol	string	optional	Symbol like BTCUSDT (bare BTC accepted). Default BTCUSDT.
timeframe	string	optional	Model window. Default 24h, the only one served without a Builder or higher key.

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "description": "Symbol like BTCUSDT (bare BTC accepted). Default BTCUSDT.",
      "type": "string",
      "pattern": "^[A-Z0-9]{2,20}$"
    },
    "timeframe": {
      "description": "Model window. Default 24h, the only one served without a Builder or higher key.",
      "type": "string",
      "enum": [
        "1h",
        "4h",
        "12h",
        "24h",
        "3d",
        "1w",
        "30d"
      ]
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_tradfi_board

Call this when the user asks about stock perpetuals (TSLA, NVDA, AAPL, gold, S&P 500...), tokenized-equity perps, TradFi perp funding rates, open interest, liquidations, which exchanges list a stock perp, or whether the equity session is open. Returns Binance's TradFi perpetual board: per contract mark, index, basis, funding, 24h change and volume, open interest, 24h recorded liquidations, other venues listing the same underlying, and the trading-session state per market. Filter by market (EQUITY, HK_EQUITY, KR_EQUITY, CN_EQUITY, COMMODITY, INDEX, PREMARKET) or one symbol.

Parameters2

market	string	optional	Market filter: EQUITY \| HK_EQUITY \| KR_EQUITY \| CN_EQUITY \| COMMODITY \| INDEX \| PREMARKET
symbol	string	optional	One Binance TradFi symbol, e.g. TSLAUSDT

Raw schema

{
  "type": "object",
  "properties": {
    "market": {
      "description": "Market filter: EQUITY | HK_EQUITY | KR_EQUITY | CN_EQUITY | COMMODITY | INDEX | PREMARKET",
      "type": "string",
      "pattern": "^[A-Z_]{3,16}$"
    },
    "symbol": {
      "description": "One Binance TradFi symbol, e.g. TSLAUSDT",
      "type": "string",
      "pattern": "^[A-Z0-9]{2,24}$"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_rsi_heatmap

Call this when the user asks which coins are overbought or oversold, for a crypto RSI heatmap, multi-timeframe RSI, or one contract's RSI on 15m, 1h, 4h, 12h, 1d, 3d, 1w or 1M. Returns the live board for the top-400 Binance crypto perps by volume plus every TradFi perp, with overbought/oversold counts per interval. Filter by symbol or kind (crypto|tradfi), sort by an interval.

Parameters3

symbol	string	optional	One Binance symbol, e.g. BTCUSDT
kind	string	optional	crypto \| tradfi
sort	string	optional	Interval to sort by, descending

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "description": "One Binance symbol, e.g. BTCUSDT",
      "type": "string",
      "pattern": "^[A-Z0-9]{2,24}$"
    },
    "kind": {
      "description": "crypto | tradfi",
      "type": "string",
      "enum": [
        "crypto",
        "tradfi"
      ]
    },
    "sort": {
      "description": "Interval to sort by, descending",
      "type": "string",
      "enum": [
        "15m",
        "1h",
        "4h",
        "12h",
        "1d",
        "3d",
        "1w",
        "1M"
      ]
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_cycle_indicators

Call this when the user asks whether Bitcoin is near a cycle top or bottom by the classic indicators, about the Pi Cycle Top, Mayer Multiple, 200-week moving average, 2-year MA multiplier, golden ratio multiple, profitable days, stock-to-flow, Puell Multiple or Bitfinex margin positioning. Returns the latest readings, the Pi Cycle cross dates on record, and optionally the daily series (recomputed nightly from a first-party close record since 2012). Levels, not forecasts.

Parameters2

days	integer	optional	Window in days for the series (default 730)
include_points	boolean	optional	Include the daily series (large). Default false: latest values and cross dates only.

Raw schema

{
  "type": "object",
  "properties": {
    "days": {
      "description": "Window in days for the series (default 730)",
      "type": "integer",
      "minimum": 30,
      "maximum": 10000
    },
    "include_points": {
      "description": "Include the daily series (large). Default false: latest values and cross dates only.",
      "type": "boolean"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_hl_whales

Call this when the user asks what Hyperliquid whales are doing, whether the biggest Hyperliquid accounts are net long or short a coin, for the largest open positions with liquidation prices, or what large accounts just opened, closed or flipped. Returns the live board of the 300 largest accounts by equity (scanned every 5 minutes, addresses only) and with events the last 200 position changes.

Parameters2

coin	string	optional	One coin, e.g. BTC
events	boolean	optional	Include the last 200 position change events

Raw schema

{
  "type": "object",
  "properties": {
    "coin": {
      "description": "One coin, e.g. BTC",
      "type": "string",
      "pattern": "^[A-Z0-9]{1,24}$"
    },
    "events": {
      "description": "Include the last 200 position change events",
      "type": "boolean"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_positioning

Call this when the user asks about the long/short ratio, whether retail or top traders are net long or short, the taker buy/sell ratio, or CVD (cumulative volume delta) for a perpetual. Returns exchange-published statistics for the 30 most traded Binance USDT perps on every perpetual venue the positioning board records (Binance global and top-trader ratios, Bybit share long, OKX ratios and taker volume, Gate account and top-trader ratios, HTX elite ratios, Bitget account and position ratios) and CVD series for BTC, ETH and SOL; refreshed every 15 minutes.

Parameters1

symbol

string

optional

One Binance symbol, e.g. BTCUSDT

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "description": "One Binance symbol, e.g. BTCUSDT",
      "type": "string",
      "pattern": "^[A-Z0-9]{2,24}$"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_turkey_premium

Call this when the user asks about Bitcoin, Ether or USDT prices in Turkish lira, the Turkey premium, the USDT/TRY rate or dollar premium in Turkey, or which Turkish exchanges (BtcTurk, Bitlo, CoinTR, OKX TR, Binance TR, Bybit TR, Bitexen; KuCoin TR contributes the USDT pairs only) trade above or below the global price. Returns the live board: the Turkey Premium Index (what a lira buyer pays for bitcoin against the global dollar price at the official exchange rate, in bps) with its dollar leg and crypto leg, a 0-100 score (50 = world price) and regime, 24h and 7d averages and the same-sign streak; then five reference prices (median of eligible order books), per-venue book status, spread, depth and each venue's implied premium. Pass pair and history_days for 15-minute history of one pair.

Parameters2

pair	string	optional	Pair: BTC-TRY, ETH-TRY, USDT-TRY, BTC-USDT or ETH-USDT
history_days	integer	optional	Include 15-minute index history for the pair, 1..30 days

Raw schema

{
  "type": "object",
  "properties": {
    "pair": {
      "description": "Pair: BTC-TRY, ETH-TRY, USDT-TRY, BTC-USDT or ETH-USDT",
      "type": "string",
      "pattern": "^(BTC-TRY|ETH-TRY|USDT-TRY|BTC-USDT|ETH-USDT)$"
    },
    "history_days": {
      "description": "Include 15-minute index history for the pair, 1..30 days",
      "type": "integer",
      "minimum": 1,
      "maximum": 30
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_data_proof

Call this when the user asks whether ByKaranteli data can be verified or was changed afterwards, about the BYK Data Layer, on-chain proofs of market data, or wants the proof behind one sealed number. Every 5 minutes a catalog of derived feeds (funding composite, aggregate open interest, liquidations, depth within 2%, pressure scores, Kimchi and Turkey premiums) is sealed into one Merkle root, signed and written to Solana mainnet, and attested on Base once a day. With no arguments returns the stream overview: network, epochs and records sealed, final anchors and the newest epochs with explorer links. Pass feed and asset for one record's proof (value, 104-byte leaf, Merkle path, signed manifest, signature, Solana and Base anchors) at the newest epoch or at sequence; sequence alone for one epoch; catalog for the feed list. result ANCHORED means ByKaranteli signed it and an anchor is final; the protocol verdict is reached from the chains alone at https://bykaranteli.com/proof.

Parameters4

feed	string	optional	Feed id from the catalog, e.g. BYK.FUNDING.COMPOSITE.B
asset	string	optional	Asset of the feed: BTC, ETH, SOL, XRP, DOGE, BNB, USDT or ALL
sequence	integer	optional	Epoch sequence; omit for the newest
catalog	boolean	optional	true: list every sealed feed with its unit and methodology

Raw schema

{
  "type": "object",
  "properties": {
    "feed": {
      "description": "Feed id from the catalog, e.g. BYK.FUNDING.COMPOSITE.B",
      "type": "string",
      "pattern": "^BYK\\.[A-Z0-9_.]{3,60}$"
    },
    "asset": {
      "description": "Asset of the feed: BTC, ETH, SOL, XRP, DOGE, BNB, USDT or ALL",
      "type": "string",
      "pattern": "^[A-Z0-9]{2,10}$"
    },
    "sequence": {
      "description": "Epoch sequence; omit for the newest",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "catalog": {
      "description": "true: list every sealed feed with its unit and methodology",
      "type": "boolean"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_jupiter_perps

Call this when the user asks about Jupiter perpetuals on Solana: long versus short open interest per market (SOL, ETH, BTC) read from the on-chain custody state, pool utilization and hourly borrow rates, JLP pool AUM and APR, 24h volume, or the week's top traders by realized PnL. Pass base and history_days for the hourly OI history.

Parameters2

base	string	optional	Market base: SOL, ETH or BTC
history_days	integer	optional	Include hourly OI history for the base, 1..30 days

Raw schema

{
  "type": "object",
  "properties": {
    "base": {
      "description": "Market base: SOL, ETH or BTC",
      "type": "string",
      "pattern": "^(SOL|ETH|BTC)$"
    },
    "history_days": {
      "description": "Include hourly OI history for the base, 1..30 days",
      "type": "integer",
      "minimum": 1,
      "maximum": 30
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_market_profile

Call this when the user asks about a perpetual's Market Profile, TPO profile, point of control (POC), value area (VAH, VAL), initial balance or naked (untested) points of control. Returns one row per closed UTC day from ByKaranteli's own one-minute bars of the Binance USDT-M perpetual (30-minute TPO periods, buckets of 0.05% of the day's open, 70% value area, first-hour initial balance, volume point of control), the naked points of control of the last 60 recorded days and the latest day's profile per price bucket. Symbols without recorded minute bars return no_profile.

Parameters2

symbol	string	optional	Ticker such as BTC or BTCUSDT (default BTC)
days	integer	optional	Closed UTC days, newest first, 1..30 (default 7)

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "description": "Ticker such as BTC or BTCUSDT (default BTC)",
      "type": "string",
      "pattern": "^[A-Z0-9]{2,20}$"
    },
    "days": {
      "description": "Closed UTC days, newest first, 1..30 (default 7)",
      "type": "integer",
      "minimum": 1,
      "maximum": 30
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_options_chain

Call this when the user asks how the BTC or ETH option chain moved today or over the last day: open interest and mark IV per expiry and strike from ByKaranteli's own hourly capture of every listed venue, the change over the last hour and the last 24 hours, and the front expiry's ATM IV hour by hour. Anonymous depth lists the largest strikes; a key with member depth lists every strike. Recorded from 2026-09-30, so the first days carry a short history.

Parameters4

currency	string	optional	BTC or ETH (default BTC)
venue	string	optional	One venue or all (default all)
expiry	string	optional	Expiry as DDMONYY, e.g. 31OCT26 (default: every expiry)
strikes	string	optional	top (largest strikes) or all (member depth)

Raw schema

{
  "type": "object",
  "properties": {
    "currency": {
      "description": "BTC or ETH (default BTC)",
      "type": "string",
      "enum": [
        "BTC",
        "ETH"
      ]
    },
    "venue": {
      "description": "One venue or all (default all)",
      "type": "string",
      "enum": [
        "all",
        "deribit",
        "bybit",
        "binance",
        "okx",
        "delta"
      ]
    },
    "expiry": {
      "description": "Expiry as DDMONYY, e.g. 31OCT26 (default: every expiry)",
      "type": "string",
      "pattern": "^\\d{1,2}[A-Z]{3}\\d{2}$"
    },
    "strikes": {
      "description": "top (largest strikes) or all (member depth)",
      "type": "string",
      "enum": [
        "top",
        "all"
      ]
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_hl_positions

Call this when the user asks where Hyperliquid whales would be liquidated, how much tracked notional sits at each price, how the largest accounts lean on a coin, or how their liquidation prices compare with the LiqMap model. The universe is the largest accounts by equity on Hyperliquid's public leaderboard, scanned every five minutes; the levels are their own liquidation prices bucketed around the mark. hours returns the hourly archive of level totals.

Parameters2

coin	string	optional	Coin as Hyperliquid names it, e.g. BTC, ETH, SOL (default BTC)
hours	integer	optional	Hours of archive to return, 1..720 (default 24)

Raw schema

{
  "type": "object",
  "properties": {
    "coin": {
      "description": "Coin as Hyperliquid names it, e.g. BTC, ETH, SOL (default BTC)",
      "type": "string",
      "pattern": "^[A-Z0-9]{1,24}$"
    },
    "hours": {
      "description": "Hours of archive to return, 1..720 (default 24)",
      "type": "integer",
      "minimum": 1,
      "maximum": 720
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_venue_share

Call this when the user asks which exchange sees the most liquidations, how that share moved this week or this month, or how perpetual open interest splits between venues. Shares over one, seven or thirty days from ByKaranteli's own hourly liquidation record (counted venues only, each with the day its record started) and the hourly open interest record.

Parameters1

days

integer

optional

Window in days: 1, 7 or 30 (default 7)

Raw schema

{
  "type": "object",
  "properties": {
    "days": {
      "description": "Window in days: 1, 7 or 30 (default 7)",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_tradfi_gaps

Call this when the user asks what a stock, index or commodity perpetual did over the weekend or overnight while the cash market was closed, how far it sat from the last cash close at each checkpoint, how the venues disagreed, and what gap the next open then realised. From ByKaranteli's own ten-minute venue record; window weekend or night; one symbol or the whole board.

Parameters2

window	string	optional	weekend (Friday close to Monday open) or night (cash close to next open); default weekend
symbol	string	optional	One underlying, e.g. TSLA or XAU (default: the whole board)

Raw schema

{
  "type": "object",
  "properties": {
    "window": {
      "description": "weekend (Friday close to Monday open) or night (cash close to next open); default weekend",
      "type": "string",
      "enum": [
        "weekend",
        "night"
      ]
    },
    "symbol": {
      "description": "One underlying, e.g. TSLA or XAU (default: the whole board)",
      "type": "string",
      "pattern": "^[A-Z0-9.]{1,24}$"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_solana_perps

Call this when the user asks about perpetuals on Solana as a whole, which Solana perp DEX has the most open interest or volume, a market on Pacifica, Phoenix, GM Trade (GMX on Solana), Velocity (the Drift relaunch) or Bullet (funding, open interest, 24h volume, mark), or how Jupiter compares with the order-book venues. Returns the board read every 10 minutes: per-venue totals (one-sided open interest, both sides on pool venues, 24h volume, market count, median hourly rate, as_of), every market of every venue largest first with instrument type (perpetual, equity, index, commodity, fx), and optional hourly history of one market on any venue but Jupiter (7 days free, 30 with member depth; Jupiter history is get_jupiter_perps).

Parameters3

venue	string	optional	Venue filter: jupiter, pacifica, phoenix, gmtrade, velocity or bullet
symbol	string	optional	Market symbol on the chosen venue (Pacifica when venue is not given) for hourly history, as the board lists it, e.g. SOL, SOL-PERP, SOL-USD, kBONK
history_days	integer	optional	Hourly history for the symbol, 1..30 days

Raw schema

{
  "type": "object",
  "properties": {
    "venue": {
      "description": "Venue filter: jupiter, pacifica, phoenix, gmtrade, velocity or bullet",
      "type": "string",
      "pattern": "^(jupiter|pacifica|phoenix|gmtrade|velocity|bullet)$"
    },
    "symbol": {
      "description": "Market symbol on the chosen venue (Pacifica when venue is not given) for hourly history, as the board lists it, e.g. SOL, SOL-PERP, SOL-USD, kBONK",
      "type": "string",
      "pattern": "^[A-Za-z0-9_.-]{1,24}$"
    },
    "history_days": {
      "description": "Hourly history for the symbol, 1..30 days",
      "type": "integer",
      "minimum": 1,
      "maximum": 30
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_coverage

Call this when the user asks which exchanges sit behind a ByKaranteli number, whether a feed is complete or sampled, since when a venue is collected, or how fresh the data is. Returns the live coverage registry: liquidation feeds per venue with kind and last record, snapshot feeds per venue and market, funding arbitrage legs, positioning sources, whale tape, spot minutes and the Hyperliquid whale scan with freshness. snapshots[].country is the jurisdiction only when the venue states one; it is null for most venues, so do not read null as unknown risk.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_orderbook_depth

Call this when the user asks where the bid or ask walls are, how deep the spot order book is, whether buyers or sellers have more resting orders near price, or for an order book heatmap. Returns the books of every spot venue with a public book that the coverage page lists, binned into 0.1% buckets within 20% of mid (USD notional), the largest walls with venue split, 2% depth and book reach per venue, and optionally the summed 5-minute history; coins: BTC, ETH, SOL, XRP, DOGE, ADA, LINK, AVAX, LTC, BNB. Books whose size is not corroborated are recorded and returned per venue with in_aggregate false (listed in held_out) but not summed into the walls, 2% depth or history.

Parameters2

symbol	string	optional	One coin, e.g. BTC (default BTC)
hours	integer	optional	Include the summed 5-minute history for this many hours

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "description": "One coin, e.g. BTC (default BTC)",
      "type": "string",
      "pattern": "^[A-Z0-9]{2,12}$"
    },
    "hours": {
      "description": "Include the summed 5-minute history for this many hours",
      "type": "integer",
      "minimum": 1,
      "maximum": 24
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_series

Call this when the user wants the history of one recorded metric for one perpetual as a time series: price candles, volume, perp or spot CVD, open interest, funding, liquidations, long/short ratios, RSI, the Coinbase premium, US spot ETF flows, borrow rates or Hyperliquid whale net flow, for charting, backtesting or "what did X do over the last N days". Returns the /api/series answer (points as [t, v], or [t, o, h, l, c, v] for price, with unit, kind, source and source_kind, the bars served and whether member depth applied) plus provenance. metric is one of: price, volume, cvd_perp, cvd_spot, oi, funding, liquidations, long_short, top_traders, rsi, premium, etf_flow, borrow, whale_net (unit, finest period and venue support of each: https://bykaranteli.com/api/series/metrics). Public depth serves fewer bars and no 5m bars; a Builder key and above get member depth; the bar limits are in the same list. Pass from and to (ISO) for a window, or limit for the newest bars.

Parameters7

metric	string	required	string, metric key, e.g. price, oi, funding, liquidations (list: /api/series/metrics)
symbol	string	optional	string, optional Binance USDT-M perp or coin, e.g. BTCUSDT or BTC (default BTCUSDT)
period	string	optional	string, optional bar period: 5m \| 15m \| 1h \| 4h \| 1d (default 1h; each metric has a finest period)
venue	string	optional	string, optional venue id for price, oi, funding or borrow, e.g. okx (default binance)
from	string	optional	string, optional ISO start, e.g. 2026-09-01T00:00:00Z
to	string	optional	string, optional ISO end (default now)
limit	number	optional	number, optional newest bars, 10..5000; the key's depth caps it

Raw schema

{
  "type": "object",
  "properties": {
    "metric": {
      "type": "string",
      "description": "string, metric key, e.g. price, oi, funding, liquidations (list: /api/series/metrics)"
    },
    "symbol": {
      "description": "string, optional Binance USDT-M perp or coin, e.g. BTCUSDT or BTC (default BTCUSDT)",
      "type": "string"
    },
    "period": {
      "description": "string, optional bar period: 5m | 15m | 1h | 4h | 1d (default 1h; each metric has a finest period)",
      "type": "string",
      "enum": [
        "5m",
        "15m",
        "1h",
        "4h",
        "1d"
      ]
    },
    "venue": {
      "description": "string, optional venue id for price, oi, funding or borrow, e.g. okx (default binance)",
      "type": "string"
    },
    "from": {
      "description": "string, optional ISO start, e.g. 2026-09-01T00:00:00Z",
      "type": "string"
    },
    "to": {
      "description": "string, optional ISO end (default now)",
      "type": "string"
    },
    "limit": {
      "description": "number, optional newest bars, 10..5000; the key's depth caps it",
      "type": "number"
    }
  },
  "required": [
    "metric"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

parse_alert_text

Call this when the user describes an alert in words ("tell me when ETH drops 5% in a day", "BTC funding above 5 bps", "liquidations over $20M in an hour") and you want the exact recipe before creating it. Rule based, nothing is saved: returns recipe (name, scope, symbols, conditions of field, op, value, cooldownHours, channels) or null, confidence 0..1, a one-line summary to confirm with the user, and unresolved (what the text left open or what was assumed; timing words are not part of a recipe). A threshold the text does not state is never invented. English and tickers; at most 500 characters. Pass the returned conditions, scope, symbols and channels to create_alert_recipe once the user agrees.

Parameters1

text

string

required

string, the alert in plain English, e.g. "SOL funding below -0.01% or OI up 10%"

Raw schema

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "description": "string, the alert in plain English, e.g. \"SOL funding below -0.01% or OI up 10%\""
    }
  },
  "required": [
    "text"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_alert_recipes

Call this when the user asks which alerts they have, whether an alert fired, or before deleting or changing one. Returns the account's alert recipes (id, name, scope, symbols, conditions, cooldown in hours, enabled, last fired, fire count, channels). Needs the account key; reads nothing but this account.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

create_alert_recipe

Call this when the user asks to be alerted when a metric crosses a threshold and has agreed to the exact condition (parse_alert_text turns their words into one). Saves an alert recipe on the account: it fires when every condition holds, delivers by Telegram first with email as fallback unless channels says otherwise, and waits cooldown_hours before it fires again for the same symbol. field is one of: mark_price, pressure_score, funding_rate_pct, oi24h_pct, basis_pct, price_change_24h_pct, liq_cluster_distance_pct, usdt_peg_min_usd, usdc_peg_min_usd, liq_1h_usd, rsi_4h, ls_ratio_global, book_imbalance_2pct_pct, withdrawal_paused_venues, max_leverage_min, borrow_apr_pct, hl_whale_long_share_pct; op is one of >= > <= < ==; percent fields take percent values (0.05 means 0.05%). Pass field, op and threshold for one condition, or conditions for up to 6. scope: watchlist (default), any, or symbols with symbols. The plan sets how many recipes an account keeps; past it the tool answers with the limit. Writes are rate limited per key and each one is recorded on the account.

Parameters9

field	string	optional	string, one condition's metric, e.g. funding_rate_pct
op	string	optional	string, one condition's comparison: >= \| > \| <= \| < \| ==
threshold	number	optional	number, one condition's threshold, e.g. 0.05
conditions	array	optional	array, optional up to 6 conditions {field, op, value}, all must hold (instead of field, op, threshold)
scope	string	optional	string, optional: watchlist (default), any, symbols
symbols	array	optional	array, optional up to 20 symbols, e.g. ["BTCUSDT", "ETH"]; implies scope symbols
channels	array	optional	array, optional delivery channels: telegram \| email \| push \| webhook; empty means Telegram first, email as fallback
cooldown_hours	number	optional	number, optional 1..168 hours before it fires again (default 24)
name	string	optional	string, optional name; default describes the condition

Raw schema

{
  "type": "object",
  "properties": {
    "field": {
      "description": "string, one condition's metric, e.g. funding_rate_pct",
      "type": "string"
    },
    "op": {
      "description": "string, one condition's comparison: >= | > | <= | < | ==",
      "type": "string",
      "enum": [
        ">=",
        ">",
        "<=",
        "<",
        "=="
      ]
    },
    "threshold": {
      "description": "number, one condition's threshold, e.g. 0.05",
      "type": "number"
    },
    "conditions": {
      "description": "array, optional up to 6 conditions {field, op, value}, all must hold (instead of field, op, threshold)",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "field": {
            "type": "string"
          },
          "op": {
            "type": "string",
            "enum": [
              ">=",
              ">",
              "<=",
              "<",
              "=="
            ]
          },
          "value": {
            "type": "number"
          }
        },
        "required": [
          "field",
          "op",
          "value"
        ]
      }
    },
    "scope": {
      "description": "string, optional: watchlist (default), any, symbols",
      "type": "string",
      "enum": [
        "watchlist",
        "any",
        "symbols"
      ]
    },
    "symbols": {
      "description": "array, optional up to 20 symbols, e.g. [\"BTCUSDT\", \"ETH\"]; implies scope symbols",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "channels": {
      "description": "array, optional delivery channels: telegram | email | push | webhook; empty means Telegram first, email as fallback",
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "telegram",
          "email",
          "push",
          "webhook"
        ]
      }
    },
    "cooldown_hours": {
      "description": "number, optional 1..168 hours before it fires again (default 24)",
      "type": "number"
    },
    "name": {
      "description": "string, optional name; default describes the condition",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

delete_alert_recipe

Call this when the user asks to remove an alert. Deletes the alert recipe with this id from the account (list_alert_recipes shows the ids); an id that is not one of the account's recipes changes nothing and says so. Writes are rate limited per key and each one is recorded on the account.

Parameters1

string

required

string, the recipe id from list_alert_recipes

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "string, the recipe id from list_alert_recipes"
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_watchlists

Call this when the user asks what is on their watchlist, which lists they have, or before adding or removing a symbol. Returns the account's watchlists (id, name, symbol count) and, unless include_symbols is false, the symbols on each list in order. Needs the account key; reads nothing but this account.

Parameters1

include_symbols

boolean

optional

boolean, optional: include each list's symbols (default true)

Raw schema

{
  "type": "object",
  "properties": {
    "include_symbols": {
      "description": "boolean, optional: include each list's symbols (default true)",
      "type": "boolean"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

add_watchlist_symbol

Call this when the user asks to watch, follow or add a coin to their watchlist. Adds the symbol to the list named by watchlist_id, else to the default list (or the only list the account has); a symbol already on the list stays once. Returns the list's symbols after the change. Writes are rate limited per key and each one is recorded on the account.

Parameters2

symbol	string	required	string, a Binance USDT-M perp or coin, e.g. SOLUSDT or SOL
watchlist_id	string	optional	string, optional list id from list_watchlists (default: the default list)

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "description": "string, a Binance USDT-M perp or coin, e.g. SOLUSDT or SOL"
    },
    "watchlist_id": {
      "description": "string, optional list id from list_watchlists (default: the default list)",
      "type": "string"
    }
  },
  "required": [
    "symbol"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

remove_watchlist_symbol

Call this when the user asks to stop watching a coin or remove it from their watchlist. Removes the symbol from the list named by watchlist_id, else from the default list (or the only list the account has); a symbol that is not on the list changes nothing. Returns the list's symbols after the change. Writes are rate limited per key and each one is recorded on the account.

Parameters2

symbol	string	required	string, the symbol to remove, e.g. SOLUSDT or SOL
watchlist_id	string	optional	string, optional list id from list_watchlists (default: the default list)

Raw schema

{
  "type": "object",
  "properties": {
    "symbol": {
      "type": "string",
      "description": "string, the symbol to remove, e.g. SOLUSDT or SOL"
    },
    "watchlist_id": {
      "description": "string, optional list id from list_watchlists (default: the default list)",
      "type": "string"
    }
  },
  "required": [
    "symbol"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_tracked_addresses

Call this when the user asks which Hyperliquid addresses they follow, or what those addresses hold right now. Returns every followed address with its label, the positions last seen on it and the plan's address limit; following addresses is part of Terminal and the plans above it.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

add_tracked_address

Call this when the user asks to follow, track or get alerts for a Hyperliquid address (0x followed by 40 hex characters). Every later position change of the address (opened, closed, increased, reduced, flipped) reaches the user's alert channels; the first sight is the baseline and sends nothing. Counted against the plan's address limit; the route answers terminal_required or limit_reached when it cannot add.

Parameters2

address	string	required	string, 0x followed by 40 hex characters
label	string	optional	string, optional name for the address, up to 40 characters

Raw schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "description": "string, 0x followed by 40 hex characters"
    },
    "label": {
      "description": "string, optional name for the address, up to 40 characters",
      "type": "string"
    }
  },
  "required": [
    "address"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

remove_tracked_address

Call this when the user asks to stop following or tracking a Hyperliquid address. Takes the id from list_tracked_addresses; the address's alerts stop, its recorded events stay.

Parameters1

string

required

string, the id from list_tracked_addresses

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "string, the id from list_tracked_addresses"
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

README.md10 KBView on GitHub

bykaranteli-mcp

MCP (Model Context Protocol) server for live crypto derivatives data: funding rates, cross-exchange funding arbitrage, open interest pressure, liquidations, options, ETF flows, Fear & Greed and BTC dominance.

51 read-only tools over the public JSON API of bykaranteli.com. Since 2026-09-10 the API asks programs for an account key: a free key comes with any verified account at https://bykaranteli.com/dashboard/api (30 requests a minute and 15,000 a month, public depth), and the Builder, Business and Scale plans raise the rate and the monthly fair use and unlock member depth (LiqMap on seven timeframes, 5-minute series, a monthly x402 catalog allowance). Set it as BYKARANTELI_API_KEY. Data covers Binance USDT-M perpetuals; funding arbitrage, liquidations, order book depth, options, positioning and insurance funds add the other venues each board lists on bykaranteli.com/coverage.

Hosted endpoint (no install)

Paste https://mcp.bykaranteli.com as a custom connector in any MCP-capable assistant. Same 51 tools, nothing to install. Every tool call needs your account key (free at https://bykaranteli.com/dashboard/api); connecting and listing the tools work without one. The key travels one of three ways:

the request header x-api-key: bk_... (claude.ai custom connectors, Cursor, Claude Code);
the request header Authorization: Bearer bk_...;
the address https://mcp.bykaranteli.com/?key=bk_... for clients that cannot send headers (ChatGPT). Treat that address like a password and revoke the key if it leaks.

A free account covers the API and the hosted MCP on one monthly counter; Builder and above bring higher rates and member depth.

Step-by-step guide for beginners: https://bykaranteli.com/guide/connect

Quick start

Claude Code

bash

claude mcp add bykaranteli -e BYKARANTELI_API_KEY=bk_... -- npx -y bykaranteli-mcp

Claude Desktop

Add to claude_desktop_config.json:

json

{
  "mcpServers": {
    "bykaranteli": {
      "command": "npx",
      "args": ["-y", "bykaranteli-mcp"],
      "env": { "BYKARANTELI_API_KEY": "bk_..." }
    }
  }
}

Cursor / other MCP clients

Any stdio MCP client works: command npx, args ["-y", "bykaranteli-mcp"], env BYKARANTELI_API_KEY.

Requires Node.js 18 or newer.

Tools

Tool	What it answers
`get_market_indices`	"What is the Fear & Greed index today?", "What is BTC dominance right now?"
`get_funding_heatmap`	"What are funding rates right now?", "What is SOL's funding?"
`get_funding_arbitrage`	"Any funding arb opportunities?", "Best venue to long/short BTC for carry?"
`get_pressure_scores`	"Which coins are over-leveraged / crowded right now?"
`get_top_movers`	"Biggest OI spikes today?", "Most extreme funding right now?"
`get_liquidations`	"How much was liquidated today?", "Did longs or shorts get flushed this week?"
`get_liquidation_leaderboard`	"What was the biggest liquidation today?", "When do liquidations cluster, Asia or US hours?"
`get_insurance_funds`	"How big is the Binance insurance fund?", "Did any exchange insurance fund shrink this week?"
`get_tokenized_stocks`	"How much tokenized Tesla exists onchain?", "Which tokenized stock trades furthest from the real share?", "Which price valued this wrapper's supply?" (`price_source`, `totals.priced_by`)
`get_etf_flows`	"Did the Bitcoin ETFs buy or sell yesterday?", "Cumulative ETH ETF inflow?"
`get_cot_positioning`	"Are hedge funds long or short Bitcoin?", "What did the COT report show?"
`get_options_snapshot`	"Where are the BTC option walls?", "What is DVOL / the zero-gamma level?"
`get_coinbase_premium`	"Are US investors buying Bitcoin?", "What does the basis trade pay?"
`get_flow_toxicity`	"Is toxic order flow building?", "What is BTC's VPIN right now?"
`get_options_flow`	"What are the big options players buying?", "Any block trades today?"
`get_slippage`	"How much slippage on a $1M market order?", "Which book is thinnest?"
`get_fomc_impact`	"What does BTC do on Fed days?", "When is the next FOMC meeting?"
`get_liquidation_cascades`	"What caused that flush?", "Who got liquidated this week?"
`get_open_interest`	"Is leverage entering the market?", "Are shorts building in XRP?"
`get_psi_charge`	"What liquidity state is the market in?", "Is parked money deploying?"
`get_theme_indices`	"Which crypto narrative is leading: AI, RWA, DePIN, memes, L2s, DeFi?"
`get_factor_board`	"Which indicators sit in an unusual band today, and what followed historically?"
`get_venue_markets`	"Total BTC open interest across exchanges?", "What is the DEX share of perp OI?", "Is USDT off peg anywhere?"
`get_leverage_tiers`	"How much leverage does Bybit allow on SOL?", "Which exchange has the highest max leverage for DOGE?", "Did any venue cut leverage on a coin this week?"
`get_withdrawal_status`	"Has KuCoin paused USDT withdrawals?", "Cheapest network to withdraw USDT from Gate?", "Which exchanges have withdrawals closed right now?"
`get_venue_profile`	"What do you record about Bybit?", "How many contracts does OKX list?", "Is HTX up, and what happened there this week?"
`get_settlements`	"What expires this week?", "When is the next BTC quarterly on OKX?", "At what price did the September future settle?"
`get_borrow_rates`	"What does it cost to borrow USDT on Binance?", "Cheapest venue to borrow ETH?", "Is stablecoin borrow spiking?"
`get_fee_table`	"What are Bitget's perp fees?", "Which exchange has the lowest taker fee?", "Did any venue change fees this week?"
`get_lead_lag`	"Does Coinbase or Binance move first?"
`get_iv_surface`	"What is BTC implied vol by expiry?", "Is downside protection expensive (skew)?"
`get_whale_tape`	"Are whales buying or selling right now?"
`get_correlations`	"How correlated is SOL to BTC over 30 days?"
`get_new_listings`	"Which perpetuals were listed this week, and where first?"
`get_macro_liquidity`	"What is the Fed balance sheet / RRP / stablecoin supply doing?"
`get_network_health`	"Bitcoin hashrate, difficulty, fees, mempool right now?"
`get_tradfi_board`	"TSLA perp funding rate? Which exchanges list NVDA perps? Is the stock session open?"
`get_rsi_heatmap`	"Which coins are oversold on the daily? BTC RSI on 4h and 1w?"
`get_hl_whales`	"Are Hyperliquid whales net long BTC? What did the biggest accounts just flip?"
`get_positioning`	"BTC long/short ratio on Binance? Are top traders net short ETH? CVD today?"
`get_coverage`	"Which exchanges are behind your liquidation totals? How fresh is the data?"
`get_orderbook_depth`	"Where is the biggest BTC bid wall? How deep is ETH within 2% on Coinbase vs Binance?"
`get_jupiter_perps`	"How much long vs short OI is on Jupiter SOL perps? Who topped Jupiter this week? What is the JLP APR?"
`get_solana_perps`	"Which Solana perp DEX has the most open interest? What is Pacifica's BTC funding and 24h volume? Phoenix SOL open interest? GM Trade versus Jupiter?"
`get_turkey_premium`	"What do lira buyers pay for bitcoin above the world price? What is the Turkey Premium Index and its score right now? Which Turkish exchange is dearest? What is USDT/TRY against the official rate?"
`get_data_proof`	"Can I verify a ByKaranteli number was not changed later? Show the on-chain proof for BTC funding right now. Which Solana transaction sealed the newest epoch?"
`get_cycle_indicators`	"Has the Pi Cycle crossed? Mayer Multiple and Puell today?"
`get_altseason`	"Is it altseason?", "What is the altcoin season index?"
`get_metric_context`	"Is today's funding extreme historically?", "Where does this reading sit in its distribution?"
`get_quantum_exposure`	"How much Bitcoin is quantum-vulnerable?", "What is the P2PK exposure?"
`get_liqmap`	"Where are the BTC liquidation clusters?", "Where would leveraged longs get liquidated?"

All responses are JSON and carry a generatedAt timestamp plus a source URL to the human-readable page. Symbols accept both BTCUSDT and bare BTC.

Configuration

Env var	Default	Purpose
`BYKARANTELI_API_KEY`	none	Account key (`bk_...`) sent as `Authorization: Bearer`. Free at https://bykaranteli.com/dashboard/api; required for programs from 2026-09-10
`BYKARANTELI_BASE_URL`	`https://bykaranteli.com`	Override the API host (testing only)

Data notes

The signal engine was retired in September 2026; this server publishes recorded market data only, no trading signals or performance claims.
Funding, OI and pressure data refresh every 15 to 30 minutes; indices every 30 minutes.
Nothing here is financial advice. See bykaranteli.com/risk-guide.

Development

bash

npm install
npm run build
node dist/index.js   # speaks MCP over stdio

License

Server: MIT. Data: personal and research use with attribution "ByKaranteli (bykaranteli.com)"; commercial use with the Business plan. Licence text: https://bykaranteli.com/data#license.

Plans and paid depth

Plan	Price	Rate	Monthly	Depth
Free API	$0	30 / min	15,000	public pages
Terminal	$29 / mo	60 / min	150,000	public pages
Builder	$49 / mo	300 / min	1,000,000 fair use	member depth, 1,000 x402 catalog calls a month
Business	$149 / mo	1,200 / min	3,000,000 fair use	member depth, commercial licence, 10,000 x402 catalog calls a month, monthly bulk
Scale	$399 / mo	3,000 / min	10,000,000 fair use	member depth, derived redistribution, x402 catalog with no ceiling, daily raw

A Free or Terminal key past its monthly figure gets 429 until the month resets. A paid key past its fair use is never stopped: it answers at the Free rate (30 a minute) until the month resets, with x-quota-state: slow on every answer.

Full table: https://bykaranteli.com/developers#tiers. For recorded history and raw records beyond the live snapshots, bykaranteli.com also exposes pay-per-call x402 endpoints for anonymous agents (USDC on Solana or Base, priced per call, no account): https://bykaranteli.com/developers#x402 · machine catalog: https://bykaranteli.com/api/x402. Builder keys call those routes unpaid up to 1,000 calls a month, Business up to 10,000, Scale with no ceiling; past the allowance a key pays per call like an anonymous agent or moves up a plan.

Install

Tools (67)

get_market_indicesget_liquidationsget_etf_flowsget_funding_heatmapget_funding_arbitrageget_pressure_scoresget_top_moversget_cot_positioning

Add to VS Code Add to Cursor

claude_desktop_config.json

json

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