defillama-mcp

Purpose: Batch historical price queries Request Body: { "coins": { "ethereum:0x...": [1640995200, 1641081600], "bsc:0x...": [1640995200] } } Response: { "coins": { "ethereum:0x...": { "prices": [ {"timestamp": 1640995200, "price": 1.01}, {"timestamp": 1641081600, "price": 0.99} ] } } }

[DISCOVERY] Purpose: TVL by category Parameters: None Response: { "chart": { "1752796800": { "Lending": {"tvl": 25000000000}, "Dexes": {"tvl": 15000000000}, "CDP": {"tvl": 8000000000} } }, "categories": { "Lending": ["aave", "compound", "morpho"], "Dexes": ["uniswap", "curve", "balancer"], "CDP": ["makerdao", "liquity", "reflexer"] }, "categoryPercentages": { "Lending": 50.0, "Dexes": 30.0, "CDP": 16.0, "Others": 4.0 } }

[DISCOVERY] Base: https://pro-api.llama.fi Purpose: Asset breakdown across all chains Parameters: None Response: { "Ethereum": { "canonical": { "total": "4482065428.83", "breakdown": {"USDT": "2000000000", "USDC": "1500000000"} }, "native": { "total": "10848868127.01", "breakdown": {"ETH": "10000000000"} }, "thirdParty": { "total": "3182802062.49", "breakdown": {"WBTC": "2000000000"} } }, "timestamp": 1752843956 } =============================================================================== SECTION 2: PRICE & COIN DATA =============================================================================== Base URL for all: https://pro-api.llama.fi

Purpose: Detailed vesting schedule

[DISCOVERY] Purpose: All tokens with unlock schedules Parameters: None Response: [ { "token": "coingecko:whitebit", "sources": [ "https://cdn.whitebit.com/wbt/whitepaper-en.pdf" ], "protocolId": "6143", "name": "WhiteBIT", "circSupply": 293500000, "circSupply30d": 293500000, "totalLocked": 81500000, "maxSupply": 375000000, "gecko_id": "whitebit", "events": [ { "description": "A cliff of {tokens[0]} tokens was unlocked from Funds 1 on {timestamp}", "timestamp": 1659657600, "noOfTokens": [ 120000000 ], "category": "noncirculating", "unlockType": "cliff" } ], "nextEvent": { "date": 1773360001, "toUnlock": 81500000 }, "unlocksPerDay": 0, "mcap": 6577845629.249915 } ]

[DISCOVERY] Purpose: Company/entity information Parameters: None Response: [ { "id": "entity-8", "name": "Blockchain Capital", "url": "https://blockchain.capital", "description": "Blockchain Capital is a leading venture firm in the blockchain industry. In the last 9 years we have made over 160 investments in companies and protocols in the sector, across different stages, geographies and asset types.", "logo": "https://icons.llama.fi/blockchain-capital.jpg", "category": "VC", "module": "entities/blockchain-capital.js", "twitter": "blockchaincap", "symbol": "", "chain": "Ethereum", "gecko_id": null, "cmcId": null, "chains": [ "Ethereum" ], "slug": "blockchain-capital", "tvl": 131402986.1539898, "chainTvls": { "Ethereum": 131402986.1539898 }, "change_1h": 0.5368786705972184, "change_1d": 5.632604890674784, "change_7d": 11.27548502629729, "tokenBreakdowns": { "ownTokens": 0, "stablecoins": 0.06493662312, "majors": 29628575.4114822, "others": 101774410.67757098 }, "mcap": null } ]

[DISCOVERY] Purpose: Protocol fork relationships Parameters: None Response: { "chart": { "1752796800": { "Uniswap V3": {"tvl": 5000000000, "forks": 15}, "Compound V2": {"tvl": 3000000000, "forks": 8} } }, "forks": { "Uniswap V3": ["pancakeswap-v3", "sushiswap-v3", "quickswap-v3"], "Compound V2": ["benqi", "moonwell", "bastion"] }, "parentProtocols": { "pancakeswap-v3": "Uniswap V3", "benqi": "Compound V2" } }

[DISCOVERY] Purpose: Historical exploits database Parameters: None Response: [ { "date": 1711065600, "name": "Super Sushi Samurai", "classification": "Protocol Logic", "technique": "Infinite Mint and Dump", "amount": 4800000, "chain": [ "Blast" ], "bridgeHack": false, "targetType": "Gaming", "source": "https://rekt.news/sss-rekt/", "returnedFunds": null, "defillamaId": null, "language": "Solidity" } ]

