F1ow Crypto Market Data & Research MCP is an MCP server published by com.f1ow, hosted at mcp.f1ow.com. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 39 tools, including catalysts_calendar, catalysts_economic_calendar, catalysts_etf_flows, catalysts_exchange_listings, derivatives_flow.
Crypto market & research MCP for AI agents: prices, derivatives, options, on-chain, sentiment, news.
66 connections through 4 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Lists upcoming crypto catalyst events for the next 7 days. Optionally filter by comma-separated coin symbols (e.g. 'sol,eth').
| Parameter | Type | Description |
|---|---|---|
| coins | string | Comma-separated coin symbols, e.g. 'sol,eth'. Omit for all coins. |
{
"name": "catalysts_calendar",
"title": "Catalyst Calendar",
"description": "Lists upcoming crypto catalyst events for the next 7 days. Optionally filter by comma-separated coin symbols (e.g. 'sol,eth').",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"coins": {
"type": "string",
"description": "Comma-separated coin symbols, e.g. 'sol,eth'. Omit for all coins."
}
}
},
"outputSchema": {
"type": "object",
"required": [
"events"
],
"properties": {
"events": {
"type": "array",
"items": {
"type": "object",
"required": [
"title",
"coins",
"date",
"categories"
],
"properties": {
"url": {
"type": "string",
"description": "Event page on the originating platform; absent when unknown"
},
"date": {
"type": "string",
"description": "Event date, ISO 8601"
},
"coins": {
"type": "array",
"items": {
"type": "string"
},
"description": "Coin symbols the event concerns; empty means all coins"
},
"title": {
"type": "string"
},
"categories": {
"type": "array",
"items": {
"type": "string"
}
}
}
},
"description": "Upcoming catalyst events; empty when none"
}
}
},
"annotations": {
"readOnlyHint": true
}
}Scheduled macroeconomic data releases (CPI, FOMC, jobs, GDP, etc.; CoinGlass plans above Hobbyist only) plus dated crypto catalysts (supply unlocks, upgrades, summits; CoinMarketCal), from the last ~2 days through the next 7 days. Crypto events have country 'Crypto' and medium importance. Optionally set 'min_importance' (1-3, default 1, i.e. everything) to filter out low-impact releases.
| Parameter | Type | Description |
|---|---|---|
| min_importance | integer | Minimum importance level to include: 1 (all), 2 (medium+), 3 (high only). Defaults to 1. |
{
"name": "catalysts_economic_calendar",
"title": "Economic Calendar",
"description": "Scheduled macroeconomic data releases (CPI, FOMC, jobs, GDP, etc.; CoinGlass plans above Hobbyist only) plus dated crypto catalysts (supply unlocks, upgrades, summits; CoinMarketCal), from the last ~2 days through the next 7 days. Crypto events have country 'Crypto' and medium importance. Optionally set 'min_importance' (1-3, default 1, i.e. everything) to filter out low-impact releases.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"min_importance": {
"type": "integer",
"description": "Minimum importance level to include: 1 (all), 2 (medium+), 3 (high only). Defaults to 1."
}
}
},
"outputSchema": {
"type": "object",
"required": [
"events"
],
"properties": {
"events": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"country",
"countryCode",
"importance"
],
"properties": {
"name": {
"type": "string"
},
"actual": {
"type": "string",
"description": "Published value, in the release's own unit; absent until released"
},
"country": {
"type": "string"
},
"forecast": {
"type": "string",
"description": "Consensus forecast, in the release's own unit; absent when none"
},
"previous": {
"type": "string",
"description": "Previous value, in the release's own unit; absent when none"
},
"releaseMs": {
"type": "integer",
"description": "Scheduled release time, epoch ms; absent when TBD"
},
"importance": {
"type": "integer",
"description": "1 (low) to 3 (high)"
},
"countryCode": {
"type": "string"
}
}
},
"description": "Releases at or above the requested importance, up to 40; empty when none"
}
}
},
"annotations": {
"readOnlyHint": true
}
}Recent daily spot-ETF net flows (USD) for an underlying asset (BTC, ETH, SOL, XRP; defaults to BTC): latest day total, per-fund breakdown, and the trailing daily trend. Positive means net inflows. Flows settle behind spot and skip weekends, so the latest row is routinely a day or more old — its age is reported next to the date, and the price it carries is the price on THAT date, not spot. 'symbol' is accepted as an alias for 'asset'.
| Parameter | Type | Description |
|---|---|---|
| asset | string | Underlying asset symbol, e.g. "BTC" or "ETH". Defaults to BTC. |
| symbol | string | Alias for 'asset'. |
{
"name": "catalysts_etf_flows",
"title": "ETF Flows",
"description": "Recent daily spot-ETF net flows (USD) for an underlying asset (BTC, ETH, SOL, XRP; defaults to BTC): latest day total, per-fund breakdown, and the trailing daily trend. Positive means net inflows. Flows settle behind spot and skip weekends, so the latest row is routinely a day or more old — its age is reported next to the date, and the price it carries is the price on THAT date, not spot. 'symbol' is accepted as an alias for 'asset'.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"asset": {
"type": "string",
"description": "Underlying asset symbol, e.g. \"BTC\" or \"ETH\". Defaults to BTC."
},
"symbol": {
"type": "string",
"description": "Alias for 'asset'."
}
}
},
"outputSchema": {
"type": "object",
"required": [
"asset",
"days"
],
"properties": {
"days": {
"type": "array",
"items": {
"type": "object",
"required": [
"date",
"dateMs",
"netFlowUsd",
"priceUsd",
"byTicker"
],
"properties": {
"date": {
"type": "string",
"description": "Trading day, yyyy-MM-dd (UTC)"
},
"dateMs": {
"type": "integer",
"description": "Trading day start, epoch ms"
},
"byTicker": {
"type": "array",
"items": {
"type": "object",
"required": [
"ticker",
"flowUsd"
],
"properties": {
"ticker": {
"type": "string"
},
"flowUsd": {
"type": "number",
"description": "Fund net flow, USD"
}
}
},
"description": "Per-fund net flow"
},
"priceUsd": {
"type": "number",
"description": "Underlying price on that day, USD (not spot)"
},
"netFlowUsd": {
"type": "number",
"description": "Net flow across all funds, USD; positive = inflow"
}
}
},
"description": "Daily net flows, newest first, up to 30; empty when the provider has no data for the asset"
},
"asset": {
"type": "string",
"description": "Underlying asset symbol, upper case"
}
}
},
"annotations": {
"readOnlyHint": true
}
}Exchange listings and delistings from the venues' own notices: what is SCHEDULED (with the exact time when the venue states it) and what happened in the last 'days' (default 7, max 30). Binance (futures instrument list: exact open/settle times; announcements when configured), Bybit and OKX (official announcement feeds) and Upbit. Delistings are announced 2–7 days ahead; new listings, Upbit and Binance especially, are among the most price-moving events. Coins and times are parsed from each notice's title and text: a notice that does not name them says so. Filter by coin ('symbol', comma-separated), 'kind' (listing, delisting, or all to include other trading notices such as pair removals, margin/collateral changes, migrations and postponements) and 'exchange'.
| Parameter | Type | Description |
|---|---|---|
| days | integer | How many days back 'recent' reaches, 1–30. Default 7. |
| kind | string | listing, delisting, both (default) or all (adds other trading notices) |
| symbol | string | Coin symbol(s), comma-separated, e.g. 'EPIC' or 'sol,eth'. Omit for all coins. |
| exchange | string | Binance, Bybit, OKX or Upbit. Omit for all. |
{
"name": "catalysts_exchange_listings",
"title": "Exchange Listings",
"description": "Exchange listings and delistings from the venues' own notices: what is SCHEDULED (with the exact time when the venue states it) and what happened in the last 'days' (default 7, max 30). Binance (futures instrument list: exact open/settle times; announcements when configured), Bybit and OKX (official announcement feeds) and Upbit. Delistings are announced 2–7 days ahead; new listings, Upbit and Binance especially, are among the most price-moving events. Coins and times are parsed from each notice's title and text: a notice that does not name them says so. Filter by coin ('symbol', comma-separated), 'kind' (listing, delisting, or all to include other trading notices such as pair removals, margin/collateral changes, migrations and postponements) and 'exchange'.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"days": {
"type": "integer",
"description": "How many days back 'recent' reaches, 1–30. Default 7."
},
"kind": {
"enum": [
"listing",
"delisting",
"both",
"all"
],
"type": "string",
"description": "listing, delisting, both (default) or all (adds other trading notices)"
},
"symbol": {
"type": "string",
"description": "Coin symbol(s), comma-separated, e.g. 'EPIC' or 'sol,eth'. Omit for all coins."
},
"exchange": {
"type": "string",
"description": "Binance, Bybit, OKX or Upbit. Omit for all."
}
}
},
"outputSchema": {
"type": "object",
"$defs": {
"notice": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"kind": {
"enum": [
"listing",
"delisting",
"other"
],
"type": "string"
},
"coins": {
"type": "array",
"items": {
"type": "string"
},
"description": "Base tickers parsed from the notice; empty when it names none"
},
"title": {
"type": "string"
},
"market": {
"type": [
"string",
"null"
],
"description": "spot or perp; null when the notice does not say"
},
"source": {
"type": "string",
"description": "announcement or listing data (the venue's instrument list)"
},
"category": {
"type": "string",
"description": "The venue's own category"
},
"exchange": {
"type": "string"
},
"effectiveMs": {
"type": [
"integer",
"null"
],
"description": "When trading opens or closes, when stated"
},
"publishedMs": {
"type": [
"integer",
"null"
]
},
"effectiveDayOnly": {
"type": "boolean"
}
}
}
},
"required": [
"scheduled",
"recent",
"sources"
],
"properties": {
"days": {
"type": "integer"
},
"kind": {
"type": "string"
},
"asOfMs": {
"type": "integer"
},
"recent": {
"type": "array",
"items": {
"$ref": "#/$defs/notice"
},
"description": "Took effect (or, undated, was announced) within 'days', newest first"
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"ok": {
"type": "boolean"
},
"name": {
"type": "string"
},
"note": {
"type": [
"string",
"null"
]
},
"error": {
"type": [
"string",
"null"
]
}
}
}
},
"scheduled": {
"type": "array",
"items": {
"$ref": "#/$defs/notice"
},
"description": "Takes effect after asOfMs, soonest first"
}
}
},
"annotations": {
"readOnlyHint": true
}
}USDT-margined perpetual flow for one coin on a 5m/15m/1h grid, from one venue: Binance, or Bybit for coins Binance doesn't list (e.g. WAVES). Open interest (USD) at every bucket edge joined to taker buy and sell volume (USD), with each stretch read as new longs, new shorts, short covering or long unwind (OI direction × the aggressive side). Bybit publishes the taker split only for its last ~1000 trades, so older Bybit buckets are read from OI against price direction instead, and every read states its basis (taker or price). Reports the window, the open-interest swings of 1% or more with the price and taker flow inside them (flagging aggressors absorbed by passive orders, taker basis only), and the buckets where OI moved most. One venue, not the market-wide aggregate. Use it to say whether a move was positions opening or closing, and which side pushed.
| Parameter | Type | Description |
|---|---|---|
| hours | integer | Trailing window in hours, 1–72. Default 24. At 5m the window is capped at about 41h by the venue's 500-snapshot limit. |
| symbol * | string | Coin symbol, e.g. "ETH". |
| interval | string | Bucket size. Default 15m. |
{
"name": "derivatives_flow",
"title": "Perp Flow (OI × Taker, Binance or Bybit)",
"description": "USDT-margined perpetual flow for one coin on a 5m/15m/1h grid, from one venue: Binance, or Bybit for coins Binance doesn't list (e.g. WAVES). Open interest (USD) at every bucket edge joined to taker buy and sell volume (USD), with each stretch read as new longs, new shorts, short covering or long unwind (OI direction × the aggressive side). Bybit publishes the taker split only for its last ~1000 trades, so older Bybit buckets are read from OI against price direction instead, and every read states its basis (taker or price). Reports the window, the open-interest swings of 1% or more with the price and taker flow inside them (flagging aggressors absorbed by passive orders, taker basis only), and the buckets where OI moved most. One venue, not the market-wide aggregate. Use it to say whether a move was positions opening or closing, and which side pushed.",
"inputSchema": {
"type": "object",
"required": [
"symbol"
],
"properties": {
"hours": {
"type": "integer",
"description": "Trailing window in hours, 1–72. Default 24. At 5m the window is capped at about 41h by the venue's 500-snapshot limit."
},
"symbol": {
"type": "string",
"description": "Coin symbol, e.g. \"ETH\"."
},
"interval": {
"enum": [
"5m",
"15m",
"1h"
],
"type": "string",
"description": "Bucket size. Default 15m."
}
}
},
"outputSchema": {
"type": "object",
"required": [
"symbol",
"venue"
],
"properties": {
"rule": {
"type": "string"
},
"venue": {
"type": "string"
},
"market": {
"type": "string"
},
"symbol": {
"type": "string"
},
"window": {
"type": "object",
"properties": {
"read": {
"enum": [
"new_longs",
"new_shorts",
"short_covering",
"long_unwind",
"opened_balanced",
"closed_balanced",
"oi_flat"
],
"type": "string"
},
"oiEndUsd": {
"type": "number"
},
"priceEnd": {
"type": "number"
},
"readBasis": {
"enum": [
"taker",
"price"
],
"type": "string"
},
"oiStartUsd": {
"type": "number"
},
"priceStart": {
"type": "number"
},
"oiChangePct": {
"type": "number"
},
"takerBuyPct": {
"type": "number"
},
"takerBuyUsd": {
"type": "number"
},
"takerSellUsd": {
"type": "number"
},
"priceChangePct": {
"type": "number"
},
"takerCoveragePct": {
"type": "number",
"description": "Share of volume whose taker split is known"
}
}
},
"buckets": {
"type": "integer"
},
"caveats": {
"type": "array",
"items": {
"type": "string"
}
},
"episodes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"read": {
"type": "string"
},
"endMs": {
"type": "integer"
},
"startMs": {
"type": "integer"
},
"absorbed": {
"type": "boolean",
"description": "Aggressors pushed one way, price went the other (taker basis only)"
},
"oiEndUsd": {
"type": "number"
},
"priceEnd": {
"type": "number"
},
"readBasis": {
"enum": [
"taker",
"price"
],
"type": "string"
},
"oiStartUsd": {
"type": "number"
},
"priceStart": {
"type": "number"
},
"oiChangePct": {
"type": "number"
},
"takerBuyPct": {
"type": "number"
},
"takerBuyUsd": {
"type": "number"
},
"takerSellUsd": {
"type": "number"
},
"priceChangePct": {
"type": "number"
},
"takerCoveragePct": {
"type": "number"
}
}
},
"description": "Open-interest swings of at least 1% between zigzag pivots, oldest first"
},
"interval": {
"type": "string"
},
"windowHours": {
"type": "integer"
},
"largestOiBuckets": {
"type": "array",
"items": {
"type": "object",
"properties": {
"read": {
"type": "string"
},
"timeMs": {
"type": "integer"
},
"readBasis": {
"enum": [
"taker",
"price"
],
"type": "string"
},
"oiChangePct": {
"type": "number"
},
"oiChangeUsd": {
"type": "number"
},
"takerBuyPct": {
"type": "number"
},
"priceChangePct": {
"type": "number"
}
}
}
},
"takerSplitFromMs": {
"type": "integer",
"description": "When the venue covers only part of the window: the first bucket with a taker split"
}
}
},
"annotations": {
"readOnlyHint": true
}
}Liquidation history for one coin's perpetuals: market-wide long/short liquidations (USD) in 4h buckets and the 24h split by venue, plus a minute-level timing sample of individual liquidation orders from venues that publish them (OKX, Gate) with detected cascades (time, side, size, order count, price range) and the largest orders. The sample is a share of the market, stated per bucket, never scaled up. Use it to say WHEN and WHICH SIDE was forced out, instead of inferring liquidations from price and open interest: flat OI can hide heavy liquidations that new positions replaced. A 1y baseline ranks the trailing ~24h of longs and shorts against a year of daily totals (percentile, 'largest since' date, median day, the year's three largest days per side), so a figure can be called big or routine for this coin.
| Parameter | Type | Description |
|---|---|---|
| hours | integer | Trailing window in hours, 1–72. Default 24. |
| symbol * | string | Coin symbol, e.g. "BTC". |
| interval | string | Bucket size for the timing sample. Default 15m. |
| top_orders | integer | Largest individual liquidations to list, 0–20. Default 5. |
{
"name": "derivatives_liquidations",
"title": "Liquidation History",
"description": "Liquidation history for one coin's perpetuals: market-wide long/short liquidations (USD) in 4h buckets and the 24h split by venue, plus a minute-level timing sample of individual liquidation orders from venues that publish them (OKX, Gate) with detected cascades (time, side, size, order count, price range) and the largest orders. The sample is a share of the market, stated per bucket, never scaled up. Use it to say WHEN and WHICH SIDE was forced out, instead of inferring liquidations from price and open interest: flat OI can hide heavy liquidations that new positions replaced. A 1y baseline ranks the trailing ~24h of longs and shorts against a year of daily totals (percentile, 'largest since' date, median day, the year's three largest days per side), so a figure can be called big or routine for this coin.",
"inputSchema": {
"type": "object",
"required": [
"symbol"
],
"properties": {
"hours": {
"type": "integer",
"description": "Trailing window in hours, 1–72. Default 24."
},
"symbol": {
"type": "string",
"description": "Coin symbol, e.g. \"BTC\"."
},
"interval": {
"enum": [
"5m",
"15m",
"1h"
],
"type": "string",
"description": "Bucket size for the timing sample. Default 15m."
},
"top_orders": {
"type": "integer",
"description": "Largest individual liquidations to list, 0–20. Default 5."
}
}
},
"outputSchema": {
"type": "object",
"required": [
"symbol"
],
"properties": {
"sample": {
"type": "object",
"properties": {
"note": {
"type": "string"
},
"venues": {
"type": "array",
"items": {
"type": "string"
}
},
"sharePct24h": {
"type": "number",
"description": "Sample venues' share of the trailing-24h market-wide total"
},
"coveredFromMs": {
"type": "integer",
"description": "Earliest time every sample venue covers; earlier is unknown, not quiet"
}
}
},
"symbol": {
"type": "string"
},
"cascades": {
"type": "array",
"items": {
"type": "object",
"properties": {
"usd": {
"type": "number"
},
"side": {
"enum": [
"long",
"short"
],
"type": "string"
},
"endMs": {
"type": "integer"
},
"orders": {
"type": "integer"
},
"startMs": {
"type": "integer"
},
"lowPriceUsd": {
"type": "number"
},
"highPriceUsd": {
"type": "number"
}
}
}
},
"interval": {
"type": "string"
},
"baseline1y": {
"type": "object",
"properties": {
"days": {
"type": [
"integer",
"null"
],
"description": "Settled days ranked against"
},
"note": {
"type": [
"string",
"null"
],
"description": "Why the baseline is missing"
},
"longs": {
"type": [
"object",
"null"
],
"properties": {
"usd": {
"type": "number",
"description": "Trailing-window total"
},
"percentile": {
"type": "number",
"description": "Rank among the year's settled daily totals, 0-100"
},
"medianDayUsd": {
"type": "number"
},
"largestSinceMs": {
"type": [
"integer",
"null"
],
"description": "Newest day at or above this total, set only from the 75th percentile up; null there means above every day of the year"
}
}
},
"shorts": {
"type": [
"object",
"null"
],
"properties": {
"usd": {
"type": "number",
"description": "Trailing-window total"
},
"percentile": {
"type": "number",
"description": "Rank among the year's settled daily totals, 0-100"
},
"medianDayUsd": {
"type": "number"
},
"largestSinceMs": {
"type": [
"integer",
"null"
],
"description": "Newest day at or above this total, set only from the 75th percentile up; null there means above every day of the year"
}
}
},
"available": {
"type": "boolean"
},
"trailingFromMs": {
"type": [
"integer",
"null"
],
"description": "Start of the trailing window (20-24h back)"
},
"largestLongDays": {
"type": "array",
"items": {
"type": "object",
"properties": {
"usd": {
"type": "number"
},
"timeMs": {
"type": "integer"
}
}
}
},
"largestShortDays": {
"type": "array",
"items": {
"type": "object",
"properties": {
"usd": {
"type": "number"
},
"timeMs": {
"type": "integer"
}
}
}
}
},
"description": "The trailing ~24h (newest six 4h buckets) ranked against a year of CoinGlass daily totals over the same venues"
},
"cascadeRule": {
"type": "string"
},
"windowHours": {
"type": "integer"
},
"largestOrders": {
"type": "array",
"items": {
"type": "object",
"properties": {
"usd": {
"type": "number"
},
"side": {
"type": "string"
},
"venue": {
"type": "string"
},
"timeMs": {
"type": "integer"
},
"priceUsd": {
"type": "number"
}
}
}
},
"marketWide24h": {
"type": "object",
"properties": {
"venues": {
"type": "array",
"items": {
"type": "object",
"properties": {
"venue": {
"type": "string"
},
"longUsd": {
"type": "number"
},
"sharePct": {
"type": "number"
},
"shortUsd": {
"type": "number"
}
}
}
},
"longUsd": {
"type": "number"
},
"shortUsd": {
"type": "number"
}
},
"description": "CoinGlass trailing-24h totals and per-venue split"
},
"sourcesFailed": {
"type": "array",
"items": {
"type": "object",
"properties": {
"error": {
"type": "string"
},
"source": {
"type": "string"
}
}
}
},
"marketBuckets4h": {
"type": "array",
"items": {
"type": "object",
"properties": {
"timeMs": {
"type": "integer"
},
"forming": {
"type": "boolean",
"description": "Bucket still open; its totals will grow"
},
"longUsd": {
"type": "number"
},
"shortUsd": {
"type": "number"
}
}
},
"description": "Market-wide 4h buckets overlapping the window, oldest first"
}
}
},
"annotations": {
"readOnlyHint": true
}
}Current market-wide (cross-exchange aggregate) open interest (USD) for one coin's perpetuals, with its 24h and 7d change, the 24h price change, AND the underlying 4h-bucket series. Read OI against price: price up on rising OI is new money opening positions, price up on falling OI is short covering — opposite trades off the same price move. The series makes that read available bucket by bucket instead of once per day (pair it with market_candles at 4h for the price leg), and carries the window's own low/high so the current level can be judged against where it has actually been. A 1y line ranks the level and today's 24h change against a year of daily closes (percentile, range with dates); the change rank is the better read, since the USD level mostly tracks price. Falls back to a single-venue figure if the aggregate source is offline. Set 'points' to trim the series (omit for the full ~10-day window; 0 to suppress it).
| Parameter | Type | Description |
|---|---|---|
| points | integer | How many of the newest 4h buckets to emit. Omit for the full window (60 points ~ 10 days); 0 suppresses the series and returns the summary only. |
| symbol * | string | Coin symbol, e.g. "BTC". |
{
"name": "derivatives_open_interest",
"title": "Open Interest",
"description": "Current market-wide (cross-exchange aggregate) open interest (USD) for one coin's perpetuals, with its 24h and 7d change, the 24h price change, AND the underlying 4h-bucket series. Read OI against price: price up on rising OI is new money opening positions, price up on falling OI is short covering — opposite trades off the same price move. The series makes that read available bucket by bucket instead of once per day (pair it with market_candles at 4h for the price leg), and carries the window's own low/high so the current level can be judged against where it has actually been. A 1y line ranks the level and today's 24h change against a year of daily closes (percentile, range with dates); the change rank is the better read, since the USD level mostly tracks price. Falls back to a single-venue figure if the aggregate source is offline. Set 'points' to trim the series (omit for the full ~10-day window; 0 to suppress it).",
"inputSchema": {
"type": "object",
"required": [
"symbol"
],
"properties": {
"points": {
"type": "integer",
"description": "How many of the newest 4h buckets to emit. Omit for the full window (60 points ~ 10 days); 0 suppresses the series and returns the summary only."
},
"symbol": {
"type": "string",
"description": "Coin symbol, e.g. \"BTC\"."
}
}
},
"outputSchema": {
"type": "object",
"required": [
"found",
"symbol"
],
"properties": {
"found": {
"type": "boolean",
"description": "False when no provider lists the symbol; only symbol is then present"
},
"series": {
"type": "object",
"required": [
"source",
"points"
],
"properties": {
"points": {
"type": "array",
"items": {
"type": "object",
"required": [
"timeMs",
"openInterestUsd",
"forming"
],
"properties": {
"timeMs": {
"type": "integer",
"description": "Bucket open time, Unix epoch milliseconds"
},
"forming": {
"type": "boolean",
"description": "Bucket still open: a running estimate the feed rewrites until it closes"
},
"openInterestUsd": {
"type": "number",
"description": "Open interest, USD"
}
}
},
"description": "Oldest first"
},
"source": {
"type": "string"
},
"intervalHours": {
"type": "number",
"description": "Bucket size, hours"
}
},
"description": "The open-interest series; absent when points=0 or the history feed is down"
},
"symbol": {
"type": "string"
},
"changes": {
"type": "array",
"items": {
"type": "object",
"required": [
"window",
"priorUsd",
"nowUsd",
"changePct"
],
"properties": {
"nowUsd": {
"type": "number",
"description": "Open interest at the newest point, USD"
},
"window": {
"type": "string",
"description": "24h or 7d"
},
"priorUsd": {
"type": "number",
"description": "Open interest at the start of the window, USD"
},
"changePct": {
"type": "number",
"description": "Change over the window, percent"
}
}
},
"description": "Open-interest change over 24h and 7d from the 4h series; empty when the history feed is down or too short"
},
"aggregate": {
"type": "boolean",
"description": "False when the aggregate source was offline and the level is one venue's"
},
"baseline1y": {
"type": "object",
"required": [
"level"
],
"properties": {
"level": {
"type": "object",
"required": [
"available"
],
"properties": {
"low": {
"type": "number",
"description": "Year's lowest daily close, USD"
},
"days": {
"type": "integer",
"description": "Settled days ranked against"
},
"high": {
"type": "number",
"description": "Year's highest daily close, USD"
},
"note": {
"type": "string",
"description": "Why the baseline is missing"
},
"lowMs": {
"type": "integer",
"description": "Day of the low, Unix epoch milliseconds"
},
"highMs": {
"type": "integer",
"description": "Day of the high, Unix epoch milliseconds"
},
"median": {
"type": "number",
"description": "Year's median daily close, USD"
},
"available": {
"type": "boolean",
"description": "False when there is nothing to rank against; note says why"
},
"percentile": {
"type": "number",
"description": "Rank among the year's settled daily closes, 0-100"
},
"atOrAboveMs": {
"type": "integer",
"description": "Newest day at or above the level, Unix epoch milliseconds; absent when it tops the year"
}
},
"description": "The level's rank; low, median and high are USD. Unavailable when the level is one venue's"
},
"change24h": {
"type": "object",
"required": [
"available"
],
"properties": {
"low": {
"type": "number",
"description": "Year's lowest day-on-day change, percent"
},
"days": {
"type": "integer",
"description": "Settled days ranked against"
},
"high": {
"type": "number",
"description": "Year's highest day-on-day change, percent"
},
"note": {
"type": "string"
},
"lowMs": {
"type": "integer",
"description": "Day of the low, Unix epoch milliseconds"
},
"highMs": {
"type": "integer",
"description": "Day of the high, Unix epoch milliseconds"
},
"median": {
"type": "number",
"description": "Year's median day-on-day change, percent"
},
"available": {
"type": "boolean"
},
"percentile": {
"type": "number",
"description": "Rank among the year's day-on-day changes, 0-100"
},
"atOrAboveMs": {
"type": "integer",
"description": "Newest day at or above this change, Unix epoch milliseconds; absent when it tops the year"
}
},
"description": "The current 24h change ranked among the year's day-on-day changes; low, median and high are percent. Absent when the level is one venue's, the 4h series is not the aggregate, or the year is too short"
}
},
"description": "The level and today's 24h change ranked against a year of the aggregate's daily closes"
},
"levelAsOfMs": {
"type": "integer",
"description": "Open time of that bucket (a snapshot, not live), Unix epoch milliseconds"
},
"levelSource": {
"type": "string",
"description": "Venue whose newest 4h bucket stands in for the level when aggregate is false; absent when the level is the merged single-venue figure"
},
"seriesVenue": {
"type": "string",
"description": "Set when the level is the aggregate but changes and series come from one venue (a different book than the level)"
},
"openInterestUsd": {
"type": "number",
"description": "Open interest, USD: the cross-exchange aggregate, or one venue's when aggregate is false"
},
"priceChangePct24h": {
"type": "number",
"description": "24h price change in percentage points; absent when there is no price"
}
}
},
"annotations": {
"readOnlyHint": true
}
}Market-implied prediction-market odds for a topic (e.g. 'Fed rate cut', 'bitcoin 100k'). Returns the most active matching markets with per-outcome probabilities, volume, and resolution date.
| Parameter | Type | Description |
|---|---|---|
| query * | string | Topic to match against market questions, e.g. 'Fed', 'bitcoin', 'ETH ETF'. |
{
"name": "events_prediction_odds",
"title": "Prediction Market Odds",
"description": "Market-implied prediction-market odds for a topic (e.g. 'Fed rate cut', 'bitcoin 100k'). Returns the most active matching markets with per-outcome probabilities, volume, and resolution date.",
"inputSchema": {
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"description": "Topic to match against market questions, e.g. 'Fed', 'bitcoin', 'ETH ETF'."
}
}
},
"outputSchema": {
"type": "object",
"required": [
"markets"
],
"properties": {
"markets": {
"type": "array",
"items": {
"type": "object",
"required": [
"question",
"outcomes",
"volumeUsd",
"liquidityUsd",
"endDate",
"url",
"source"
],
"properties": {
"url": {
"type": "string",
"description": "Market page; empty when unknown"
},
"source": {
"type": "string",
"description": "Venue providing the market"
},
"endDate": {
"type": "string",
"description": "Resolution date, ISO 8601; empty when unknown"
},
"outcomes": {
"type": "array",
"items": {
"type": "object",
"required": [
"label",
"probability"
],
"properties": {
"label": {
"type": "string"
},
"probability": {
"type": "number",
"description": "Market-implied probability, 0-1"
}
}
}
},
"question": {
"type": "string"
},
"volumeUsd": {
"type": "number",
"description": "Traded volume, USD"
},
"liquidityUsd": {
"type": "number",
"description": "Available liquidity, USD"
}
}
},
"description": "Most active matching markets; empty when none"
}
}
},
"annotations": {
"readOnlyHint": true
}
}Crypto deposit and withdrawal availability across exchanges, for every asset each exchange returns (omit 'assets' for all; there is no ticker list or top-N cutoff). One row per exchange, region, asset and network where the exchange states flags per network (KuCoin, Bitget, Gate, HTX, Binance, MEXC, Bybit, OKX, Upbit); otherwise one asset-level row with network null (Coinone, WhiteBIT). 'deposit' and 'withdrawal' are independent: enabled, disabled or unknown. unknown means the exchange did not state it in a documented way; a missing field, an absent asset, a failed or rate-limited request or an unrecognised value is never reported as disabled. An asset-level flag is never copied onto its networks. Rows keep the exchange's own asset and network ids and contract address where it gives one; 'network' is a canonical name matched by explicit aliases (ERC20, TRC20, BEP20...), never by ticker. 'networks' filters by alias, the exchange's own label or a contract address; asset-level rows never match it. Page with 'limit' (default 200, max 1000) and 'cursor' (next_cursor; same filters). Each row carries retrieved_at and stale: a stale row is last-known data served because the exchange failed now, with its original retrieved_at. Coverage and health are not part of the response; instead 'warnings' names every exchange that did not answer (its rows are absent, which never means disabled), that answered from stale data, that was not queried for lack of credentials, and where Gate's per-chain status was not confirmed. Keyed exchanges (Binance, MEXC, Bybit, OKX, Upbit) are not queried until the operator configures read-only keys. Status can lag the exchange by minutes; check before moving funds, never a guarantee.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Rows per page, 1-1000. Default 200. |
| assets | array | Asset symbols, e.g. ['WAVES'] or ['USDT','USDC']. Omit for every asset each exchange returns. |
| cursor | string | next_cursor from the previous page, with the same filters. |
| networks |
Searches recent regulatory filings (full-text) for a company, ticker, or theme (e.g. 'bitcoin treasury'). Returns the most recent matching filings with form type, filer, and a direct document link.
| Parameter | Type | Description |
|---|---|---|
| query * | string | Free-text query, e.g. a company name, ticker, or theme. |
{
"name": "filings_search",
"title": "Regulatory Filings Search",
"description": "Searches recent regulatory filings (full-text) for a company, ticker, or theme (e.g. 'bitcoin treasury'). Returns the most recent matching filings with form type, filer, and a direct document link.",
"inputSchema": {
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"description": "Free-text query, e.g. a company name, ticker, or theme."
}
}
},
"outputSchema": {
"type": "object",
"required": [
"filings"
],
"properties": {
"filings": {
"type": "array",
"items": {
"type": "object",
"required": [
"company",
"form",
"filedDate",
"description"
],
"properties": {
"url": {
"type": "string",
"description": "Direct link to the filing document; absent when unknown"
},
"form": {
"type": "string",
"description": "Filing type, e.g. 8-K"
},
"company": {
"type": "string",
"description": "Primary filer"
},
"filedDate": {
"type": "string",
"description": "ISO 8601 date"
},
"description": {
"type": "string"
}
}
},
"description": "Most recent matching filings, up to 15; empty when none"
}
}
},
"annotations": {
"readOnlyHint": true
}
}Perp price levels for one coin, from what printed rather than from a chart: executed volume at price on every venue that lists it (Binance, Bybit, BingX, Hyperliquid), with the value area (70% of volume around the POC), high-volume nodes and thin zones (prices crossed without trading, where moves tend to run); open-interest changes at price split into long and short entries; realized liquidations at price (OKX/Gate sample); and resting walls from deep books on several venues, counted only when a second snapshot 2 s later still shows them. Every level is graded by evidence — traded (volume, liquidations) > inferred (OI side) > resting (orders, which can be pulled) — and lists the other evidence at the same price (confluence). Walls larger than their venue's own daily volume are flagged. Use it for where price may stall, accelerate or meet forced flow; it is not a forecast.
| Parameter | Type | Description |
|---|---|---|
| hours | integer | Window in hours, 24–168. Default 72. |
| symbol * | string | Coin symbol, e.g. "WAVES". |
{
"name": "flow_levels",
"title": "Perp Levels (volume, OI, liquidations, walls)",
"description": "Perp price levels for one coin, from what printed rather than from a chart: executed volume at price on every venue that lists it (Binance, Bybit, BingX, Hyperliquid), with the value area (70% of volume around the POC), high-volume nodes and thin zones (prices crossed without trading, where moves tend to run); open-interest changes at price split into long and short entries; realized liquidations at price (OKX/Gate sample); and resting walls from deep books on several venues, counted only when a second snapshot 2 s later still shows them. Every level is graded by evidence — traded (volume, liquidations) > inferred (OI side) > resting (orders, which can be pulled) — and lists the other evidence at the same price (confluence). Walls larger than their venue's own daily volume are flagged. Use it for where price may stall, accelerate or meet forced flow; it is not a forecast.",
"inputSchema": {
"type": "object",
"required": [
"symbol"
],
"properties": {
"hours": {
"type": "integer",
"description": "Window in hours, 24–168. Default 72."
},
"symbol": {
"type": "string",
"description": "Coin symbol, e.g. \"WAVES\"."
}
}
},
"outputSchema": {
"type": "object",
"required": [
"symbol",
"spot"
],
"properties": {
"rule": {
"type": "string"
},
"spot": {
"type": "number"
},
"step": {
"type": "number",
"description": "Price bin width"
},
"levels": {
"type": "array",
"items": {
"type": "object",
"properties": {
"usd": {
"type": "number"
},
"kind": {
"enum": [
"poc",
"value_area_high",
"value_area_low",
"high_volume_node",
"thin_zone",
"long_entries",
"short_entries",
"long_liquidations",
"short_liquidations",
"bid_wall",
"ask_wall"
],
"type": "string"
},
"price": {
"type": "number",
"description": "Quoted price: a value-area edge at its edge, a bin at its middle, a zone at its low end"
},
"venue": {
"type": "string"
},
"priceHi": {
"type": "number"
},
"priceLo": {
"type": "number"
},
"evidence": {
"enum": [
"traded",
"inferred",
"resting"
],
"type": "string"
},
"onLadder": {
"type": "boolean",
"description": "Inside the volume band the view draws"
},
"outsized": {
"type": "boolean",
"description": "A wall larger than its venue's own 24h volume"
},
"strength": {
"type": "integer",
"maximum": 3,
"minimum": 1
},
"withKinds": {
"type": "array",
"items": {
"type": "string"
}
},
"distancePct": {
"type": "number"
},
"readFromPrice": {
"type": "boolean",
"description": "An entry whose side was read from price, not a taker split"
}
}
}
},
"symbol": {
"type": "string"
},
"window": {
"type": "object",
"properties": {
"oiVenue": {
"type": "string"
},
"oiEndUsd": {
"type": "number"
},
"priceEnd": {
"type": "number"
},
"volumeUsd": {
"type": "number"
},
"oiStartUsd": {
"type": "number"
},
"priceStart": {
"type": "number"
},
"priceVenue": {
"type": "string"
},
"oiChangePct": {
"type": "number"
},
"liquidatedUsd": {
"type": "number"
},
"priceChangePct": {
"type": "number"
}
},
"description": "The window at a glance: price from the venue that traded most, OI from the flow venue, volume in the band, liquidations in the sample"
},
"caveats": {
"type": "array",
"items": {
"type": "string"
}
},
"sources": {
"type": "object",
"properties": {
"flow": {
"type": "string"
},
"books": {
"type": "array",
"items": {
"type": "object",
"properties": {
"venue": {
"type": "string"
},
"persisted": {
"type": "boolean"
},
"reachUpPct": {
"type": "number"
},
"reachDownPct": {
"type": "number"
}
}
}
},
"volume": {
"type": "array",
"items": {
"type": "string"
}
},
"liquidations": {
"type": "array",
"items": {
"type": "string"
}
},
"takerCoveragePct": {
"type": "number"
}
}
},
"supports": {
"type": "array",
"items": {
"type": "object",
"properties": {
"usd": {
"type": "number"
},
"kinds": {
"type": "array",
"items": {
"type": "string"
}
},
"price": {
"type": "number"
},
"venue": {
"type": "string"
},
"evidence": {
"type": "array",
"items": {
"type": "string"
}
},
"outsized": {
"type": "boolean"
},
"strength": {
"type": "integer",
"maximum": 3,
"minimum": 1
},
"distancePct": {
"type": "number"
}
}
},
"description": "Nearest levels on this side, one entry per price, strongest-first among the nearest"
},
"valueArea": {
"type": "object",
"properties": {
"low": {
"type": "number"
},
"poc": {
"type": "number"
},
"high": {
"type": "number"
}
}
},
"resistances": {
"type": "array",
"items": {
"type": "object",
"properties": {
"usd": {
"type": "number"
},
"kinds": {
"type": "array",
"items": {
"type": "string"
}
},
"price": {
"type": "number"
},
"venue": {
"type": "string"
},
"evidence": {
"type": "array",
"items": {
"type": "string"
}
},
"outsized": {
"type": "boolean"
},
"strength": {
"type": "integer",
"maximum": 3,
"minimum": 1
},
"distancePct": {
"type": "number"
}
}
},
"description": "Nearest levels on this side, one entry per price, strongest-first among the nearest"
},
"spotContext": {
"type": "object",
"properties": {
"inThinZone": {
"type": "boolean"
},
"inValueArea": {
"type": "boolean"
},
"nearestAbove": {
"type": "object",
"description": "Nearest level above spot (same shape as levels[])"
},
"nearestBelow": {
"type": "object",
"description": "Nearest level below spot (same shape as levels[])"
}
}
},
"windowHours": {
"type": "integer"
},
"dailyRangePct": {
"type": "number",
"description": "Average 24h high–low range over the window, percent of price"
},
"sourcesFailed": {
"type": "array",
"items": {
"type": "object",
"properties": {
"error": {
"type": "string"
},
"source": {
"type": "string"
}
}
}
},
"unconfirmedWalls": {
"type": "array",
"items": {
"type": "object"
},
"description": "Walls larger than their venue's own 24h volume: shown, never counted as support or resistance"
}
}
},
"annotations": {
"readOnlyHint": true
}
}Order-book snapshot for one coin's perpetuals: best bid/ask, spread in bps, top-of-book depth (USD) per side, bid/ask depth imbalance, and the cost vs mid of $10k and $100k market orders against the visible levels. Positive imbalance means more bid depth. Single-venue by nature — Hyperliquid, falling back to Bybit for coins it doesn't list; the response names the venue that answered and how far its visible book reaches.
| Parameter | Type | Description |
|---|---|---|
| symbol * | string | Coin symbol, e.g. "BTC". |
{
"name": "flow_orderbook",
"title": "Order Book Snapshot",
"description": "Order-book snapshot for one coin's perpetuals: best bid/ask, spread in bps, top-of-book depth (USD) per side, bid/ask depth imbalance, and the cost vs mid of $10k and $100k market orders against the visible levels. Positive imbalance means more bid depth. Single-venue by nature — Hyperliquid, falling back to Bybit for coins it doesn't list; the response names the venue that answered and how far its visible book reaches.",
"inputSchema": {
"type": "object",
"required": [
"symbol"
],
"properties": {
"symbol": {
"type": "string",
"description": "Coin symbol, e.g. \"BTC\"."
}
}
},
"outputSchema": {
"type": "object",
"required": [
"symbol"
],
"properties": {
"asOfAt": {
"type": "string",
"description": "Order-book timestamp, ISO-8601 UTC"
},
"asOfMs": {
"type": "integer",
"description": "Order-book timestamp, Unix epoch milliseconds"
},
"source": {
"type": "string",
"description": "Venue that served the book"
},
"symbol": {
"type": "string"
},
"fillCosts": {
"type": "array",
"items": {
"type": "object",
"required": [
"sizeUsd"
],
"properties": {
"buyBps": {
"type": "number",
"description": "Average buy fill vs mid in bps; absent when the visible asks can't fill the size"
},
"sellBps": {
"type": "number",
"description": "Average sell fill vs mid in bps (positive = cost); absent when the visible bids can't fill the size"
},
"sizeUsd": {
"type": "number"
}
}
},
"description": "Cost vs mid of a market order of each size against the visible levels"
},
"spreadBps": {
"type": "number",
"description": "Bid/ask spread, basis points of mid"
},
"bestAskUsd": {
"type": "number",
"description": "Best ask price, USD"
},
"bestBidUsd": {
"type": "number",
"description": "Best bid price, USD"
},
"askDepthUsd": {
"type": "number",
"description": "Top-of-book ask depth, USD"
},
"bidDepthUsd": {
"type": "number",
"description": "Top-of-book bid depth, USD"
},
"midPriceUsd": {
"type": "number",
"description": "Mid price, USD"
},
"imbalancePct": {
"type": "number",
"description": "Signed bid-vs-ask depth skew in percentage points (positive = more bids)"
},
"visibleAskReachPct": {
"type": "number",
"description": "Deepest returned ask vs mid, percent; nothing beyond is visible"
},
"visibleBidReachPct": {
"type": "number",
"description": "Deepest returned bid vs mid, percent; nothing beyond is visible"
}
}
},
"annotations": {
"readOnlyHint": true
}
}Aggregate whale context for one coin (cohort-level, no individual wallets): per-exchange reserve changes (1d/7d), top-trader long/short positioning on Binance perps, and large on-chain transfers to/from exchange wallets above a USD threshold. The transfer feed covers ERC-20 tokens; for native assets (BTC, ETH) it substitutes market-wide USDT exchange flows as a dry-powder signal. Exchange withdrawals suggest accumulation; deposits suggest potential sell pressure. For specific whale wallets and their live positions use flow_whale_positions.
| Parameter | Type | Description |
|---|---|---|
| symbol * | string | Coin symbol, e.g. "BTC" or "ETH". |
| min_usd | number | Minimum transfer size in USD to count as a whale transfer. Defaults to 1000000. |
{
"name": "flow_whale_context",
"title": "Whale Flow Context",
"description": "Aggregate whale context for one coin (cohort-level, no individual wallets): per-exchange reserve changes (1d/7d), top-trader long/short positioning on Binance perps, and large on-chain transfers to/from exchange wallets above a USD threshold. The transfer feed covers ERC-20 tokens; for native assets (BTC, ETH) it substitutes market-wide USDT exchange flows as a dry-powder signal. Exchange withdrawals suggest accumulation; deposits suggest potential sell pressure. For specific whale wallets and their live positions use flow_whale_positions.",
"inputSchema": {
"type": "object",
"required": [
"symbol"
],
"properties": {
"symbol": {
"type": "string",
"description": "Coin symbol, e.g. \"BTC\" or \"ETH\"."
},
"min_usd": {
"type": "number",
"description": "Minimum transfer size in USD to count as a whale transfer. Defaults to 1000000."
}
}
},
"outputSchema": {
"type": "object",
"required": [
"symbol",
"source",
"reserves",
"topTraders",
"transfers"
],
"properties": {
"source": {
"type": "string",
"description": "Provider that served the snapshot"
},
"symbol": {
"type": "string"
},
"reserves": {
"type": "object",
"required": [
"venues"
],
"properties": {
"venues": {
"type": "array",
"items": {
"type": "object",
"required": [
"exchange",
"balanceCoins",
"change1dCoins",
"change1dPct",
"change7dCoins",
"change7dPct"
],
"properties": {
"exchange": {
"type": "string"
},
"change1dPct": {
"type": "number",
"description": "1d change, percent (vendor-side)"
},
"change7dPct": {
"type": "number",
"description": "7d change, percent (vendor-side)"
},
"balanceCoins": {
"type": "number",
"description": "Reserve balance, coins"
},
"change1dCoins": {
"type": "number",
"description": "1d change, coins"
},
"change7dCoins": {
"type": "number",
"description": "7d change, coins"
}
}
}
},
"net1dCoins": {
"type": "number",
"description": "1d reserve change summed across venues, coins; absent when there are no venues"
},
"net7dCoins": {
"type": "number",
"description": "7d reserve change summed across venues, coins; absent when there are no venues"
}
},
"description": "Exchange reserve balances, in coin units (not USD); venues largest first, empty when the feed has none"
},
"transfers": {
"type": "object",
"required": [
"minUsd",
"depositCount",
"depositUsd",
"withdrawalCount",
"withdrawalUsd",
"largest"
],
"properties": {
"minUsd": {
"type": "number",
"description": "Minimum transfer size counted, USD"
},
"largest": {
"type": "array",
"items": {
"type": "object",
"required": [
"timeMs",
"asset",
"amountUsd",
"exchange",
"direction"
],
"properties": {
"asset": {
"type": "string"
},
"timeMs": {
"type": "integer",
"description": "Transfer time, Unix epoch milliseconds"
},
"exchange": {
"type": "string"
},
"amountUsd": {
"type": "number",
"description": "Transfer size, USD"
},
"direction": {
"enum": [
"deposit",
"withdrawal"
],
"type": "string"
}
}
},
"description": "Up to 50 transfers, largest first; empty when none are tracked"
},
"depositUsd": {
"type": "number",
"description": "Total deposited, USD"
},
"proxyAsset": {
"type": "string",
"description": "Set when the feed has no native series and the transfers are another asset's market-wide flows (USDT), a dry-powder proxy; absent for native transfers"
},
"depositCount": {
"type": "integer"
},
"withdrawalUsd": {
"type": "number",
"description": "Total withdrawn, USD"
},
"withdrawalCount": {
"type": "integer"
}
},
"description": "Large on-chain transfers to or from exchange wallets, from the exchange's perspective: a deposit is potential sell pressure, a withdrawal accumulation"
},
"topTraders": {
"type": "array",
"items": {
"type": "object",
"required": [
"timeMs",
"longPct",
"shortPct",
"longShortRatio"
],
"properties": {
"timeMs": {
"type": "integer",
"description": "Snapshot time, Unix epoch milliseconds"
},
"longPct": {
"type": "number",
"description": "Share of top-trader positions that are long, percent"
},
"shortPct": {
"type": "number",
"description": "Share that are short, percent"
},
"longShortRatio": {
"type": "number",
"description": "Long/short ratio"
}
}
},
"description": "Binance perp top-trader long/short split in 4h snapshots, oldest first; empty when the feed is down"
}
}
},
"annotations": {
"readOnlyHint": true
}
}Live whale positions on Hyperliquid perps. By default discovers the largest currently-active whale accounts from the venue leaderboard and returns each one's equity and open positions with side, notional (USD), entry price, liquidation price, leverage and unrealized PnL. Optionally pass 'addresses' (comma-separated 0x wallets, max 10) to follow specific wallets instead. For aggregate cohort signals use flow_whale_context.
| Parameter | Type | Description |
|---|---|---|
| addresses | string | Optional comma-separated 0x wallet addresses to inspect (max 10). Omit to auto-discover the biggest live whales. |
{
"name": "flow_whale_positions",
"title": "Whale Positions",
"description": "Live whale positions on Hyperliquid perps. By default discovers the largest currently-active whale accounts from the venue leaderboard and returns each one's equity and open positions with side, notional (USD), entry price, liquidation price, leverage and unrealized PnL. Optionally pass 'addresses' (comma-separated 0x wallets, max 10) to follow specific wallets instead. For aggregate cohort signals use flow_whale_context.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"addresses": {
"type": "string",
"description": "Optional comma-separated 0x wallet addresses to inspect (max 10). Omit to auto-discover the biggest live whales."
}
}
},
"outputSchema": {
"type": "object",
"properties": {
"accounts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"address": {
"type": "string"
},
"positions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"coin": {
"type": "string"
},
"side": {
"type": "string",
"description": "long or short"
},
"isLong": {
"type": "boolean"
},
"leverage": {
"type": "number",
"description": "Position leverage as a multiple"
},
"notionalUsd": {
"type": "number",
"description": "Position notional, USD"
},
"entryPriceUsd": {
"type": "number",
"description": "Entry price, USD"
},
"unrealizedPnlUsd": {
"type": "number",
"description": "Unrealized PnL, USD"
},
"liquidationPriceUsd": {
"type": "number",
"description": "Liquidation price, USD; omitted when not liquidatable at current margin"
}
}
}
},
"accountValueUsd": {
"type": "number",
"description": "Wallet equity, USD"
}
}
}
}
}
},
"annotations": {
"readOnlyHint": true
}
}Current perpetual funding rate for one coin (hourly rate plus an annualized estimate), merged across providers, with its 24h and 7d trajectory AND the underlying 8h-bucket series. Positive means longs pay shorts. The trajectory is the point: the same +6% annualized reads as post-flush relief if it fell from +40% and as shorts capitulating if it rose from -20%. The series carries the shape a trailing delta flattens away — a steady drift and a spike that retraced give the same 24h change off opposite tapes — plus the window's own low/high, so the current rate can be judged against where it has actually been rather than an absolute threshold. A 1y line ranks the current rate against a year of daily closes (percentile, low/median/high with dates), so 'high' means high for this coin, not just for the week. Set 'points' to trim the series (omit for the full ~10-day window; 0 to suppress it).
| Parameter | Type | Description |
|---|---|---|
| points | integer | How many of the newest 8h buckets to emit. Omit for the full window (30 points ~ 10 days); 0 suppresses the series and returns the summary only. |
| symbol * | string | Coin symbol, e.g. "BTC". |
{
"name": "funding_current",
"title": "Current Funding Rates",
"description": "Current perpetual funding rate for one coin (hourly rate plus an annualized estimate), merged across providers, with its 24h and 7d trajectory AND the underlying 8h-bucket series. Positive means longs pay shorts. The trajectory is the point: the same +6% annualized reads as post-flush relief if it fell from +40% and as shorts capitulating if it rose from -20%. The series carries the shape a trailing delta flattens away — a steady drift and a spike that retraced give the same 24h change off opposite tapes — plus the window's own low/high, so the current rate can be judged against where it has actually been rather than an absolute threshold. A 1y line ranks the current rate against a year of daily closes (percentile, low/median/high with dates), so 'high' means high for this coin, not just for the week. Set 'points' to trim the series (omit for the full ~10-day window; 0 to suppress it).",
"inputSchema": {
"type": "object",
"required": [
"symbol"
],
"properties": {
"points": {
"type": "integer",
"description": "How many of the newest 8h buckets to emit. Omit for the full window (30 points ~ 10 days); 0 suppresses the series and returns the summary only."
},
"symbol": {
"type": "string",
"description": "Coin symbol, e.g. \"BTC\"."
}
}
},
"outputSchema": {
"type": "object",
"required": [
"found",
"symbol"
],
"properties": {
"basis": {
"type": "string",
"description": "Which leg the headline is: OI-weighted across venues, one venue's settled rate, or the cross-venue median"
},
"found": {
"type": "boolean",
"description": "False when no provider lists the symbol; only symbol is then present"
},
"series": {
"type": "object",
"required": [
"source",
"points"
],
"properties": {
"points": {
"type": "array",
"items": {
"type": "object",
"required": [
"timeMs",
"annualizedPct",
"forming"
],
"properties": {
"timeMs": {
"type": "integer",
"description": "Bucket open time, Unix epoch milliseconds"
},
"forming": {
"type": "boolean",
"description": "Bucket still open: a running estimate the feed rewrites until it closes"
},
"annualizedPct": {
"type": "number",
"description": "Annualized rate, percent"
}
}
},
"description": "Oldest first"
},
"source": {
"type": "string"
},
"intervalHours": {
"type": "number",
"description": "Bucket size, hours"
}
},
"description": "The funding series; absent when points=0 or the history feed is down"
},
"symbol": {
"type": "string"
},
"baseline1y": {
"type": "object",
"required": [
"available"
],
"properties": {
"low": {
"type": "number",
"description": "Year's lowest daily close, annualized percent"
},
"days": {
"type": "integer",
"description": "Settled days ranked against"
},
"high": {
"type": "number",
"description": "Year's highest daily close, annualized percent"
},
"note": {
"type": "string",
"description": "Why the baseline is missing"
},
"lowMs": {
"type": "integer",
"description": "Day of the low, Unix epoch milliseconds"
},
"highMs": {
"type": "integer",
"description": "Day of the high, Unix epoch milliseconds"
},
"median": {
"type": "number",
"description": "Year's median daily close, annualized percent"
},
"available": {
"type": "boolean",
"description": "False when there is nothing to rank against; note says why"
},
"percentile": {
"type": "number",
"description": "Rank among the year's settled daily closes, 0-100"
},
"atOrAboveMs": {
"type": "integer",
"description": "Newest day at or above the current rate, Unix epoch milliseconds; absent when it tops the year"
}
},
"description": "The headline rate ranked against a year of daily closes of the OI-weighted rate; low, median and high are annualized percent"
},
"trajectory": {
"type": "array",
"items": {
"type": "object",
"required": [
"window",
"priorAnnualizedPct",
"nowAnnualizedPct",
"changePp"
],
"properties": {
"window": {
"type": "string",
"description": "24h or 7d"
},
"changePp": {
"type": "number",
"description": "Change in annualized percentage points"
},
"nowAnnualizedPct": {
"type": "number",
"description": "Annualized rate at the newest point, percent"
},
"priorAnnualizedPct": {
"type": "number",
"description": "Annualized rate at the start of the window, percent"
}
}
},
"description": "The rate now against 24h and 7d ago, from the 8h series; empty when the history feed is down or too short"
},
"annualizedPct": {
"type": "number",
"description": "Headline rate annualized, percent"
},
"ratePctPerHour": {
"type": "number",
"description": "Headline funding rate, percent per hour (0.001 = 0.001%/h); positive means longs pay shorts"
}
}
},
"annotations": {
"readOnlyHint": true
}
}OHLC(V) candle history for a coin by symbol (e.g. 'ETH', 'BTC'). 'interval' picks the candle size (1m|5m|15m|30m|1h|4h|12h|1d|1w, default 1d); 'limit' the number of candles (default 100, max 400); 'market' picks the series — 'spot' (Binance, Bybit, then CoinGecko/CoinMarketCap), 'perp' (Hyperliquid, Bybit, then Binance futures — perpetual marks), or 'auto' (default: spot preferred; perp when spot fails, or when spot's history is shorter than the request and than 210 candles while perp's is materially longer — e.g. a coin whose spot pair listed recently). spot/perp are hard constraints and error rather than substitute. The response labels the market, interval and source actually delivered, includes USD volume when the source carries it, and flags a still-forming last candle.
| Parameter | Type | Description |
|---|---|---|
| days | integer | DEPRECATED: trailing window in days; use interval+limit instead. Ignored when interval is given. |
| limit | integer | Number of candles, newest last. Default 100, max 400. |
| market | string | Which market's series: spot exchange trades, perpetual-futures marks, or auto (spot preferred; perp when spot fails or its history is too short). Default auto. |
| symbol * | string | Coin symbol, e.g. 'ETH' or 'BTC' |
| interval | string | Candle size. Default 1d. |
{
"name": "market_candles",
"title": "Price Candles",
"description": "OHLC(V) candle history for a coin by symbol (e.g. 'ETH', 'BTC'). 'interval' picks the candle size (1m|5m|15m|30m|1h|4h|12h|1d|1w, default 1d); 'limit' the number of candles (default 100, max 400); 'market' picks the series — 'spot' (Binance, Bybit, then CoinGecko/CoinMarketCap), 'perp' (Hyperliquid, Bybit, then Binance futures — perpetual marks), or 'auto' (default: spot preferred; perp when spot fails, or when spot's history is shorter than the request and than 210 candles while perp's is materially longer — e.g. a coin whose spot pair listed recently). spot/perp are hard constraints and error rather than substitute. The response labels the market, interval and source actually delivered, includes USD volume when the source carries it, and flags a still-forming last candle.",
"inputSchema": {
"type": "object",
"required": [
"symbol"
],
"properties": {
"days": {
"type": "integer",
"description": "DEPRECATED: trailing window in days; use interval+limit instead. Ignored when interval is given."
},
"limit": {
"type": "integer",
"description": "Number of candles, newest last. Default 100, max 400."
},
"market": {
"enum": [
"spot",
"perp",
"auto"
],
"type": "string",
"description": "Which market's series: spot exchange trades, perpetual-futures marks, or auto (spot preferred; perp when spot fails or its history is too short). Default auto."
},
"symbol": {
"type": "string",
"description": "Coin symbol, e.g. 'ETH' or 'BTC'"
},
"interval": {
"enum": [
"1m",
"5m",
"15m",
"30m",
"1h",
"4h",
"12h",
"1d",
"1w"
],
"type": "string",
"description": "Candle size. Default 1d."
}
}
},
"outputSchema": {
"type": "object",
"properties": {
"coinId": {
"type": "string",
"description": "Identifier the answering provider queried"
},
"market": {
"type": "string",
"description": "'spot' or 'perp' — which market the series describes"
},
"source": {
"type": "string",
"description": "Provider that answered"
},
"symbol": {
"type": "string",
"description": "The coin symbol that was requested, upper-cased"
},
"candles": {
"type": "array",
"items": {
"type": "object",
"properties": {
"asOfAt": {
"type": "string",
"description": "Candle open time, ISO-8601 UTC"
},
"lowUsd": {
"type": "number",
"description": "Low price, USD"
},
"highUsd": {
"type": "number",
"description": "High price, USD"
},
"openUsd": {
"type": "number",
"description": "Open price, USD"
},
"closeUsd": {
"type": "number",
"description": "Close price, USD"
},
"volumeUsd": {
"type": "number",
"description": "Traded volume, USD notional; omitted when the source has none"
},
"timestampMs": {
"type": "integer",
"description": "Candle open time, Unix epoch milliseconds"
}
}
}
},
"interval": {
"type": "string",
"description": "Candle size actually delivered, e.g. '4h'"
},
"lastCandleIsPartial": {
"type": "boolean",
"description": "True when the newest candle is still forming; exclude it from indicator math"
}
}
},
"annotations": {
"readOnlyHint": true
}
}Fetches price, market cap, ATH/ATL and description for a coin by its CoinGecko coin ID (e.g. 'bitcoin', 'ethereum') or by ticker symbol (e.g. 'BTC', 'WAVES'). IDs are case-sensitive; a symbol, or an ID in the wrong case, is resolved by search and the response names the ID actually fetched, so a resolution is never silent.
| Parameter | Type | Description |
|---|---|---|
| coin_id * | string | CoinGecko coin ID (e.g. 'bitcoin') or ticker symbol (e.g. 'BTC'). IDs are case-sensitive; symbols are resolved by search. |
{
"name": "market_coin_details",
"title": "Coin Details",
"description": "Fetches price, market cap, ATH/ATL and description for a coin by its CoinGecko coin ID (e.g. 'bitcoin', 'ethereum') or by ticker symbol (e.g. 'BTC', 'WAVES'). IDs are case-sensitive; a symbol, or an ID in the wrong case, is resolved by search and the response names the ID actually fetched, so a resolution is never silent.",
"inputSchema": {
"type": "object",
"required": [
"coin_id"
],
"properties": {
"coin_id": {
"type": "string",
"description": "CoinGecko coin ID (e.g. 'bitcoin') or ticker symbol (e.g. 'BTC'). IDs are case-sensitive; symbols are resolved by search."
}
}
},
"outputSchema": {
"type": "object",
"required": [
"id",
"symbol",
"name",
"description",
"homepage",
"priceUsd",
"marketCapUsd",
"change24hPct",
"athUsd",
"atlUsd"
],
"properties": {
"id": {
"type": "string",
"description": "CoinGecko id actually fetched (differs from the request when a symbol or miscased id was resolved)"
},
"name": {
"type": "string"
},
"athUsd": {
"type": "number",
"description": "All-time high, USD"
},
"atlUsd": {
"type": "number",
"description": "All-time low, USD"
},
"symbol": {
"type": "string"
},
"homepage": {
"type": "string"
},
"priceUsd": {
"type": "number",
"description": "Current price, USD"
},
"description": {
"type": "string",
"description": "Description, truncated to 400 characters"
},
"change24hPct": {
"type": "number",
"description": "24h price change, percent"
},
"marketCapUsd": {
"type": "number",
"description": "Market cap, USD"
}
}
},
"annotations": {
"readOnlyHint": true
}
}Lists the coin symbols available from the market-data provider
No parameters.
{
"name": "market_coins",
"title": "Supported Coins",
"description": "Lists the coin symbols available from the market-data provider",
"inputSchema": {
"type": "object",
"properties": {}
},
"outputSchema": {
"type": "object",
"required": [
"coins"
],
"properties": {
"coins": {
"type": "array",
"items": {
"type": "string"
},
"description": "Coin symbols the market-data provider covers"
}
}
},
"annotations": {
"readOnlyHint": true
}
}Bulk history for one coin, one metric per call, in pages: 'price' (OHLCV candles, spot or perp), 'open_interest' (market-wide aggregate USD), 'funding' (OI-weighted rate, %/8h and annualized) or 'liquidations' (market-wide long/short USD per bucket). Returns up to 'limit' rows (default 200, max 1000) at or before 'end' (default now), oldest first, as compact columns + rows; pass the returned nextEndMs as 'end' to fetch the page before it, and 'start' to stop there. Reach: price is full venue history (Binance spot from 2017, futures from 2019) at 1m–1w; derivatives come from CoinGlass at 4h (about 180 days back), 6h/8h/12h (about 360 days) or 1d/1w (back to 2020) — use 1d for anything older than six months. The newest row may still be forming (newestForming). Use this to pull history; for a read of what is happening now, use the derivatives_* and research_* tools.
| Parameter | Type | Description |
|---|---|---|
| end | string | Latest time to include: ISO-8601 or Unix ms. Default now. Pass nextEndMs here to page back. |
| limit | integer | Rows per page, 1–1000. Default 200. |
| start | string | Earliest time to include: ISO-8601 (UTC if no offset) or Unix ms. Paging stops here. |
| market | string | Price only: spot (default) or perpetual candles. |
| metric * | string | one of ["price","open_interest","funding","liquidations"] |
| symbol * | string | Coin symbol, e.g. "BTC". |
| interval | string |
Global market snapshot: total market cap, BTC/ETH dominance, Fear & Greed index, and Altcoin Season index
No parameters.
{
"name": "market_overview",
"title": "Market Overview",
"description": "Global market snapshot: total market cap, BTC/ETH dominance, Fear & Greed index, and Altcoin Season index",
"inputSchema": {
"type": "object",
"properties": {}
},
"outputSchema": {
"type": "object",
"examples": [
{
"fearGreedLabel": "Greed",
"fearGreedValue": 55,
"btcDominancePct": 58.2,
"ethDominancePct": 12.4,
"totalMarketCapUsd": 2500000000000,
"totalVolume24hUsd": 85000000000,
"altcoinSeasonIndex": 35
}
],
"properties": {
"fearGreedLabel": {
"type": "string"
},
"fearGreedValue": {
"type": "integer",
"description": "Fear & Greed index, 0-100"
},
"btcDominancePct": {
"type": "number",
"description": "BTC dominance in percentage points"
},
"ethDominancePct": {
"type": "number",
"description": "ETH dominance in percentage points"
},
"totalMarketCapUsd": {
"type": "number",
"description": "Total crypto market cap, USD"
},
"totalVolume24hUsd": {
"type": "number",
"description": "Total 24h volume, USD"
},
"altcoinSeasonIndex": {
"type": "integer",
"description": "Altcoin Season index, 0-100"
}
}
},
"annotations": {
"readOnlyHint": true
}
}Per-coin market snapshot (spot price, perpetual mark price, 24h change, funding rate, open interest, long/short ratio, 24h liquidations), merged across providers. Spot and perp prices are separate fields (spot from spot-market providers, perp mark from the perp venue); they differ by the basis. Pass 'symbols' to filter to specific coins; omit it for every covered coin.
| Parameter | Type | Description |
|---|---|---|
| symbols | array | Coin symbols to include, e.g. ["BTC","ETH"]. Omit for all covered coins. |
{
"name": "market_quotes",
"title": "Market Quotes",
"description": "Per-coin market snapshot (spot price, perpetual mark price, 24h change, funding rate, open interest, long/short ratio, 24h liquidations), merged across providers. Spot and perp prices are separate fields (spot from spot-market providers, perp mark from the perp venue); they differ by the basis. Pass 'symbols' to filter to specific coins; omit it for every covered coin.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"symbols": {
"type": "array",
"items": {
"type": "string"
},
"description": "Coin symbols to include, e.g. [\"BTC\",\"ETH\"]. Omit for all covered coins."
}
}
},
"outputSchema": {
"type": "object",
"properties": {
"quotes": {
"type": "array",
"items": {
"type": "object",
"required": [
"symbol"
],
"properties": {
"symbol": {
"type": "string"
},
"priceUsd": {
"type": "number",
"description": "Canonical price, USD: spot when available, else perp mark"
},
"marketCapUsd": {
"type": "number",
"description": "Market cap, USD"
},
"perpPriceUsd": {
"type": "number",
"description": "Perpetual mark price, USD; 0 when no perp venue covers the coin"
},
"spotPriceUsd": {
"type": "number",
"description": "Spot/index price, USD; 0 when no spot source covers the coin"
},
"fundingRatePct": {
"type": "number",
"description": "Perp funding rate in percent (0.01 = 0.01%)"
},
"openInterestUsd": {
"type": "number",
"description": "Open interest, USD"
},
"liquidation24hUsd": {
"type": "number",
"description": "24h liquidations, USD"
},
"longShortRatio24h": {
"type": "number",
"description": "Long/short account ratio over 24h"
},
"priceChangePct24h": {
"type": "number",
"description": "24h price change in percentage points (5.2 = +5.2%)"
}
}
}
}
}
},
"annotations": {
"readOnlyHint": true
}
}Ranked 24h gainers, losers, and trend candidates (>+5% move)
No parameters.
{
"name": "market_top_movers",
"title": "Top Movers",
"description": "Ranked 24h gainers, losers, and trend candidates (>+5% move)",
"inputSchema": {
"type": "object",
"properties": {}
},
"outputSchema": {
"type": "object",
"$defs": {
"mover": {
"type": "object",
"required": [
"symbol",
"name",
"marketCapRank",
"priceUsd",
"change24hPct",
"marketCapUsd"
],
"properties": {
"name": {
"type": "string"
},
"symbol": {
"type": "string"
},
"priceUsd": {
"type": "number",
"description": "Price, USD"
},
"change24hPct": {
"type": "number",
"description": "24h price change, percent"
},
"marketCapUsd": {
"type": "number",
"description": "Market cap, USD"
},
"marketCapRank": {
"type": "integer",
"description": "CoinMarketCap rank by market cap"
}
}
}
},
"required": [
"gainers",
"losers",
"trendCandidates"
],
"properties": {
"losers": {
"type": "array",
"items": {
"$ref": "#/$defs/mover"
},
"description": "Top 24h losers, worst first"
},
"gainers": {
"type": "array",
"items": {
"$ref": "#/$defs/mover"
},
"description": "Top 24h gainers, best first"
},
"trendCandidates": {
"type": "array",
"items": {
"type": "string"
},
"description": "Symbols of gainers up more than 5% over 24h"
}
}
},
"annotations": {
"readOnlyHint": true
}
}Lists the currently trending cryptocurrencies
No parameters.
{
"name": "market_trending",
"title": "Trending Coins",
"description": "Lists the currently trending cryptocurrencies",
"inputSchema": {
"type": "object",
"properties": {}
},
"outputSchema": {
"type": "object",
"required": [
"coins"
],
"properties": {
"coins": {
"type": "array",
"items": {
"type": "object",
"required": [
"symbol",
"name"
],
"properties": {
"name": {
"type": "string"
},
"symbol": {
"type": "string"
},
"marketCapRank": {
"type": "integer",
"description": "Rank by market cap; absent when unranked"
}
}
},
"description": "Currently trending coins; empty when none"
}
}
},
"annotations": {
"readOnlyHint": true
}
}Searches for recent news on a topic — articles, market-moving posts and exchange notices, newest first. Exchange notices (kind 'exchange', title prefixed [Exchange kind]) come from Binance, Bybit, OKX and Upbit's own listing and delisting feeds; for the full schedule with exact times use catalysts_exchange_listings. Each item is tagged with its kind and, where measured, the price move that followed the headline.
| Parameter | Type | Description |
|---|---|---|
| query * | string |
{
"name": "news_search",
"title": "Crypto News Search",
"description": "Searches for recent news on a topic — articles, market-moving posts and exchange notices, newest first. Exchange notices (kind 'exchange', title prefixed [Exchange kind]) come from Binance, Bybit, OKX and Upbit's own listing and delisting feeds; for the full schedule with exact times use catalysts_exchange_listings. Each item is tagged with its kind and, where measured, the price move that followed the headline.",
"inputSchema": {
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "string"
}
}
},
"outputSchema": {
"type": "object",
"required": [
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"title",
"url",
"snippet",
"source",
"kind",
"coins"
],
"properties": {
"url": {
"type": "string"
},
"date": {
"type": "string",
"description": "Publication time as the feed states it, ISO 8601; absent when undated"
},
"kind": {
"type": "string",
"description": "article, tweet or exchange"
},
"coins": {
"type": "array",
"items": {
"type": "string"
},
"description": "Coin tickers the item names; may be empty"
},
"title": {
"type": "string"
},
"impact": {
"type": "object",
"required": [
"coin",
"pct",
"upPct",
"downPct",
"windowMinutes"
],
"properties": {
"pct": {
"type": "number",
"description": "Net move over the window, percent"
},
"coin": {
"type": "string"
},
"upPct": {
"type": "number",
"description": "Highest excursion in the window, percent"
},
"downPct": {
"type": "number",
"description": "Lowest excursion in the window, percent"
},
"windowMinutes": {
"type": "integer",
"description": "Measurement window, minutes"
}
},
"description": "Measured price move after the headline; absent when not measured"
},
"source": {
"type": "string",
"description": "Feed that produced the item"
},
"timeMs": {
"type": "integer",
"description": "date as epoch ms; absent when undated or unparseable"
},
"snippet": {
"type": "string"
}
}
},
"description": "Newest first; empty when nothing matched"
}
}
},
"annotations": {
"readOnlyHint": true
}
}On-chain TVL and network fees/revenue (24h/7d/30d) for one chain. Use a chain's own token symbol (e.g. 'ETH', 'SOL', 'BNB') — returns a plain 'not a tracked chain' message for tokens that aren't L1/L2s. Does not cover gas price (gwei).
| Parameter | Type | Description |
|---|---|---|
| symbol * | string | Chain token symbol, e.g. 'ETH' or 'SOL' |
{
"name": "onchain_metrics",
"title": "On-Chain Metrics",
"description": "On-chain TVL and network fees/revenue (24h/7d/30d) for one chain. Use a chain's own token symbol (e.g. 'ETH', 'SOL', 'BNB') — returns a plain 'not a tracked chain' message for tokens that aren't L1/L2s. Does not cover gas price (gwei).",
"inputSchema": {
"type": "object",
"required": [
"symbol"
],
"properties": {
"symbol": {
"type": "string",
"description": "Chain token symbol, e.g. 'ETH' or 'SOL'"
}
}
},
"outputSchema": {
"type": "object",
"required": [
"tracked"
],
"properties": {
"chain": {
"type": "string",
"description": "DeFiLlama chain name"
},
"tvlUsd": {
"type": "number",
"description": "Total value locked, USD"
},
"tracked": {
"type": "boolean",
"description": "False when the symbol is not a chain DeFiLlama tracks (most tokens are not); the fields below are then absent"
},
"fees7dUsd": {
"type": "number",
"description": "Network fees, last 7 days, USD"
},
"fees24hUsd": {
"type": "number",
"description": "Network fees, last 24h, USD"
},
"fees30dUsd": {
"type": "number",
"description": "Network fees, last 30 days, USD"
},
"fees24hChangePct": {
"type": "number",
"description": "24h fees change vs the prior day, percent"
}
}
},
"annotations": {
"readOnlyHint": true
}
}Crypto options chain (Deribit) for one underlying and expiry: calls/puts by strike with bid/ask/mark (native and USD), mark IV, calculated Black-76 delta, open interest (coins and USD notional) and 24h volume. Lists every available expiry. Underlyings: BTC and ETH (deep; inverse and USDC-linear books), SOL, XRP, HYPE, AVAX, TRX (USDC-linear, thin). Defaults: next expiry, strikes within ±10% of spot, both types.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max contracts returned, default 40, max 200. |
| expiry | string | "next" (default), a date like "2026-12-25", or an exchange code like "25DEC26". |
| currency * | string | Underlying symbol, e.g. "BTC", "ETH", "SOL". |
| strike_max | number | Highest strike (USD). |
| strike_min | number | Lowest strike (USD). |
| option_type | string | Default both. |
| moneyness_pct | number | When no strike bounds are given: keep strikes within ± this % of spot. Default 10. |
{
"name": "options_chain",
"title": "Options Chain",
"description": "Crypto options chain (Deribit) for one underlying and expiry: calls/puts by strike with bid/ask/mark (native and USD), mark IV, calculated Black-76 delta, open interest (coins and USD notional) and 24h volume. Lists every available expiry. Underlyings: BTC and ETH (deep; inverse and USDC-linear books), SOL, XRP, HYPE, AVAX, TRX (USDC-linear, thin). Defaults: next expiry, strikes within ±10% of spot, both types.",
"inputSchema": {
"type": "object",
"required": [
"currency"
],
"properties": {
"limit": {
"type": "integer",
"description": "Max contracts returned, default 40, max 200."
},
"expiry": {
"type": "string",
"description": "\"next\" (default), a date like \"2026-12-25\", or an exchange code like \"25DEC26\"."
},
"currency": {
"type": "string",
"description": "Underlying symbol, e.g. \"BTC\", \"ETH\", \"SOL\"."
},
"strike_max": {
"type": "number",
"description": "Highest strike (USD)."
},
"strike_min": {
"type": "number",
"description": "Lowest strike (USD)."
},
"option_type": {
"enum": [
"call",
"put",
"both"
],
"type": "string",
"description": "Default both."
},
"moneyness_pct": {
"type": "number",
"description": "When no strike bounds are given: keep strikes within ± this % of spot. Default 10."
}
}
},
"outputSchema": {
"type": "object",
"required": [
"meta",
"expiries",
"metricSources",
"units",
"contracts"
],
"properties": {
"meta": {
"type": "object",
"required": [
"provider",
"underlying",
"observedAt",
"ageSeconds"
],
"properties": {
"provider": {
"type": "string",
"description": "Data venue, e.g. Deribit"
},
"ageSeconds": {
"type": "integer",
"description": "Seconds between the observation and this response"
},
"observedAt": {
"type": "string",
"description": "When the venue snapshot was observed, ISO 8601 UTC"
},
"underlying": {
"type": "string",
"description": "Underlying symbol, e.g. BTC"
}
},
"description": "Provenance of the snapshot the numbers come from"
},
"units": {
"type": "object",
"properties": {
"markIv": {
"type": "string"
},
"volume24h": {
"type": "string"
},
"nativePrice": {
"type": "string"
},
"openInterest": {
"type": "string"
}
},
"description": "Units of the contract fields"
},
"expiry": {
"type": "string",
"description": "The expiry shown, ISO 8601 UTC (08:00 UTC settlement); absent when the venue lists no options"
},
"expiries": {
"type": "array",
"items": {
"type": "string"
},
"description": "Every listed future expiry, ISO 8601 UTC, nearest first"
},
"contracts": {
"type": "array",
"items": {
"type": "object",
"required": [
"instrument",
"settlement",
"type",
"strike",
"contractSize",
"openInterest",
"volume24h"
],
"properties": {
"ask": {
"type": "number",
"description": "Best ask, native premium units"
},
"bid": {
"type": "number",
"description": "Best bid, native premium units"
},
"mark": {
"type": "number",
"description": "Venue mark price, native premium units"
},
"type": {
"enum": [
"call",
"put"
],
"type": "string"
},
"askUsd": {
"type": "number",
"description": "Best ask, USD (calculated)"
},
"bidUsd": {
"type": "number",
"description": "Best bid, USD (calculated)"
},
"markIv": {
"type": "number",
"description": "Mark implied volatility, percent annualized"
},
"strike": {
"type": "number",
"description": "Strike, USD"
},
"markUsd": {
"type": "number",
"description": "Mark price, USD (calculated)"
},
"volume24h": {
"type": "number",
"description": "24h volume, underlying coins"
},
"instrument": {
"type": "string",
"description": "Venue instrument name"
},
"settlement": {
"enum": [
"inverse",
"linear"
],
"type": "string",
"description": "inverse = premium in the coin, linear = in USDC"
},
"contractSize": {
"type": "number",
"description": "Underlying coins per contract"
},
"openInterest": {
"type": "number",
"description": "Open interest, underlying coins"
},
"volumeUsd24h": {
"type": "number",
"description": "24h volume, USD"
},
"deltaCalculated": {
"type": "number",
"description": "Black-76 delta on the forward, r=0 (calculated)"
},
"openInterestUsd": {
"type": "number",
"description": "Open interest notional, USD (calculated at the spot index)"
}
}
},
"description": "Contracts of that expiry inside the strike range and type filter, by strike; the strikes nearest spot when truncated to the limit"
},
"forwardUsd": {
"type": "number",
"description": "Forward (underlying) price the venue priced that expiry off, USD"
},
"daysToExpiry": {
"type": "number",
"description": "Days from now to that expiry"
},
"indexPriceUsd": {
"type": "number",
"description": "Spot index of the underlying, USD"
},
"metricSources": {
"type": "object",
"required": [
"reported",
"calculated"
],
"properties": {
"reported": {
"type": "array",
"items": {
"type": "string"
},
"description": "Fields taken as reported by the venue"
},
"calculated": {
"type": "array",
"items": {
"type": "string"
},
"description": "Fields calculated here from reported data"
}
},
"description": "Which fields the venue reports and which this server calculates"
}
}
},
"annotations": {
"readOnlyHint": true
}
}Crypto options gamma exposure (Deribit, modeled): gross and dealer-signed GEX in USD per 1% move, by strike and expiry, gamma walls, modeled gamma flip levels, options-derived price levels (call/put OI walls, gamma concentrations, max pain, high-sensitivity zones) and a rule-based options regime (positive/negative modeled gamma, near flip, expiry concentration, elevated/compressed vol), with perp funding/OI/liquidations/order book as a separate evidence block. What-ifs: hedging=true adds theoretical dealer hedge ladders (spot ±0.5–5%, charm 1–24h and through the next expiry, vanna ±1/2/5 vol points); target_price / horizon_hours / iv_change reprice the same frozen contracts (GEX, dealer delta, hedge, flips and walls before vs after). Signed numbers depend on an explicit dealer-positioning scenario; modeled, not observed orders.
| Parameter | Type | Description |
|---|---|---|
| expiry | string | What-if/hedging scope: only this expiry ("next", "2026-11-27" or "27NOV26"). Default all. |
| hedging | boolean | Add theoretical dealer hedge ladders (price, charm, vanna). Implied by any what-if parameter. |
| currency * | string | Underlying symbol, e.g. "BTC". |
| scenario | string | Assumed dealer positioning (public OI can't show it). Default calls_long_puts_short: dealers long calls, short puts. |
| iv_change | number | What-if: absolute IV shift in vol points (e.g. -2). |
| target_price | number | What-if: underlying price to reprice at. |
| horizon_hours | number |
Crypto options positioning (Deribit) for one underlying: total call/put open interest in coins and USD notional, put/call OI and volume ratios, largest strike concentrations, upcoming expirations with expiring notional and theoretical max pain, OI change over 24h/7d (from hourly snapshots), and recent trade flow (aggressor premium by calls/puts, block share, largest trades). Descriptive positioning — not a direction signal.
| Parameter | Type | Description |
|---|---|---|
| currency * | string | Underlying symbol, e.g. "BTC". |
| expiries | integer | Upcoming expirations to list, default 6, max 20. |
| trades_hours | number | Trade-flow window in hours, default 4, max 24; 0 skips trades. |
{
"name": "options_positioning",
"title": "Options Positioning",
"description": "Crypto options positioning (Deribit) for one underlying: total call/put open interest in coins and USD notional, put/call OI and volume ratios, largest strike concentrations, upcoming expirations with expiring notional and theoretical max pain, OI change over 24h/7d (from hourly snapshots), and recent trade flow (aggressor premium by calls/puts, block share, largest trades). Descriptive positioning — not a direction signal.",
"inputSchema": {
"type": "object",
"required": [
"currency"
],
"properties": {
"currency": {
"type": "string",
"description": "Underlying symbol, e.g. \"BTC\"."
},
"expiries": {
"type": "integer",
"description": "Upcoming expirations to list, default 6, max 20."
},
"trades_hours": {
"type": "number",
"description": "Trade-flow window in hours, default 4, max 24; 0 skips trades."
}
}
},
"outputSchema": {
"type": "object",
"required": [
"meta",
"metricSources",
"totals",
"state",
"topStrikes",
"expiries",
"notes",
"caveat"
],
"properties": {
"meta": {
"type": "object",
"required": [
"provider",
"underlying",
"observedAt",
"ageSeconds"
],
"properties": {
"provider": {
"type": "string",
"description": "Data venue, e.g. Deribit"
},
"ageSeconds": {
"type": "integer",
"description": "Seconds between the observation and this response"
},
"observedAt": {
"type": "string",
"description": "When the venue snapshot was observed, ISO 8601 UTC"
},
"underlying": {
"type": "string",
"description": "Underlying symbol, e.g. BTC"
}
},
"description": "Provenance of the snapshot the numbers come from"
},
"notes": {
"type": "array",
"items": {
"type": "string"
},
"description": "Data caveats"
},
"state": {
"type": "string",
"description": "CALL-HEAVY | BALANCED | PUT-HEAVY by put/call OI; descriptive, not a direction signal"
},
"caveat": {
"type": "string",
"description": "What the numbers do not say: positioning and pricing, not direction; max pain is theoretical"
},
"totals": {
"type": "object",
"required": [
"callOi",
"putOi",
"callNotionalUsd",
"putNotionalUsd",
"callVolume24h",
"putVolume24h",
"instruments"
],
"properties": {
"putOi": {
"type": "number",
"description": "Put open interest, underlying coins"
},
"callOi": {
"type": "number",
"description": "Call open interest, underlying coins"
},
"putCallOi": {
"type": "number",
"description": "Put OI ÷ call OI; absent without call OI"
},
"instruments": {
"type": "integer",
"description": "Listed instruments counted"
},
"putVolume24h": {
"type": "number",
"description": "Put 24h volume, underlying coins"
},
"callVolume24h": {
"type": "number",
"description": "Call 24h volume, underlying coins"
},
"putCallVolume": {
"type": "number",
"description": "Put ÷ call 24h volume; absent when no calls traded"
},
"putNotionalUsd": {
"type": "number",
"description": "Put OI notional, USD (calculated at the spot index)"
},
"callNotionalUsd": {
"type": "number",
"description": "Call OI notional, USD (calculated at the spot index)"
}
}
},
"expiries": {
"type": "array",
"items": {
"type": "object",
"required": [
"expiry",
"days",
"totals",
"shareOfOiPct",
"topStrikes"
],
"properties": {
"days": {
"type": "number"
},
"expiry": {
"type": "string",
"description": "ISO 8601 UTC"
},
"totals": {
"type": "object",
"required": [
"callOi",
"putOi",
"callNotionalUsd",
"putNotionalUsd",
"callVolume24h",
"putVolume24h",
"instruments"
],
"properties": {
"putOi": {
"type": "number",
"description": "Put open interest, underlying coins"
},
"callOi": {
"type": "number",
"description": "Call open interest, underlying coins"
},
"putCallOi": {
"type": "number",
"description": "Put OI ÷ call OI; absent without call OI"
},
"instruments": {
"type": "integer",
"description": "Listed instruments counted"
},
"putVolume24h": {
"type": "number",
"description": "Put 24h volume, underlying coins"
},
"callVolume24h": {
"type": "number",
"description": "Call 24h volume, underlying coins"
},
"putCallVolume": {
"type": "number",
"description": "Put ÷ call 24h volume; absent when no calls traded"
},
"putNotionalUsd": {
"type": "number",
"description": "Put OI notional, USD (calculated at the spot index)"
},
"callNotionalUsd": {
"type": "number",
"description": "Call OI notional, USD (calculated at the spot index)"
}
}
},
"topStrikes": {
"type": "array",
"items": {
"type": "object",
"required": [
"strike",
"callOi",
"putOi",
"notionalUsd"
],
"properties": {
"putOi": {
"type": "number",
"description": "Put OI, underlying coins"
},
"callOi": {
"type": "number",
"description": "Call OI, underlying coins"
},
"strike": {
"type": "number",
"description": "Strike, USD"
},
"notionalUsd": {
"type": "number",
"description": "Call + put OI notional, USD"
}
}
}
},
"shareOfOiPct": {
"type": "number",
"description": "This expiry's share of total OI notional, percent"
},
"maxPainTheoretical": {
"type": "object",
"required": [
"strike",
"holderPayoutUsd"
],
"properties": {
"strike": {
"type": "number",
"description": "USD"
},
"holderPayoutUsd": {
"type": "number",
"description": "Total holder payout at that strike, USD"
}
},
"description": "Strike minimising the total holder payout; a theoretical calculation, not a forecast"
}
}
},
"description": "Upcoming expirations, nearest first"
},
"tradeFlow": {
"type": "object",
"required": [
"from",
"to",
"truncated",
"trades",
"callBuyPremiumUsd",
"callSellPremiumUsd",
"putBuyPremiumUsd",
"putSellPremiumUsd",
"notionalUsd",
"blockNotionalUsd",
"largest"
],
"properties": {
"to": {
"type": "string",
"description": "Window end, ISO 8601 UTC"
},
"from": {
"type": "string",
"description": "Window start, ISO 8601 UTC"
},
"trades": {
"type": "integer",
"description": "Trades in the window"
},
"largest": {
"type": "array",
"items": {
"type": "object",
"required": [
"at",
"instrument",
"direction",
"amount",
"notionalUsd",
"premiumUsd",
"block"
],
"properties": {
"at": {
"type": "string",
"description": "ISO 8601 UTC"
},
"iv": {
"type": "number",
"description": "Trade IV, percent"
},
"block": {
"type": "boolean"
},
"amount": {
"type": "number",
"description": "Underlying coins"
},
"direction": {
"type": "string",
"description": "buy | sell, the aggressor"
},
"instrument": {
"type": "string"
},
"premiumUsd": {
"type": "number"
},
"notionalUsd": {
"type": "number"
}
}
},
"description": "Largest trades by notional"
},
"truncated": {
"type": "boolean",
"description": "True when the page cap shortened the window"
},
"notionalUsd": {
"type": "number",
"description": "Notional traded, USD"
},
"blockNotionalUsd": {
"type": "number",
"description": "Notional of block trades, USD"
},
"putBuyPremiumUsd": {
"type": "number"
},
"callBuyPremiumUsd": {
"type": "number"
},
"putSellPremiumUsd": {
"type": "number"
},
"callSellPremiumUsd": {
"type": "number"
}
},
"description": "Aggressor-side flow of recent trades (who crossed the spread, not who opened or closed positions); absent when trades_hours is 0 or the trade fetch failed"
},
"oiChange7d": {
"type": "object",
"required": [
"hours",
"from",
"callOiChange",
"putOiChange",
"notionalChangeUsd",
"scope",
"settledOi",
"newListingOi"
],
"properties": {
"from": {
"type": "string",
"description": "Snapshot time, ISO 8601 UTC"
},
"hours": {
"type": "number",
"description": "Look-back, hours"
},
"scope": {
"type": "string"
},
"settledOi": {
"type": "number",
"description": "Coins in expiries that settled since the snapshot (not counted as closed)"
},
"putOiChange": {
"type": "number",
"description": "Underlying coins"
},
"callOiChange": {
"type": "number",
"description": "Underlying coins"
},
"newListingOi": {
"type": "number",
"description": "Coins in expiries listed since the snapshot"
},
"putOiChangePct": {
"type": "number",
"description": "Percent"
},
"callOiChangePct": {
"type": "number",
"description": "Percent"
},
"notionalChangeUsd": {
"type": "number",
"description": "USD; also moves with price"
}
},
"description": "OI change vs a stored hourly snapshot, over the expiries live at both times; absent before such a snapshot exists"
},
"topStrikes": {
"type": "array",
"items": {
"type": "object",
"required": [
"strike",
"callOi",
"putOi",
"notionalUsd"
],
"properties": {
"putOi": {
"type": "number",
"description": "Put OI, underlying coins"
},
"callOi": {
"type": "number",
"description": "Call OI, underlying coins"
},
"strike": {
"type": "number",
"description": "Strike, USD"
},
"notionalUsd": {
"type": "number",
"description": "Call + put OI notional, USD"
}
}
}
},
"oiChange24h": {
"type": "object",
"required": [
"hours",
"from",
"callOiChange",
"putOiChange",
"notionalChangeUsd",
"scope",
"settledOi",
"newListingOi"
],
"properties": {
"from": {
"type": "string",
"description": "Snapshot time, ISO 8601 UTC"
},
"hours": {
"type": "number",
"description": "Look-back, hours"
},
"scope": {
"type": "string"
},
"settledOi": {
"type": "number",
"description": "Coins in expiries that settled since the snapshot (not counted as closed)"
},
"putOiChange": {
"type": "number",
"description": "Underlying coins"
},
"callOiChange": {
"type": "number",
"description": "Underlying coins"
},
"newListingOi": {
"type": "number",
"description": "Coins in expiries listed since the snapshot"
},
"putOiChangePct": {
"type": "number",
"description": "Percent"
},
"callOiChangePct": {
"type": "number",
"description": "Percent"
},
"notionalChangeUsd": {
"type": "number",
"description": "USD; also moves with price"
}
},
"description": "OI change vs a stored hourly snapshot, over the expiries live at both times; absent before such a snapshot exists"
},
"indexPriceUsd": {
"type": "number",
"description": "Spot index, USD"
},
"metricSources": {
"type": "object",
"required": [
"reported",
"calculated"
],
"properties": {
"reported": {
"type": "array",
"items": {
"type": "string"
},
"description": "Fields taken as reported by the venue"
},
"calculated": {
"type": "array",
"items": {
"type": "string"
},
"description": "Fields calculated here from reported data"
}
},
"description": "Which fields the venue reports and which this server calculates"
},
"tradeFlowError": {
"type": "string",
"description": "Why trade flow is missing when it was requested but the trade fetch failed"
}
}
},
"annotations": {
"readOnlyHint": true
}
}Risk-neutral probabilities implied by crypto options (Deribit) at one expiry: chance of settling above/below a price or inside a range, expected 68%/90% ranges, lognormal at that expiry's ATM IV and forward plus a smile-adjusted value within quoted strikes. Market-implied odds, not calibrated forecasts.
| Parameter | Type | Description |
|---|---|---|
| price | number | Price to get P(above)/P(below) for. |
| expiry | string | "next" (first expiry ≥ 1 day, default), "2026-12-25" or "25DEC26". |
| currency * | string | Underlying symbol, e.g. "BTC". |
| range_low | number | Range lower bound. |
| range_high | number | Range upper bound. |
{
"name": "options_probability",
"title": "Options Expiry Probabilities",
"description": "Risk-neutral probabilities implied by crypto options (Deribit) at one expiry: chance of settling above/below a price or inside a range, expected 68%/90% ranges, lognormal at that expiry's ATM IV and forward plus a smile-adjusted value within quoted strikes. Market-implied odds, not calibrated forecasts.",
"inputSchema": {
"type": "object",
"required": [
"currency"
],
"properties": {
"price": {
"type": "number",
"description": "Price to get P(above)/P(below) for."
},
"expiry": {
"type": "string",
"description": "\"next\" (first expiry ≥ 1 day, default), \"2026-12-25\" or \"25DEC26\"."
},
"currency": {
"type": "string",
"description": "Underlying symbol, e.g. \"BTC\"."
},
"range_low": {
"type": "number",
"description": "Range lower bound."
},
"range_high": {
"type": "number",
"description": "Range upper bound."
}
}
},
"outputSchema": {
"type": "object",
"required": [
"meta",
"model",
"quantiles",
"prices"
],
"properties": {
"days": {
"type": "number",
"description": "Days from the snapshot to that expiry"
},
"meta": {
"type": "object",
"required": [
"provider",
"underlying",
"observedAt",
"ageSeconds"
],
"properties": {
"provider": {
"type": "string",
"description": "Data venue, e.g. Deribit"
},
"ageSeconds": {
"type": "integer",
"description": "Seconds between the observation and this response"
},
"observedAt": {
"type": "string",
"description": "When the venue snapshot was observed, ISO 8601 UTC"
},
"underlying": {
"type": "string",
"description": "Underlying symbol, e.g. BTC"
}
},
"description": "Provenance of the snapshot the numbers come from"
},
"model": {
"type": "string",
"description": "How the odds are computed"
},
"expiry": {
"type": "string",
"description": "The expiry used, ISO 8601 UTC (08:00 UTC settlement); absent when the venue lists no options"
},
"prices": {
"type": "array",
"items": {
"type": "object",
"required": [
"price",
"aboveLognormal",
"belowLognormal"
],
"properties": {
"price": {
"type": "number",
"description": "USD"
},
"aboveLognormal": {
"type": "number",
"description": "P(settle above), 0–1, lognormal at ATM IV"
},
"belowLognormal": {
"type": "number",
"description": "P(settle below), 0–1"
},
"aboveSmileAdjusted": {
"type": "number",
"description": "P(settle above) adjusted for the smile; absent outside the quoted strikes"
}
}
},
"description": "Odds of settling above or below each price: the requested price, or a ladder of ±1σ and ±2σ of that expiry when none was given; empty when a range was requested"
},
"between": {
"type": "object",
"required": [
"low",
"high",
"lognormal"
],
"properties": {
"low": {
"type": "number",
"description": "USD"
},
"high": {
"type": "number",
"description": "USD"
},
"lognormal": {
"type": "number",
"description": "0–1"
},
"smileAdjusted": {
"type": "number",
"description": "0–1; absent outside the quoted strikes"
}
},
"description": "Odds of settling inside the requested range; absent when no range was requested"
},
"atmIvPct": {
"type": "number",
"description": "ATM implied volatility of that expiry, percent annualized (calculated; not DVOL)"
},
"quantiles": {
"type": "array",
"items": {
"type": "object",
"required": [
"cumulative",
"price"
],
"properties": {
"price": {
"type": "number",
"description": "USD"
},
"cumulative": {
"type": "number",
"description": "Cumulative probability, 0–1 (0.16/0.84 bound the 68% range, 0.05/0.95 the 90% range)"
}
}
},
"description": "Risk-neutral lognormal quantiles of the settlement price"
},
"forwardUsd": {
"type": "number",
"description": "Forward price the venue priced that expiry off, USD"
},
"quotedStrikeRange": {
"type": "object",
"properties": {
"low": {
"type": "number",
"description": "USD"
},
"high": {
"type": "number",
"description": "USD"
}
},
"description": "Strikes inside which the smile-adjusted values are available"
}
}
},
"annotations": {
"readOnlyHint": true
}
}Crypto options implied volatility (Deribit): DVOL index with 1y percentile, ATM IV term structure (7/30/90d) and inversion, 25-delta risk reversal and butterfly per expiry, 30d IV vs realized volatility, spot–vol correlation, 24h/7d skew and term changes, and the implied 1σ move for 1/7/30 days — how fast a move options price, not its direction. Pass several underlyings ("BTC,ETH") to compare.
| Parameter | Type | Description |
|---|---|---|
| currency * | string | Underlying symbol or comma-separated list (max 4), e.g. "BTC" or "BTC,ETH". |
{
"name": "options_volatility",
"title": "Options Volatility",
"description": "Crypto options implied volatility (Deribit): DVOL index with 1y percentile, ATM IV term structure (7/30/90d) and inversion, 25-delta risk reversal and butterfly per expiry, 30d IV vs realized volatility, spot–vol correlation, 24h/7d skew and term changes, and the implied 1σ move for 1/7/30 days — how fast a move options price, not its direction. Pass several underlyings (\"BTC,ETH\") to compare.",
"inputSchema": {
"type": "object",
"required": [
"currency"
],
"properties": {
"currency": {
"type": "string",
"description": "Underlying symbol or comma-separated list (max 4), e.g. \"BTC\" or \"BTC,ETH\"."
}
}
},
"outputSchema": {
"type": "object",
"required": [
"reads",
"unavailable",
"caveat"
],
"properties": {
"reads": {
"type": "array",
"items": {
"type": "object",
"required": [
"meta",
"atmIv",
"termState",
"skewState",
"impliedMovePct",
"expiries",
"changes",
"notes"
],
"properties": {
"dvol": {
"type": "object",
"required": [
"value",
"at",
"percentile",
"days",
"source"
],
"properties": {
"at": {
"type": "string",
"description": "Time of that value, ISO 8601 UTC"
},
"days": {
"type": "integer",
"description": "Daily closes in that window"
},
"value": {
"type": "number",
"description": "Latest DVOL, vol points"
},
"source": {
"type": "string",
"description": "reported"
},
"percentile": {
"type": "number",
"description": "Percentile of the current value against about a year of daily closes, 0–100"
},
"changeVsPriorDay": {
"type": "number",
"description": "Change vs the previous daily close, vol points"
}
},
"description": "DVOL, the venue's reported 30-day implied-volatility index; absent when unavailable"
},
"meta": {
"type": "object",
"required": [
"provider",
"underlying",
"observedAt",
"ageSeconds"
],
"properties": {
"provider": {
"type": "string",
"description": "Data venue, e.g. Deribit"
},
"ageSeconds": {
"type": "integer",
"description": "Seconds between the observation and this response"
},
"observedAt": {
"type": "string",
"description": "When the venue snapshot was observed, ISO 8601 UTC"
},
"underlying": {
"type": "string",
"description": "Underlying symbol, e.g. BTC"
}
},
"description": "Provenance of the snapshot the numbers come from"
},
"atmIv": {
"type": "object",
"required": [
"source"
],
"properties": {
"d7": {
"type": "number"
},
"d30": {
"type": "number"
},
"d90": {
"type": "number"
},
"source": {
"type": "string",
"description": "calculated"
}
},
"description": "Constant-maturity ATM implied volatility, percent annualized (calculated)"
},
"notes": {
"type": "array",
"items": {
"type": "string"
},
"description": "Data caveats, e.g. a DVOL or candle source that failed"
},
"changes": {
"type": "array",
"items": {
"type": "object",
"required": [
"hours",
"from",
"source"
],
"properties": {
"from": {
"type": "string",
"description": "Snapshot time, ISO 8601 UTC"
},
"hours": {
"type": "number",
"description": "Look-back, hours"
},
"source": {
"type": "string",
"description": "stored snapshot"
},
"iv30dChange": {
"type": "number",
"description": "Change of 30d ATM IV, vol points"
},
"termSlopeChange": {
"type": "number",
"description": "Change of the term slope, vol points"
},
"riskReversal25Change": {
"type": "number",
"description": "Change of the 25-delta risk reversal, vol points"
}
}
},
"description": "Changes of the vol state vs stored hourly snapshots; empty before any snapshot exists"
},
"expiries": {
"type": "array",
"items": {
"type": "object",
"required": [
"expiry",
"days",
"forwardUsd"
],
"properties": {
"days": {
"type": "number"
},
"atmIv": {
"type": "number",
"description": "ATM IV, percent annualized"
},
"expiry": {
"type": "string",
"description": "ISO 8601 UTC"
},
"forwardUsd": {
"type": "number",
"description": "Forward price the venue priced the expiry off, USD"
},
"butterfly25": {
"type": "number",
"description": "25-delta wing average minus ATM IV, vol points"
},
"riskReversal25": {
"type": "number",
"description": "25-delta call IV minus put IV, vol points"
}
}
},
"description": "Per-expiry volatility surface summary, nearest first"
},
"skewState": {
"type": "string",
"description": "PUTS OVER CALLS | CALLS OVER PUTS | NEUTRAL | UNAVAILABLE"
},
"termState": {
"type": "string",
"description": "INVERTED | CONTANGO | FLAT | UNAVAILABLE"
},
"volPremium": {
"type": "number",
"description": "30d ATM IV minus 30d realized, vol points"
},
"realized30d": {
"type": "number",
"description": "30d realized volatility from daily closes, percent annualized (calculated)"
},
"indexPriceUsd": {
"type": "number",
"description": "Spot index, USD"
},
"impliedMovePct": {
"type": "array",
"items": {
"type": "object",
"required": [
"days",
"pct",
"extrapolated"
],
"properties": {
"pct": {
"type": "number",
"description": "1σ move, percent of spot"
},
"days": {
"type": "number",
"description": "Horizon, days"
},
"extrapolated": {
"type": "boolean",
"description": "True when the horizon is shorter than the front expiry and front IV was used"
}
}
},
"description": "Implied 1σ move over each horizon, how fast the market prices a move, not its direction"
},
"riskReversal25At30d": {
"type": "number",
"description": "25-delta risk reversal at 30d, call IV minus put IV, vol points (calculated)"
},
"termSlope7dMinus30d": {
"type": "number",
"description": "7d ATM IV minus 30d ATM IV, vol points"
},
"spotVolCorrelation90d": {
"type": "number",
"description": "Correlation of daily DVOL change with daily log return over the last 90 days, −1 to 1 (calculated)"
}
}
},
"description": "One read per underlying that answered, in the order requested"
},
"caveat": {
"type": "string",
"description": "What the numbers do not say: positioning and pricing, not direction"
},
"unavailable": {
"type": "array",
"items": {
"type": "string"
},
"description": "Underlyings that failed, with the reason"
}
}
},
"annotations": {
"readOnlyHint": true
}
}Cross-sectional opportunity scan across every major and medium-cap coin at once — the screener the per-coin tools cannot be looped into safely. Two whole-universe feeds (the merged market snapshot + venue perp contexts) build a liquidity-filtered universe and rank it, then candles are fetched for a bounded shortlist only; ZERO per-symbol calls are made to the rate-limited derivatives provider, which is what lets this cover a universe without silently degrading. Up to eight signals per candidate: crowding (annualized funding vs the venue-standard anchor AND its percentile across the screened universe right now — a cross-sectional read, explicitly NOT the own-history percentile research_positioning reports; reported without a vote, because funding extremes have tended to continue rather than reverse), stress (24h long and short liquidations each as a share of open interest, both read on Bybit so the ratio is one book — longs flushed leans long, shorts flushed (a spent squeeze) leans short), leverage (open interest as a share of market cap — the gap-through-your-stop condition), compression (4h Bollinger bandwidth ranked against the coin's own trailing window — the per-coin form of the reading research_regime computes for BTC alone; says energy is loading, never direction), trend (ADX with the +DI/-DI separation on 4h, confirmed against 1d — votes +1 only for a strong 3:1 trend the slow timeframe agrees with), location (distance from the 4h EMA20 in ATR units — an extended coin scores DOWN, because a chase is not a setup), entry (whether the limit is still live) and reward (net-of-fees reward:risk and stop distance). Each signal reports its state, the numbers, and a +1/0/-1 setup-quality vote; the setup name and score come from a disclosed rule shipped with every scan, under which the reading that named the setup counts 0. Each candidate also says why it is worth a look now: its 24h price, OI (venue contracts) and volume against its own last 60 days, the plain-word labels those earn (longs building, short covering, crowded short, coiling, ...), and for each label what followed it in a 2-year backtest, verdict included (often 'no edge'). Priced setups carry their setup type's backtest track record (trades, win rate, average R after fees, against random entries). Each candidate says whether it is ACTIONABLE (a priced live entry, net reward:risk >= 1.5, score >= +1) and, when not, which gates it missed; actionable candidates rank first. Candidates carry ATR-and-structure trade plans priced so they feed research_trade_plan directly. A TRENDING PULLBACK is entered at market with its levels from the EMA20 pullback, taking half at +1R and moving the rest to breakeven (60% of 19,139 backtested trades won, about 0R on average, the same as random entries with those exits); an ABSORPTION SHORT (yesterday's Binance taker-buy share in the bottom 10% of the coin's own 60 days while the day closed flat or up) is a short at market, stop 2.5 ATR, target 2R, the one setup type that beat random entries in the backtest; a BREAKDOWN (24h drop in the bottom 5% of the coin's own 60 days) is a short at market; a COIL BREAKOUT (volatility squeezed, no trend) is a stop bracket around the 10-candle range. Stops sit behind the recent swing (a bracket's at the range midpoint), and targets at the structural level or 2R, whichever is nearer. Every priced plan carries its type's 2-year backtest record and a plain caveat; none of the three types passed a pre-registered edge test. No geometry is priced after a 24h move beyond ±30% or with a stop over 15% from entry, nor, for 7 days after BTC moves ±6% in 24h, for a TRENDING PULLBACK against that move (such plans lost in the backtest, in and out of sample; marketShock reports the active shock); the candidate says why. News is on the board but never scored: 'news.market' lists the last 24h's headlines after which BTC or ETH moved 1%+ (or a major coin 3%+) within the hour, and each candidate carries up to 3 headline
Deterministic positioning read for one coin — the game-state companion to research_regime, answering 'who is crowded, who is paying, who is trapped, and where'. Up to nine axes, each tagged with the market-actor cohort it reads: crowding (annualized funding vs the venue-standard 0.01%/8h anchor, long/short skew, dollars/day the majority pays to hold, crowd-vs-top-trader divergence, and cross-venue funding dispersion), buildup (24h price vs open-interest direction and the funding trend — whether positions are being added into the move or closed out), liquidity (order-book spread and imbalance — makers backing off), basis (perp vs oracle premium — spot-perp froth or hedging pressure, informational), fragility (24h liquidations as a share of market-wide open interest; the axis degrades rather than substituting a single venue's OI, since the liquidation total is cross-exchange), predation (visible Hyperliquid whale positions within 2 daily sigmas of their liquidation price, with defending book depth), trap (share of tracked whale notional underwater on the funding-paying side — attrition fuel), house book (Hyperliquid HLP LP-vault inventory, summed across its child sub-vaults — the literal venue counterparty, so the inventory it carries mirrors how traders are crowded; measured as net over its own gross book, since a market maker's net is a rounding error against venue open interest; informational), and disagreement (the most liquid matching prediction market, volume-gated, informational). Each axis reports its state, the numbers, and a +1/0/-1 fragility vote (+1 clean, -1 crowded/fragile); the stance is the disclosed sum-of-votes rule. Also returns a one-line 'farmed' synthesis (which cohort the board is currently farming, or an explicit statement that none is), focal points — reachable liquidation and breakeven price levels the whole market can see — and 'would change the call' thresholds a polling agent can watch statelessly. Reports the board, not a direction: crowding says who is paying, not where price goes. Deterministic — same inputs, same read. Call research_regime first for market context, then this per coin before sizing or timing decisions.
| Parameter | Type | Description |
|---|---|---|
| symbol * | string | Coin symbol, e.g. "BTC" or "ETH". |
Deterministic market-regime classification across seven axes: trend (Mayer Multiple bands vs the 200-day SMA), volatility (30d realized, percentile vs own history), cycle (a ~30-indicator top checklist incl. MVRV Z-Score, NUPL, Pi Cycle, AHR999), sentiment (Fear & Greed level, trajectory and percentile), leverage stress (derivatives-risk-index percentile), liquidity (7d spot-ETF net flows vs prior 7d), and rotation (Altcoin Season index, BTC dominance, ETH/BTC 30d). Each axis reports its state, the numbers behind it, and a +1/0/-1 vote; the overall posture is the disclosed sum-of-votes rule, with one exception — while 30d realized volatility sits at or below its 5th percentile the tape is compressed, trend structure stops being tradeable, and the Trend axis's vote is withheld (its reading is still reported). Compression is flagged structurally, and adds an informational, never-voting asymmetry lean naming which side is more exposed. Includes explicit 'would change the call' thresholds to watch. Rule-based and deterministic — same inputs, same read. Useful as a first call: most other signals (funding, sentiment, flows) read differently depending on this regime.
No parameters.
{
"name": "research_regime",
"title": "Market Regime",
"description": "Deterministic market-regime classification across seven axes: trend (Mayer Multiple bands vs the 200-day SMA), volatility (30d realized, percentile vs own history), cycle (a ~30-indicator top checklist incl. MVRV Z-Score, NUPL, Pi Cycle, AHR999), sentiment (Fear & Greed level, trajectory and percentile), leverage stress (derivatives-risk-index percentile), liquidity (7d spot-ETF net flows vs prior 7d), and rotation (Altcoin Season index, BTC dominance, ETH/BTC 30d). Each axis reports its state, the numbers behind it, and a +1/0/-1 vote; the overall posture is the disclosed sum-of-votes rule, with one exception — while 30d realized volatility sits at or below its 5th percentile the tape is compressed, trend structure stops being tradeable, and the Trend axis's vote is withheld (its reading is still reported). Compression is flagged structurally, and adds an informational, never-voting asymmetry lean naming which side is more exposed. Includes explicit 'would change the call' thresholds to watch. Rule-based and deterministic — same inputs, same read. Useful as a first call: most other signals (funding, sentiment, flows) read differently depending on this regime.",
"inputSchema": {
"type": "object",
"properties": {}
},
"outputSchema": {
"type": "object",
"properties": {
"axes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"vote": {
"type": "integer",
"description": "+1 risk-on, -1 risk-off, 0 neutral"
},
"state": {
"type": "string"
},
"detail": {
"type": "string",
"description": "The numbers behind the state"
}
}
}
},
"options": {
"type": "object",
"description": "Informational BTC/ETH implied-vol context from Deribit options (DVOL, ATM IV term structure, IV vs realized, 25-delta skew) and the modeled options regime (under gamma). Never votes."
},
"posture": {
"type": "string",
"description": "Overall risk-posture label"
},
"asymmetry": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"vote": {
"type": "integer"
},
"state": {
"type": "string"
},
"detail": {
"type": "string"
}
},
"description": "Which side is more exposed while compressed; a lean with a stated confidence, never a vote. Absent unless the tape is compressed and at least two of its inputs are meaningful"
},
"axesTotal": {
"type": "integer"
},
"compressed": {
"type": "boolean",
"description": "30d realized vol at or below its 5th percentile — while true the Trend axis contributes 0 to the posture whatever its state"
},
"postureRule": {
"type": "string",
"description": "The exact rule that produced posture"
},
"wouldChange": {
"type": "array",
"items": {
"type": "string"
},
"description": "Thresholds that would flip an axis"
},
"axesComputed": {
"type": "integer"
},
"volatilityPercentile": {
"type": "number",
"description": "30d realized-vol percentile vs own history; absent when no candle history was available, which is not the same as not compressed"
}
}
},
"annotations": {
"readOnlyHint": true
}
}Aggregated single-coin dossier: market data (spot/perp price, funding, market-wide OI, long/short, liquidations — the same enriched line as market_quotes), global market context (dominance, Fear & Greed), multi-timeframe technicals computed in-house from candles (4h + 1d: RSI, EMA/SMA, MACD, ATR, Bollinger, ADX, trend — the same numbers as ta_technicals), on-chain TVL/fees (when the symbol is a tracked chain), news, a grounded narrative synthesis with citations, upcoming catalyst events, social sentiment, ETF flows, prediction-market odds, live provider coverage, and a per-section status list that distinguishes an empty section from a failed feed — for one symbol (e.g. 'ETH').
| Parameter | Type | Description |
|---|---|---|
| symbol * | string | Coin symbol, e.g. 'ETH' or 'BTC' |
{
"name": "research_token_view",
"title": "Token Deep Dive",
"description": "Aggregated single-coin dossier: market data (spot/perp price, funding, market-wide OI, long/short, liquidations — the same enriched line as market_quotes), global market context (dominance, Fear & Greed), multi-timeframe technicals computed in-house from candles (4h + 1d: RSI, EMA/SMA, MACD, ATR, Bollinger, ADX, trend — the same numbers as ta_technicals), on-chain TVL/fees (when the symbol is a tracked chain), news, a grounded narrative synthesis with citations, upcoming catalyst events, social sentiment, ETF flows, prediction-market odds, live provider coverage, and a per-section status list that distinguishes an empty section from a failed feed — for one symbol (e.g. 'ETH').",
"inputSchema": {
"type": "object",
"required": [
"symbol"
],
"properties": {
"symbol": {
"type": "string",
"description": "Coin symbol, e.g. 'ETH' or 'BTC'"
}
}
},
"outputSchema": {
"type": "object",
"required": [
"symbol"
],
"properties": {
"news": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"date": {
"type": "string",
"description": "Publish date; omitted when unknown"
},
"kind": {
"type": "string",
"description": "Item type: article, tweet or exchange (announcement); empty when the feed doesn't say"
},
"coins": {
"type": "array",
"items": {
"type": "string"
},
"description": "Coin symbols the feed tagged on the item, e.g. [\"BTC\",\"ETH\"]"
},
"title": {
"type": "string"
},
"impact": {
"type": "object",
"properties": {
"up": {
"type": "number",
"description": "Best move reached in the window, percentage points"
},
"pct": {
"type": "number",
"description": "Net move over the window, percentage points, e.g. 1.9"
},
"coin": {
"type": "string"
},
"down": {
"type": "number",
"description": "Worst move reached in the window, percentage points"
},
"windowMs": {
"type": "number",
"description": "Measurement window in milliseconds, e.g. 3600000"
}
},
"description": "Measured price move after the headline broke; omitted when not measured"
},
"source": {
"type": "string"
},
"snippet": {
"type": "string"
}
}
}
},
"market": {
"type": "object",
"description": "Same shape as one market_quotes item; omitted when no provider covers the symbol"
},
"social": {
"type": "object",
"properties": {
"symbol": {
"type": "string"
},
"altRank": {
"type": "number",
"description": "1-based rank, lower is stronger"
},
"galaxyScore": {
"type": "number",
"description": "0-100 composite"
},
"sentimentPct": {
"type": "number",
"description": "Bullish share, percentage points"
},
"interactions24h": {
"type": "number"
},
"socialVolume24h": {
"type": "number"
},
"socialDominancePct": {
"type": "number",
"description": "Share of total crypto social volume, percentage points"
}
}
},
"symbol": {
"type": "string"
},
"etfFlow": {
"type": "object",
"properties": {
"asset": {
"type": "string"
},
"stale": {
"type": "boolean",
"description": "True when the flow date is more than 96h old — the series has missed a publication"
},
"asOfAt": {
"type": "string",
"description": "Flow date, ISO-8601 UTC"
},
"dateMs": {
"type": "integer",
"description": "Flow date, Unix epoch milliseconds"
},
"ageHours": {
"type": "number",
"description": "How old the flow date is now, in hours. ETF flows settle behind spot and skip weekends, so this is routinely >24."
},
"byTicker": {
"type": "array",
"items": {
"type": "object",
"properties": {
"ticker": {
"type": "string"
},
"flowUsd": {
"type": "number",
"description": "Per-fund net flow, USD"
}
}
}
},
"priceUsd": {
"type": "number",
"description": "The underlying's price ON THE FLOW DATE, not spot — compare against ageHours before reading it as current"
},
"totalFlowUsd": {
"type": "number",
"description": "Net flow across all funds, USD (positive = inflow)"
}
}
},
"onChain": {
"type": "object",
"properties": {
"tvlUsd": {
"type": "number",
"description": "Total value locked, USD"
},
"chainName": {
"type": "string"
},
"fees7dUsd": {
"type": "number"
},
"fees24hUsd": {
"type": "number"
},
"fees30dUsd": {
"type": "number"
},
"feesChangePct24h": {
"type": "number",
"description": "24h fees change, percentage points"
}
}
},
"sections": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Section key, e.g. news, narrative, catalysts"
},
"reason": {
"type": "string",
"description": "Present for not_applicable and unavailable"
},
"status": {
"type": "string",
"description": "ok, empty (feed answered, nothing for this symbol), not_applicable, or unavailable (feed failed)"
}
}
},
"description": "Per-section outcome, so an empty section can be told apart from a failed feed. Check this before reading an empty array as a real absence."
},
"catalysts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"coins": {
"type": "array",
"items": {
"type": "string"
}
},
"title": {
"type": "string"
},
"source": {
"type": "string"
},
"dateAdded": {
"type": "string"
},
"eventDate": {
"type": "string"
},
"categories": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"narrative": {
"type": "object",
"properties": {
"answer": {
"type": "string"
},
"citations": {
"type": "array",
"items": {
"type": "string"
}
}
}
},
"technicals": {
"type": "array",
"items": {
"type": "object"
},
"description": "In-house per-timeframe snapshots; same item shape as ta_technicals's timeframes. Empty when no timeframe could be analyzed."
},
"marketContext": {
"type": "object",
"description": "Same shape as market_overview"
},
"exchangeNotices": {
"type": "array",
"description": "Scheduled and recent (within 7 days) exchange listings and delistings for the coins in this answer; see catalysts_exchange_listings. Shown, never scored."
},
"providerCoverage": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"reason": {
"type": "string",
"description": "Present only when degraded or offline"
},
"status": {
"type": "string",
"description": "healthy, degraded, or offline"
}
}
}
},
"predictionMarkets": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"source": {
"type": "string"
},
"endDate": {
"type": "string"
},
"outcomes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"outcome": {
"type": "string"
},
"probability": {
"type": "number",
"description": "Market-implied probability, 0-1"
}
}
}
},
"question": {
"type": "string"
},
"volumeUsd": {
"type": "number"
},
"liquidityUsd": {
"type": "number"
}
}
}
}
}
},
"annotations": {
"readOnlyHint": true
}
}Check, review or replay a perp trade setup (entry, stop, optional target), before it is placed or after: the tool for 'check this setup', 'is this trade good' and 'how did my trade do'. Renders an interactive trade ticket. Give the coin, entry and stop; optionally target, leverage, order type, placed_at, and account size with risk percent. Returns reward:risk, the stop's distance in % and 4h ATR, the isolated liquidation price at the leverage (first-tier 0.5% maintenance margin, so the optimistic case), funding per day at the current rate (in % of notional, and in USD when sized), the perp levels around the setup (from flow_levels: volume nodes, value area, liquidation clusters, entries, walls), and named checks: liquidation before the stop, price already through the stop, a stop inside one ATR of noise, a stop just in front of a level a wick would reach for, a level between entry and target, reward:risk under 2:1, costs that pull a 2:1 plan under it, leverage over 10x, and an entry far from live. Costs: fees per fill (a venue's base tier, Binance by default; override with venue, fee_bps, maker_fee_bps), funding carry over hold_hours at the current rate with the rate's 1y percentile, and, when sized, the slippage of a market exit of the whole size at the stop against today's visible book; they give a net reward:risk, the break-even win rate, and the stop, target and liquidation outcomes in R (and USD and % of account when sized). Everything reads in R and % without an account; give account_size and risk_percent (both or neither) to add the fixed-fractional size, notional and margin. Pass placed_at (when the order was placed) to replay the setup since then from public candles, filling the entry by order_type: a limit fills when price comes to it (or at once if it was already marketable, e.g. a buy limit above the market), a stop entry when price comes through it, a market order at placement; R is measured from the actual fill. Statuses: PENDING, MISSED (target traded before the entry), OPEN with the result and best/worst so far in R, STOPPED, TARGET, or AMBIGUOUS when one candle reached both; plus funding paid while open. Nothing about the plan is stored: the numbers come in, the replay goes out, and planLine is the one-line copy to bring the plan back later. Use it after research_opportunities or flow_levels has suggested a setup; it is a check of the setup, not a signal.
| Parameter | Type | Description |
|---|---|---|
| stop * |
Market-wide Fear & Greed index (0-100 plus label) as the median of independent sources (CoinMarketCap, Alternative.me, CoinGlass), with every source's own value, label and observation time in `sources`. `agreement` (aligned/mixed/divergent) says how far the sources differ; a source older than 36h is listed but excluded from the median. Sources publish at different cadences (CoinMarketCap about every 15 minutes, the others daily), so read `observedAt`/`ageSeconds` per source. A macro sentiment gauge; use market_overview for the full market snapshot.
No parameters.
{
"name": "sentiment_fear_greed",
"title": "Fear & Greed Index",
"description": "Market-wide Fear & Greed index (0-100 plus label) as the median of independent sources (CoinMarketCap, Alternative.me, CoinGlass), with every source's own value, label and observation time in `sources`. `agreement` (aligned/mixed/divergent) says how far the sources differ; a source older than 36h is listed but excluded from the median. Sources publish at different cadences (CoinMarketCap about every 15 minutes, the others daily), so read `observedAt`/`ageSeconds` per source. A macro sentiment gauge; use market_overview for the full market snapshot.",
"inputSchema": {
"type": "object",
"properties": {}
},
"outputSchema": {
"type": "object",
"required": [
"value",
"label",
"method",
"asOf",
"sourceCount",
"min",
"max",
"spread",
"agreement",
"sources"
],
"properties": {
"max": {
"type": "integer",
"description": "Highest counted source value"
},
"min": {
"type": "integer",
"description": "Lowest counted source value"
},
"asOf": {
"type": "string",
"description": "ISO 8601 time of the newest observation among the sources that counted"
},
"label": {
"type": "string",
"description": "Index band for `value`, e.g. Fear or Greed"
},
"value": {
"type": "integer",
"description": "Consensus Fear & Greed index, 0-100: the median of the sources that counted"
},
"method": {
"type": "string",
"description": "How `value` was aggregated (median)"
},
"spread": {
"type": "integer",
"description": "max - min across the counted sources"
},
"sources": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"included"
],
"properties": {
"name": {
"type": "string"
},
"note": {
"type": "string",
"description": "Why a source did not count, or a caveat on one that did"
},
"label": {
"type": "string",
"description": "Band for the source's value"
},
"value": {
"type": "integer",
"description": "The source's own reading, 0-100 (absent when it failed)"
},
"included": {
"type": "boolean",
"description": "Whether it counted toward `value`"
},
"ageSeconds": {
"type": "integer",
"description": "Seconds since observedAt"
},
"observedAt": {
"type": "string",
"description": "ISO 8601 time the source says the value was computed"
},
"expectedNextUpdateAt": {
"type": "string",
"description": "ISO 8601 time the source should next publish"
}
}
},
"description": "Every source asked, whether or not it counted"
},
"agreement": {
"type": "string",
"description": "aligned (spread <= 10), mixed (<= 20) or divergent"
},
"sourceCount": {
"type": "integer",
"description": "Sources that counted toward `value`"
}
}
},
"annotations": {
"readOnlyHint": true
}
}Searches public X Posts from the last 7 days using X search syntax (keywords, phrases, hashtags, cashtags, or operators such as from:handle). Returns engagement, views and direct links; sorted by relevance unless latest=true. Results are capped at 10 Posts.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max Posts to return (1-10). Defaults to 5. |
| query * | string | X recent-search query (keywords, phrases, hashtags, cashtags, or operators), e.g. "$BTC", "bitcoin ETF", or "from:handle BTC". Self-serve query limit: 512 characters. |
| latest | boolean | Return the newest Posts instead of top relevance. Defaults to false. |
| minLikes | integer | Only Posts with at least this many likes. Defaults to 0. |
{
"name": "sentiment_twitter",
"title": "Twitter Sentiment",
"description": "Searches public X Posts from the last 7 days using X search syntax (keywords, phrases, hashtags, cashtags, or operators such as from:handle). Returns engagement, views and direct links; sorted by relevance unless latest=true. Results are capped at 10 Posts.",
"inputSchema": {
"type": "object",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"description": "Max Posts to return (1-10). Defaults to 5."
},
"query": {
"type": "string",
"description": "X recent-search query (keywords, phrases, hashtags, cashtags, or operators), e.g. \"$BTC\", \"bitcoin ETF\", or \"from:handle BTC\". Self-serve query limit: 512 characters."
},
"latest": {
"type": "boolean",
"description": "Return the newest Posts instead of top relevance. Defaults to false."
},
"minLikes": {
"type": "integer",
"description": "Only Posts with at least this many likes. Defaults to 0."
}
}
},
"outputSchema": {
"type": "object",
"properties": {
"tweets": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "X Post permalink"
},
"text": {
"type": "string"
},
"likes": {
"type": "number"
},
"views": {
"type": "number"
},
"replies": {
"type": "number"
},
"retweets": {
"type": "number"
},
"createdAt": {
"type": "string",
"description": "ISO 8601"
}
}
}
}
}
},
"annotations": {
"readOnlyHint": true
}
}Multi-timeframe technical-analysis snapshot for one coin, computed locally from real candles (not a vendor black box): per interval — last close, RSI(14), EMA20/50/200 + SMA200, MACD(12,26,9) with signal/histogram/cross freshness, ATR(14) with 2xATR stop suggestions (feed research_trade_plan), Bollinger(20,2) with %B and bandwidth, ADX(14) with +DI/-DI, volume vs 20-candle average, and a transparent trend rule (EMA alignment qualified by ADX). 'intervals' picks the timeframes (default 1h,4h,1d; max 4 of 1m|5m|15m|30m|1h|4h|12h|1d|1w); 'market' routes candles (spot|perp|auto, default auto: spot preferred; perp when spot fails or a recent spot listing has too little history for the indicators). Support/resistance comes from the same candles: daily swing highs/lows over the last year, clustered within half a daily ATR, nearest 3 on each side with distance, swing count and last touch, plus the year's range. For levels from executed perp flow (volume at price, liquidations, OI), use flow_levels.
| Parameter | Type | Description |
|---|---|---|
| market | string | Which candle series: 'spot', 'perp', or 'auto' (default: spot preferred; perp when spot fails or its history is too short) |
| symbol * | string | Coin symbol, e.g. 'ETH' or 'BTC' |
| intervals | array | Candle intervals to analyze, e.g. ["4h","1d"]. Default ["1h","4h","1d"]; max 4 of 1m|5m|15m|30m|1h|4h|12h|1d|1w |
{
"name": "ta_technicals",
"title": "Technical Analysis",
"description": "Multi-timeframe technical-analysis snapshot for one coin, computed locally from real candles (not a vendor black box): per interval — last close, RSI(14), EMA20/50/200 + SMA200, MACD(12,26,9) with signal/histogram/cross freshness, ATR(14) with 2xATR stop suggestions (feed research_trade_plan), Bollinger(20,2) with %B and bandwidth, ADX(14) with +DI/-DI, volume vs 20-candle average, and a transparent trend rule (EMA alignment qualified by ADX). 'intervals' picks the timeframes (default 1h,4h,1d; max 4 of 1m|5m|15m|30m|1h|4h|12h|1d|1w); 'market' routes candles (spot|perp|auto, default auto: spot preferred; perp when spot fails or a recent spot listing has too little history for the indicators). Support/resistance comes from the same candles: daily swing highs/lows over the last year, clustered within half a daily ATR, nearest 3 on each side with distance, swing count and last touch, plus the year's range. For levels from executed perp flow (volume at price, liquidations, OI), use flow_levels.",
"inputSchema": {
"type": "object",
"required": [
"symbol"
],
"properties": {
"market": {
"type": "string",
"description": "Which candle series: 'spot', 'perp', or 'auto' (default: spot preferred; perp when spot fails or its history is too short)"
},
"symbol": {
"type": "string",
"description": "Coin symbol, e.g. 'ETH' or 'BTC'"
},
"intervals": {
"type": "array",
"items": {
"type": "string"
},
"description": "Candle intervals to analyze, e.g. [\"4h\",\"1d\"]. Default [\"1h\",\"4h\",\"1d\"]; max 4 of 1m|5m|15m|30m|1h|4h|12h|1d|1w"
}
}
},
"outputSchema": {
"type": "object",
"required": [
"symbol",
"lastPriceUsd",
"timeframes"
],
"properties": {
"levels": {
"type": "object",
"properties": {
"interval": {
"type": "string"
},
"supports": {
"type": "array",
"items": {
"type": "object",
"properties": {
"swings": {
"type": "integer",
"description": "Confirmed swing highs/lows in the cluster"
},
"priceUsd": {
"type": "number"
},
"distancePct": {
"type": "number",
"description": "Signed distance from measuredFromUsd, % (negative = below)"
},
"lastTouchAt": {
"type": "string",
"description": "Newest swing in the cluster, ISO-8601 UTC"
}
}
},
"description": "Nearest first, below measuredFromUsd"
},
"rangeLowAt": {
"type": "string"
},
"rangeHighAt": {
"type": "string"
},
"rangeLowUsd": {
"type": "number"
},
"resistances": {
"type": "array",
"items": {
"type": "object",
"properties": {
"swings": {
"type": "integer",
"description": "Confirmed swing highs/lows in the cluster"
},
"priceUsd": {
"type": "number"
},
"distancePct": {
"type": "number",
"description": "Signed distance from measuredFromUsd, % (negative = below)"
},
"lastTouchAt": {
"type": "string",
"description": "Newest swing in the cluster, ISO-8601 UTC"
}
}
},
"description": "Nearest first, at or above measuredFromUsd"
},
"rangeHighUsd": {
"type": "number"
},
"toleranceUsd": {
"type": "number",
"description": "Cluster width: half a daily ATR(14), floored at 0.25% of price"
},
"windowCandles": {
"type": "integer"
},
"measuredFromUsd": {
"type": "number",
"description": "Price the levels are split around and distances measured from (the headline lastPriceUsd)"
}
},
"description": "Daily swing support/resistance; omitted when unavailable (see levelsUnavailable)"
},
"symbol": {
"type": "string"
},
"timeframes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"macd": {
"type": "object",
"properties": {
"macd": {
"type": "number"
},
"signal": {
"type": "number"
},
"histogram": {
"type": "number",
"description": "macd - signal; sign is the cross state"
},
"aboveSignal": {
"type": "boolean"
},
"candlesSinceCross": {
"type": "integer",
"description": "1 = crossed on the newest closed candle; omitted when no cross in window"
}
}
},
"adx14": {
"type": "number",
"description": ">=25 trending, 20-25 developing, <20 rangebound"
},
"rsi14": {
"type": "number",
"description": "Wilder RSI, 0-100; omitted without 15 closed candles"
},
"trend": {
"type": "string",
"description": "Transparent rule: EMA alignment qualified by ADX"
},
"asOfAt": {
"type": "string",
"description": "Same instant, ISO-8601 UTC"
},
"asOfMs": {
"type": "integer",
"description": "Open time of the newest closed candle, Unix epoch ms"
},
"market": {
"type": "string",
"description": "'spot' or 'perp' — series actually delivered"
},
"source": {
"type": "string",
"description": "Candle provider that answered"
},
"atr14Pct": {
"type": "number",
"description": "ATR(14) as % of last close — stop-sizing form"
},
"atr14Usd": {
"type": "number",
"description": "Wilder ATR(14), USD"
},
"ema20Usd": {
"type": "number"
},
"ema50Usd": {
"type": "number"
},
"interval": {
"type": "string"
},
"plusDi14": {
"type": "number"
},
"bollinger": {
"type": "object",
"properties": {
"lowerUsd": {
"type": "number"
},
"percentB": {
"type": "number",
"description": "Close inside the band: 0 = lower, 1 = upper"
},
"upperUsd": {
"type": "number"
},
"middleUsd": {
"type": "number"
},
"bandwidthPct": {
"type": "number",
"description": "Band width as % of middle — squeeze measure"
}
}
},
"ema200Usd": {
"type": "number"
},
"minusDi14": {
"type": "number"
},
"sma200Usd": {
"type": "number"
},
"lastCloseUsd": {
"type": "number"
},
"closedCandles": {
"type": "integer"
},
"volumeAvg20Usd": {
"type": "number"
},
"volumeLastClosedUsd": {
"type": "number"
},
"droppedPartialCandle": {
"type": "boolean",
"description": "True when a still-forming newest candle was excluded"
}
}
}
},
"lastPriceUsd": {
"type": "number",
"description": "Newest close of the finest analyzed timeframe"
},
"failedIntervals": {
"type": "array",
"items": {
"type": "string"
},
"description": "Intervals that could not be analyzed, with reasons"
},
"levelsUnavailable": {
"type": "string",
"description": "Why levels are missing, when they are"
}
}
},
"annotations": {
"readOnlyHint": true
}
}Returns the current UTC time in ISO 8601 format. Use it to anchor 'now' — e.g. to judge how stale a generatedAt timestamp or news date is.
No parameters.
{
"name": "utc_time",
"title": "Current UTC Time",
"description": "Returns the current UTC time in ISO 8601 format. Use it to anchor 'now' — e.g. to judge how stale a generatedAt timestamp or news date is.",
"inputSchema": {
"type": "object",
"properties": {}
},
"outputSchema": {
"type": "object",
"required": [
"utc"
],
"properties": {
"utc": {
"type": "string",
"description": "Current UTC time, ISO 8601"
}
}
},
"annotations": {
"readOnlyHint": true
}
}f1ow: crypto perpetual-futures data and research. Routing: for what to trade now, research_opportunities. To check, review or size a specific trade plan (entry, stop, target, account, risk), including a trade already placed (pass placed_at and, if the entry was a stop order, order_type), call research_trade_plan rather than rebuilding it from market_candles: it returns reward:risk, liquidation, funding, the levels and the replay (and the size when the user gives an account and risk), and renders a trade ticket. For one coin's board: research_positioning; price levels: flow_levels; flow: derivatives_flow; liquidations: derivatives_liquidations. For options (implied volatility and expected move size, skew, put/call, OI by strike, expirations, max pain): options_volatility, options_positioning, options_chain; modeled gamma exposure, walls, flip, options regime and dealer-hedging what-ifs: options_gamma; risk-neutral expiry odds: options_probability. These render interactive views; prefer them to reconstructing the same data from market_candles. For bulk history (backtests, months of OI, funding, liquidations or candles), market_history pages backwards with nextEndMs. To check whether an exchange accepts deposits or withdrawals of an asset or network (per network where the exchange says so), use exchange_wallet_status; unknown there never means disabled. Reports boards, not forecasts.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
| array |
| Networks, by alias ('ERC20', 'Tron'), the exchange's own label, or a contract address. Omit for all. |
| exchanges | array | Exchange names or ids, e.g. ['Gate','upbit-kr']. Omit for all. |
{
"name": "exchange_wallet_status",
"title": "Exchange Wallet Status",
"description": "Crypto deposit and withdrawal availability across exchanges, for every asset each exchange returns (omit 'assets' for all; there is no ticker list or top-N cutoff). One row per exchange, region, asset and network where the exchange states flags per network (KuCoin, Bitget, Gate, HTX, Binance, MEXC, Bybit, OKX, Upbit); otherwise one asset-level row with network null (Coinone, WhiteBIT). 'deposit' and 'withdrawal' are independent: enabled, disabled or unknown. unknown means the exchange did not state it in a documented way; a missing field, an absent asset, a failed or rate-limited request or an unrecognised value is never reported as disabled. An asset-level flag is never copied onto its networks. Rows keep the exchange's own asset and network ids and contract address where it gives one; 'network' is a canonical name matched by explicit aliases (ERC20, TRC20, BEP20...), never by ticker. 'networks' filters by alias, the exchange's own label or a contract address; asset-level rows never match it. Page with 'limit' (default 200, max 1000) and 'cursor' (next_cursor; same filters). Each row carries retrieved_at and stale: a stale row is last-known data served because the exchange failed now, with its original retrieved_at. Coverage and health are not part of the response; instead 'warnings' names every exchange that did not answer (its rows are absent, which never means disabled), that answered from stale data, that was not queried for lack of credentials, and where Gate's per-chain status was not confirmed. Keyed exchanges (Binance, MEXC, Bybit, OKX, Upbit) are not queried until the operator configures read-only keys. Status can lag the exchange by minutes; check before moving funds, never a guarantee.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"limit": {
"type": "integer",
"description": "Rows per page, 1-1000. Default 200."
},
"assets": {
"type": "array",
"items": {
"type": "string"
},
"description": "Asset symbols, e.g. ['WAVES'] or ['USDT','USDC']. Omit for every asset each exchange returns."
},
"cursor": {
"type": "string",
"description": "next_cursor from the previous page, with the same filters."
},
"networks": {
"type": "array",
"items": {
"type": "string"
},
"description": "Networks, by alias ('ERC20', 'Tron'), the exchange's own label, or a contract address. Omit for all."
},
"exchanges": {
"type": "array",
"items": {
"type": "string"
},
"description": "Exchange names or ids, e.g. ['Gate','upbit-kr']. Omit for all."
}
}
},
"outputSchema": {
"type": "object",
"required": [
"rows",
"total",
"next_cursor",
"warnings"
],
"properties": {
"rows": {
"type": "array",
"items": {
"type": "object",
"required": [
"exchange",
"region",
"asset",
"asset_id",
"network",
"network_id",
"deposit",
"withdrawal",
"retrieved_at",
"stale"
],
"properties": {
"asset": {
"type": "string",
"description": "Symbol, upper-cased"
},
"stale": {
"type": "boolean"
},
"region": {
"type": "string"
},
"deposit": {
"enum": [
"enabled",
"disabled",
"unknown"
],
"type": "string"
},
"network": {
"type": [
"string",
"null"
],
"description": "Canonical network, when the aliases match; null for an asset-level row or an unrecognised label"
},
"asset_id": {
"type": "string",
"description": "The exchange's own asset id"
},
"exchange": {
"type": "string"
},
"network_id": {
"type": [
"string",
"null"
],
"description": "The exchange's own network id; null when the exchange states no per-network flags"
},
"withdrawal": {
"enum": [
"enabled",
"disabled",
"unknown"
],
"type": "string"
},
"network_name": {
"type": [
"string",
"null"
]
},
"retrieved_at": {
"type": "string"
},
"stale_reason": {
"type": [
"string",
"null"
]
},
"contract_address": {
"type": [
"string",
"null"
]
}
}
}
},
"total": {
"type": "integer",
"description": "Rows matching the filters across all pages"
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"next_cursor": {
"type": [
"string",
"null"
]
}
}
},
"annotations": {
"readOnlyHint": true
}
}| Bucket size. Price: 1m–1w except 6h/8h, default 1d. Derivatives: 4h, 6h, 8h, 12h, 1d or 1w; default 4h (funding 8h). |
{
"name": "market_history",
"title": "Market History",
"description": "Bulk history for one coin, one metric per call, in pages: 'price' (OHLCV candles, spot or perp), 'open_interest' (market-wide aggregate USD), 'funding' (OI-weighted rate, %/8h and annualized) or 'liquidations' (market-wide long/short USD per bucket). Returns up to 'limit' rows (default 200, max 1000) at or before 'end' (default now), oldest first, as compact columns + rows; pass the returned nextEndMs as 'end' to fetch the page before it, and 'start' to stop there. Reach: price is full venue history (Binance spot from 2017, futures from 2019) at 1m–1w; derivatives come from CoinGlass at 4h (about 180 days back), 6h/8h/12h (about 360 days) or 1d/1w (back to 2020) — use 1d for anything older than six months. The newest row may still be forming (newestForming). Use this to pull history; for a read of what is happening now, use the derivatives_* and research_* tools.",
"inputSchema": {
"type": "object",
"required": [
"symbol",
"metric"
],
"properties": {
"end": {
"type": "string",
"description": "Latest time to include: ISO-8601 or Unix ms. Default now. Pass nextEndMs here to page back."
},
"limit": {
"type": "integer",
"description": "Rows per page, 1–1000. Default 200."
},
"start": {
"type": "string",
"description": "Earliest time to include: ISO-8601 (UTC if no offset) or Unix ms. Paging stops here."
},
"market": {
"enum": [
"spot",
"perp"
],
"type": "string",
"description": "Price only: spot (default) or perpetual candles."
},
"metric": {
"enum": [
"price",
"open_interest",
"funding",
"liquidations"
],
"type": "string"
},
"symbol": {
"type": "string",
"description": "Coin symbol, e.g. \"BTC\"."
},
"interval": {
"enum": [
"1m",
"5m",
"15m",
"30m",
"1h",
"4h",
"6h",
"8h",
"12h",
"1d",
"1w"
],
"type": "string",
"description": "Bucket size. Price: 1m–1w except 6h/8h, default 1d. Derivatives: 4h, 6h, 8h, 12h, 1d or 1w; default 4h (funding 8h)."
}
}
},
"outputSchema": {
"type": "object",
"required": [
"symbol",
"metric",
"columns",
"rows",
"count"
],
"properties": {
"note": {
"type": [
"string",
"null"
]
},
"rows": {
"type": "array",
"items": {
"type": "array",
"items": {
"type": [
"number",
"null"
]
}
},
"description": "Oldest first; each row is [timeMs, ...values] in column order; null where the source has no value"
},
"count": {
"type": "integer"
},
"endMs": {
"type": "integer",
"description": "The page's end bound, Unix ms"
},
"units": {
"type": "string",
"description": "What each value column means"
},
"market": {
"type": [
"string",
"null"
],
"description": "Price only: spot or perp"
},
"metric": {
"type": "string"
},
"source": {
"type": "string",
"description": "Provider that answered this page"
},
"symbol": {
"type": "string"
},
"columns": {
"type": "array",
"items": {
"type": "string"
},
"description": "Names of each row's cells; the first is timeMs (bucket open, Unix ms)"
},
"startMs": {
"type": [
"integer",
"null"
]
},
"interval": {
"type": "string"
},
"nextEndMs": {
"type": [
"integer",
"null"
],
"description": "Pass as 'end' for the page before this one; null when this page reached 'start' or the series' beginning"
},
"newestForming": {
"type": "boolean",
"description": "Newest row's bucket is still open; the vendor rewrites it until it closes"
},
"earliestAvailableMs": {
"type": [
"integer",
"null"
],
"description": "Set when 'end' was before the plan's history edge for this interval"
}
}
},
"annotations": {
"readOnlyHint": true
}
}| What-if: hours to advance (0–2160). Contracts expiring in between drop out. |
| price_change_pct | number | Extra custom spot move for the hedge ladder, percent (e.g. -3). |
{
"name": "options_gamma",
"title": "Options Gamma Exposure",
"description": "Crypto options gamma exposure (Deribit, modeled): gross and dealer-signed GEX in USD per 1% move, by strike and expiry, gamma walls, modeled gamma flip levels, options-derived price levels (call/put OI walls, gamma concentrations, max pain, high-sensitivity zones) and a rule-based options regime (positive/negative modeled gamma, near flip, expiry concentration, elevated/compressed vol), with perp funding/OI/liquidations/order book as a separate evidence block. What-ifs: hedging=true adds theoretical dealer hedge ladders (spot ±0.5–5%, charm 1–24h and through the next expiry, vanna ±1/2/5 vol points); target_price / horizon_hours / iv_change reprice the same frozen contracts (GEX, dealer delta, hedge, flips and walls before vs after). Signed numbers depend on an explicit dealer-positioning scenario; modeled, not observed orders.",
"inputSchema": {
"type": "object",
"required": [
"currency"
],
"properties": {
"expiry": {
"type": "string",
"description": "What-if/hedging scope: only this expiry (\"next\", \"2026-11-27\" or \"27NOV26\"). Default all."
},
"hedging": {
"type": "boolean",
"description": "Add theoretical dealer hedge ladders (price, charm, vanna). Implied by any what-if parameter."
},
"currency": {
"type": "string",
"description": "Underlying symbol, e.g. \"BTC\"."
},
"scenario": {
"enum": [
"calls_long_puts_short",
"short_all",
"long_all"
],
"type": "string",
"description": "Assumed dealer positioning (public OI can't show it). Default calls_long_puts_short: dealers long calls, short puts."
},
"iv_change": {
"type": "number",
"description": "What-if: absolute IV shift in vol points (e.g. -2)."
},
"target_price": {
"type": "number",
"description": "What-if: underlying price to reprice at."
},
"horizon_hours": {
"type": "number",
"description": "What-if: hours to advance (0–2160). Contracts expiring in between drop out."
},
"price_change_pct": {
"type": "number",
"description": "Extra custom spot move for the hedge ladder, percent (e.g. -3)."
}
}
},
"outputSchema": {
"type": "object",
"required": [
"meta",
"model",
"caveat",
"scenario",
"units",
"byStrike",
"byExpiry",
"scenarios",
"walls",
"levels"
],
"properties": {
"gex": {
"type": "object",
"required": [
"grossUsdPer1Pct",
"callUsdPer1Pct",
"putUsdPer1Pct",
"signedUsdPer1PctModeled",
"signedAtSpotDown1Pct",
"signedAtSpotUp1Pct",
"top5StrikeSharePct",
"expiring7dSharePct",
"gammaState"
],
"properties": {
"gammaState": {
"type": "string",
"description": "POSITIVE MODELED GAMMA | NEGATIVE MODELED GAMMA | NEAR-NEUTRAL MODELED GAMMA | NO GAMMA"
},
"putUsdPer1Pct": {
"type": "number"
},
"callUsdPer1Pct": {
"type": "number"
},
"grossUsdPer1Pct": {
"type": "number",
"description": "Calls + puts as long-option magnitudes, no positioning assumption"
},
"expiring7dSharePct": {
"type": "number",
"description": "Share of OI notional expiring within 7 days, percent"
},
"signedAtSpotUp1Pct": {
"type": "number",
"description": "Signed GEX repriced at spot +1%"
},
"top5StrikeSharePct": {
"type": "number",
"description": "Share of gross GEX held by the top 5 strikes, percent"
},
"signedAtSpotDown1Pct": {
"type": "number",
"description": "Signed GEX repriced at spot −1%"
},
"signedUsdPer1PctModeled": {
"type": "number",
"description": "Dealer-signed under the assumed scenario"
}
},
"description": "Gamma exposure totals, USD of underlying hedge per 1% move"
},
"flip": {
"type": "object",
"required": [
"crossings",
"gridLow",
"gridHigh"
],
"properties": {
"gridLow": {
"type": "number",
"description": "Lowest price of the grid, USD"
},
"gridHigh": {
"type": "number",
"description": "Highest price of the grid, USD"
},
"crossings": {
"type": "array",
"items": {
"type": "number"
},
"description": "Crossing prices, USD; empty when none in the grid"
}
},
"description": "Modeled gamma flip: spot levels where signed GEX crosses zero when spot is repriced across the grid"
},
"meta": {
"type": "object",
"required": [
"underlying"
],
"properties": {
"provider": {
"type": "string",
"description": "Data venue, e.g. Deribit"
},
"ageSeconds": {
"type": "integer",
"description": "Seconds between the observation and this response"
},
"observedAt": {
"type": "string",
"description": "When the venue snapshot was observed, ISO 8601 UTC"
},
"underlying": {
"type": "string",
"description": "Underlying symbol, e.g. BTC"
}
},
"description": "Provenance of the snapshot the numbers come from"
},
"model": {
"type": "string",
"description": "Model assumptions"
},
"units": {
"type": "object",
"properties": {
"gex": {
"type": "string"
}
}
},
"walls": {
"type": "object",
"required": [
"positive",
"negative",
"absolute"
],
"properties": {
"absolute": {
"type": "array",
"items": {
"type": "object",
"required": [
"strike",
"signedUsdPer1Pct",
"grossUsdPer1Pct",
"distancePct"
],
"properties": {
"strike": {
"type": "number",
"description": "Strike, USD"
},
"distancePct": {
"type": "number",
"description": "Distance from spot, percent"
},
"grossUsdPer1Pct": {
"type": "number",
"description": "Gross GEX at the strike, USD per 1% move, no positioning assumption"
},
"relativeStrength": {
"type": "number",
"description": "Multiple of the neighbouring strikes' exposure; absent when not computed"
},
"signedUsdPer1Pct": {
"type": "number",
"description": "Modeled dealer-signed GEX at the strike, USD of hedge per 1% move"
}
}
}
},
"negative": {
"type": "array",
"items": {
"type": "object",
"required": [
"strike",
"signedUsdPer1Pct",
"grossUsdPer1Pct",
"distancePct"
],
"properties": {
"strike": {
"type": "number",
"description": "Strike, USD"
},
"distancePct": {
"type": "number",
"description": "Distance from spot, percent"
},
"grossUsdPer1Pct": {
"type": "number",
"description": "Gross GEX at the strike, USD per 1% move, no positioning assumption"
},
"relativeStrength": {
"type": "number",
"description": "Multiple of the neighbouring strikes' exposure; absent when not computed"
},
"signedUsdPer1Pct": {
"type": "number",
"description": "Modeled dealer-signed GEX at the strike, USD of hedge per 1% move"
}
}
}
},
"positive": {
"type": "array",
"items": {
"type": "object",
"required": [
"strike",
"signedUsdPer1Pct",
"grossUsdPer1Pct",
"distancePct"
],
"properties": {
"strike": {
"type": "number",
"description": "Strike, USD"
},
"distancePct": {
"type": "number",
"description": "Distance from spot, percent"
},
"grossUsdPer1Pct": {
"type": "number",
"description": "Gross GEX at the strike, USD per 1% move, no positioning assumption"
},
"relativeStrength": {
"type": "number",
"description": "Multiple of the neighbouring strikes' exposure; absent when not computed"
},
"signedUsdPer1Pct": {
"type": "number",
"description": "Modeled dealer-signed GEX at the strike, USD of hedge per 1% move"
}
}
}
}
},
"description": "Gamma walls: exposure concentrations, not support or resistance"
},
"caveat": {
"type": "string",
"description": "Modeled dealer hedging is not observed dealer trading"
},
"levels": {
"type": "array",
"items": {
"type": "object",
"required": [
"price",
"kind",
"value",
"unit",
"distancePct",
"basis"
],
"properties": {
"kind": {
"type": "string",
"description": "E.g. call/put OI wall, gamma concentration, max pain, gamma flip"
},
"unit": {
"type": "string"
},
"basis": {
"type": "string",
"description": "What the level is computed from"
},
"price": {
"type": "number",
"description": "USD"
},
"value": {
"type": "number",
"description": "Magnitude in `unit`"
},
"expiry": {
"type": "string",
"description": "ISO 8601 UTC, for expiry-specific levels"
},
"distancePct": {
"type": "number",
"description": "Distance from spot, percent"
}
}
},
"description": "Options-derived reference price levels, nearest first; not guaranteed support or resistance"
},
"regime": {
"type": "object",
"required": [
"labels",
"evidence",
"thresholds"
],
"properties": {
"labels": {
"type": "array",
"items": {
"type": "string"
}
},
"evidence": {
"type": "array",
"items": {
"type": "string"
},
"description": "The numbers behind the labels"
},
"thresholds": {
"type": "array",
"items": {
"type": "string"
},
"description": "The rules applied"
}
},
"description": "Rule-based options regime"
},
"whatIf": {
"type": "object",
"required": [
"meta",
"model",
"scenario",
"units",
"priceLadder",
"charmLadder",
"vannaLadder",
"byScenario"
],
"properties": {
"meta": {
"type": "object",
"required": [
"provider",
"underlying",
"observedAt",
"ageSeconds"
],
"properties": {
"provider": {
"type": "string",
"description": "Data venue, e.g. Deribit"
},
"ageSeconds": {
"type": "integer",
"description": "Seconds between the observation and this response"
},
"observedAt": {
"type": "string",
"description": "When the venue snapshot was observed, ISO 8601 UTC"
},
"underlying": {
"type": "string",
"description": "Underlying symbol, e.g. BTC"
}
},
"description": "Provenance of the snapshot the numbers come from"
},
"model": {
"type": "string",
"description": "Model assumptions"
},
"scope": {
"type": "string",
"description": "Contracts included: all expiries or one expiry"
},
"units": {
"type": "object",
"properties": {
"usd": {
"type": "string"
},
"coins": {
"type": "string"
}
}
},
"spotUsd": {
"type": "number",
"description": "Spot index the model starts from, USD"
},
"scenario": {
"type": "object",
"required": [
"code",
"description",
"observed"
],
"properties": {
"code": {
"enum": [
"calls_long_puts_short",
"short_all",
"long_all"
],
"type": "string"
},
"observed": {
"type": "boolean",
"description": "Always false: public OI cannot show dealer positioning"
},
"description": {
"type": "string"
}
},
"description": "The assumed dealer positioning; never observed"
},
"byScenario": {
"type": "array",
"items": {
"type": "object",
"required": [
"scenario",
"ladder"
],
"properties": {
"ladder": {
"type": "array",
"items": {
"type": "object",
"required": [
"label",
"coins",
"usd",
"expiryUnwindCoins"
],
"properties": {
"usd": {
"type": "number",
"description": "Coins × spot of the resulting state, USD"
},
"coins": {
"type": "number",
"description": "Underlying coins"
},
"label": {
"type": "string",
"description": "The move this step prices"
},
"expiryUnwindCoins": {
"type": "number",
"description": "Part of coins that is the unwind of expiring contracts"
}
},
"description": "Modeled dealer hedge change; positive = the modeled dealer book buys the underlying"
}
},
"scenario": {
"type": "string"
}
}
},
"description": "The ±1% spot move under every dealer-positioning scenario"
},
"simulation": {
"type": "object",
"required": [
"targetSpot",
"horizonHours",
"ivShiftPoints",
"openInterest",
"grossGexFrom",
"grossGexTo",
"signedGexFrom",
"signedGexTo",
"dealerDeltaFrom",
"dealerDeltaTo",
"hedge",
"flipFrom",
"flipTo",
"wallsFrom",
"wallsTo",
"byStrikeTo",
"expiringNotionalUsd",
"vannaAtTarget",
"gammaStateFrom",
"gammaStateTo"
],
"properties": {
"hedge": {
"type": "object",
"required": [
"label",
"coins",
"usd",
"expiryUnwindCoins"
],
"properties": {
"usd": {
"type": "number",
"description": "Coins × spot of the resulting state, USD"
},
"coins": {
"type": "number",
"description": "Underlying coins"
},
"label": {
"type": "string",
"description": "The move this step prices"
},
"expiryUnwindCoins": {
"type": "number",
"description": "Part of coins that is the unwind of expiring contracts"
}
},
"description": "Modeled dealer hedge change; positive = the modeled dealer book buys the underlying"
},
"flipTo": {
"type": "object",
"required": [
"crossings",
"gridLow",
"gridHigh"
],
"properties": {
"gridLow": {
"type": "number",
"description": "Lowest price of the grid, USD"
},
"gridHigh": {
"type": "number",
"description": "Highest price of the grid, USD"
},
"crossings": {
"type": "array",
"items": {
"type": "number"
},
"description": "Crossing prices, USD; empty when none in the grid"
}
},
"description": "Modeled gamma flip: spot levels where signed GEX crosses zero when spot is repriced across the grid"
},
"wallsTo": {
"type": "array",
"items": {
"type": "object",
"required": [
"strike",
"signedUsdPer1Pct",
"grossUsdPer1Pct",
"distancePct"
],
"properties": {
"strike": {
"type": "number",
"description": "Strike, USD"
},
"distancePct": {
"type": "number",
"description": "Distance from spot, percent"
},
"grossUsdPer1Pct": {
"type": "number",
"description": "Gross GEX at the strike, USD per 1% move, no positioning assumption"
},
"relativeStrength": {
"type": "number",
"description": "Multiple of the neighbouring strikes' exposure; absent when not computed"
},
"signedUsdPer1Pct": {
"type": "number",
"description": "Modeled dealer-signed GEX at the strike, USD of hedge per 1% move"
}
}
}
},
"flipFrom": {
"type": "object",
"required": [
"crossings",
"gridLow",
"gridHigh"
],
"properties": {
"gridLow": {
"type": "number",
"description": "Lowest price of the grid, USD"
},
"gridHigh": {
"type": "number",
"description": "Highest price of the grid, USD"
},
"crossings": {
"type": "array",
"items": {
"type": "number"
},
"description": "Crossing prices, USD; empty when none in the grid"
}
},
"description": "Modeled gamma flip: spot levels where signed GEX crosses zero when spot is repriced across the grid"
},
"wallsFrom": {
"type": "array",
"items": {
"type": "object",
"required": [
"strike",
"signedUsdPer1Pct",
"grossUsdPer1Pct",
"distancePct"
],
"properties": {
"strike": {
"type": "number",
"description": "Strike, USD"
},
"distancePct": {
"type": "number",
"description": "Distance from spot, percent"
},
"grossUsdPer1Pct": {
"type": "number",
"description": "Gross GEX at the strike, USD per 1% move, no positioning assumption"
},
"relativeStrength": {
"type": "number",
"description": "Multiple of the neighbouring strikes' exposure; absent when not computed"
},
"signedUsdPer1Pct": {
"type": "number",
"description": "Modeled dealer-signed GEX at the strike, USD of hedge per 1% move"
}
}
}
},
"byStrikeTo": {
"type": "array",
"items": {
"type": "object",
"required": [
"strike",
"callUsd",
"putUsd",
"signedUsd",
"grossUsd"
],
"properties": {
"putUsd": {
"type": "number",
"description": "Put gamma exposure, long-option magnitude"
},
"strike": {
"type": "number",
"description": "USD"
},
"callUsd": {
"type": "number",
"description": "Call gamma exposure, long-option magnitude"
},
"grossUsd": {
"type": "number",
"description": "Call + put magnitude"
},
"signedUsd": {
"type": "number",
"description": "Modeled dealer-signed exposure"
}
}
},
"description": "GEX per strike within ±30% of spot, USD per 1% move"
},
"grossGexTo": {
"type": "number",
"description": "USD per 1% move, after"
},
"targetSpot": {
"type": "number",
"description": "USD"
},
"signedGexTo": {
"type": "number",
"description": "Modeled signed GEX after, USD per 1% move"
},
"gammaStateTo": {
"type": "string"
},
"grossGexFrom": {
"type": "number",
"description": "USD per 1% move, before"
},
"horizonHours": {
"type": "number"
},
"openInterest": {
"type": "string",
"description": "frozen as listed"
},
"dealerDeltaTo": {
"type": "number",
"description": "Modeled dealer option delta after, coins"
},
"ivShiftPoints": {
"type": "number",
"description": "Absolute IV shift, vol points"
},
"signedGexFrom": {
"type": "number",
"description": "Modeled signed GEX before, USD per 1% move"
},
"vannaAtTarget": {
"type": "array",
"items": {
"type": "object",
"required": [
"label",
"coins",
"usd",
"expiryUnwindCoins"
],
"properties": {
"usd": {
"type": "number",
"description": "Coins × spot of the resulting state, USD"
},
"coins": {
"type": "number",
"description": "Underlying coins"
},
"label": {
"type": "string",
"description": "The move this step prices"
},
"expiryUnwindCoins": {
"type": "number",
"description": "Part of coins that is the unwind of expiring contracts"
}
},
"description": "Modeled dealer hedge change; positive = the modeled dealer book buys the underlying"
}
},
"gammaStateFrom": {
"type": "string"
},
"dealerDeltaFrom": {
"type": "number",
"description": "Modeled dealer option delta before, coins"
},
"expiringNotionalUsd": {
"type": "number",
"description": "OI notional expiring within the horizon, USD"
}
},
"description": "Reprice of the same frozen contracts at a target spot, time and IV shift; present only when target_price, horizon_hours or iv_change was given"
},
"charmLadder": {
"type": "array",
"items": {
"type": "object",
"required": [
"label",
"coins",
"usd",
"expiryUnwindCoins"
],
"properties": {
"usd": {
"type": "number",
"description": "Coins × spot of the resulting state, USD"
},
"coins": {
"type": "number",
"description": "Underlying coins"
},
"label": {
"type": "string",
"description": "The move this step prices"
},
"expiryUnwindCoins": {
"type": "number",
"description": "Part of coins that is the unwind of expiring contracts"
}
},
"description": "Modeled dealer hedge change; positive = the modeled dealer book buys the underlying"
}
},
"priceLadder": {
"type": "array",
"items": {
"type": "object",
"required": [
"label",
"coins",
"usd",
"expiryUnwindCoins"
],
"properties": {
"usd": {
"type": "number",
"description": "Coins × spot of the resulting state, USD"
},
"coins": {
"type": "number",
"description": "Underlying coins"
},
"label": {
"type": "string",
"description": "The move this step prices"
},
"expiryUnwindCoins": {
"type": "number",
"description": "Part of coins that is the unwind of expiring contracts"
}
},
"description": "Modeled dealer hedge change; positive = the modeled dealer book buys the underlying"
}
},
"vannaLadder": {
"type": "array",
"items": {
"type": "object",
"required": [
"label",
"coins",
"usd",
"expiryUnwindCoins"
],
"properties": {
"usd": {
"type": "number",
"description": "Coins × spot of the resulting state, USD"
},
"coins": {
"type": "number",
"description": "Underlying coins"
},
"label": {
"type": "string",
"description": "The move this step prices"
},
"expiryUnwindCoins": {
"type": "number",
"description": "Part of coins that is the unwind of expiring contracts"
}
},
"description": "Modeled dealer hedge change; positive = the modeled dealer book buys the underlying"
}
}
}
},
"spotUsd": {
"type": "number",
"description": "Spot index, USD"
},
"byExpiry": {
"type": "array",
"items": {
"type": "object",
"required": [
"expiry",
"grossUsd",
"signedUsd"
],
"properties": {
"expiry": {
"type": "string",
"description": "ISO 8601 UTC"
},
"grossUsd": {
"type": "number"
},
"signedUsd": {
"type": "number",
"description": "Modeled dealer-signed"
}
}
},
"description": "GEX per expiry, USD per 1% move"
},
"byStrike": {
"type": "array",
"items": {
"type": "object",
"required": [
"strike",
"callUsd",
"putUsd",
"signedUsd",
"grossUsd"
],
"properties": {
"putUsd": {
"type": "number",
"description": "Put gamma exposure, long-option magnitude"
},
"strike": {
"type": "number",
"description": "USD"
},
"callUsd": {
"type": "number",
"description": "Call gamma exposure, long-option magnitude"
},
"grossUsd": {
"type": "number",
"description": "Call + put magnitude"
},
"signedUsd": {
"type": "number",
"description": "Modeled dealer-signed exposure"
}
}
},
"description": "GEX per strike within ±30% of spot, USD per 1% move"
},
"scenario": {
"type": "object",
"required": [
"code",
"description",
"observed"
],
"properties": {
"code": {
"enum": [
"calls_long_puts_short",
"short_all",
"long_all"
],
"type": "string"
},
"observed": {
"type": "boolean",
"description": "Always false: public OI cannot show dealer positioning"
},
"description": {
"type": "string"
}
},
"description": "The assumed dealer positioning; never observed"
},
"scenarios": {
"type": "array",
"items": {
"type": "object",
"required": [
"scenario",
"signedUsdPer1Pct",
"flip"
],
"properties": {
"flip": {
"type": "object",
"required": [
"crossings",
"gridLow",
"gridHigh"
],
"properties": {
"gridLow": {
"type": "number",
"description": "Lowest price of the grid, USD"
},
"gridHigh": {
"type": "number",
"description": "Highest price of the grid, USD"
},
"crossings": {
"type": "array",
"items": {
"type": "number"
},
"description": "Crossing prices, USD; empty when none in the grid"
}
},
"description": "Modeled gamma flip: spot levels where signed GEX crosses zero when spot is repriced across the grid"
},
"scenario": {
"type": "string"
},
"signedUsdPer1Pct": {
"type": "number"
}
}
},
"description": "Signed GEX and flip under every dealer-positioning scenario"
},
"stored24h": {
"type": "object",
"required": [
"at",
"source",
"grossUsd",
"flips"
],
"properties": {
"at": {
"type": "string",
"description": "ISO 8601 UTC"
},
"flips": {
"type": "array",
"items": {
"type": "number"
},
"description": "Flip prices, USD"
},
"source": {
"type": "string",
"description": "stored snapshot"
},
"grossUsd": {
"type": "number"
},
"signedUsd": {
"type": "number"
},
"gammaState": {
"type": "string"
}
},
"description": "Modeled gamma state from the stored snapshot about 24h ago under the default scenario; absent until one exists"
},
"crossMarket": {
"type": "object",
"required": [
"source"
],
"properties": {
"source": {
"type": "string"
},
"bookImbalancePct": {
"type": "number",
"description": "Order book imbalance, percent"
},
"priceChange24hPct": {
"type": "number"
},
"liquidations24hUsd": {
"type": "number"
},
"perpOpenInterestUsd": {
"type": "number"
},
"fundingRatePctPerInterval": {
"type": "number",
"description": "Percent per funding interval"
}
},
"description": "Perp funding, OI, liquidations and order book as separate evidence, not used in the options labels; fields absent when that data did not answer"
},
"dataQuality": {
"type": "object",
"required": [
"instruments",
"priced",
"pricedOiSharePct",
"unpricedWithOi",
"nearExpiryExcluded",
"linearOnly",
"warnings"
],
"properties": {
"priced": {
"type": "integer",
"description": "Instruments priced (OI, mark IV and forward)"
},
"warnings": {
"type": "array",
"items": {
"type": "string"
}
},
"linearOnly": {
"type": "boolean",
"description": "True when only the thin linear USDC book exists"
},
"instruments": {
"type": "integer",
"description": "Listed instruments"
},
"unpricedWithOi": {
"type": "integer",
"description": "Instruments with OI but no price"
},
"pricedOiSharePct": {
"type": "number",
"description": "Share of live OI that is priced, percent"
},
"nearExpiryExcluded": {
"type": "integer",
"description": "Contracts too close to expiry, left out of gamma"
}
}
}
}
},
"annotations": {
"readOnlyHint": true
}
}| Parameter | Type | Description |
|---|---|---|
| tier | string | Size tier to screen: 'major' (market cap >= $10B), 'medium' ($300M-$10B), or 'all' (default). |
| limit | integer | Ranked candidates to return. Default 10, max 25. |
| symbols | array | Optional: narrow the universe to these coin symbols, e.g. ["SOL","AVAX"]. Omit to screen everything that clears the tier and liquidity floors. |
| intervals | array | The timeframe pair to analyse, FINEST FIRST: [fast] or [fast, slow]. Default ["4h","1d"]. This is the most consequential argument: entry, stop, target, ATR and every AT STRUCTURE verdict are measured on the fast timeframe, so changing it produces a DIFFERENT trade rather than a refinement of the sam… |
{
"name": "research_opportunities",
"title": "Opportunity Scan",
"description": "Cross-sectional opportunity scan across every major and medium-cap coin at once — the screener the per-coin tools cannot be looped into safely. Two whole-universe feeds (the merged market snapshot + venue perp contexts) build a liquidity-filtered universe and rank it, then candles are fetched for a bounded shortlist only; ZERO per-symbol calls are made to the rate-limited derivatives provider, which is what lets this cover a universe without silently degrading. Up to eight signals per candidate: crowding (annualized funding vs the venue-standard anchor AND its percentile across the screened universe right now — a cross-sectional read, explicitly NOT the own-history percentile research_positioning reports; reported without a vote, because funding extremes have tended to continue rather than reverse), stress (24h long and short liquidations each as a share of open interest, both read on Bybit so the ratio is one book — longs flushed leans long, shorts flushed (a spent squeeze) leans short), leverage (open interest as a share of market cap — the gap-through-your-stop condition), compression (4h Bollinger bandwidth ranked against the coin's own trailing window — the per-coin form of the reading research_regime computes for BTC alone; says energy is loading, never direction), trend (ADX with the +DI/-DI separation on 4h, confirmed against 1d — votes +1 only for a strong 3:1 trend the slow timeframe agrees with), location (distance from the 4h EMA20 in ATR units — an extended coin scores DOWN, because a chase is not a setup), entry (whether the limit is still live) and reward (net-of-fees reward:risk and stop distance). Each signal reports its state, the numbers, and a +1/0/-1 setup-quality vote; the setup name and score come from a disclosed rule shipped with every scan, under which the reading that named the setup counts 0. Each candidate also says why it is worth a look now: its 24h price, OI (venue contracts) and volume against its own last 60 days, the plain-word labels those earn (longs building, short covering, crowded short, coiling, ...), and for each label what followed it in a 2-year backtest, verdict included (often 'no edge'). Priced setups carry their setup type's backtest track record (trades, win rate, average R after fees, against random entries). Each candidate says whether it is ACTIONABLE (a priced live entry, net reward:risk >= 1.5, score >= +1) and, when not, which gates it missed; actionable candidates rank first. Candidates carry ATR-and-structure trade plans priced so they feed research_trade_plan directly. A TRENDING PULLBACK is entered at market with its levels from the EMA20 pullback, taking half at +1R and moving the rest to breakeven (60% of 19,139 backtested trades won, about 0R on average, the same as random entries with those exits); an ABSORPTION SHORT (yesterday's Binance taker-buy share in the bottom 10% of the coin's own 60 days while the day closed flat or up) is a short at market, stop 2.5 ATR, target 2R, the one setup type that beat random entries in the backtest; a BREAKDOWN (24h drop in the bottom 5% of the coin's own 60 days) is a short at market; a COIL BREAKOUT (volatility squeezed, no trend) is a stop bracket around the 10-candle range. Stops sit behind the recent swing (a bracket's at the range midpoint), and targets at the structural level or 2R, whichever is nearer. Every priced plan carries its type's 2-year backtest record and a plain caveat; none of the three types passed a pre-registered edge test. No geometry is priced after a 24h move beyond ±30% or with a stop over 15% from entry, nor, for 7 days after BTC moves ±6% in 24h, for a TRENDING PULLBACK against that move (such plans lost in the backtest, in and out of sample; marketShock reports the active shock); the candidate says why. News is on the board but never scored: 'news.market' lists the last 24h's headlines after which BTC or ETH moved 1%+ (or a major coin 3%+) within the hour, and each candidate carries up to 3 headline",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"tier": {
"enum": [
"major",
"medium",
"all"
],
"type": "string",
"description": "Size tier to screen: 'major' (market cap >= $10B), 'medium' ($300M-$10B), or 'all' (default)."
},
"limit": {
"type": "integer",
"description": "Ranked candidates to return. Default 10, max 25."
},
"symbols": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional: narrow the universe to these coin symbols, e.g. [\"SOL\",\"AVAX\"]. Omit to screen everything that clears the tier and liquidity floors."
},
"intervals": {
"type": "array",
"items": {
"enum": [
"1m",
"5m",
"15m",
"30m",
"1h",
"4h",
"12h",
"1d",
"1w"
],
"type": "string"
},
"description": "The timeframe pair to analyse, FINEST FIRST: [fast] or [fast, slow]. Default [\"4h\",\"1d\"]. This is the most consequential argument: entry, stop, target, ATR and every AT STRUCTURE verdict are measured on the fast timeframe, so changing it produces a DIFFERENT trade rather than a refinement of the same one — on one live BTC read the 1h pair put the entry 0.2% above spot while the 1d pair put it 10.7% below, with stops of 0.77% and 3.31%. Lookbacks are counted in candles, so the swing windows scale too (30 candles is 5 days at 4h, 7 hours at 15m). The second interval only CONFIRMS the first and must be slower; pass one interval to skip confirmation, which halves the candle cost and makes the trend vote abstain."
}
}
},
"outputSchema": {
"type": "object",
"properties": {
"news": {
"type": [
"object",
"null"
],
"properties": {
"market": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"atMs": {
"type": "integer"
},
"kind": {
"type": "string",
"description": "article | tweet | exchange"
},
"coins": {
"type": "array",
"items": {
"type": "string"
},
"description": "The feed's own coin tags, a word match that can be wrong"
},
"title": {
"type": "string"
},
"impact": {
"type": [
"object",
"null"
],
"properties": {
"up": {
"type": "number"
},
"pct": {
"type": "number",
"description": "Net move over the window, percent"
},
"coin": {
"type": "string"
},
"down": {
"type": "number"
},
"windowMs": {
"type": "integer"
}
},
"description": "The move the feed measured on a tagged coin within the hour after the headline: what followed it, not proof it caused it"
}
}
},
"description": "Headlines of the last 24h after which, within the hour, BTC or ETH moved 1%+ or a major-tier coin 3%+ (a Binance hack tags BNB, not BTC), newest first"
},
"sinceMs": {
"type": "integer",
"description": "The oldest headline the server's news memory holds (the feed keeps about 6 hours; the server up to 48, from its last deploy)"
}
},
"description": "Headlines, shown and never scored: no setup, score or price reads them. Null when the news feed did not answer (no data, not no news)."
},
"rule": {
"type": "string",
"description": "The exact rule that produced setup and score"
},
"caveats": {
"type": "array",
"items": {
"type": "string"
},
"description": "What the scan cannot see, stated rather than implied"
},
"backdrop": {
"type": [
"object",
"null"
],
"properties": {
"axes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"vote": {
"type": "integer"
},
"state": {
"type": "string"
},
"detail": {
"type": "string"
}
}
},
"description": "The regime axes: Trend, Volatility, Cycle, Sentiment (Fear & Greed), Leverage, Liquidity (ETF flows), Rotation"
},
"posture": {
"type": "string",
"description": "RISK-ON | CAUTIOUS RISK-ON | NEUTRAL | DEFENSIVE | RISK-OFF, with its vote score"
},
"direction": {
"type": "string",
"description": "bull | bear | empty for NEUTRAL"
},
"bearishNews": {
"type": "integer",
"description": "... followed by a fall"
},
"bullishNews": {
"type": "integer",
"description": "Market headlines of the last 24h followed by a rise within the hour"
}
},
"description": "The market's direction as research_regime reads it, shown and never scored: each candidate's backdrop field says whether its side is with or against it, but nothing is priced or ranked by it. Null when the regime read failed."
},
"coverage": {
"type": "object",
"properties": {
"major": {
"type": "integer"
},
"medium": {
"type": "integer"
},
"quoted": {
"type": "integer",
"description": "Coins the merged market feed returned with a usable price"
},
"sources": {
"type": "array",
"items": {
"type": "string"
}
},
"analyzed": {
"type": "integer",
"description": "Shortlisted coins whose candles answered"
},
"screened": {
"type": "integer",
"description": "Every coin passing the liquidity floors — the universe every cross-sectional percentile is computed against, whatever tier or symbols were requested"
},
"selected": {
"type": "integer",
"description": "Coins left after the tier/symbol narrowing — the set the shortlist is drawn from. Equal to screened when nothing was filtered."
},
"perpCovered": {
"type": "integer",
"description": "Coins with a venue perp context, the source of the 24h volume floor"
},
"fastInterval": {
"type": "string",
"description": "The timeframe every level in this report is measured on"
},
"slowInterval": {
"type": "string",
"description": "The confirmation timeframe; absent when only one interval was requested, in which case the trend vote abstains"
},
"technicalsFailed": {
"type": "integer",
"description": "Shortlisted coins whose candles did not answer; their candidates carry Stage A signals only"
},
"priceDisagreements": {
"type": "array",
"items": {
"type": "object",
"properties": {
"symbol": {
"type": "string"
},
"mergePriceUsd": {
"type": "number"
},
"candleCloseUsd": {
"type": "number"
}
}
},
"description": "Shortlisted coins whose candle series was DISCARDED because its newest close disagreed with the merged market price beyond the divergence band — a stale or mismatched series (e.g. a delisted pair a venue still serves). A wrong answer, not a missing one. These candidates carry Stage A signals only and are never priced."
}
},
"description": "What the scan actually looked at — read this before treating an empty candidate list as a quiet market"
},
"candidates": {
"type": "array",
"items": {
"type": "object",
"properties": {
"lean": {
"type": "string",
"description": "long, short, or empty. A lean, never a call; a COIL BREAKOUT carries none until a leg of its bracket fills."
},
"tier": {
"type": "string",
"description": "major or medium"
},
"score": {
"type": "integer",
"description": "Plain sum of signal votes"
},
"setup": {
"type": "string",
"description": "ABSORPTION SHORT (short at market) | TRENDING PULLBACK (at market, half at +1R) | BREAKDOWN (short at market) | COIL BREAKOUT (stop bracket) | EXTENDED | NO SETUP. EXTENDED is reported so it is NOT taken as an entry."
},
"symbol": {
"type": "string"
},
"signals": {
"type": "array",
"items": {
"type": "object",
"properties": {
"lean": {
"type": "string"
},
"name": {
"type": "string"
},
"vote": {
"type": "integer",
"description": "The signal's own reading: +1 supports a defined entry, -1 argues against one, 0 informational. Not summable with research_regime or research_positioning votes."
},
"state": {
"type": "string"
},
"detail": {
"type": "string",
"description": "The numbers behind the state, as prose"
},
"metrics": {
"type": "object",
"description": "The same numbers keyed by metric name, e.g. fundingUniversePercentile, bandwidthOwnPercentile, distanceFromEma20Atr",
"additionalProperties": {
"type": "number"
}
},
"contribution": {
"type": "integer",
"description": "What the signal contributed to the score once the setup's side was known. Equals vote except where the signal leans against that side, when the sign flips — a reading favouring the opposite side is evidence the entry would be joining the cohort that pays."
}
}
}
},
"backdrop": {
"type": "string",
"description": "with | against | empty: whether this candidate's side agrees with the market backdrop's direction. Shown, never scored."
},
"evidence": {
"type": "string",
"description": "passed | failed | none: whether this setup type passed its pre-registered backtest (beat random entries in both years after fees and funding). Only ABSORPTION SHORT passed; read a 'failed' plan as a described setup, not an edge. none = EXTENDED or NO SETUP, which carry no plan."
},
"geometry": {
"type": "object",
"properties": {
"rule": {
"type": "string"
},
"bracket": {
"type": [
"object",
"null"
],
"properties": {
"longStopUsd": {
"type": "number"
},
"longEntryUsd": {
"type": "number"
},
"shortStopUsd": {
"type": "number"
},
"longTargetUsd": {
"type": "number"
},
"shortEntryUsd": {
"type": "number"
},
"shortTargetUsd": {
"type": "number"
}
},
"description": "Both legs of a stop bracket: the first to trade fills and cancels the other"
},
"stopUsd": {
"type": "number"
},
"entryUsd": {
"type": "number",
"description": "Where the entry is placed, per orderType: the 4h EMA20 for a limit, the live price for market, the buy-stop for a stop bracket (see bracket for both legs)"
},
"freshness": {
"type": "string",
"description": "PENDING (limit not reached) | AT ENTRY (filling now) | THROUGH (passed the limit, stop still holds). Geometry is absent entirely when INVALIDATED — price is already at or beyond the stop."
},
"orderType": {
"type": "string",
"description": "limit | market | stop bracket"
},
"targetUsd": {
"type": "number"
},
"management": {
"type": [
"object",
"null"
],
"properties": {
"partialAtR": {
"type": "number"
},
"partialFraction": {
"type": "number"
},
"breakevenAfterPartial": {
"type": "boolean"
}
},
"description": "Post-fill management the plan was backtested with: take partialFraction at partialAtR from the fill, then move the stop on the rest to breakeven"
},
"rewardRisk": {
"type": "number",
"description": "Reported as computed, never adjusted to clear the 2:1 bar"
},
"entryGapAtr": {
"type": "number",
"description": "How far live price sits from the entry in ATR units, signed in the setup's favour: positive means the limit has not been reached yet, negative that price has passed it"
},
"targetBasis": {
"type": "string",
"description": "The structural level the target was shaded inside, named"
},
"livePriceUsd": {
"type": "number",
"description": "The live merged market price the entry was checked against"
},
"netRewardRisk": {
"type": "number",
"description": "Reward:risk net of base-tier fees (Binance: maker entry and target, taker stop). What the geometry pays; research_trade_plan adds carry and slippage."
},
"stopDistanceAtr": {
"type": "number",
"description": "Stop distance in ATR(14) units"
},
"stopDistancePct": {
"type": "number",
"description": "Stop distance as a percentage of entry"
},
"targetDistanceAtr": {
"type": "number",
"description": "Target distance in ATR(14) units. Read alongside rewardRisk: a tight stop with a distant target prices well and still asks price to travel a long way. R:R is geometry, never expectancy."
},
"breakEvenWinRatePct": {
"type": [
"number",
"null"
],
"description": "Win rate at which the setup breaks even net of those fees, in percent; null when a win doesn't cover its fees"
}
},
"description": "ATR-and-structure prices, ready for research_trade_plan. Absent for EXTENDED and NO SETUP, and whenever a plan was refused a price (see notPriced)."
},
"priceUsd": {
"type": "number"
},
"headlines": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"atMs": {
"type": "integer"
},
"kind": {
"type": "string",
"description": "article | tweet | exchange"
},
"coins": {
"type": "array",
"items": {
"type": "string"
},
"description": "The feed's own coin tags, a word match that can be wrong"
},
"title": {
"type": "string"
},
"impact": {
"type": [
"object",
"null"
],
"properties": {
"up": {
"type": "number"
},
"pct": {
"type": "number",
"description": "Net move over the window, percent"
},
"coin": {
"type": "string"
},
"down": {
"type": "number"
},
"windowMs": {
"type": "integer"
}
},
"description": "The move the feed measured on a tagged coin within the hour after the headline: what followed it, not proof it caused it"
}
}
},
"description": "Up to 3 headlines of the last 24h the feed tagged with this coin, newest first. Shown, never scored."
},
"timeframes": {
"type": "array",
"items": {
"type": "string"
},
"description": "Intervals whose candles answered; empty means Stage A signals only"
},
"change24hPct": {
"type": "number"
},
"marketCapUsd": {
"type": "number"
},
"signalsTotal": {
"type": "integer"
},
"dayNotionalUsd": {
"type": "number",
"description": "24h perp notional volume, USD"
},
"tierFromVolume": {
"type": "boolean",
"description": "True when no market-cap source answered and the tier was inferred from 24h volume instead — a weaker claim than a size tier, and those rows carry no leverage signal"
},
"signalsComputed": {
"type": "integer"
}
}
}
},
"marketShock": {
"type": [
"object",
"null"
],
"properties": {
"atMs": {
"type": "integer",
"description": "When the guard started (the hour after the crossing close)"
},
"untilMs": {
"type": "integer",
"description": "When the guard lapses"
},
"changePct": {
"type": "number",
"description": "BTC's 24h change at the hour that crossed"
},
"direction": {
"type": "string",
"description": "up | down"
},
"notPricedSide": {
"type": "string",
"description": "long | short: the TRENDING PULLBACK side not priced"
}
},
"description": "The BTC shock whose guard is active, or null. After BTC's hourly close first sits 6% or more from its close 24h earlier, for 168h a TRENDING PULLBACK on notPricedSide (against the move) is not priced; those candidates say so in notPriced. In the backtest such plans lost (−0.05R a trade out of sample, −0.10R in sample, against about 0R otherwise). Loss avoidance, not an edge for the other side."
},
"absorptionToday": {
"type": [
"object",
"null"
],
"properties": {
"read": {
"type": "integer",
"description": "Coins whose taker flow answered and could be ranked"
},
"count": {
"type": "integer"
},
"fired": {
"type": "array",
"items": {
"type": "string"
}
}
},
"description": "How many selected coins fired the ABSORPTION SHORT reading on the last closed UTC day. Descriptive only: in the backtest the count did not separate results (days it fired widely +0.18R per trade, other days +0.16R), so a high count is not a better trade. Null when the reading was not taken (a fast interval other than 4h)."
},
"exchangeNotices": {
"type": "array",
"description": "Scheduled and recent (within 7 days) exchange listings and delistings for the coins in this answer; see catalysts_exchange_listings. Shown, never scored."
},
"requestedSymbols": {
"type": "array",
"items": {
"type": "object",
"properties": {
"detail": {
"type": "string",
"description": "The numbers behind the status, with the floor each was measured against"
},
"status": {
"type": "string",
"description": "selected | tier_excluded | below_liquidity_floors | below_tier_floor | not_quoted | excluded | alias"
},
"symbol": {
"type": "string"
}
}
},
"description": "One entry per symbol named in the 'symbols' argument, so a symbol missing from 'candidates' can be explained. Empty when no symbols were named. A status other than 'selected' means no band was applied to that coin, so its absence says nothing about its setup."
}
}
},
"annotations": {
"readOnlyHint": true
}
}{
"name": "research_positioning",
"title": "Positioning Analysis",
"description": "Deterministic positioning read for one coin — the game-state companion to research_regime, answering 'who is crowded, who is paying, who is trapped, and where'. Up to nine axes, each tagged with the market-actor cohort it reads: crowding (annualized funding vs the venue-standard 0.01%/8h anchor, long/short skew, dollars/day the majority pays to hold, crowd-vs-top-trader divergence, and cross-venue funding dispersion), buildup (24h price vs open-interest direction and the funding trend — whether positions are being added into the move or closed out), liquidity (order-book spread and imbalance — makers backing off), basis (perp vs oracle premium — spot-perp froth or hedging pressure, informational), fragility (24h liquidations as a share of market-wide open interest; the axis degrades rather than substituting a single venue's OI, since the liquidation total is cross-exchange), predation (visible Hyperliquid whale positions within 2 daily sigmas of their liquidation price, with defending book depth), trap (share of tracked whale notional underwater on the funding-paying side — attrition fuel), house book (Hyperliquid HLP LP-vault inventory, summed across its child sub-vaults — the literal venue counterparty, so the inventory it carries mirrors how traders are crowded; measured as net over its own gross book, since a market maker's net is a rounding error against venue open interest; informational), and disagreement (the most liquid matching prediction market, volume-gated, informational). Each axis reports its state, the numbers, and a +1/0/-1 fragility vote (+1 clean, -1 crowded/fragile); the stance is the disclosed sum-of-votes rule. Also returns a one-line 'farmed' synthesis (which cohort the board is currently farming, or an explicit statement that none is), focal points — reachable liquidation and breakeven price levels the whole market can see — and 'would change the call' thresholds a polling agent can watch statelessly. Reports the board, not a direction: crowding says who is paying, not where price goes. Deterministic — same inputs, same read. Call research_regime first for market context, then this per coin before sizing or timing decisions.",
"inputSchema": {
"type": "object",
"required": [
"symbol"
],
"properties": {
"symbol": {
"type": "string",
"description": "Coin symbol, e.g. \"BTC\" or \"ETH\"."
}
}
},
"outputSchema": {
"type": "object",
"properties": {
"axes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"vote": {
"type": "integer",
"description": "+1 clean, -1 crowded/fragile, 0 neutral or informational"
},
"state": {
"type": "string"
},
"actors": {
"type": "string",
"description": "The market-actor cohort(s) this axis reads — the counterparty tag"
},
"detail": {
"type": "string",
"description": "The numbers behind the state, as prose"
},
"metrics": {
"type": "object",
"description": "The same numbers keyed by metric name, e.g. annualizedFundingPct, trappedShare",
"additionalProperties": {
"type": "number"
}
}
}
}
},
"farmed": {
"type": "string",
"description": "One-line synthesis of which cohort the board is currently farming. Always populated: when no cohort clears the trap/crowding/predation bars it says so explicitly and names who is paying the carry."
},
"stance": {
"type": "string",
"description": "Overall positioning-fragility label"
},
"symbol": {
"type": "string"
},
"options": {
"type": "object",
"description": "Informational option-holder cohort read from Deribit (OI notional, put/call OI, 25-delta skew, next expiry and theoretical max pain) and the modeled gamma state (under gamma). Never votes; present when the coin has listed options."
},
"axesTotal": {
"type": "integer"
},
"stanceRule": {
"type": "string",
"description": "The exact rule that produced stance"
},
"thresholds": {
"type": "array",
"items": {
"type": "object",
"properties": {
"value": {
"type": "number",
"description": "The disclosed flip threshold"
},
"metric": {
"type": "string"
},
"current": {
"type": "number",
"description": "Where the metric stands now"
},
"flipsTo": {
"type": "string",
"description": "The state the axis flips to at the threshold"
},
"comparator": {
"type": "string",
"description": ">= or <="
}
}
},
"description": "The wouldChange lines in machine-readable form for stateless alerting"
},
"focalPoints": {
"type": "array",
"items": {
"type": "object",
"properties": {
"side": {
"type": "string",
"description": "e.g. long liquidation, short liquidation, long breakeven"
},
"reason": {
"type": "string",
"description": "The position behind the level"
},
"priceUsd": {
"type": "number",
"description": "A known price level: a visible liquidation or a breakeven exit level"
}
}
},
"description": "Price levels that are common knowledge on the board, nearest to spot first"
},
"skippedAxes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"reason": {
"type": "string",
"description": "The feed that was offline, or what the coin lacks"
}
}
},
"description": "Axes attempted but not computed; the stance is over the computed ones only"
},
"wouldChange": {
"type": "array",
"items": {
"type": "string"
},
"description": "Thresholds that would flip an axis, as prose"
},
"axesComputed": {
"type": "integer"
},
"exchangeNotices": {
"type": "array",
"description": "Scheduled and recent (within 7 days) exchange listings and delistings for the coins in this answer; see catalysts_exchange_listings. Shown, never scored."
}
}
},
"annotations": {
"readOnlyHint": true
}
}| number |
| Stop-loss price (below entry = long, above = short) |
| entry * | number | Planned entry price |
| venue | string | Optional venue whose base-tier fees to apply. Default binance (5 bps taker, 2 bps maker). |
| symbol * | string | Coin symbol, e.g. "ETH". |
| target | number | Optional take-profit price |
| fee_bps | number | Optional taker fee per fill in bps of notional (e.g. 4.5), when the user states their own fee tier. Overrides the venue's. |
| leverage | number | Optional leverage the position is opened at, 1–200, for the liquidation price. Default when sized: the smallest whole leverage that carries the notional; unsized: no liquidation price unless given. |
| placed_at | string | When the order was placed, as ISO 8601 (e.g. 2026-10-14T12:00:00Z) or unix time, up to 90 days back. Pass it whenever the user says when the trade was placed or opened ('placed 2026-10-12T12:00Z', 'opened yesterday at 14:00'): with it the tool replays the trade and reports filled / stopped / target … |
| hold_hours | number | Optional expected holding time in hours, e.g. 72 for three days: prices the funding carry over the hold into the net reward:risk. |
| order_type | string | How the entry was placed, for the replay. limit (default): fills when price comes to the entry, or at once if the entry was already on the far side of the market. stop: a breakout trigger that fills when price comes through the entry. market: filled at placement. Omit it when the user hasn't said: i… |
| account_size | number | Optional account equity in USD, with risk_percent: adds the position size, notional and margin. Leave both out when the user didn't give them. |
| risk_percent | number | Optional percent of the account lost if the stop is hit, e.g. 1; only with account_size |
| maker_fee_bps | number | Optional maker fee per fill in bps (negative for a rebate). Overrides the venue's. |
{
"name": "research_trade_plan",
"title": "Trade Plan Check & Replay",
"description": "Check, review or replay a perp trade setup (entry, stop, optional target), before it is placed or after: the tool for 'check this setup', 'is this trade good' and 'how did my trade do'. Renders an interactive trade ticket. Give the coin, entry and stop; optionally target, leverage, order type, placed_at, and account size with risk percent. Returns reward:risk, the stop's distance in % and 4h ATR, the isolated liquidation price at the leverage (first-tier 0.5% maintenance margin, so the optimistic case), funding per day at the current rate (in % of notional, and in USD when sized), the perp levels around the setup (from flow_levels: volume nodes, value area, liquidation clusters, entries, walls), and named checks: liquidation before the stop, price already through the stop, a stop inside one ATR of noise, a stop just in front of a level a wick would reach for, a level between entry and target, reward:risk under 2:1, costs that pull a 2:1 plan under it, leverage over 10x, and an entry far from live. Costs: fees per fill (a venue's base tier, Binance by default; override with venue, fee_bps, maker_fee_bps), funding carry over hold_hours at the current rate with the rate's 1y percentile, and, when sized, the slippage of a market exit of the whole size at the stop against today's visible book; they give a net reward:risk, the break-even win rate, and the stop, target and liquidation outcomes in R (and USD and % of account when sized). Everything reads in R and % without an account; give account_size and risk_percent (both or neither) to add the fixed-fractional size, notional and margin. Pass placed_at (when the order was placed) to replay the setup since then from public candles, filling the entry by order_type: a limit fills when price comes to it (or at once if it was already marketable, e.g. a buy limit above the market), a stop entry when price comes through it, a market order at placement; R is measured from the actual fill. Statuses: PENDING, MISSED (target traded before the entry), OPEN with the result and best/worst so far in R, STOPPED, TARGET, or AMBIGUOUS when one candle reached both; plus funding paid while open. Nothing about the plan is stored: the numbers come in, the replay goes out, and planLine is the one-line copy to bring the plan back later. Use it after research_opportunities or flow_levels has suggested a setup; it is a check of the setup, not a signal.",
"inputSchema": {
"type": "object",
"required": [
"symbol",
"entry",
"stop"
],
"properties": {
"stop": {
"type": "number",
"description": "Stop-loss price (below entry = long, above = short)"
},
"entry": {
"type": "number",
"description": "Planned entry price"
},
"venue": {
"enum": [
"binance",
"bybit",
"okx",
"hyperliquid",
"bingx",
"bitget"
],
"type": "string",
"description": "Optional venue whose base-tier fees to apply. Default binance (5 bps taker, 2 bps maker)."
},
"symbol": {
"type": "string",
"description": "Coin symbol, e.g. \"ETH\"."
},
"target": {
"type": "number",
"description": "Optional take-profit price"
},
"fee_bps": {
"type": "number",
"description": "Optional taker fee per fill in bps of notional (e.g. 4.5), when the user states their own fee tier. Overrides the venue's."
},
"leverage": {
"type": "number",
"description": "Optional leverage the position is opened at, 1–200, for the liquidation price. Default when sized: the smallest whole leverage that carries the notional; unsized: no liquidation price unless given."
},
"placed_at": {
"type": "string",
"description": "When the order was placed, as ISO 8601 (e.g. 2026-10-14T12:00:00Z) or unix time, up to 90 days back. Pass it whenever the user says when the trade was placed or opened ('placed 2026-10-12T12:00Z', 'opened yesterday at 14:00'): with it the tool replays the trade and reports filled / stopped / target / open; without it the plan is checked as if not yet placed."
},
"hold_hours": {
"type": "number",
"description": "Optional expected holding time in hours, e.g. 72 for three days: prices the funding carry over the hold into the net reward:risk."
},
"order_type": {
"enum": [
"limit",
"stop",
"market"
],
"type": "string",
"description": "How the entry was placed, for the replay. limit (default): fills when price comes to the entry, or at once if the entry was already on the far side of the market. stop: a breakout trigger that fills when price comes through the entry. market: filled at placement. Omit it when the user hasn't said: if the entry was through the market at placement, one call returns both readings (lifecycle as a limit, alternativeLifecycle as a stop); ask the user which applies rather than calling again. Also sets the entry fee: a resting limit pays maker, anything else taker."
},
"account_size": {
"type": "number",
"description": "Optional account equity in USD, with risk_percent: adds the position size, notional and margin. Leave both out when the user didn't give them."
},
"risk_percent": {
"type": "number",
"description": "Optional percent of the account lost if the stop is hit, e.g. 1; only with account_size"
},
"maker_fee_bps": {
"type": "number",
"description": "Optional maker fee per fill in bps (negative for a rebate). Overrides the venue's."
}
}
},
"outputSchema": {
"type": "object",
"required": [
"symbol",
"direction",
"entryUsd",
"stopUsd",
"stopDistancePct",
"leverageAssumed",
"maintenanceMarginRate",
"costs",
"atrInterval",
"checks",
"levels",
"guidance",
"planLine",
"sourcesFailed",
"rules"
],
"properties": {
"costs": {
"type": "object",
"required": [
"takerFeeBps",
"makerFeeBps",
"feeBasis",
"entryFill",
"stopSlippageComplete",
"scenarios"
],
"properties": {
"carryR": {
"type": "number",
"description": "Funding carry over the hold, in R"
},
"carryPct": {
"type": "number",
"description": "Funding carry over the hold, percent of notional"
},
"carryUsd": {
"type": "number",
"description": "Funding carry over the hold, USD; sized plans only"
},
"feeBasis": {
"type": "string",
"description": "Where the fee schedule comes from"
},
"entryFill": {
"enum": [
"maker",
"taker"
],
"type": "string",
"description": "Which fee the entry pays"
},
"holdHours": {
"type": "number",
"description": "Holding time the carry is priced over, hours"
},
"scenarios": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"priceUsd",
"r",
"ifStopFails"
],
"properties": {
"r": {
"type": "number",
"description": "Result in R (multiples of the planned risk)"
},
"name": {
"type": "string"
},
"pnlUsd": {
"type": "number",
"description": "Result, USD; sized plans only"
},
"priceUsd": {
"type": "number",
"description": "Exit price, USD"
},
"accountPct": {
"type": "number",
"description": "Result, percent of the account; sized plans only"
},
"ifStopFails": {
"type": "boolean",
"description": "A liquidation the stop closes the trade before: reached only if the stop fails to fill"
}
}
},
"description": "How the trade can end, net of costs"
},
"makerFeeBps": {
"type": "number",
"description": "Maker fee per fill, bps of notional (negative is a rebate)"
},
"takerFeeBps": {
"type": "number",
"description": "Taker fee per fill, bps of notional"
},
"netRewardRisk": {
"type": "number",
"description": "Reward over risk after fees, slippage and carry"
},
"stopSlippageBps": {
"type": "number",
"description": "Slippage of a market exit at the stop against the visible book, bps; sized plans only"
},
"breakEvenWinRatePct": {
"type": "number",
"description": "Win rate that breaks even after costs, percent"
},
"stopSlippageComplete": {
"type": "boolean",
"description": "False when the visible book could not fill the whole exit"
},
"grossBreakEvenWinRatePct": {
"type": "number",
"description": "Win rate that breaks even before costs, percent"
}
},
"description": "What running the plan costs beyond its geometry, and the outcomes net of it"
},
"rules": {
"type": "string",
"description": "The check rules and constants in words"
},
"atrUsd": {
"type": "number",
"description": "14-period ATR on atrInterval candles, USD; absent without usable candles"
},
"checks": {
"type": "array",
"items": {
"type": "object",
"required": [
"code",
"severity",
"text"
],
"properties": {
"code": {
"type": "string",
"description": "Stable check id"
},
"text": {
"type": "string",
"description": "The finding in words"
},
"severity": {
"enum": [
"danger",
"warn",
"info"
],
"type": "string"
}
}
},
"description": "Named findings about the plan"
},
"levels": {
"type": "array",
"items": {
"type": "object",
"required": [
"priceLo",
"priceHi",
"kind",
"evidence",
"strength",
"outsized"
],
"properties": {
"kind": {
"type": "string",
"description": "Level kind, e.g. volume node, liquidation cluster"
},
"priceHi": {
"type": "number",
"description": "Zone high, USD"
},
"priceLo": {
"type": "number",
"description": "Zone low, USD"
},
"evidence": {
"type": "string"
},
"outsized": {
"type": "boolean"
},
"strength": {
"type": "number"
}
}
},
"description": "Perp levels around the setup, from flow_levels"
},
"sizing": {
"type": "object",
"required": [
"riskAmountUsd",
"positionSizeUnits",
"positionNotionalUsd",
"impliedLeverage"
],
"properties": {
"riskAmountUsd": {
"type": "number",
"description": "Amount lost at the stop, USD"
},
"impliedLeverage": {
"type": "number",
"description": "Notional over account, as a multiple"
},
"positionSizeUnits": {
"type": "number",
"description": "Position size, coin units"
},
"positionNotionalUsd": {
"type": "number",
"description": "Position notional, USD"
}
},
"description": "Fixed-fractional size; present only when account_size and risk_percent were given"
},
"symbol": {
"type": "string"
},
"options": {
"type": "object",
"description": "Options-implied move over the hold window (Deribit ATM IV), stop/target in implied sigma, risk-neutral stop/target odds and modeled gamma levels (under gamma). Its checks also appear in checks with source options. Present when the coin has listed options and the plan is not a closed replay."
},
"stopUsd": {
"type": "number",
"description": "Stop-loss, USD"
},
"entryUsd": {
"type": "number",
"description": "Planned entry, USD"
},
"guidance": {
"type": "array",
"items": {
"type": "string"
},
"description": "Instructions for the model"
},
"leverage": {
"type": "number",
"description": "Leverage used for the liquidation price, as a multiple; absent when unsized and not given"
},
"planLine": {
"type": "string",
"description": "One-line copy of the plan to bring it back later"
},
"direction": {
"enum": [
"long",
"short"
],
"type": "string",
"description": "Side implied by stop below (long) or above (short) the entry"
},
"lifecycle": {
"type": "object",
"required": [
"status",
"orderType",
"placedAtMs",
"interval",
"events",
"entryThroughMarket",
"notes"
],
"properties": {
"bestR": {
"type": "number",
"description": "Best excursion after the fill, R"
},
"notes": {
"type": "array",
"items": {
"type": "string"
},
"description": "What the replay cannot resolve from candles"
},
"events": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"timeMs",
"priceUsd"
],
"properties": {
"kind": {
"type": "string",
"description": "filled, stopped or target"
},
"timeMs": {
"type": "integer",
"description": "Unix epoch milliseconds"
},
"priceUsd": {
"type": "number",
"description": "Price, USD"
}
}
}
},
"status": {
"enum": [
"PENDING",
"MISSED",
"OPEN",
"STOPPED",
"TARGET",
"AMBIGUOUS"
],
"type": "string",
"description": "Where the order stands: PENDING (entry not reached), MISSED (target traded before the entry), OPEN, STOPPED, TARGET, AMBIGUOUS (stop and target in one candle)"
},
"worstR": {
"type": "number",
"description": "Worst excursion after the fill, R"
},
"resultR": {
"type": "number",
"description": "Result in R (multiples of the planned risk): realized at an exit, mark-to-market while open"
},
"interval": {
"type": "string",
"description": "Candle interval replayed"
},
"orderType": {
"enum": [
"limit",
"stop",
"market"
],
"type": "string",
"description": "Entry order the replay assumed"
},
"placedAtMs": {
"type": "integer",
"description": "When the order was placed, Unix epoch milliseconds"
},
"fundingBasis": {
"type": "string",
"description": "How funding was measured: history or current rate"
},
"coveredFromMs": {
"type": "integer",
"description": "Earliest candle seen, Unix epoch milliseconds; later than placedAtMs means that stretch is unknown"
},
"fundingPaidPct": {
"type": "number",
"description": "Funding paid (positive) or received, percent of notional"
},
"fundingPaidUsd": {
"type": "number",
"description": "Funding paid (positive) or received over the open period, USD; sized plans only"
},
"entryThroughMarket": {
"type": "boolean",
"description": "The entry was already through the market when placed, so a limit and a stop order are different trades"
}
},
"description": "Replay of the order since placed_at; present only when placed_at was given and candles were available"
},
"marginUsd": {
"type": "number",
"description": "Isolated margin, USD; absent without a size"
},
"targetUsd": {
"type": "number",
"description": "Take-profit, USD; absent when none was given"
},
"accountUsd": {
"type": "number",
"description": "Account equity, USD; absent when not given"
},
"rewardRisk": {
"type": "number",
"description": "Reward over risk; absent without a target on the profit side"
},
"atrInterval": {
"type": "string",
"description": "Candle interval ATR is measured on"
},
"riskPercent": {
"type": "number",
"description": "Percent of the account lost if the stop is hit; absent when not given"
},
"livePriceUsd": {
"type": "number",
"description": "Live price, USD; absent when no price source covers the coin"
},
"sourcesFailed": {
"type": "array",
"items": {
"type": "object",
"required": [
"source",
"error"
],
"properties": {
"error": {
"type": "string"
},
"source": {
"type": "string"
}
}
},
"description": "Inputs that were unavailable"
},
"leverageAssumed": {
"type": "boolean",
"description": "True when leverage was derived as the smallest whole leverage that carries the notional"
},
"stopDistancePct": {
"type": "number",
"description": "Entry to stop in percent of entry: the size of 1R"
},
"fundingPctPerDay": {
"type": "number",
"description": "Funding paid (positive) or received per day at the current rate, percent of notional"
},
"fundingRateBasis": {
"type": "string",
"description": "Which funding leg the rate is, as funding_current labels it"
},
"fundingUsdPerDay": {
"type": "number",
"description": "The same in USD; sized plans only"
},
"fundingBaseline1y": {
"type": "object",
"required": [
"percentile",
"days",
"medianPctPerHour",
"lowPctPerHour",
"highPctPerHour"
],
"properties": {
"days": {
"type": "integer",
"description": "Settled days ranked against"
},
"percentile": {
"type": "number",
"description": "Rank among the year's settled daily closes, 0-100"
},
"lowPctPerHour": {
"type": "number",
"description": "Year's low, percent per hour"
},
"highPctPerHour": {
"type": "number",
"description": "Year's high, percent per hour"
},
"medianPctPerHour": {
"type": "number",
"description": "Year's median, percent per hour"
}
},
"description": "The current rate ranked against a year of daily closes; absent when there is no baseline"
},
"liquidationPriceUsd": {
"type": "number",
"description": "Isolated liquidation price at the leverage, USD (first-tier maintenance margin, before fees)"
},
"alternativeLifecycle": {
"type": "object",
"required": [
"status",
"orderType",
"placedAtMs",
"interval",
"events",
"entryThroughMarket",
"notes"
],
"properties": {
"bestR": {
"type": "number",
"description": "Best excursion after the fill, R"
},
"notes": {
"type": "array",
"items": {
"type": "string"
},
"description": "What the replay cannot resolve from candles"
},
"events": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind",
"timeMs",
"priceUsd"
],
"properties": {
"kind": {
"type": "string",
"description": "filled, stopped or target"
},
"timeMs": {
"type": "integer",
"description": "Unix epoch milliseconds"
},
"priceUsd": {
"type": "number",
"description": "Price, USD"
}
}
}
},
"status": {
"enum": [
"PENDING",
"MISSED",
"OPEN",
"STOPPED",
"TARGET",
"AMBIGUOUS"
],
"type": "string",
"description": "Where the order stands: PENDING (entry not reached), MISSED (target traded before the entry), OPEN, STOPPED, TARGET, AMBIGUOUS (stop and target in one candle)"
},
"worstR": {
"type": "number",
"description": "Worst excursion after the fill, R"
},
"resultR": {
"type": "number",
"description": "Result in R (multiples of the planned risk): realized at an exit, mark-to-market while open"
},
"interval": {
"type": "string",
"description": "Candle interval replayed"
},
"orderType": {
"enum": [
"limit",
"stop",
"market"
],
"type": "string",
"description": "Entry order the replay assumed"
},
"placedAtMs": {
"type": "integer",
"description": "When the order was placed, Unix epoch milliseconds"
},
"fundingBasis": {
"type": "string",
"description": "How funding was measured: history or current rate"
},
"coveredFromMs": {
"type": "integer",
"description": "Earliest candle seen, Unix epoch milliseconds; later than placedAtMs means that stretch is unknown"
},
"fundingPaidPct": {
"type": "number",
"description": "Funding paid (positive) or received, percent of notional"
},
"fundingPaidUsd": {
"type": "number",
"description": "Funding paid (positive) or received over the open period, USD; sized plans only"
},
"entryThroughMarket": {
"type": "boolean",
"description": "The entry was already through the market when placed, so a limit and a stop order are different trades"
}
},
"description": "The stop-entry reading, present when order_type was not given and the entry was through the market at placement"
},
"fundingRatePctPerHour": {
"type": "number",
"description": "Current funding rate, percent per hour; positive means longs pay"
},
"maintenanceMarginRate": {
"type": "number",
"description": "Maintenance margin as a fraction of notional (0.005 = 0.5%)"
}
}
},
"annotations": {
"readOnlyHint": true
}
}