Serveur MCP

MAD Synapse · Chain

art.maddegen.agent/synapse-chain

Ce que fait ce MCP

Provides cross-chain crypto prices, exchange order books, DeFi metrics, yields, stablecoin data, gas costs, and derivatives funding information.

cex_ticker
Exchange prices (Kraken/Coinbase/OKX)
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).
Lecture seule Accès externe Idempotent
Schéma d’entrée
{'type': 'object', 'required': ['pair'], 'properties': {'pair': {'type': 'string', 'description': 'BTC/USD, ETH-USDT, SOL'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'properties': {'pair': {'type': ['string', 'null']}, 'venues': {'type': 'array', 'items': {'type': ['object', 'null'], 'properties': {'ask': {'type': ['number', 'null']}, 'bid': {'type': ['number', 'null']}, 'last': {'type': ['number', 'null']}, 'pair': {'type': ['string', 'null']}, 'venue': {'type': ['string', 'null']}, 'low_24h': {'type': ['number', 'null']}, 'high_24h': {'type': ['number', 'null']}, 'open_24h': {'type': ['number', 'null']}, 'vwap_24h': {'type': ['number', 'null']}, 'change_24h_pct': {'type': ['number', 'null']}, 'volume_24h_base': {'type': ['number', 'null']}}}}, 'best_ask': {'type': ['string', 'null']}, 'best_bid': {'type': ['string', 'null']}, 'cross_venue_spread_bps': {'type': ['number', 'null']}}}
chain_tvl
Chain TVL
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).
Lecture seule Accès externe Idempotent
Schéma d’entrée
{'type': 'object', 'properties': {'days': {'type': 'integer', 'default': 90, 'maximum': 365, 'minimum': 7, 'description': 'Days of daily TVL history (only when a single chain is requested). Range 7-365. Default 90.'}, 'chain': {'type': 'string', 'description': 'e.g. Solana, Ethereum, Base (optional)'}, 'limit': {'type': 'integer', 'default': 30, 'maximum': 200, 'minimum': 1, 'description': 'How many chains to return in the ranking. Range 1-200. Default 30.'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'properties': {'rank': {'type': ['number', 'null']}, 'chain': {'type': ['string', 'null']}, 'history': {'type': 'array', 'items': {'type': ['object', 'null'], 'properties': {'date': {'type': ['string', 'null']}, 'tvl_usd': {'type': ['number', 'null']}}}}, 'tvl_usd': {'type': ['number', 'null']}, 'change_7d_pct': {'type': ['number', 'null']}, 'change_30d_pct': {'type': ['number', 'null']}, 'change_90d_pct': {'type': ['number', 'null']}}}
crypto_price
Crypto prices (any 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).
Lecture seule Accès externe Idempotent
Schéma d’entrée
{'type': 'object', 'required': ['assets'], 'properties': {'chain': {'enum': ['ethereum', 'base', 'arbitrum', 'optimism', 'polygon', 'bsc', 'avalanche', 'linea', 'blast', 'scroll', 'gnosis', 'sonic', 'unichain', 'mantle', 'berachain', 'hyperevm', 'monad'], 'type': 'string', '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".'}, 'assets': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 30, 'description': 'e.g. ["BTC","ETH","coingecko:solana","base:0x833589fcd6edb6e08f4c7c32d4f71b54bda02913"]. 0-30 items.'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'properties': {'as_of': {'type': ['string', 'null']}, 'prices': {'type': 'array', 'items': {'type': ['object', 'null'], 'properties': {'id': {'type': ['string', 'null']}, 'usd': {'type': ['number', 'null']}, 'name': {}, 'query': {'type': ['string', 'null']}, 'symbol': {'type': ['string', 'null']}, 'updated': {'type': ['string', 'null']}, 'decimals': {}, 'confidence': {'type': ['number', 'null']}, 'change_24h_pct': {'type': ['number', 'null']}, 'market_cap_rank': {}}}}, 'source': {'type': ['string', 'null']}}}
defi_protocol
DeFi protocol profile
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).
Lecture seule Accès externe Idempotent
Schéma d’entrée
{'type': 'object', 'required': ['protocol'], 'properties': {'protocol': {'type': 'string', 'description': 'name or slug'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'properties': {'url': {'type': ['string', 'null']}, 'name': {'type': ['string', 'null']}, 'slug': {'type': ['string', 'null']}, 'found': {'type': ['boolean', 'null']}, 'token': {'type': ['string', 'null']}, 'audits': {'type': ['number', 'null']}, 'tvl_usd': {'type': ['number', 'null']}, 'twitter': {'type': ['string', 'null']}, 'category': {'type': ['string', 'null']}, 'fees_usd': {'type': ['object', 'null'], 'properties': {'7d': {'type': ['number', 'null']}, '24h': {'type': ['number', 'null']}, '30d': {'type': ['number', 'null']}, 'all_time': {'type': ['number', 'null']}}}, 'gecko_id': {}, 'mcap_usd': {}, 'listed_at': {'type': ['string', 'null']}, 'audit_links': {'type': 'array', 'items': {'type': ['string', 'null']}}, 'description': {'type': ['string', 'null']}, 'forked_from': {'type': 'array'}, 'revenue_usd': {'type': ['object', 'null'], 'properties': {'7d': {'type': ['number', 'null']}, '24h': {'type': ['number', 'null']}, '30d': {'type': ['number', 'null']}, 'all_time': {'type': ['number', 'null']}}}, 'alternatives': {'type': 'array', 'items': {'type': ['object', 'null'], 'properties': {'name': {'type': ['string', 'null']}, 'slug': {'type': ['string', 'null']}, 'tvl_usd': {'type': ['number', 'null']}}}}, 'tvl_by_chain': {'type': 'array', 'items': {'type': ['object', 'null'], 'properties': {'chain': {'type': ['string', 'null']}, 'tvl_usd': {'type': ['number', 'null']}}}}, 'change_1d_pct': {'type': ['number', 'null']}, 'change_1h_pct': {'type': ['number', 'null']}, 'change_7d_pct': {'type': ['number', 'null']}}}
defi_rankings
DeFi protocol rankings
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).
Lecture seule Accès externe Idempotent
Schéma d’entrée
{'type': 'object', 'properties': {'sort': {'enum': ['tvl', 'change_1d', 'change_7d'], 'type': 'string', 'default': 'tvl', 'description': 'Rank by current TVL or by 1-day / 7-day TVL change. One of "tvl", "change_1d", "change_7d". Default "tvl".'}, 'chain': {'type': 'string', 'description': 'DefiLlama chain name, e.g. Ethereum, Solana, Base, Arbitrum (optional)'}, 'limit': {'type': 'integer', 'default': 25, 'maximum': 100, 'minimum': 1, 'description': 'How many protocols to return. Range 1-100. Default 25.'}, 'category': {'type': 'string', 'description': 'e.g. Lending, Dexs, Liquid Staking, Bridge, Derivatives, Yield, CDP, RWA (optional)'}, 'min_tvl_usd': {'type': 'number', 'default': 1000000, 'minimum': 0, 'description': 'Skip protocols with less TVL than this (USD). Default 1000000.'}}, 'additionalProperties': False}
Schéma de sortie
{'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': {'url': {'type': ['string', 'null']}, 'name': {'type': ['string', 'null']}, 'slug': {'type': ['string', 'null']}, 'chains': {'type': 'array'}, 'tvl_usd': {'type': ['number', 'null']}, 'twitter': {'type': ['string', 'null']}, 'category': {'type': ['string', 'null']}, 'mcap_usd': {}, 'change_1d_pct': {'type': ['number', 'null']}, 'change_1h_pct': {'type': ['number', 'null']}, 'change_7d_pct': {'type': ['number', 'null']}, 'tvl_total_usd': {'type': ['number', 'null']}}}}, 'categories_hint': {}}}
dex_volumes
DEX volume rankings
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).
Lecture seule Accès externe Idempotent
Schéma d’entrée
{'type': 'object', 'properties': {'type': {'enum': ['dexs', 'derivatives', 'aggregators'], 'type': 'string', 'default': 'dexs', 'description': 'Spot DEXes, perp/derivatives DEXes, or DEX aggregators. One of "dexs", "derivatives", "aggregators". Default "dexs".'}, 'chain': {'type': 'string', 'description': 'e.g. Solana, Base (optional)'}, 'limit': {'type': 'integer', 'default': 15, 'maximum': 50, 'minimum': 1, 'description': 'How many venues to return. Range 1-50. Default 15.'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'properties': {'top': {'type': 'array', 'items': {'type': ['object', 'null'], 'properties': {'name': {'type': ['string', 'null']}, 'chains': {'type': 'array'}, 'share_pct': {'type': ['number', 'null']}, 'change_1d_pct': {'type': ['number', 'null']}, 'volume_7d_usd': {'type': ['number', 'null']}, 'volume_24h_usd': {'type': ['number', 'null']}}}}, 'type': {'type': ['string', 'null']}, 'scope': {'type': ['string', 'null']}, 'source': {'type': ['string', 'null']}, 'volume_usd': {'type': ['object', 'null'], 'properties': {'7d': {'type': ['number', 'null']}, '24h': {'type': ['number', 'null']}, '30d': {'type': ['number', 'null']}}}, 'change_1d_pct': {'type': ['number', 'null']}, 'change_7d_pct': {'type': ['number', 'null']}}}
fear_greed
Crypto Fear & Greed
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).
Lecture seule Accès externe Idempotent
Schéma d’entrée
{'type': 'object', 'properties': {'days': {'type': 'integer', 'default': 30, 'maximum': 365, 'minimum': 1, 'description': 'Days of index history to include. Range 1-365. Default 30.'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'properties': {'now': {'type': ['object', 'null'], 'properties': {'date': {'type': ['string', 'null']}, 'label': {'type': ['string', 'null']}, 'value': {'type': ['number', 'null']}}}, 'avg_7d': {'type': ['number', 'null']}, 'source': {'type': ['string', 'null']}, 'avg_30d': {'type': ['number', 'null']}, 'history': {'type': 'array', 'items': {'type': ['object', 'null'], 'properties': {'date': {'type': ['string', 'null']}, 'label': {'type': ['string', 'null']}, 'value': {'type': ['number', 'null']}}}}}}
fees_revenue
Protocol fees + revenue
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).
Lecture seule Accès externe Idempotent
Schéma d’entrée
{'type': 'object', 'properties': {'chain': {'type': 'string', 'description': 'optional'}, 'limit': {'type': 'integer', 'default': 20, 'maximum': 50, 'minimum': 1, 'description': 'How many protocols to return. Range 1-50. Default 20.'}, 'metric': {'enum': ['fees', 'revenue'], 'type': 'string', 'default': 'fees', 'description': 'Gross fees paid by users, or revenue kept by the protocol. One of "fees", "revenue". Default "fees".'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'properties': {'top': {'type': 'array', 'items': {'type': ['object', 'null'], 'properties': {'name': {'type': ['string', 'null']}, '7d_usd': {'type': ['number', 'null']}, 'chains': {'type': 'array'}, '24h_usd': {'type': ['number', 'null']}, '30d_usd': {'type': ['number', 'null']}, 'category': {'type': ['string', 'null']}, 'change_1d_pct': {'type': ['number', 'null']}}}}, 'scope': {'type': ['string', 'null']}, 'metric': {'type': ['string', 'null']}, 'source': {'type': ['string', 'null']}, 'total_usd': {'type': ['object', 'null'], 'properties': {'7d': {'type': ['number', 'null']}, '24h': {'type': ['number', 'null']}, '30d': {'type': ['number', 'null']}}}}}
funding_rates
Perp funding rates
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).
Lecture seule Accès externe Idempotent
Schéma d’entrée
{'type': 'object', 'required': ['coin'], 'properties': {'coin': {'type': 'string', 'pattern': '^[A-Za-z0-9]{2,12}$', 'description': 'BTC, ETH, SOL…'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'properties': {'coin': {'type': ['string', 'null']}, 'as_of': {'type': ['string', 'null']}, 'venues': {'type': 'array', 'items': {'type': ['object', 'null'], 'properties': {'mark': {'type': ['number', 'null']}, 'note': {'type': ['string', 'null']}, 'venue': {'type': ['string', 'null']}, 'apr_pct': {'type': ['number', 'null']}, 'hourly_pct': {'type': ['number', 'null']}, 'next_funding': {'type': ['string', 'null']}, 'interval_hours': {'type': ['number', 'null']}, 'open_interest_usd': {'type': ['number', 'null']}, 'rate_per_interval_pct': {'type': ['number', 'null']}}}}, 'meaning': {'type': ['string', 'null']}, 'spread_apr_pct': {'type': ['number', 'null']}}}
gas_now
Gas + fees across 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).
Lecture seule Accès externe Idempotent
Schéma d’entrée
{'type': 'object', 'properties': {'chains': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 20, 'description': 'subset, e.g. ["ethereum","base","solana","bitcoin"] (default: all) 0-20 items.'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'properties': {'note': {'type': ['string', 'null']}, 'as_of': {'type': ['string', 'null']}, 'chains': {'type': 'array', 'items': {'type': ['object', 'null'], 'properties': {'chain': {'type': ['string', 'null']}, 'native': {'type': ['string', 'null']}, 'sat_per_vb': {'type': ['object', 'null']}, 'total_gwei': {'type': ['number', 'null']}, 'measured_on': {'type': ['string', 'null']}, 'usd_140vb_tx': {'type': ['object', 'null']}, 'base_fee_gwei': {'type': ['number', 'null']}, 'usd_swap_150k': {'type': ['number', 'null']}, 'priority_basis': {'type': ['string', 'null']}, 'usd_transfer_21k': {'type': ['number', 'null']}, 'base_fee_lamports': {'type': ['number', 'null']}, 'priority_fee_gwei': {'type': ['number', 'null']}, 'usd_simple_tx_200k_cu': {'type': ['object', 'null']}, 'priority_micro_lamports_per_cu': {'type': ['object', 'null']}}}}}}
hyperliquid_markets
Hyperliquid perps
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).
Lecture seule Accès externe Idempotent
Schéma d’entrée
{'type': 'object', 'properties': {'coin': {'type': 'string', 'description': 'optional, e.g. BTC'}, 'sort': {'enum': ['volume', 'open_interest', 'funding', 'funding_negative', 'change'], 'type': 'string', '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', 'default': 20, 'maximum': 100, 'minimum': 1, 'description': 'How many markets to return. Range 1-100. Default 20.'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'properties': {'top': {'type': 'array', 'items': {'type': ['object', 'null'], 'properties': {'coin': {'type': ['string', 'null']}, 'mark': {'type': ['number', 'null']}, 'oracle': {'type': ['number', 'null']}, 'premium_pct': {'type': ['number', 'null']}, 'max_leverage': {'type': ['number', 'null']}, 'change_24h_pct': {'type': ['number', 'null']}, 'volume_24h_usd': {'type': ['number', 'null']}, 'funding_apr_pct': {'type': ['number', 'null']}, 'open_interest_usd': {'type': ['number', 'null']}, 'funding_hourly_pct': {'type': ['number', 'null']}}}}, 'markets': {'type': ['number', 'null']}, 'ranked_by': {'type': ['string', 'null']}, 'total_volume_24h_usd': {'type': ['number', 'null']}, 'total_open_interest_usd': {'type': ['number', 'null']}}}
orderbook_depth
Order book depth + slippage
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).
Lecture seule Accès externe Idempotent
Schéma d’entrée
{'type': 'object', 'required': ['pair'], 'properties': {'pair': {'type': 'string', 'description': 'Market pair as BASE/QUOTE, e.g. "BTC/USD" or "ETH/USDT".'}, 'venue': {'enum': ['coinbase', 'kraken', 'okx'], 'type': 'string', 'default': 'coinbase', 'description': 'Exchange whose order book to read. One of "coinbase", "kraken", "okx". Default "coinbase".'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'properties': {'mid': {'type': ['number', 'null']}, 'pair': {'type': ['string', 'null']}, 'venue': {'type': ['string', 'null']}, 'levels': {'type': ['object', 'null'], 'properties': {'asks': {'type': ['number', 'null']}, 'bids': {'type': ['number', 'null']}}}, 'best_ask': {'type': ['number', 'null']}, 'best_bid': {'type': ['number', 'null']}, 'depth_usd': {'type': ['object', 'null'], 'properties': {'pm_1pct': {'type': ['object', 'null'], 'properties': {'asks': {'type': ['number', 'null']}, 'bids': {'type': ['number', 'null']}}}, 'pm_2pct': {'type': ['object', 'null'], 'properties': {'asks': {'type': ['number', 'null']}, 'bids': {'type': ['number', 'null']}}}, 'pm_5pct': {'type': ['object', 'null'], 'properties': {'asks': {'type': ['number', 'null']}, 'bids': {'type': ['number', 'null']}}}, 'pm_0.1pct': {'type': ['object', 'null'], 'properties': {'asks': {'type': ['number', 'null']}, 'bids': {'type': ['number', 'null']}}}, 'pm_0.5pct': {'type': ['object', 'null'], 'properties': {'asks': {'type': ['number', 'null']}, 'bids': {'type': ['number', 'null']}}}}}, 'spread_bps': {'type': ['number', 'null']}, 'slippage_bps_market_buy': {'type': ['object', 'null'], 'properties': {'usd_1m': {'type': ['number', 'null']}, 'usd_10k': {'type': ['number', 'null']}, 'usd_100k': {'type': ['number', 'null']}}}, 'slippage_bps_market_sell': {'type': ['object', 'null'], 'properties': {'usd_1m': {'type': ['number', 'null']}, 'usd_10k': {'type': ['number', 'null']}, 'usd_100k': {'type': ['number', 'null']}}}}}
price_history
Price history + volatility
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).
Lecture seule Accès externe Idempotent
Schéma d’entrée
{'type': 'object', 'required': ['asset'], 'properties': {'days': {'type': 'integer', 'default': 30, 'maximum': 365, 'minimum': 1, 'description': 'How many days back; hourly points up to 90 days, daily beyond. Range 1-365. Default 30.'}, 'asset': {'type': 'string', 'description': 'symbol, CoinGecko id, chain:address or address'}, 'chain': {'enum': ['ethereum', 'base', 'arbitrum', 'optimism', 'polygon', 'bsc', 'avalanche', 'linea', 'blast', 'scroll', 'gnosis', 'sonic', 'unichain', 'mantle', 'berachain', 'hyperevm', 'monad'], 'type': 'string', '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".'}, 'interval': {'enum': ['hour', 'day'], 'type': 'string', 'default': 'day', 'description': 'hourly allowed up to 30 days. One of "hour", "day". Default "day".'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'properties': {'id': {'type': ['string', 'null']}, 'asset': {'type': ['string', 'null']}, 'stats': {'type': ['object', 'null'], 'properties': {'low': {'type': ['object', 'null'], 'properties': {'t': {'type': ['string', 'null']}, 'usd': {'type': ['number', 'null']}}}, 'high': {'type': ['object', 'null'], 'properties': {'t': {'type': ['string', 'null']}, 'usd': {'type': ['number', 'null']}}}, 'last_usd': {'type': ['number', 'null']}, 'first_usd': {'type': ['number', 'null']}, 'return_pct': {'type': ['number', 'null']}, 'max_drawdown_pct': {'type': ['number', 'null']}, 'volatility_annualized_pct': {'type': ['number', 'null']}}}, 'points': {'type': ['number', 'null']}, 'series': {'type': 'array', 'items': {'type': ['object', 'null'], 'properties': {'t': {'type': ['string', 'null']}, 'usd': {'type': ['number', 'null']}}}}, 'symbol': {'type': ['string', 'null']}, 'interval': {'type': ['string', 'null']}}}
stablecoins
Stablecoin supply + peg
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).
Lecture seule Accès externe Idempotent
Schéma d’entrée
{'type': 'object', 'properties': {'peg': {'enum': ['any', 'peggedUSD', 'peggedEUR', 'peggedVAR'], 'type': 'string', 'default': 'any', 'description': 'Filter by peg currency type. One of "any", "peggedUSD", "peggedEUR", "peggedVAR". Default "any".'}, 'limit': {'type': 'integer', 'default': 25, 'maximum': 100, 'minimum': 1, 'description': 'How many stablecoins to return. Range 1-100. Default 25.'}, 'symbol': {'type': 'string', 'description': 'e.g. USDC, USDe, PYUSD (optional)'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'properties': {'source': {'type': ['string', 'null']}, 'stablecoins': {'type': 'array', 'items': {'type': ['object', 'null'], 'properties': {'peg': {'type': ['string', 'null']}, 'name': {'type': ['string', 'null']}, 'chains': {'type': ['number', 'null']}, 'symbol': {'type': ['string', 'null']}, 'mechanism': {'type': ['string', 'null']}, 'price_usd': {'type': ['number', 'null']}, 'top_chains': {'type': 'array'}, 'circulating': {'type': ['number', 'null']}, 'change_1d_pct': {'type': ['number', 'null']}, 'change_7d_pct': {'type': ['number', 'null']}, 'change_30d_pct': {'type': ['number', 'null']}, 'peg_deviation_pct': {'type': ['number', 'null']}}}}, 'total_usd_pegged': {'type': ['number', 'null']}, 'depegged_over_1pct': {'type': 'array', 'items': {'type': ['object', 'null'], 'properties': {'symbol': {'type': ['string', 'null']}, 'price_usd': {'type': ['number', 'null']}, 'circulating': {'type': ['number', 'null']}}}}}}
yield_pools
DeFi yield finder
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).
Lecture seule Accès externe Idempotent
Schéma d’entrée
{'type': 'object', 'properties': {'sort': {'enum': ['apy', 'tvl', 'apy_base', 'apy_30d_mean'], 'type': 'string', '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".'}, 'chain': {'type': 'string', 'description': 'e.g. Ethereum, Solana, Base, Arbitrum'}, 'limit': {'type': 'integer', 'default': 20, 'maximum': 50, 'minimum': 1, 'description': 'How many pools to return. Range 1-50. Default 20.'}, 'token': {'type': 'string', 'description': 'token symbol that must appear in the pool, e.g. USDC, SOL'}, 'max_apy': {'type': 'number', 'default': 1000, 'minimum': 1, 'description': 'drop absurd APYs above this. Default 1000.'}, 'project': {'type': 'string', 'description': 'protocol slug, e.g. aave-v3, kamino-lend, uniswap-v3'}, 'min_tvl_usd': {'type': 'number', 'default': 1000000, 'minimum': 0, 'description': 'Skip pools with less TVL than this (USD); raises quality. Default 1000000.'}, '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.'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'properties': {'note': {'type': ['string', 'null']}, 'pools': {'type': 'array', 'items': {'type': ['object', 'null'], 'properties': {'url': {'type': ['string', 'null']}, 'chain': {'type': ['string', 'null']}, 'symbol': {'type': ['string', 'null']}, 'apy_pct': {'type': ['number', 'null']}, 'il_risk': {'type': ['string', 'null']}, 'outlook': {'type': ['object', 'null']}, 'pool_id': {'type': ['string', 'null']}, 'project': {'type': ['string', 'null']}, 'tvl_usd': {'type': ['number', 'null']}, 'exposure': {'type': ['string', 'null']}, 'pool_meta': {}, 'stablecoin': {'type': ['boolean', 'null']}, 'apy_base_pct': {'type': ['number', 'null']}, 'apy_change_7d': {'type': ['number', 'null']}, 'reward_tokens': {'type': 'array'}, 'apy_reward_pct': {}, 'apy_30d_mean_pct': {'type': ['number', 'null']}}}}, 'source': {'type': ['string', 'null']}, 'matched': {'type': ['number', 'null']}}}
Ajouté
fear_greed
29 September 2026 02:40
Ajouté
hyperliquid_markets
29 September 2026 02:40
Ajouté
funding_rates
29 September 2026 02:40
Ajouté
orderbook_depth
29 September 2026 02:40
Ajouté
cex_ticker
29 September 2026 02:40
Ajouté
gas_now
29 September 2026 02:40
Ajouté
fees_revenue
29 September 2026 02:40
Ajouté
dex_volumes
29 September 2026 02:40
Ajouté
stablecoins
29 September 2026 02:40
Ajouté
yield_pools
29 September 2026 02:40
Ajouté
chain_tvl
29 September 2026 02:40
Ajouté
defi_protocol
29 September 2026 02:40
Ajouté
defi_rankings
29 September 2026 02:40
Ajouté
price_history
29 September 2026 02:40
Ajouté
crypto_price
29 September 2026 02:40