Purpose: Historical liquidity for token

Base: https://pro-api.llama.fi Purpose: Daily capital flows for a protocol

[DISCOVERY] Purpose: Oracle protocol data Parameters: None Response: { "chart": { "1752796800": { "Chainlink": {"tvl": 15000000000, "protocolsSecured": 250}, "Pyth": {"tvl": 8000000000, "protocolsSecured": 150} } }, "oracles": { "Chainlink": ["Ethereum", "Arbitrum", "BSC"], "Pyth": ["Solana", "Aptos", "Sui"] }, "totalValueSecured": 50000000000, "dominance": { "Chainlink": 60.5, "Pyth": 25.3, "UMA": 8.2 } }

[DISCOVERY] Base: https://pro-api.llama.fi Purpose: Aggregated derivatives data Parameters: None Response: { "totalVolume24h": 5000000000, "totalOpenInterest": 2000000000, "change_1d": 10.5, "protocols": { "gmx": { "volume24h": 1000000000, "openInterest": 500000000, "chains": ["Arbitrum", "Avalanche"] } } }

[DISCOVERY] Purpose: Aggregated DEX volumes

[DISCOVERY] Purpose: Protocol fees overview

[DISCOVERY] Purpose: Options trading volumes

Base: https://pro-api.llama.fi Purpose: Detailed protocol data including historical TVL

[DISCOVERY] Base: https://pro-api.llama.fi Purpose: List all protocols with current TVL Parameters: None Response: [{ "id": "2269", "name": "Aave", "symbol": "AAVE", "category": "Lending", "chains": ["Ethereum", "Polygon"], "tvl": 5200000000, "chainTvls": {"Ethereum": 3200000000}, "change_1h": 0.5, "change_1d": 2.3, "change_7d": -1.2, "mcap": 1500000000 }]

[DISCOVERY] Purpose: Funding rounds database Parameters: None Response: { "raises": [ { "date": 1740528000, "name": "Ethena Labs", "round": "Strategic", "amount": 16, "chains": [ "Ethereum" ], "sector": "Ethena is a synthetic dollar protocol built on Ethereum", "category": "DeFi", "categoryGroup": "DeFi & CeFi", "source": "https://www.benzinga.com/pressreleases/25/02/g43966782/mexc-invests-20-million-in-usde-to-drive-stablecoin-adoption-launches-1-000-000-reward-event", "leadInvestors": [ "MEXC Ventures" ], "otherInvestors": [], "valuation": null, "defillamaId": "parent#ethena" } ] }

Base: https://pro-api.llama.fi Purpose: Specific derivatives protocol

Purpose: Specific DEX protocol volumes

Purpose: Specific protocol fees

Purpose: Specific options protocol data

Base: https://pro-api.llama.fi Purpose: Shows which protocols hold a specific token

PREREQUISITE: You MUST first call a listing/map endpoint to resolve asset identifiers (id, slug, symbol) before calling data endpoints.

[DISCOVERY] Purpose: Protocol treasury balances Parameters: None Response: [ { "id": "6355-treasury", "name": "SharpLink Gaming (treasury)", "address": null, "symbol": "-", "url": "https://www.sharplink.com/", "description": "SharpLink is one of the first Nasdaq-listed companies to develop a treasury strategy centered on ETH", "chain": "Ethereum", "logo": "https://icons.llama.fi/sharplink-gaming.jpg", "audits": "0", "audit_note": null, "gecko_id": null, "cmcId": null, "category": "Treasury Manager", "chains": [ "Ethereum" ], "module": "treasury/sharplink-gaming.js", "treasury": "sharplink-gaming.js", "forkedFromIds": [], "twitter": "SharpLinkGaming", "slug": "sharplink-gaming-(treasury)", "tvl": 976150507.157045, "chainTvls": { "Ethereum": 976150507.157045 }, "change_1h": -1.1231970563777622, "change_1d": 15.845546813803097, "change_7d": 75.57040101595928, "tokenBreakdowns": { "ownTokens": 0, "stablecoins": 0.003, "majors": 67481592.5634468, "others": 908668914.5905982 }, "mcap": null } ]

Base: https://pro-api.llama.fi Purpose: Simple endpoint returning only current TVL number

