MAD Synapse · Chain
Cross-chain markets: prices, DeFi TVL, yields, stablecoins, gas, order books, perps funding.
Should I use this
Quality & Safety
Findings (3)
- HIGHTool poisoning patterns detected
- MEDIUMTool description contains URL to non-standard domainin crypto_price
- MEDIUMTool description contains URL to non-standard domainin price_history
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"synapse-chain": {
"url": "https://agent.maddegen.art/hub/mcp/chain"
}
}
}Remote endpoints
https://agent.maddegen.art/hub/mcp/chainstreamable-httpWhat it can do
Tool inventory
Tools (15)
🟢crypto_price(assets, chain)
Live USD price and 24 h change for up to 30 crypto assets on any chain — by symbol, CoinGecko id, contract or mint address. Resolves each asset (BTC, "coingecko:ethereum", "base:0x…", a bare 0x address with chain, or a Solana mint) and prices it from DefiLlama's aggregated oracle (confidence score included). Symbols resolve against the top 1,000 coins by market cap first, so "USDC" means the real one; ambiguous symbols list the alternatives. When to use: For current prices by symbol on any chain; for Solana mints by address use price (on the MAD Synapse · Wallets & Risk server, https://agent.maddegen.art/hub/mcp/risk); for history use price_history. Price: free. Errors: returns isError with a message for invalid input or an upstream failure (not charged).
Input Schema
{
"type": "object",
"properties": {
"assets": {
"type": "array",
"maxItems": 30,
"items": {
"type": "string"
},
"description": "e.g. [\"BTC\",\"ETH\",\"coingecko:solana\",\"base:0x833589fcd6edb6e08f4c7c32d4f71b54bda02913\"]. 0-30 items."
},
"chain": {
"type": "string",
"enum": [
"ethereum",
"base",
"arbitrum",
"optimism",
"polygon",
"bsc",
"avalanche",
"linea",
"blast",
"scroll",
"gnosis",
"sonic",
"unichain",
"mantle",
"berachain",
"hyperevm",
"monad"
],
"default": "ethereum",
"description": "EVM chain: ethereum, base, arbitrum, optimism, polygon, bsc, avalanche, linea, blast, scroll, gnosis, sonic, unichain, mantle, berachain, hyperevm, monad. One of \"ethereum\", \"base\", \"arbitrum\", \"optimism\", \"polygon\", \"bsc\", \"avalanche\", \"linea\", \"blast\", \"scroll\", \"gnosis\", \"sonic\", \"unichain\", \"mantle\", \"berachain\", \"hyperevm\", \"monad\". Default \"ethereum\"."
}
},
"required": [
"assets"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"as_of": {
"type": [
"string",
"null"
]
},
"source": {
"type": [
"string",
"null"
]
},
"prices": {
"type": "array",
"items": {
"type": [
"object",
"null"
],
"properties": {
"query": {
"type": [
"string",
"null"
]
},
"id": {
"type": [
"string",
"null"
]
},
"symbol": {
"type": [
"string",
"null"
]
},
"name": {},
"usd": {
"type": [
"number",
"null"
]
},
"change_24h_pct": {
"type": [
"number",
"null"
]
},
"confidence": {
"type": [
"number",
"null"
]
},
"decimals": {},
"updated": {
"type": [
"string",
"null"
]
},
"market_cap_rank": {}
}
}
}
}
}🟢price_history(asset, days, interval, chain)
Historical USD prices for any crypto asset (hourly or daily, up to 365 days) with return, high/low, max drawdown and annualized volatility. Same asset resolution as crypto_price. Returns the series plus stats computed from it: total return, high/low with dates, max drawdown, and annualized volatility from log returns. When to use: For past prices and drawdowns; for the current price (on the MAD Synapse · Wallets & Risk server, https://agent.maddegen.art/hub/mcp/risk) use crypto_price. Price: $0.002 per call (10 free/day; after that a payment-required result lists x402 options). Errors: returns isError with a message for invalid input or an upstream failure (not charged).
Input Schema
{
"type": "object",
"properties": {
"asset": {
"type": "string",
"description": "symbol, CoinGecko id, chain:address or address"
},
"days": {
"type": "integer",
"minimum": 1,
"maximum": 365,
"default": 30,
"description": "How many days back; hourly points up to 90 days, daily beyond. Range 1-365. Default 30."
},
"interval": {
"type": "string",
"enum": [
"hour",
"day"
],
"default": "day",
"description": "hourly allowed up to 30 days. One of \"hour\", \"day\". Default \"day\"."
},
"chain": {
"type": "string",
"enum": [
"ethereum",
"base",
"arbitrum",
"optimism",
"polygon",
"bsc",
"avalanche",
"linea",
"blast",
"scroll",
"gnosis",
"sonic",
"unichain",
"mantle",
"berachain",
"hyperevm",
"monad"
],
"default": "ethereum",
"description": "EVM chain: ethereum, base, arbitrum, optimism, polygon, bsc, avalanche, linea, blast, scroll, gnosis, sonic, unichain, mantle, berachain, hyperevm, monad. One of \"ethereum\", \"base\", \"arbitrum\", \"optimism\", \"polygon\", \"bsc\", \"avalanche\", \"linea\", \"blast\", \"scroll\", \"gnosis\", \"sonic\", \"unichain\", \"mantle\", \"berachain\", \"hyperevm\", \"monad\". Default \"ethereum\"."
}
},
"required": [
"asset"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"asset": {
"type": [
"string",
"null"
]
},
"id": {
"type": [
"string",
"null"
]
},
"symbol": {
"type": [
"string",
"null"
]
},
"interval": {
"type": [
"string",
"null"
]
},
"points": {
"type": [
"number",
"null"
]
},
"stats": {
"type": [
"object",
"null"
],
"properties": {
"first_usd": {
"type": [
"number",
"null"
]
},
"last_usd": {
"type": [
"number",
"null"
]
},
"return_pct": {
"type": [
"number",
"null"
]
},
"high": {
"type": [
"object",
"null"
],
"properties": {
"t": {
"type": [
"string",
"null"
]
},
"usd": {
"type": [
"number",
"null"
]
}
}
},
"low": {
"type": [
"object",
"null"
],
"properties": {
"t": {
"type": [
"string",
"null"
]
},
"usd": {
"type": [
"number",
"null"
]
}
}
},
"max_drawdown_pct": {
"type": [
"number",
"null"
]
},
"volatility_annualized_pct": {
"type": [
"number",
"null"
]
}
}
},
"series": {
"type": "array",
"items": {
"type": [
"object",
"null"
],
"properties": {
"t": {
"type": [
"string",
"null"
]
},
"usd": {
"type": [
"number",
"null"
]
}
}
}
}
}
}🟢defi_rankings(chain, category, sort, min_tvl_usd, limit)
Top DeFi protocols by TVL (or 1 d / 7 d TVL change), filterable by chain and category — lending, DEX, liquid staking, bridges, perps… From DefiLlama's full protocol list (~6,000 protocols). Each row: TVL, TVL on the requested chain, 1 h/1 d/7 d change, market cap, category, chains, site. Use for "biggest lending protocols on Base" or "fastest growing DEXes this week". When to use: To rank protocols; for one protocol in depth use defi_protocol. Price: free. Errors: returns isError with a message for invalid input or an upstream failure (not charged).
Input Schema
{
"type": "object",
"properties": {
"chain": {
"type": "string",
"description": "DefiLlama chain name, e.g. Ethereum, Solana, Base, Arbitrum (optional)"
},
"category": {
"type": "string",
"description": "e.g. Lending, Dexs, Liquid Staking, Bridge, Derivatives, Yield, CDP, RWA (optional)"
},
"sort": {
"type": "string",
"enum": [
"tvl",
"change_1d",
"change_7d"
],
"default": "tvl",
"description": "Rank by current TVL or by 1-day / 7-day TVL change. One of \"tvl\", \"change_1d\", \"change_7d\". Default \"tvl\"."
},
"min_tvl_usd": {
"type": "number",
"minimum": 0,
"default": 1000000,
"description": "Skip protocols with less TVL than this (USD). Default 1000000."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 25,
"description": "How many protocols to return. Range 1-100. Default 25."
}
},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"source": {
"type": [
"string",
"null"
]
},
"filters": {
"type": [
"object",
"null"
],
"properties": {
"chain": {
"type": [
"string",
"null"
]
},
"category": {
"type": [
"string",
"null"
]
},
"min_tvl_usd": {
"type": [
"number",
"null"
]
}
}
},
"matched": {
"type": [
"number",
"null"
]
},
"protocols": {
"type": "array",
"items": {
"type": [
"object",
"null"
],
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"slug": {
"type": [
"string",
"null"
]
},
"category": {
"type": [
"string",
"null"
]
},
"tvl_usd": {
"type": [
"number",
"null"
]
},
"tvl_total_usd": {
"type": [
"number",
"null"
]
},
"change_1h_pct": {
"type": [
"number",
"null"
]
},
"change_1d_pct": {
"type": [
"number",
"null"
]
},
"change_7d_pct": {
"type": [
"number",
"null"
]
},
"mcap_usd": {},
"chains": {
"type": "array"
},
"url": {
"type": [
"string",
"null"
]
},
"twitter": {
"type": [
"string",
"null"
]
}
}
}
},
"categories_hint": {}
}
}🟢defi_protocol(protocol)
One DeFi protocol in depth: TVL by chain, TVL trend, fees and revenue (24 h/7 d/30 d), market cap, audits, links. Look up by name or DefiLlama slug ("aave", "Uniswap", "jupiter"). Combines DefiLlama's protocol list with its fees/revenue summaries. Fuzzy name matches return the best match plus close alternatives. Price: $0.002 per call (10 free/day; after that a payment-required result lists x402 options). Errors: returns isError with a message for invalid input or an upstream failure (not charged).
Input Schema
{
"type": "object",
"properties": {
"protocol": {
"type": "string",
"description": "name or slug"
}
},
"required": [
"protocol"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"found": {
"type": [
"boolean",
"null"
]
},
"name": {
"type": [
"string",
"null"
]
},
"slug": {
"type": [
"string",
"null"
]
},
"category": {
"type": [
"string",
"null"
]
},
"description": {
"type": [
"string",
"null"
]
},
"url": {
"type": [
"string",
"null"
]
},
"twitter": {
"type": [
"string",
"null"
]
},
"tvl_usd": {
"type": [
"number",
"null"
]
},
"change_1h_pct": {
"type": [
"number",
"null"
]
},
"change_1d_pct": {
"type": [
"number",
"null"
]
},
"change_7d_pct": {
"type": [
"number",
"null"
]
},
"mcap_usd": {},
"token": {
"type": [
"string",
"null"
]
},
"gecko_id": {},
"tvl_by_chain": {
"type": "array",
"items": {
"type": [
"object",
"null"
],
"properties": {
"chain": {
"type": [
"string",
"null"
]
},
"tvl_usd": {
"type": [
"number",
"null"
]
}
}
}
},
"fees_usd": {
"type": [
"object",
"null"
],
"properties": {
"24h": {
"type": [
"number",
"null"
]
},
"7d": {
"type": [
"number",
"null"
]
},
"30d": {
"type": [
"number",
"null"
]
},
"all_time": {
"type": [
"number",
"null"
]
}
}
},
"revenue_usd": {
"type": [
"object",
"null"
],
"properties": {
"24h": {
"type": [
"number",
"null"
]
},
"7d": {
"type": [
"number",
"null"
]
},
"30d": {
"type": [
"number",
"null"
]
},
"all_time": {
"type": [
"number",
"null"
]
}
}
},
"audits": {
"type": [
"number",
"null"
]
},
"audit_links": {
"type": "array",
"items": {
"type": [
"string",
"null"
]
}
},
"listed_at": {
"type": [
"string",
"null"
]
},
"forked_from": {
"type": "array"
},
"alternatives": {
"type": "array",
"items": {
"type": [
"object",
"null"
],
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"slug": {
"type": [
"string",
"null"
]
},
"tvl_usd": {
"type": [
"number",
"null"
]
}
}
}
}
}
}🟢chain_tvl(chain, days, limit)
Total value locked on every blockchain right now, ranked — or one chain's daily TVL history. DefiLlama chain TVL. Without "chain": ranking of all chains with token symbol. With "chain": daily TVL history for up to 365 days plus 7 d / 30 d / 90 d change. When to use: For chain-level TVL; for protocols use defi_rankings. Price: free. Errors: returns isError with a message for invalid input or an upstream failure (not charged).
Input Schema
{
"type": "object",
"properties": {
"chain": {
"type": "string",
"description": "e.g. Solana, Ethereum, Base (optional)"
},
"days": {
"type": "integer",
"minimum": 7,
"maximum": 365,
"default": 90,
"description": "Days of daily TVL history (only when a single chain is requested). Range 7-365. Default 90."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 200,
"default": 30,
"description": "How many chains to return in the ranking. Range 1-200. Default 30."
}
},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"chain": {
"type": [
"string",
"null"
]
},
"tvl_usd": {
"type": [
"number",
"null"
]
},
"rank": {
"type": [
"number",
"null"
]
},
"change_7d_pct": {
"type": [
"number",
"null"
]
},
"change_30d_pct": {
"type": [
"number",
"null"
]
},
"change_90d_pct": {
"type": [
"number",
"null"
]
},
"history": {
"type": "array",
"items": {
"type": [
"object",
"null"
],
"properties": {
"date": {
"type": [
"string",
"null"
]
},
"tvl_usd": {
"type": [
"number",
"null"
]
}
}
}
}
}
}🟢yield_pools(chain, project, token, stablecoin_only, single_exposure_only, ...)
Search ~19,000 DeFi yield pools across all chains: filter by chain, protocol, token, stablecoin-only, min TVL; sort by APY or TVL. Base vs reward APY, 30 d mean, IL risk. DefiLlama yields data, refreshed every 15 minutes. Shows APY split into base (organic fees/interest) and reward (token emissions), the 30-day mean APY so an agent can spot unsustainable spikes, impermanent-loss risk, exposure (single/multi) and DefiLlama's up/down prediction. Price: $0.003 per call (10 free/day; after that a payment-required result lists x402 options). Errors: returns isError with a message for invalid input or an upstream failure (not charged).
Input Schema
{
"type": "object",
"properties": {
"chain": {
"type": "string",
"description": "e.g. Ethereum, Solana, Base, Arbitrum"
},
"project": {
"type": "string",
"description": "protocol slug, e.g. aave-v3, kamino-lend, uniswap-v3"
},
"token": {
"type": "string",
"description": "token symbol that must appear in the pool, e.g. USDC, SOL"
},
"stablecoin_only": {
"type": "boolean",
"default": false,
"description": "true = only pools whose assets are all stablecoins. Default false."
},
"single_exposure_only": {
"type": "boolean",
"default": false,
"description": "no LP pairs (no impermanent loss) Default false."
},
"min_tvl_usd": {
"type": "number",
"minimum": 0,
"default": 1000000,
"description": "Skip pools with less TVL than this (USD); raises quality. Default 1000000."
},
"max_apy": {
"type": "number",
"minimum": 1,
"default": 1000,
"description": "drop absurd APYs above this. Default 1000."
},
"sort": {
"type": "string",
"enum": [
"apy",
"tvl",
"apy_base",
"apy_30d_mean"
],
"default": "apy",
"description": "Rank by total APY, TVL, base (non-reward) APY or 30-day mean APY. One of \"apy\", \"tvl\", \"apy_base\", \"apy_30d_mean\". Default \"apy\"."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"default": 20,
"description": "How many pools to return. Range 1-50. Default 20."
}
},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"source": {
"type": [
"string",
"null"
]
},
"matched": {
"type": [
"number",
"null"
]
},
"pools": {
"type": "array",
"items": {
"type": [
"object",
"null"
],
"properties": {
"pool_id": {
"type": [
"string",
"null"
]
},
"project": {
"type": [
"string",
"null"
]
},
"chain": {
"type": [
"string",
"null"
]
},
"symbol": {
"type": [
"string",
"null"
]
},
"pool_meta": {},
"tvl_usd": {
"type": [
"number",
"null"
]
},
"apy_pct": {
"type": [
"number",
"null"
]
},
"apy_base_pct": {
"type": [
"number",
"null"
]
},
"apy_reward_pct": {},
"apy_30d_mean_pct": {
"type": [
"number",
"null"
]
},
"apy_change_7d": {
"type": [
"number",
"null"
]
},
"stablecoin": {
"type": [
"boolean",
"null"
]
},
"exposure": {
"type": [
"string",
"null"
]
},
"il_risk": {
"type": [
"string",
"null"
]
},
"reward_tokens": {
"type": "array"
},
"outlook": {
"type": [
"object",
"null"
]
},
"url": {
"type": [
"string",
"null"
]
}
}
}
},
"note": {
"type": [
"string",
"null"
]
}
}
}🟢stablecoins(symbol, peg, limit)
Every stablecoin's circulating supply, 1 d/7 d/30 d supply change, current price and peg deviation — spot depegs and mint/burn flows. DefiLlama stablecoin data across all chains. Filter by symbol or peg type. peg_deviation_pct is measured against the peg (USD, EUR…) using DefiLlama's price. Price: free. Errors: returns isError with a message for invalid input or an upstream failure (not charged).
Input Schema
{
"type": "object",
"properties": {
"symbol": {
"type": "string",
"description": "e.g. USDC, USDe, PYUSD (optional)"
},
"peg": {
"type": "string",
"enum": [
"any",
"peggedUSD",
"peggedEUR",
"peggedVAR"
],
"default": "any",
"description": "Filter by peg currency type. One of \"any\", \"peggedUSD\", \"peggedEUR\", \"peggedVAR\". Default \"any\"."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 25,
"description": "How many stablecoins to return. Range 1-100. Default 25."
}
},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"source": {
"type": [
"string",
"null"
]
},
"total_usd_pegged": {
"type": [
"number",
"null"
]
},
"stablecoins": {
"type": "array",
"items": {
"type": [
"object",
"null"
],
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"symbol": {
"type": [
"string",
"null"
]
},
"peg": {
"type": [
"string",
"null"
]
},
"mechanism": {
"type": [
"string",
"null"
]
},
"circulating": {
"type": [
"number",
"null"
]
},
"change_1d_pct": {
"type": [
"number",
"null"
]
},
"change_7d_pct": {
"type": [
"number",
"null"
]
},
"change_30d_pct": {
"type": [
"number",
"null"
]
},
"price_usd": {
"type": [
"number",
"null"
]
},
"peg_deviation_pct": {
"type": [
"number",
"null"
]
},
"chains": {
"type": [
"number",
"null"
]
},
"top_chains": {
"type": "array"
}
}
}
},
"depegged_over_1pct": {
"type": "array",
"items": {
"type": [
"object",
"null"
],
"properties": {
"symbol": {
"type": [
"string",
"null"
]
},
"price_usd": {
"type": [
"number",
"null"
]
},
"circulating": {
"type": [
"number",
"null"
]
}
}
}
}
}
}🟢dex_volumes(chain, type, limit)
DEX trading volume in the last 24 h / 7 d / 30 d — all chains or one — with the top DEXes and their share and change. DefiLlama DEX overview. Optionally scoped to one chain. Includes perps with type=perps (derivatives volume) or aggregators. Price: free. Errors: returns isError with a message for invalid input or an upstream failure (not charged).
Input Schema
{
"type": "object",
"properties": {
"chain": {
"type": "string",
"description": "e.g. Solana, Base (optional)"
},
"type": {
"type": "string",
"enum": [
"dexs",
"derivatives",
"aggregators"
],
"default": "dexs",
"description": "Spot DEXes, perp/derivatives DEXes, or DEX aggregators. One of \"dexs\", \"derivatives\", \"aggregators\". Default \"dexs\"."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"default": 15,
"description": "How many venues to return. Range 1-50. Default 15."
}
},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"source": {
"type": [
"string",
"null"
]
},
"scope": {
"type": [
"string",
"null"
]
},
"type": {
"type": [
"string",
"null"
]
},
"volume_usd": {
"type": [
"object",
"null"
],
"properties": {
"24h": {
"type": [
"number",
"null"
]
},
"7d": {
"type": [
"number",
"null"
]
},
"30d": {
"type": [
"number",
"null"
]
}
}
},
"change_1d_pct": {
"type": [
"number",
"null"
]
},
"change_7d_pct": {
"type": [
"number",
"null"
]
},
"top": {
"type": "array",
"items": {
"type": [
"object",
"null"
],
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"volume_24h_usd": {
"type": [
"number",
"null"
]
},
"share_pct": {
"type": [
"number",
"null"
]
},
"change_1d_pct": {
"type": [
"number",
"null"
]
},
"volume_7d_usd": {
"type": [
"number",
"null"
]
},
"chains": {
"type": "array"
}
}
}
}
}
}🟢fees_revenue(metric, chain, limit)
Which protocols and chains earn the most: fees or revenue over 24 h / 7 d / 30 d, filterable by chain — the cash-flow view of crypto. DefiLlama fees/revenue overview. "fees" = what users paid; "revenue" = what the protocol kept. Ranked, with day-over-day change. Price: $0.002 per call (10 free/day; after that a payment-required result lists x402 options). Errors: returns isError with a message for invalid input or an upstream failure (not charged).
Input Schema
{
"type": "object",
"properties": {
"metric": {
"type": "string",
"enum": [
"fees",
"revenue"
],
"default": "fees",
"description": "Gross fees paid by users, or revenue kept by the protocol. One of \"fees\", \"revenue\". Default \"fees\"."
},
"chain": {
"type": "string",
"description": "optional"
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"default": 20,
"description": "How many protocols to return. Range 1-50. Default 20."
}
},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"source": {
"type": [
"string",
"null"
]
},
"metric": {
"type": [
"string",
"null"
]
},
"scope": {
"type": [
"string",
"null"
]
},
"total_usd": {
"type": [
"object",
"null"
],
"properties": {
"24h": {
"type": [
"number",
"null"
]
},
"7d": {
"type": [
"number",
"null"
]
},
"30d": {
"type": [
"number",
"null"
]
}
}
},
"top": {
"type": "array",
"items": {
"type": [
"object",
"null"
],
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"category": {
"type": [
"string",
"null"
]
},
"24h_usd": {
"type": [
"number",
"null"
]
},
"7d_usd": {
"type": [
"number",
"null"
]
},
"30d_usd": {
"type": [
"number",
"null"
]
},
"change_1d_pct": {
"type": [
"number",
"null"
]
},
"chains": {
"type": "array"
}
}
}
}
}
}🟢gas_now(chains)
What a transaction costs right now on 17 EVM chains, Solana and Bitcoin — gwei/priority fee and the USD cost of a transfer and a swap on each. EVM: base fee + priority fee from the latest block (eth_feeHistory), USD cost of a 21,000-gas transfer and a ~150,000-gas swap (L2s shown before their L1 data fee). Solana: recent prioritization-fee percentiles. Bitcoin: mempool.space recommended sat/vB with USD for a typical 140 vB transaction. Price: free. Errors: returns isError with a message for invalid input or an upstream failure (not charged).
Input Schema
{
"type": "object",
"properties": {
"chains": {
"type": "array",
"maxItems": 20,
"items": {
"type": "string"
},
"description": "subset, e.g. [\"ethereum\",\"base\",\"solana\",\"bitcoin\"] (default: all) 0-20 items."
}
},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"as_of": {
"type": [
"string",
"null"
]
},
"note": {
"type": [
"string",
"null"
]
},
"chains": {
"type": "array",
"items": {
"type": [
"object",
"null"
],
"properties": {
"chain": {
"type": [
"string",
"null"
]
},
"base_fee_gwei": {
"type": [
"number",
"null"
]
},
"priority_fee_gwei": {
"type": [
"number",
"null"
]
},
"priority_basis": {
"type": [
"string",
"null"
]
},
"total_gwei": {
"type": [
"number",
"null"
]
},
"native": {
"type": [
"string",
"null"
]
},
"usd_transfer_21k": {
"type": [
"number",
"null"
]
},
"usd_swap_150k": {
"type": [
"number",
"null"
]
},
"base_fee_lamports": {
"type": [
"number",
"null"
]
},
"priority_micro_lamports_per_cu": {
"type": [
"object",
"null"
]
},
"measured_on": {
"type": [
"string",
"null"
]
},
"usd_simple_tx_200k_cu": {
"type": [
"object",
"null"
]
},
"sat_per_vb": {
"type": [
"object",
"null"
]
},
"usd_140vb_tx": {
"type": [
"object",
"null"
]
}
}
}
}
}
}🟢cex_ticker(pair)
Live bid/ask/last, 24 h change, volume and range for a pair on Kraken, Coinbase and OKX side by side — with the cross-venue spread. Queries each venue's public ticker in parallel. OKX quotes in USDT when USD is asked for. The cross-venue spread shows arbitrage gaps and which venue is off. When to use: For top-of-book prices; for how much size the book can absorb use orderbook_depth. Price: $0.001 per call (10 free/day; after that a payment-required result lists x402 options). Errors: returns isError with a message for invalid input or an upstream failure (not charged).
Input Schema
{
"type": "object",
"properties": {
"pair": {
"type": "string",
"description": "BTC/USD, ETH-USDT, SOL"
}
},
"required": [
"pair"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"pair": {
"type": [
"string",
"null"
]
},
"venues": {
"type": "array",
"items": {
"type": [
"object",
"null"
],
"properties": {
"venue": {
"type": [
"string",
"null"
]
},
"pair": {
"type": [
"string",
"null"
]
},
"last": {
"type": [
"number",
"null"
]
},
"bid": {
"type": [
"number",
"null"
]
},
"ask": {
"type": [
"number",
"null"
]
},
"volume_24h_base": {
"type": [
"number",
"null"
]
},
"vwap_24h": {
"type": [
"number",
"null"
]
},
"open_24h": {
"type": [
"number",
"null"
]
},
"change_24h_pct": {
"type": [
"number",
"null"
]
},
"high_24h": {
"type": [
"number",
"null"
]
},
"low_24h": {
"type": [
"number",
"null"
]
}
}
}
},
"best_bid": {
"type": [
"string",
"null"
]
},
"best_ask": {
"type": [
"string",
"null"
]
},
"cross_venue_spread_bps": {
"type": [
"number",
"null"
]
}
}
}🟢orderbook_depth(pair, venue)
How much size a market can take: bid/ask depth within ±0.1/0.5/1/2/5%, spread, and the slippage of a $10k/$100k/$1M market order on Kraken, Coinbase or OKX. Pulls the full public L2 book and walks it. Use before sizing an order or comparing venue liquidity. slippage is vs. mid price, in basis points; null means the fetched book was too thin for that size. When to use: For liquidity and slippage; for just prices use cex_ticker. Price: $0.003 per call (10 free/day; after that a payment-required result lists x402 options). Errors: returns isError with a message for invalid input or an upstream failure (not charged).
Input Schema
{
"type": "object",
"properties": {
"pair": {
"type": "string",
"description": "Market pair as BASE/QUOTE, e.g. \"BTC/USD\" or \"ETH/USDT\"."
},
"venue": {
"type": "string",
"enum": [
"coinbase",
"kraken",
"okx"
],
"default": "coinbase",
"description": "Exchange whose order book to read. One of \"coinbase\", \"kraken\", \"okx\". Default \"coinbase\"."
}
},
"required": [
"pair"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"venue": {
"type": [
"string",
"null"
]
},
"pair": {
"type": [
"string",
"null"
]
},
"levels": {
"type": [
"object",
"null"
],
"properties": {
"bids": {
"type": [
"number",
"null"
]
},
"asks": {
"type": [
"number",
"null"
]
}
}
},
"best_bid": {
"type": [
"number",
"null"
]
},
"best_ask": {
"type": [
"number",
"null"
]
},
"mid": {
"type": [
"number",
"null"
]
},
"spread_bps": {
"type": [
"number",
"null"
]
},
"depth_usd": {
"type": [
"object",
"null"
],
"properties": {
"pm_0.1pct": {
"type": [
"object",
"null"
],
"properties": {
"bids": {
"type": [
"number",
"null"
]
},
"asks": {
"type": [
"number",
"null"
]
}
}
},
"pm_0.5pct": {
"type": [
"object",
"null"
],
"properties": {
"bids": {
"type": [
"number",
"null"
]
},
"asks": {
"type": [
"number",
"null"
]
}
}
},
"pm_1pct": {
"type": [
"object",
"null"
],
"properties": {
"bids": {
"type": [
"number",
"null"
]
},
"asks": {
"type": [
"number",
"null"
]
}
}
},
"pm_2pct": {
"type": [
"object",
"null"
],
"properties": {
"bids": {
"type": [
"number",
"null"
]
},
"asks": {
"type": [
"number",
"null"
]
}
}
},
"pm_5pct": {
"type": [
"object",
"null"
],
"properties": {
"bids": {
"type": [
"number",
"null"
]
},
"asks": {
"type": [
"number",
"null"
]
}
}
}
}
},
"slippage_bps_market_buy": {
"type": [
"object",
"null"
],
"properties": {
"usd_10k": {
"type": [
"number",
"null"
]
},
"usd_100k": {
"type": [
"number",
"null"
]
},
"usd_1m": {
"type": [
"number",
"null"
]
}
}
},
"slippage_bps_market_sell": {
"type": [
"object",
"null"
],
"properties": {
"usd_10k": {
"type": [
"number",
"null"
]
},
"usd_100k": {
"type": [
"number",
"null"
]
},
"usd_1m": {
"type": [
"number",
"null"
]
}
}
}
}
}🟢funding_rates(coin)
Perpetual funding for a coin on Hyperliquid, OKX and Kraken Futures side by side — per-interval rate and annualized APR — plus open interest and mark price. Positive = longs pay shorts. Each venue's rate is normalized to an hourly figure and annualized so they compare directly (OKX settles every 1–8 h, Hyperliquid hourly, Kraken hourly). Use for basis/carry trades or crowding signals. When to use: For one coin across venues; to scan every Hyperliquid market use hyperliquid_markets. Price: $0.003 per call (10 free/day; after that a payment-required result lists x402 options). Errors: returns isError with a message for invalid input or an upstream failure (not charged).
Input Schema
{
"type": "object",
"properties": {
"coin": {
"type": "string",
"pattern": "^[A-Za-z0-9]{2,12}$",
"description": "BTC, ETH, SOL…"
}
},
"required": [
"coin"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"coin": {
"type": [
"string",
"null"
]
},
"as_of": {
"type": [
"string",
"null"
]
},
"venues": {
"type": "array",
"items": {
"type": [
"object",
"null"
],
"properties": {
"venue": {
"type": [
"string",
"null"
]
},
"rate_per_interval_pct": {
"type": [
"number",
"null"
]
},
"interval_hours": {
"type": [
"number",
"null"
]
},
"hourly_pct": {
"type": [
"number",
"null"
]
},
"apr_pct": {
"type": [
"number",
"null"
]
},
"mark": {
"type": [
"number",
"null"
]
},
"open_interest_usd": {
"type": [
"number",
"null"
]
},
"next_funding": {
"type": [
"string",
"null"
]
},
"note": {
"type": [
"string",
"null"
]
}
}
}
},
"spread_apr_pct": {
"type": [
"number",
"null"
]
},
"meaning": {
"type": [
"string",
"null"
]
}
}
}🟢hyperliquid_markets(coin, sort, limit)
Every Hyperliquid perpetual: mark/oracle price, 24 h change and volume, open interest, funding APR, premium — ranked by volume, OI, funding or movers. Live from Hyperliquid's public info API. Filter to one coin or rank the whole board. Funding is hourly on Hyperliquid; apr = hourly × 8,760. Price: $0.002 per call (10 free/day; after that a payment-required result lists x402 options). Errors: returns isError with a message for invalid input or an upstream failure (not charged).
Input Schema
{
"type": "object",
"properties": {
"coin": {
"type": "string",
"description": "optional, e.g. BTC"
},
"sort": {
"type": "string",
"enum": [
"volume",
"open_interest",
"funding",
"funding_negative",
"change"
],
"default": "volume",
"description": "Rank by 24 h volume, open interest, highest or most negative funding, or 24 h change. One of \"volume\", \"open_interest\", \"funding\", \"funding_negative\", \"change\". Default \"volume\"."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 20,
"description": "How many markets to return. Range 1-100. Default 20."
}
},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"markets": {
"type": [
"number",
"null"
]
},
"total_volume_24h_usd": {
"type": [
"number",
"null"
]
},
"total_open_interest_usd": {
"type": [
"number",
"null"
]
},
"ranked_by": {
"type": [
"string",
"null"
]
},
"top": {
"type": "array",
"items": {
"type": [
"object",
"null"
],
"properties": {
"coin": {
"type": [
"string",
"null"
]
},
"mark": {
"type": [
"number",
"null"
]
},
"oracle": {
"type": [
"number",
"null"
]
},
"change_24h_pct": {
"type": [
"number",
"null"
]
},
"volume_24h_usd": {
"type": [
"number",
"null"
]
},
"open_interest_usd": {
"type": [
"number",
"null"
]
},
"funding_hourly_pct": {
"type": [
"number",
"null"
]
},
"funding_apr_pct": {
"type": [
"number",
"null"
]
},
"premium_pct": {
"type": [
"number",
"null"
]
},
"max_leverage": {
"type": [
"number",
"null"
]
}
}
}
}
}
}🟢fear_greed(days)
The Crypto Fear & Greed Index (0–100) now and its history, with the 7 d / 30 d average and how extreme today is. alternative.me index, daily. Up to 365 days of history. Price: free. Errors: returns isError with a message for invalid input or an upstream failure (not charged).
Input Schema
{
"type": "object",
"properties": {
"days": {
"type": "integer",
"minimum": 1,
"maximum": 365,
"default": 30,
"description": "Days of index history to include. Range 1-365. Default 30."
}
},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"now": {
"type": [
"object",
"null"
],
"properties": {
"date": {
"type": [
"string",
"null"
]
},
"value": {
"type": [
"number",
"null"
]
},
"label": {
"type": [
"string",
"null"
]
}
}
},
"avg_7d": {
"type": [
"number",
"null"
]
},
"avg_30d": {
"type": [
"number",
"null"
]
},
"history": {
"type": "array",
"items": {
"type": [
"object",
"null"
],
"properties": {
"date": {
"type": [
"string",
"null"
]
},
"value": {
"type": [
"number",
"null"
]
},
"label": {
"type": [
"string",
"null"
]
}
}
}
},
"source": {
"type": [
"string",
"null"
]
}
}
}Community
Evidence