MAD Synapse · Chain
Cross-chain markets: prices, DeFi TVL, yields, stablecoins, gas, order books, perps funding.
사용해야 할까요
품질 및 안전성
발견 사항 (3)
- HIGHTool poisoning patterns detected
- MEDIUMTool description contains URL to non-standard domaincrypto_price에서
- MEDIUMTool description contains URL to non-standard domainprice_history에서
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"synapse-chain": {
"url": "https://agent.maddegen.art/hub/mcp/chain"
}
}
}원격 엔드포인트
https://agent.maddegen.art/hub/mcp/chainstreamable-http할 수 있는 일
도구 목록
도구 (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).
입력 스키마
{
"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
}출력 스키마
{
"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).
입력 스키마
{
"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
}출력 스키마
{
"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).
입력 스키마
{
"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
}출력 스키마
{
"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).
입력 스키마
{
"type": "object",
"properties": {
"protocol": {
"type": "string",
"description": "name or slug"
}
},
"required": [
"protocol"
],
"additionalProperties": false
}출력 스키마
{
"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).
입력 스키마
{
"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
}출력 스키마
{
"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).
입력 스키마
{
"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
}출력 스키마
{
"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).
입력 스키마
{
"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
}출력 스키마
{
"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).
입력 스키마
{
"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
}출력 스키마
{
"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).
입력 스키마
{
"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
}출력 스키마
{
"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).
입력 스키마
{
"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
}출력 스키마
{
"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).
입력 스키마
{
"type": "object",
"properties": {
"pair": {
"type": "string",
"description": "BTC/USD, ETH-USDT, SOL"
}
},
"required": [
"pair"
],
"additionalProperties": false
}출력 스키마
{
"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).
입력 스키마
{
"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
}출력 스키마
{
"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).
입력 스키마
{
"type": "object",
"properties": {
"coin": {
"type": "string",
"pattern": "^[A-Za-z0-9]{2,12}$",
"description": "BTC, ETH, SOL…"
}
},
"required": [
"coin"
],
"additionalProperties": false
}출력 스키마
{
"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).
입력 스키마
{
"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
}출력 스키마
{
"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).
입력 스키마
{
"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
}출력 스키마
{
"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"
]
}
}
}커뮤니티
증거