[DISCOVERY] Base: https://pro-api.llama.fi Purpose: Current TVL of all chains Parameters: None Response: [{ "gecko_id": "ethereum", "tvl": 50000000000, "tokenSymbol": "ETH", "cmcId": "1027", "name": "Ethereum", "chainId": 1 }]

Base: https://pro-api.llama.fi Purpose: Historical TVL for all chains Parameters: None Response: [{ "date": 1640995200, "tvl": {"Ethereum": 150000000000, "BSC": 20000000000} }]

Purpose: Detailed bridge data — live data from DefiLlama (analytics)

PREREQUISITE: You MUST first call a listing/map endpoint to resolve asset identifiers (id, slug, symbol) before calling data endpoints.

Purpose: Daily bridge stats — live data from DefiLlama (analytics)

[DISCOVERY] Purpose: List all bridges — live data from DefiLlama (analytics)

Purpose: Bridge volume for chain

Purpose: Bridge transactions — live data from DefiLlama (analytics)

PREREQUISITE: You MUST first call a listing/map endpoint to resolve asset identifiers (id, slug, symbol) before calling data endpoints.

Purpose: Get block number at timestamp

Purpose: Price chart data with configurable intervals

Purpose: Price change percentages

Purpose: Current prices for specified coins

Purpose: First recorded price for coins

Purpose: Historical prices at specific timestamp

