Crypto market intelligence: prices, funding rates, narratives, regime, and delta-neutral research.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Ask Shumi any crypto-market question in natural language. Shumi classifies the query, fetches the relevant data, and returns a synthesized answer. Use this when no specific typed tool fits, or for multi-part / comparative questions.
The natural-language question, e.g. "is funding extreme on SOL right now?".
Specialization path (default "base"; e.g. "perp-dex").
Ask Shumi any crypto-market question in natural language. Shumi classifies the query, fetches the relevant data, and returns a synthesized answer. Use this when no specific typed tool fits, or for multi-part / comparative questions.
| Argument | Type | Description |
|---|---|---|
| query* | string | The natural-language question, e.g. "is funding extreme on SOL right now?". |
| archetype | string | Specialization path (default "base"; e.g. "perp-dex"). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"minLength": 1,
"description": "The natural-language question, e.g. \"is funding extreme on SOL right now?\"."
},
"archetype": {
"type": "string",
"description": "Specialization path (default \"base\"; e.g. \"perp-dex\")."
}
}
}Daily snapshots of the tracked basket — composition and performance over time.
| Argument | Type | Description |
|---|---|---|
| top | integer | Keep only the first N items (default 50). Raise for more, lower to save tokens. |
| fields | string | Token-saving: comma-separated top-level fields to keep. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"top": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Keep only the first N items (default 50). Raise for more, lower to save tokens.",
"exclusiveMinimum": 0
},
"fields": {
"type": "string",
"description": "Token-saving: comma-separated top-level fields to keep."
}
}
}Detail for one category. view=info (trend breakdown), coins (member coins), sentiment.
| Argument | Type | Description |
|---|---|---|
| top | integer | Keep only the first N items (default 50). Raise for more, lower to save tokens. |
| name* | string | Category name, e.g. "Layer 2". |
| view | string | Which category view to return. |
| fields | string | Token-saving: comma-separated top-level fields to keep. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name"
],
"properties": {
"top": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Keep only the first N items (default 50). Raise for more, lower to save tokens.",
"exclusiveMinimum": 0
},
"name": {
"type": "string",
"minLength": 1,
"description": "Category name, e.g. \"Layer 2\"."
},
"view": {
"enum": [
"info",
"coins",
"sentiment"
],
"type": "string",
"default": "info",
"description": "Which category view to return."
},
"fields": {
"type": "string",
"description": "Token-saving: comma-separated top-level fields to keep."
}
}
}Market cap, volume, open interest, funding rate and price for a coin AS OF a chosen point in the past. Returns a single snapshot, not a series: call it once per point you want to compare (e.g. amount=7 interval=d for a week ago, then again with no offset for now). Use this to answer "how has funding/open interest changed since…".
| Argument | Type | Description |
|---|---|---|
| amount | integer | How far back to look, in units of `interval`. Omit for the most recent snapshot. |
| symbol* | string | Coin symbol, e.g. ETH. |
| interval | string | Unit for `amount`: h (hours) or d (days). Defaults to hours. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol"
],
"properties": {
"amount": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "How far back to look, in units of `interval`. Omit for the most recent snapshot."
},
"symbol": {
"type": "string",
"minLength": 1,
"description": "Coin symbol, e.g. ETH."
},
"interval": {
"enum": [
"h",
"d"
],
"type": "string",
"description": "Unit for `amount`: h (hours) or d (days). Defaults to hours."
}
}
}Bundled risk context for one or more coins: price, funding APR, deterministic funding_paying_side, funding_receiving_side, carry_if_long and carry_if_short fields, daily/weekly trend, sentiment stance, and BTC correlation. Funding applies to perpetual positions only; spot positions neither pay nor receive it. Relay the carry fields exactly rather than inferring direction from crowding. The best single tool for "should I be worried about X".
| Argument | Type | Description |
|---|---|---|
| symbols* | any | Symbols as an array ["BTC","ETH","SOL"] or a comma-separated string "BTC,ETH,SOL". 1-15 of them. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbols"
],
"properties": {
"symbols": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"minLength": 1
}
},
{
"type": "string",
"minLength": 1
}
],
"description": "Symbols as an array [\"BTC\",\"ETH\",\"SOL\"] or a comma-separated string \"BTC,ETH,SOL\". 1-15 of them."
}
}
}On-chain/social sentiment aggregates for a single coin.
| Argument | Type | Description |
|---|---|---|
| symbol* | string | Coin symbol, e.g. BTC. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol"
],
"properties": {
"symbol": {
"type": "string",
"minLength": 1,
"description": "Coin symbol, e.g. BTC."
}
}
}Discrete funding-rate alert events (asset, trigger zone, funding at trigger, fired-at time).
| Argument | Type | Description |
|---|---|---|
| top | integer | Keep only the first N items (default 50). Raise for more, lower to save tokens. |
| fields | string | Token-saving: comma-separated top-level fields to keep. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"top": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Keep only the first N items (default 50). Raise for more, lower to save tokens.",
"exclusiveMinimum": 0
},
"fields": {
"type": "string",
"description": "Token-saving: comma-separated top-level fields to keep."
}
}
}Perpetual funding-rate positioning context, market-wide or for one symbol. APR is already in percent units (1.7 = 1.7%). Positive funding means longs pay and shorts receive; negative funding means shorts pay and longs receive. Funding is context only, not a standalone directional, timing, or entry signal.
| Argument | Type | Description |
|---|---|---|
| symbol | string | Restrict to one symbol, e.g. BTC. Omit for the market-wide view. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"symbol": {
"type": "string",
"description": "Restrict to one symbol, e.g. BTC. Omit for the market-wide view."
}
}
}Perpetual-futures signal engine. view=state (currently open signals), log (recent fires), history (one asset's past signals — needs asset).
| Argument | Type | Description |
|---|---|---|
| top | integer | Keep only the first N items (default 50). Raise for more, lower to save tokens. |
| view | string | Which futures view to return. |
| asset | string | Asset symbol, e.g. BTC. Required when view="history". |
| fields | string | Token-saving: comma-separated top-level fields to keep. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"top": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Keep only the first N items (default 50). Raise for more, lower to save tokens.",
"exclusiveMinimum": 0
},
"view": {
"enum": [
"state",
"log",
"history"
],
"type": "string",
"default": "state",
"description": "Which futures view to return."
},
"asset": {
"type": "string",
"description": "Asset symbol, e.g. BTC. Required when view=\"history\"."
},
"fields": {
"type": "string",
"description": "Token-saving: comma-separated top-level fields to keep."
}
}
}Global market aggregates: BTC dominance, total market cap, total volume.
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
}Tracked token-holder cohorts. view=watchlist (which token contracts are tracked), movements (recent holder-count changes for one contract). Answers "is the holder base growing or bleeding?".
| Argument | Type | Description |
|---|---|---|
| top | integer | Keep only the first N items (default 50). Raise for more, lower to save tokens. |
| view | string | Which holder view to return. |
| limit | integer | Max results. |
| fields | string | Token-saving: comma-separated top-level fields to keep. |
| contract | string | Token contract address. Required when view="movements". |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"top": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Keep only the first N items (default 50). Raise for more, lower to save tokens.",
"exclusiveMinimum": 0
},
"view": {
"enum": [
"watchlist",
"movements"
],
"type": "string",
"default": "watchlist",
"description": "Which holder view to return."
},
"limit": {
"type": "integer",
"maximum": 200,
"description": "Max results.",
"exclusiveMinimum": 0
},
"fields": {
"type": "string",
"description": "Token-saving: comma-separated top-level fields to keep."
},
"contract": {
"type": "string",
"description": "Token contract address. Required when view=\"movements\"."
}
}
}The most recent regime crossing — when one trend cohort (UP/HODL/DOWN) overtook another market-wide. Answers "has the market flipped?". Returns an empty `crossings` array plus a message when no crossing has fired.
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
}Overall market health: the UP/HODL/DOWN trend distribution and extreme movers. Set context for the full bundle.
| Argument | Type | Description |
|---|---|---|
| context | boolean | Include the full market-context bundle (breadth velocity, regime age, leadership). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"context": {
"type": "boolean",
"description": "Include the full market-context bundle (breadth velocity, regime age, leadership)."
}
}
}Aggregate market sentiment. view=market/latest/summary (overall), narratives, categories, slopes/entity-slopes (what is trending), health (pipeline status).
| Argument | Type | Description |
|---|---|---|
| top | integer | Keep only the first N items (default 50). Raise for more, lower to save tokens. |
| view | string | Which sentiment view to return. |
| fields | string | Token-saving: comma-separated top-level fields to keep. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"top": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Keep only the first N items (default 50). Raise for more, lower to save tokens.",
"exclusiveMinimum": 0
},
"view": {
"enum": [
"market",
"latest",
"summary",
"narratives",
"categories",
"health",
"slopes",
"entity-slopes"
],
"type": "string",
"default": "market",
"description": "Which sentiment view to return."
},
"fields": {
"type": "string",
"description": "Token-saving: comma-separated top-level fields to keep."
}
}
}Sentiment and momentum for a single named narrative.
| Argument | Type | Description |
|---|---|---|
| name* | string | Narrative name, e.g. "AI coins". |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"minLength": 1,
"description": "Narrative name, e.g. \"AI coins\"."
}
}
}Pair-trading and delta-neutral funding-arbitrage intelligence. mode=suggestions (pair ideas), delta-neutral (funding arb), history (backtest), signal (state for a specific pair — needs token_a & token_b).
| Argument | Type | Description |
|---|---|---|
| top | integer | Keep only the first N items (default 50). Raise for more, lower to save tokens. |
| mode | string | Which pair view to return. |
| limit | integer | Max results. |
| fields | string | Token-saving: comma-separated top-level fields to keep. |
| symbol | string | Filter by symbol (suggestions / delta-neutral). |
| token_a | string | First token (required for mode="signal"), e.g. ETH. |
| token_b | string | Second token (required for mode="signal"), e.g. SOL. |
| dex_only | boolean | DEX exchanges only (delta-neutral). |
| exchange | string | Filter by exchange (delta-neutral). |
Bulk live prices, optionally with 4h/24h/7d baseline overlays. Omit symbols for the full tracked set.
| Argument | Type | Description |
|---|---|---|
| top | integer | Keep only the first N items (default 50). Raise for more, lower to save tokens. |
| fields | string | Token-saving: comma-separated top-level fields to keep. |
| symbols | any | Symbols as an array ["BTC","ETH"] or a comma-separated string "BTC,ETH". Omit for all tracked coins. |
| baselines | boolean | Include 4h/24h/7d baseline price overlay. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"top": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Keep only the first N items (default 50). Raise for more, lower to save tokens.",
"exclusiveMinimum": 0
},
"fields": {
"type": "string",
"description": "Token-saving: comma-separated top-level fields to keep."
},
"symbols": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"minLength": 1
}
},
{
"type": "string",
"minLength": 1
}
],
"description": "Symbols as an array [\"BTC\",\"ETH\"] or a comma-separated string \"BTC,ETH\". Omit for all tracked coins."
},
"baselines": {
"type": "boolean",
"description": "Include 4h/24h/7d baseline price overlay."
}
}
}Market regime signals. view=active (current positions), signals (all), confidence (scores). Provide symbol to get that symbol's regime history instead.
| Argument | Type | Description |
|---|---|---|
| view | string | Which regime view to return (ignored when symbol is set). |
| symbol | string | If set, returns regime history for this symbol. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"view": {
"enum": [
"active",
"signals",
"confidence"
],
"type": "string",
"default": "active",
"description": "Which regime view to return (ignored when symbol is set)."
},
"symbol": {
"type": "string",
"description": "If set, returns regime history for this symbol."
}
}
}Price, daily/weekly trend and perp funding for one real-world asset (stock, ETF, commodity, index, FX). Look up by ticker (AAPL, GOLD) or by namespaced id (xyz:AAPL). Funding belongs to the PERPETUAL CONTRACT, not the underlying — `funding.apr` is the annualized rate in percent, `funding.rate` is the raw per-hour fraction. Do not use the crypto coin tools for these.
| Argument | Type | Description |
|---|---|---|
| by | string | How `identifier` is interpreted. |
| identifier* | string | Ticker (AAPL, GOLD, SP500) or namespaced id (xyz:AAPL). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"identifier"
],
"properties": {
"by": {
"enum": [
"symbol",
"id"
],
"type": "string",
"default": "symbol",
"description": "How `identifier` is interpreted."
},
"identifier": {
"type": "string",
"minLength": 1,
"description": "Ticker (AAPL, GOLD, SP500) or namespaced id (xyz:AAPL)."
}
}
}Synthesized verdict for a coin, combining trend, funding, sentiment and regime.
| Argument | Type | Description |
|---|---|---|
| symbol* | string | Coin symbol, e.g. SOL. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol"
],
"properties": {
"symbol": {
"type": "string",
"minLength": 1,
"description": "Coin symbol, e.g. SOL."
}
}
}Signal validation envelope for an asset: Sharpe ratio, win rate, sample size, reliability tier.
| Argument | Type | Description |
|---|---|---|
| asset* | string | Asset symbol, e.g. BTC. |
| signal_type | string | Signal type (default: mean_reversion). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"asset"
],
"properties": {
"asset": {
"type": "string",
"minLength": 1,
"description": "Asset symbol, e.g. BTC."
},
"signal_type": {
"type": "string",
"description": "Signal type (default: mean_reversion)."
}
}
}Highlights mined from tracked video/podcast transcripts. view=highlights (extracted claims with the coins, sectors and macro tags they mention), sources (which channels are tracked). Answers "what are people actually saying about X?".
| Argument | Type | Description |
|---|---|---|
| top | integer | Keep only the first N items (default 50). Raise for more, lower to save tokens. |
| view | string | Which transcript view to return. |
| fields | string | Token-saving: comma-separated top-level fields to keep. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"top": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Keep only the first N items (default 50). Raise for more, lower to save tokens.",
"exclusiveMinimum": 0
},
"view": {
"enum": [
"highlights",
"sources"
],
"type": "string",
"default": "highlights",
"description": "Which transcript view to return."
},
"fields": {
"type": "string",
"description": "Token-saving: comma-separated top-level fields to keep."
}
}
}Upcoming token unlocks ACROSS THE MARKET when no single coin is named: each row has date, days until, coin, tokens, USD value, % of market cap, recipients and insider (team + investor) share, with its source. Defaults: next 7 days, top 500 coins, at least 0.5 % of market cap, ranked by % of market cap. Only coins DropsTab tracks; each recipient's next release only. Answers "biggest unlocks this week?", "big VC unlocks this month?". For one coin use get_unlocks.
| Argument | Type | Description |
|---|---|---|
| days | integer | Window in days from today (default 7). |
| sort | string | pct = biggest share of market cap (default), usd = biggest dollar value, date = soonest. |
| limit | integer | Rows to return (default 15). |
| minPct | number | Minimum size in % of market cap (default and floor 0.5). |
| maxRank | integer | Only coins up to this market-cap rank (default 500). |
| insidersOnly | boolean | Only unlocks with a team or investor leg. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"days": {
"type": "integer",
"maximum": 30,
"minimum": 1,
"description": "Window in days from today (default 7)."
},
"sort": {
"enum": [
"pct",
"usd",
"date"
],
"type": "string",
"description": "pct = biggest share of market cap (default), usd = biggest dollar value, date = soonest."
},
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Rows to return (default 15)."
},
"minPct": {
"type": "number",
"maximum": 100,
"minimum": 0.5,
"description": "Minimum size in % of market cap (default and floor 0.5)."
},
"maxRank": {
"type": "integer",
"maximum": 5000,
"minimum": 10,
"description": "Only coins up to this market-cap rank (default 500)."
},
"insidersOnly": {
"type": "boolean",
"description": "Only unlocks with a team or investor leg."
}
}
}Scheduled token unlocks for ONE coin: the next unlock (date, days until, tokens, USD value, % of market cap, recipients such as team/investors/ecosystem, cliff or monthly tranche), what releases over 30 and 90 days, % unlocked and locked, the final unlock date, the last unlock, and how price moved in the 7 days before and after its last 3-6 unlocks (history, not a forecast). Sources: DropsTab cross-checked with DefiLlama, each figure with its source link and fetch time; `state` says `upcoming`, `fully_unlocked`, `no_unlock_data` or `not_covered` (then `publishedSchedule` may carry the project's own vesting terms). Answers "when is ARB's next unlock?", "who gets the OP unlock?", "how did SUI trade around its unlocks?".
| Argument | Type | Description |
|---|---|---|
| coinId | string | Coin id (e.g. "arbitrum") when a previous result gave it; wins over the ticker when several coins share it. |
| symbol* | string | Coin ticker, e.g. ARB. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"symbol"
],
"properties": {
"coinId": {
"type": "string",
"description": "Coin id (e.g. \"arbitrum\") when a previous result gave it; wins over the ticker when several coins share it."
},
"symbol": {
"type": "string",
"maxLength": 20,
"minLength": 1,
"description": "Coin ticker, e.g. ARB."
}
}
}Tracked wallets. view=watchlist (which wallets are tracked), movements (recent balance changes for one wallet address). Answers "what did this wallet do recently?".
| Argument | Type | Description |
|---|---|---|
| top | integer | Keep only the first N items (default 50). Raise for more, lower to save tokens. |
| view | string | Which wallet view to return. |
| limit | integer | Max results. |
| fields | string | Token-saving: comma-separated top-level fields to keep. |
| address | string | Wallet address. Required when view="movements". |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"top": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Keep only the first N items (default 50). Raise for more, lower to save tokens.",
"exclusiveMinimum": 0
},
"view": {
"enum": [
"watchlist",
"movements"
],
"type": "string",
"default": "watchlist",
"description": "Which wallet view to return."
},
"limit": {
"type": "integer",
"maximum": 200,
"description": "Max results.",
"exclusiveMinimum": 0
},
"fields": {
"type": "string",
"description": "Token-saving: comma-separated top-level fields to keep."
},
"address": {
"type": "string",
"description": "Wallet address. Required when view=\"movements\"."
}
}
}List tracked crypto categories by their exact names (e.g. "Meme", "Layer-2"), the names scan_coins expects.
| Argument | Type | Description |
|---|---|---|
| top | integer | Keep only the first N items (default 50). Raise for more, lower to save tokens. |
| fields | string | Token-saving: comma-separated top-level fields to keep. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"top": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Keep only the first N items (default 50). Raise for more, lower to save tokens.",
"exclusiveMinimum": 0
},
"fields": {
"type": "string",
"description": "Token-saving: comma-separated top-level fields to keep."
}
}
}List the currently active market narratives (e.g. "AI coins", "DeFi summer").
| Argument | Type | Description |
|---|---|---|
| top | integer | Keep only the first N items (default 50). Raise for more, lower to save tokens. |
| fields | string | Token-saving: comma-separated top-level fields to keep. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"top": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Keep only the first N items (default 50). Raise for more, lower to save tokens.",
"exclusiveMinimum": 0
},
"fields": {
"type": "string",
"description": "Token-saving: comma-separated top-level fields to keep."
}
}
}List the tradable real-world assets — stocks and ETFs (AAPL, NVDA, SPY), metals and commodities (GOLD, SILVER, BRENT), stock indices (SP500, JP225) and FX. These trade as perps on Hyperliquid builder DEXes and are NOT crypto tokens; the crypto tools will not find them. Use this to answer "which stocks/commodities can I look at?".
| Argument | Type | Description |
|---|---|---|
| dex | string | Filter by builder-DEX slug, e.g. "xyz". |
| top | integer | Max assets to return (server default 200; the full universe is ~94). |
| type | string | Filter by asset class. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"dex": {
"type": "string",
"description": "Filter by builder-DEX slug, e.g. \"xyz\"."
},
"top": {
"type": "integer",
"maximum": 1000,
"description": "Max assets to return (server default 200; the full universe is ~94).",
"exclusiveMinimum": 0
},
"type": {
"enum": [
"equity",
"etf",
"commodity",
"index",
"fx"
],
"type": "string",
"description": "Filter by asset class."
}
}
}Look up a single coin and its core metrics (price, trend, metadata) by symbol, name, CoinGecko/internal id, or on-chain contract address. Read the coin's CURRENT trend from `currentTrend` ({ trend: UP|DOWN|HODL, since, days, asOf, incompleteDayExcluded }; `currentTrendWeekly` when present is the weekly one), not from the last row of `trends` — `trends` is the history of past trend runs. Quote it as "<trend> since <since> (<days> days, as of <asOf>)". Only when `currentTrend` is absent, fall back to the last `trends` row.
| Argument | Type | Description |
|---|---|---|
| by | string | How `identifier` is interpreted. |
| chain | string | Chain for contract lookups (ethereum, bsc, solana, base, …). Required when by="contract". |
| identifier* | string | The symbol (BTC), name (Bitcoin), id (bitcoin), or contract address. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"identifier"
],
"properties": {
"by": {
"enum": [
"symbol",
"name",
"id",
"contract"
],
"type": "string",
"default": "symbol",
"description": "How `identifier` is interpreted."
},
"chain": {
"type": "string",
"description": "Chain for contract lookups (ethereum, bsc, solana, base, …). Required when by=\"contract\"."
},
"identifier": {
"type": "string",
"minLength": 1,
"description": "The symbol (BTC), name (Bitcoin), id (bitcoin), or contract address."
}
}
}Fuzzily resolve a symbol, name, or contract to canonical coin candidates. Use this first when the user input is ambiguous, before calling other tools.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Max candidates to return. |
| query* | string | Symbol, name, or contract to resolve. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 50,
"description": "Max candidates to return.",
"exclusiveMinimum": 0
},
"query": {
"type": "string",
"minLength": 1,
"description": "Symbol, name, or contract to resolve."
}
}
}Filter the tracked universe by trend direction, category and market-cap band, and sort the result. For movers questions ("what's pumping", "top gainers/losers today", "biggest movers") use sort_by="change24h" ("change7d" for the week) — sort_order="desc" for gainers, "asc" for losers — and quote each row's change from the row itself (`change_24h_pct` / `change_7d_pct`, or `change24h` / `change7d`). With the default marketCap sort rows are plain coin names; a change sort may return `{ rows: [...] }` with a coverage summary instead of a bare list. Pass ONE category per call; the server ignores case and punctuation ("meme", "Layer 2" and "DeFi" all work) and rejects an unknown name with close matches (list_categories has the names). There is no exchange filter yet: `exchange` is rejected with an explanation, because the only venue data behind this scan is spot listings. Do not present a scan as "coins on <exchange>". An empty result means no coin matched all the filters.
| Argument | Type | Description |
|---|---|---|
| top | integer | Keep only the first N items (default 50). Raise for more, lower to save tokens. |
| limit | integer | Max results. |
| trend | string | Filter by trend direction. |
| fields | string | Token-saving: comma-separated top-level fields to keep. |
| sort_by | string | Sort key (default marketCap). change24h / change7d = 24h / 7d price change, for movers / "what's pumping" questions. |
Trend scanner. state=fresh (newly started), stale (longest running), aligned (multi-timeframe agreement), extreme (biggest moves), historical.
| Argument | Type | Description |
|---|---|---|
| top | integer | Keep only the first N items (default 50). Raise for more, lower to save tokens. |
| limit | integer | Max results. |
| state | string | Which trend slice to return. |
| fields | string | Token-saving: comma-separated top-level fields to keep. |
| interval | string | Trend interval: 1d (daily) or 1w (weekly). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"top": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Keep only the first N items (default 50). Raise for more, lower to save tokens.",
"exclusiveMinimum": 0
},
"limit": {
"type": "integer",
"maximum": 200,
"description": "Max results.",
"exclusiveMinimum": 0
},
"state": {
"enum": [
"fresh",
"stale",
"aligned",
"extreme",
"historical"
],
"type": "string",
"default": "fresh",
"description": "Which trend slice to return."
},
"fields": {
"type": "string",
"description": "Token-saving: comma-separated top-level fields to keep."
},
"interval": {
"enum": [
"1d",
"1w"
],
"type": "string",
"description": "Trend interval: 1d (daily) or 1w (weekly)."
}
}
}Search the web for crypto information, or get a direct answer. Backed by Shumi's web-search tool.
| Argument | Type | Description |
|---|---|---|
| query* | string | What to search for. |
| answer | boolean | Return a direct synthesized answer instead of raw search results. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"minLength": 1,
"description": "What to search for."
},
"answer": {
"type": "boolean",
"description": "Return a direct synthesized answer instead of raw search results."
}
}
}{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"top": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Keep only the first N items (default 50). Raise for more, lower to save tokens.",
"exclusiveMinimum": 0
},
"mode": {
"enum": [
"suggestions",
"delta-neutral",
"history",
"signal"
],
"type": "string",
"default": "suggestions",
"description": "Which pair view to return."
},
"limit": {
"type": "integer",
"maximum": 100,
"description": "Max results.",
"exclusiveMinimum": 0
},
"fields": {
"type": "string",
"description": "Token-saving: comma-separated top-level fields to keep."
},
"symbol": {
"type": "string",
"description": "Filter by symbol (suggestions / delta-neutral)."
},
"token_a": {
"type": "string",
"description": "First token (required for mode=\"signal\"), e.g. ETH."
},
"token_b": {
"type": "string",
"description": "Second token (required for mode=\"signal\"), e.g. SOL."
},
"dex_only": {
"type": "boolean",
"description": "DEX exchanges only (delta-neutral)."
},
"exchange": {
"type": "string",
"description": "Filter by exchange (delta-neutral)."
}
}
}| category |
| string |
| ONE category, e.g. "Meme", "Layer 2" or "DeFi"; case and punctuation are ignored (list_categories has the names). Comma-joined values are rejected; call once per category. |
| exchange | string | Not supported yet: the server rejects it with an explanation (its venue data covers spot listings only, so a filtered answer would mislead). Leave unset. |
| interval | string | Trend interval: 1d (daily) or 1w (weekly). |
| mcap_max | number | Maximum market cap in USD. |
| mcap_min | number | Minimum market cap in USD. |
| sort_order | string | desc (default) = largest first; asc = smallest first (e.g. biggest 24h losers). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"top": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Keep only the first N items (default 50). Raise for more, lower to save tokens.",
"exclusiveMinimum": 0
},
"limit": {
"type": "integer",
"maximum": 200,
"description": "Max results.",
"exclusiveMinimum": 0
},
"trend": {
"enum": [
"UP",
"HODL",
"DOWN"
],
"type": "string",
"description": "Filter by trend direction."
},
"fields": {
"type": "string",
"description": "Token-saving: comma-separated top-level fields to keep."
},
"sort_by": {
"enum": [
"marketCap",
"change24h",
"change7d",
"streak",
"price"
],
"type": "string",
"description": "Sort key (default marketCap). change24h / change7d = 24h / 7d price change, for movers / \"what's pumping\" questions."
},
"category": {
"type": "string",
"description": "ONE category, e.g. \"Meme\", \"Layer 2\" or \"DeFi\"; case and punctuation are ignored (list_categories has the names). Comma-joined values are rejected; call once per category."
},
"exchange": {
"type": "string",
"description": "Not supported yet: the server rejects it with an explanation (its venue data covers spot listings only, so a filtered answer would mislead). Leave unset."
},
"interval": {
"enum": [
"1d",
"1w"
],
"type": "string",
"description": "Trend interval: 1d (daily) or 1w (weekly)."
},
"mcap_max": {
"type": "number",
"description": "Maximum market cap in USD."
},
"mcap_min": {
"type": "number",
"description": "Minimum market cap in USD."
},
"sort_order": {
"enum": [
"asc",
"desc"
],
"type": "string",
"description": "desc (default) = largest first; asc = smallest first (e.g. biggest 24h losers)."
}
}
}