Serveur MCP

mcp

com.bykaranteli/mcp

Ce que fait ce MCP

Provides crypto derivatives and market-structure data including funding, open interest, liquidations, options, ETF flows, leverage, whale activity, and macro indicators.

get_altseason
Altcoin Season Index (live + recorded history)
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).
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
get_borrow_rates
Margin borrow rates per venue: the cost of leverage, hourly
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).
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
get_coinbase_premium
Coinbase Premium (US demand gauge) + carry yield
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.
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
get_correlations
Crypto correlation matrix
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.
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
get_cot_positioning
CME futures positioning (weekly COT report, BTC + ETH)
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.
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
get_coverage
Coverage registry: which venues and data types we collect, how, and how fresh
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.
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
get_cycle_indicators
Bitcoin cycle indicators: Pi Cycle, Mayer, 200W MA, Puell, S2F
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.
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'days': {'type': 'integer', 'maximum': 10000, 'minimum': 30, 'description': 'Window in days for the series (default 730)'}, 'include_points': {'type': 'boolean', 'description': 'Include the daily series (large). Default false: latest values and cross dates only.'}}}
get_data_proof
BYK Data Layer: on-chain proof that a ByKaranteli number was sealed, signed and anchored on Solana and Base
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.
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'feed': {'type': 'string', 'pattern': '^BYK\\.[A-Z0-9_.]{3,60}$', 'description': 'Feed id from the catalog, e.g. BYK.FUNDING.COMPOSITE.B'}, 'asset': {'type': 'string', 'pattern': '^[A-Z0-9]{2,10}$', 'description': 'Asset of the feed: BTC, ETH, SOL, XRP, DOGE, BNB, USDT or ALL'}, 'catalog': {'type': 'boolean', 'description': 'true: list every sealed feed with its unit and methodology'}, 'sequence': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Epoch sequence; omit for the newest'}}}
get_etf_flows
US spot Bitcoin and Ethereum ETF daily 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.
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'days': {'type': 'integer', 'maximum': 400, 'minimum': 1, 'description': 'How many most recent trading days to return (default 10).'}, 'asset': {'enum': ['BTC', 'ETH', 'SOL'], 'type': 'string', 'description': 'Filter to one asset (BTC, ETH or SOL, SOL since 2026-09-02). Omit for all.'}}}
get_factor_board
Factor board: what followed days like today across recorded metrics
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.
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
get_fee_table
Trading fee schedules per venue, base tier maker and taker
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.
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
get_flow_toxicity
Order-flow toxicity (VPIN) for BTC, ETH, SOL perps
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.
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
get_fomc_impact
Measured FOMC impact on Bitcoin
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.
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
get_funding_arbitrage
Cross-exchange funding arbitrage opportunities
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).
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
get_funding_heatmap
Funding rates across the ~30 most traded Binance perps
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.
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'symbol': {'type': 'string', 'description': 'Optional. Filter to one symbol, e.g. BTCUSDT or just BTC. Omit to get all 30 rows.'}}}
get_hl_whales
Hyperliquid whale tracker: top-300 accounts, long vs short, positions, changes
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.
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'coin': {'type': 'string', 'pattern': '^[A-Z0-9]{1,24}$', 'description': 'One coin, e.g. BTC'}, 'events': {'type': 'boolean', 'description': 'Include the last 200 position change events'}}}
get_insurance_funds
Exchange insurance funds: size, 24h and 7d change, fund against open interest, daily history
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.
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'pools': {'type': 'boolean', 'description': 'Include every pool row (large for Binance and Bybit). Default false.'}, 'venue': {'enum': ['binance', 'bybit', 'okx', 'gate'], 'type': 'string', 'description': 'One venue; omit for every covered venue.'}, 'history_days': {'type': 'integer', 'maximum': 366, 'minimum': 1, 'description': 'Days of daily closes (default 30, max 366).'}}}
get_iv_surface
Options implied-volatility surface and 25-delta skew
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.
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'currency': {'enum': ['BTC', 'ETH'], 'type': 'string', 'description': 'BTC or ETH, default BTC'}}}
get_jupiter_perps
Jupiter Perps (Solana): exact long/short OI, utilization, borrow rates, weekly top traders
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.
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'base': {'type': 'string', 'pattern': '^(SOL|ETH|BTC)$', 'description': 'Market base: SOL, ETH or BTC'}, 'history_days': {'type': 'integer', 'maximum': 30, 'minimum': 1, 'description': 'Include hourly OI history for the base, 1..30 days'}}}
get_lead_lag
Venue lead-lag: who moves first (Coinbase, Kraken, Binance)
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.
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
get_leverage_tiers
Leverage tiers: max leverage and maintenance margin per perpetual on every venue
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).
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'venue': {'type': 'string', 'description': 'string, optional venue id, e.g. bybit'}, 'symbol': {'type': 'string', 'description': 'string, optional base asset, e.g. BTC'}}}
get_liqmap
LiqMap: estimated liquidation clusters with real prints overlaid
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.
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'symbol': {'type': 'string', 'pattern': '^[A-Z0-9]{2,20}$', 'description': 'Symbol like BTCUSDT (bare BTC accepted). Default BTCUSDT.'}, 'timeframe': {'enum': ['1h', '4h', '12h', '24h', '3d', '1w', '30d'], 'type': 'string', 'description': 'Model window. Default 24h, the only one served without a Builder or higher key.'}}}
get_liquidation_cascades
Auto-detected liquidation cascades (forensic case file)
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.
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
get_liquidation_leaderboard
Largest single liquidations and a 30-day session heatmap (counted venue feeds)
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.
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'days': {'type': 'integer', 'maximum': 90, 'minimum': 7, 'description': 'Days folded into the session heatmap (default 30).'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Rows to return (default 25, max 100).'}, 'window': {'enum': ['24h', '7d', '30d'], 'type': 'string', 'description': 'Ranking window: 24h (default), 7d or 30d.'}}}
get_liquidations
Crypto liquidations: daily long/short totals per symbol and exchange
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.
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'days': {'type': 'integer', 'maximum': 90, 'minimum': 1, 'description': 'How many most recent days to return (default 7).'}, 'symbol': {'type': 'string', 'pattern': '^[A-Z0-9]{2,20}$', 'description': 'Optional symbol filter like BTCUSDT or ETHUSDT. Omit for all symbols.'}}}
get_macro_liquidity
Macro liquidity: Fed funds, 10y, balance sheet, RRP, stablecoin supply
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.
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'days': {'type': 'integer', 'maximum': 730, 'minimum': 1, 'description': 'Window in days, 1-730 (default 365).'}}}
get_market_indices
Crypto market indices (Fear & Greed, BTC dominance, euphoria)
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.
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
get_metric_context
Historical context for any recorded metric (conditional distribution)
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.
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['metric'], '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.'}}}
get_network_health
Bitcoin network health from our own node
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.
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'days': {'type': 'integer', 'maximum': 730, 'minimum': 1, 'description': 'Window in days, 1-730 (default 365).'}}}
get_new_listings
New and delisted perpetual contracts
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.
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'days': {'type': 'integer', 'maximum': 30, 'minimum': 1, 'description': 'Window in days, 1-30 (default 30). Longer listing history is the listings dataset at bykaranteli.com/data.'}}}
get_open_interest
Intraday open interest and leverage regimes (10 major perps)
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.
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
get_options_flow
Options tape: biggest prints and premium flow (BTC + ETH)
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.
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
get_options_snapshot
Options walls, gamma exposure and DVOL (BTC + ETH)
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.
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'venue': {'enum': ['all', 'deribit', 'bybit', 'binance', 'okx', 'delta'], 'type': 'string', 'description': 'all (default) sums every options venue; or one venue id: deribit, bybit, binance, okx or delta (Delta Exchange India).'}}}
get_orderbook_depth
Spot order book depth: walls and 2% depth from every spot venue on the coverage page
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.
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'hours': {'type': 'integer', 'maximum': 24, 'minimum': 1, 'description': 'Include the summed 5-minute history for this many hours'}, 'symbol': {'type': 'string', 'pattern': '^[A-Z0-9]{2,12}$', 'description': 'One coin, e.g. BTC (default BTC)'}}}
get_positioning
Positioning: long/short ratios, taker buy/sell and CVD across exchanges
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.
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'symbol': {'type': 'string', 'pattern': '^[A-Z0-9]{2,24}$', 'description': 'One Binance symbol, e.g. BTCUSDT'}}}
get_pressure_scores
Derivatives pressure scores (funding + OI + basis composite)
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.
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Optional. Max rows to return when no symbol filter is set (default 20, sorted by score).'}, 'symbol': {'type': 'string', 'description': 'Optional. Return only this symbol, e.g. BTCUSDT or BTC.'}}}
get_psi_charge
PsiCharge liquidity state (proprietary model, outcomes published)
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.
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
get_quantum_exposure
Quantum-exposed Bitcoin (daily first-party measurement)
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.
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
get_rsi_heatmap
RSI heatmap: Wilder RSI(14) on eight timeframes for the top-400 crypto perps and every TradFi perp
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.
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'kind': {'enum': ['crypto', 'tradfi'], 'type': 'string', 'description': 'crypto | tradfi'}, 'sort': {'enum': ['15m', '1h', '4h', '12h', '1d', '3d', '1w', '1M'], 'type': 'string', 'description': 'Interval to sort by, descending'}, 'symbol': {'type': 'string', 'pattern': '^[A-Z0-9]{2,24}$', 'description': 'One Binance symbol, e.g. BTCUSDT'}}}
get_settlements
Expiry calendar and settlement prices across venues
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.
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
get_slippage
Live execution cost: what a market order really costs
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.
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
get_solana_perps
Solana Perps board: open interest, 24h volume and hourly rates across six Solana perpetual venues (Jupiter, Pacifica, Phoenix, GM Trade, Velocity, Bullet)
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).
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'venue': {'type': 'string', 'pattern': '^(jupiter|pacifica|phoenix|gmtrade|velocity|bullet)$', 'description': 'Venue filter: jupiter, pacifica, phoenix, gmtrade, velocity or bullet'}, 'symbol': {'type': 'string', 'pattern': '^[A-Za-z0-9_.-]{1,24}$', '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'}, 'history_days': {'type': 'integer', 'maximum': 30, 'minimum': 1, 'description': 'Hourly history for the symbol, 1..30 days'}}}
get_theme_indices
Crypto narrative indices (AI, RWA, DePIN, meme, L1, L2, DeFi, quantum)
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.
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'include_points': {'type': 'boolean', 'description': 'boolean, optional: include the daily index points (large)'}}}
get_tokenized_stocks
Tokenized stocks onchain: supply, premium to the real share, DEX pools and exchange pairs
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.
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'top': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'Rows by supply (default 20, max 200).'}, 'chain': {'type': 'string', 'pattern': '^[a-z]{2,12}$', 'description': 'One chain, e.g. solana, base, bnb, robinhood, ethereum, ton, all (xStocks circulating) or cex (exchange pairs).'}, 'issuer': {'enum': ['xstocks', 'robinhood', 'coinbase', 'bstocks', 'ondo', 'backpack', 'gstocks', 'reality', 'superstate', 'figure', 'dinari', 'securitize'], 'type': 'string', 'description': 'One issuer: xstocks, robinhood, coinbase, bstocks, ondo, backpack, gstocks, reality, superstate, figure, dinari or securitize; omit for every issuer.'}, 'underlying': {'type': 'string', 'pattern': '^[A-Za-z0-9.]{1,16}$', 'description': 'Stock ticker, e.g. TSLA; omit for the whole board.'}}}
get_top_movers
Top movers: OI spikes, extreme funding, widest basis, highest stress
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.
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
get_tradfi_board
TradFi perpetuals: stock, index and commodity perps on Binance
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.
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'market': {'type': 'string', 'pattern': '^[A-Z_]{3,16}$', 'description': 'Market filter: EQUITY | HK_EQUITY | KR_EQUITY | CN_EQUITY | COMMODITY | INDEX | PREMARKET'}, 'symbol': {'type': 'string', 'pattern': '^[A-Z0-9]{2,24}$', 'description': 'One Binance TradFi symbol, e.g. TSLAUSDT'}}}
get_turkey_premium
Turkey Premium Index: what lira buyers pay above the world price, with TRY reference prices from Turkish venues
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.
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'pair': {'type': 'string', 'pattern': '^(BTC-TRY|ETH-TRY|USDT-TRY|BTC-USDT|ETH-USDT)$', 'description': 'Pair: BTC-TRY, ETH-TRY, USDT-TRY, BTC-USDT or ETH-USDT'}, 'history_days': {'type': 'integer', 'maximum': 30, 'minimum': 1, 'description': 'Include 15-minute index history for the pair, 1..30 days'}}}
get_venue_markets
Exchange coverage: OI, volume, funding and pegs across every exchange we snapshot
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.
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'symbol': {'type': 'string', 'description': 'string, optional base asset, e.g. BTC'}, 'history_days': {'type': 'integer', 'maximum': 90, 'minimum': 1, 'description': 'Return the hourly multi-venue open interest history (total, DEX share, OI-weighted funding) for this many days instead of the snapshot'}}}
get_venue_profile
Venue profile: everything ByKaranteli records about one exchange
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.
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'venue': {'type': 'string', 'description': 'string, optional venue id, e.g. bybit'}}}
get_whale_tape
Whale tape: $1M+ aggressive prints with 24h buy share
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.
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
get_withdrawal_status
Withdrawal status and network fees: which exchanges paused withdrawals, per asset and network
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.
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'asset': {'type': 'string', 'description': 'string, optional asset code, e.g. USDT'}, 'venue': {'type': 'string', 'description': 'string, optional venue id, e.g. kucoin'}}}
Modifié
get_options_flow
1 October 2026 02:53
Modifié
get_options_snapshot
1 October 2026 02:53
Modifié
get_solana_perps
29 September 2026 03:01
Modifié
get_turkey_premium
29 September 2026 03:01
Modifié
get_tokenized_stocks
29 September 2026 03:01
Ajouté
get_solana_perps
27 September 2026 02:52
Modifié
get_tokenized_stocks
27 September 2026 02:52
Ajouté
get_tokenized_stocks
25 September 2026 03:01
Modifié
get_orderbook_depth
25 September 2026 03:01
Modifié
get_positioning
25 September 2026 03:01
Modifié
get_liqmap
25 September 2026 03:01
Modifié
get_new_listings
25 September 2026 03:01
Ajouté
get_insurance_funds
25 September 2026 03:01
Modifié
get_options_snapshot
25 September 2026 03:01
Modifié
get_liquidations
25 September 2026 03:01
Modifié
get_positioning
23 September 2026 02:52
Ajouté
get_liquidation_leaderboard
23 September 2026 02:52
Modifié
get_funding_arbitrage
23 September 2026 02:52
Modifié
get_data_proof
21 September 2026 02:59
Modifié
get_turkey_premium
21 September 2026 02:59
Modifié
get_rsi_heatmap
21 September 2026 02:59
Modifié
get_venue_markets
21 September 2026 02:59
Ajouté
get_data_proof
19 September 2026 02:50
Ajouté
get_turkey_premium
19 September 2026 02:50
Ajouté
get_orderbook_depth
17 September 2026 12:34
Ajouté
get_coverage
17 September 2026 12:34
Ajouté
get_jupiter_perps
17 September 2026 12:34
Ajouté
get_positioning
17 September 2026 12:34
Ajouté
get_hl_whales
17 September 2026 12:34
Ajouté
get_cycle_indicators
17 September 2026 12:34