[DISCOVERY] Purpose: Get comprehensive Digital Asset Treasury data for all institutions Description: Returns detailed data about institutions holding digital assets, including mNAV calculations (realized, realistic, maximum) as described in the DAT Methodology (https://docs.llama.fi/analysts/dat-methodology) Parameters: None Response: { "institutionMetadata": { "1": { "institutionId": 1, "ticker": "MSTR", "name": "Strategy, Inc. (Formerly: MicroStrategy Inc.)", "type": "Stock", "price": 171.42, "priceChange24h": -3.25, "volume24h": 42770300, "mcapRealized": 49258176727.84, "mcapRealistic": 54861256214.33, "mcapMax": 54861256214.33, "realized_mNAV": 0.838, "realistic_mNAV": 0.934, "max_mNAV": 0.934, "totalUsdValue": 58754718187.34, "totalCost": 48422689951, "holdings": { "bitcoin": { "amount": 650001, "avgPrice": 74496.33, "usdValue": 60619743261, "cost": 48422689951, "transactionCount": 90, "firstAnnouncementDate": "2020-08-11", "lastAnnouncementDate": "2025-12-01", "supplyPercentage": 3.26 } } } }, "assetMetadata": { "bitcoin": { "name": "Bitcoin", "ticker": "BTC", "geckoId": "bitcoin", "companies": 36, "totalAmount": 951605.06, "totalUsdValue": 88747639039.36, "circSupplyPerc": 4.77 } }, "institutions": [ { "institutionId": 1, "totalUsdValue": 58754718187.34, "totalCost": 48422689951 } ], "assets": { "bitcoin": [ { "institutionId": 1, "usdValue": 60619743261, "amount": 650001 } ] }, "totalCompanies": 70, "flows": { "bitcoin": [ [1583107200000, 944, 944, 0, 0, 8088005.32] ] }, "mNAV": { "bitcoin": { "MSTR": [ [1595894400000, 0.485, 0.488, 0.559] ] } }, "lastUpdated": "2025-12-03T10:21:47.773Z" }

Purpose: Historical ETF flows Parameters: None Response: [ { "timestamp": 1704931200, "timestamp_exact": 1705017598, "ticker": "ARKB", "price": 46.76, "volume": 279749462.16, "aum": 46855730.4, "underlying": null, "shares": 1002047.271171942, "underlying_price": 46396, "flows": null } ]

Purpose: Historical Ethereum ETF data Parameters: None Response: Similar to history but ETH only

Purpose: TradFi crypto ETF overview Parameters: None Response: [ { "timestamp": 1732278611, "timestamp_as_of": 1732147200, "ticker": "IBIT", "issuer": "Blackrock", "etf_name": "iShares Bitcoin Trust", "etf_type": "spot", "custodian": "Coinbase", "pct_fee": 0.25, "url": "https://www.blackrock.com/us/individual/products/333011/ishares-bitcoin-trust", "price": 55.9, "volume": 5105037034.5, "shares": 846080000, "underlying": null, "underlying_price": 98855, "aum": 47313346647, "flows": 645378400 } ]

Purpose: Ethereum ETF data Parameters: None Response: Similar to overview but ETH only

Purpose: FDV performance metrics

Purpose: Detailed data for specific stablecoin

[DISCOVERY] Purpose: List all chains with stablecoin data Parameters: None Response: [ { "name": "Ethereum", "totalCirculating": { "peggedUSD": 45000000000 } } ]

Purpose: Historical stablecoin data for specific chain

Purpose: Historical market cap data for all stablecoins Parameters: None Response: [ { "date": 1609459200, "totalCirculating": { "peggedUSD": 25000000000 } } ]

Purpose: Get stablecoin dominance per chain

[DISCOVERY] Purpose: Historical prices for all stablecoins Parameters: None Response: [ { "date": 1609459200, "prices": { "USDT": 1.001, "USDC": 0.999, "DAI": 1.002, "BUSD": 1.000 } } ] =============================================================================== SECTION 5: VOLUME METRICS (DEXs, Derivatives, Options) =============================================================================== Base URL: https://pro-api.llama.fi

[DISCOVERY] Purpose: List all stablecoins with current market data Parameters: None Response: [ { "id": 1, "name": "Tether USD", "symbol": "USDT", "gecko_id": "tether", "circulating": 75000000000, "price": 1.001, "chains": ["Ethereum", "Tron", "BSC"], "chainCirculating": { "Ethereum": 45000000000, "Tron": 20000000000, "BSC": 10000000000 } } ]

Base: https://pro-api.llama.fi Purpose: Check API usage Parameters: None (uses API key from header) Response: { "creditsRemaining": 95000, "creditsUsed": 5000, "resetDate": "2024-02-01", "plan": "pro", "rateLimit": "1000/hour", "endpoints": ["all"] }

Base: https://pro-api.llama.fi Purpose: Historical APY/TVL for a pool

Base: https://pro-api.llama.fi Purpose: Historical lend/borrow rates

[DISCOVERY] Base: https://pro-api.llama.fi Purpose: Liquid staking derivative rates Parameters: None Response: { "status": "success", "data": [{ "pool": "lsd-123", "project": "lido", "symbol": "stETH", "chain": "Ethereum", "apy": 3.8, "tvlUsd": 35000000000, "apyBase": 3.8, "apyBase7d": 3.7, "apyBase30d": 3.9, "marketShare": 0.32 }] } =============================================================================== SECTION 4: STABLECOINS =============================================================================== Base URL: https://pro-api.llama.fi

[DISCOVERY] Base: https://pro-api.llama.fi Purpose: Perpetual futures funding rates Parameters: None Response: { "status": "success", "data": [{ "pool": "perp-123", "chain": "Arbitrum", "project": "gmx", "symbol": "ETH-USD", "fundingRate": 0.01, "fundingRate7dAvg": 0.008, "fundingRate30dAvg": 0.009, "openInterest": 500000000, "indexPrice": 2500.50, "markPrice": 2501.00, "nextFundingTime": "2024-01-16T08:00:00Z" }] }

[DISCOVERY] Base: https://pro-api.llama.fi Purpose: All yield pools with current APY Parameters: None Response: { "status": "success", "data": [{ "pool": "747c1d2a-c668-4682-b9f9-296708a3dd90", "chain": "Ethereum", "project": "aave-v3", "symbol": "USDC", "tvlUsd": 1500000000, "apy": 3.5, "apyBase": 2.5, "apyReward": 1.0, "rewardTokens": ["AAVE"], "underlyingTokens": ["0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"], "poolMeta": "Lending", "exposure": "single", "il7d": 0, "apyBase7d": 2.3, "volumeUsd1d": 50000000, "volumeUsd7d": 350000000 }] }

Base: https://pro-api.llama.fi Purpose: Borrowing rates across protocols Parameters: None Response: { "status": "success", "data": [{ "pool": "abc-123", "chain": "Ethereum", "project": "aave-v3", "symbol": "USDC", "apyBaseBorrow": 5.2, "apyRewardBorrow": -0.5, "totalSupplyUsd": 2000000000, "totalBorrowUsd": 1500000000, "ltv": 0.75, "borrowable": true, "mintedCoin": "aUSDC" }] }

Base: https://pro-api.llama.fi Purpose: Legacy pools with contract addresses Parameters: None Response: Similar to /pools with additional pool_old field