{"uid":"cap_Jvj8bR5aY8Rs_7wsfDF_M","slug":"agent402-defi-protocol-lookup-bd11e9f5","name":"Agent402 DeFi Protocol Lookup","description":"One DeFi protocol in full: TVL rank, TVL per chain, recent change, market cap to TVL, token, website, audits and parent, with name suggestions when the slug is unknown. Use it when an agent is researching a specific protocol and needs its size, footprint and audit status in one answer.","url":"https://agent402.tools/api/defi-protocol","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"protocol":{"type":"string","description":"DefiLlama protocol slug (lowercase, hyphenated), e.g. aave-v3, uniswap-v3, lido, morpho-v1."}}},"responseSchema":{"type":"json","example":{"cached":true,"source":"defillama-protocols","protocol":{"url":"https://aave.com","logo":"https://icons.llamao.fi/icons/protocols/aave-v3","name":"Aave V3","rank":3,"slug":"aave-v3","audits":2,"chains":["Ethereum","Base"],"symbol":"AAVE","tvlUsd":17023522168,"address":"0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9","geckoId":null,"mcapTvl":0.188,"mcapUsd":3200000000,"twitter":"aave","category":"Lending","listedAt":"2022-04-01","pool2Usd":null,"chainTvls":[{"chain":"Ethereum","tvlUsd":12000000000}],"auditLinks":["https://aave.com/security"],"chainCount":21,"stakingUsd":null,"borrowedUsd":9000000000,"change1dPct":0.8,"change1hPct":0.02,"change7dPct":2.4,"description":"Earn interest, borrow assets, and build applications","parentProtocol":"aave"},"fetchedAt":"2026-08-22T12:00:00.000Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_KHJNSBJAdWkLFfqtZ83dr","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches comprehensive DeFi protocol data from DefiLlama including TVL, market cap, chains, audits, and metadata for a given protocol slug","exampleAgentPrompt":"Pull up the DefiLlama data for aave-v3 — I want to see its TVL, how many chains it's on, market cap, and audit info.","exampleUseCases":[{"title":"Portfolio DeFi protocol due diligence","prompt":"Before I allocate funds, can you look up lido on DefiLlama and tell me its current TVL, audit status, which chains it's on, and its market cap to TVL ratio?"},{"title":"Protocol TVL trend monitoring","prompt":"Check the DefiLlama stats for morpho-v1 — specifically the 1-day and 7-day TVL percentage changes so I can see if it's growing or shrinking."},{"title":"Competitive lending protocol comparison","prompt":"Fetch the protocol details for uniswap-v3 from DefiLlama, including its category, total TVL, chain count, and token symbol so I can compare it against other DEXes."}],"resultDescription":"Returns a JSON object with comprehensive protocol data including: name, slug, TVL in USD (total and per-chain breakdown), 1h/1d/7d TVL change percentages, market cap, mcap/TVL ratio, borrowed USD, staking USD, pool2 USD, token symbol, CoinGecko ID, contract address, category, listed date, chain list, audit count and links, Twitter handle, description, logo URL, parent protocol, and cache metadata (source, fetchedAt, cached flag).","failureModes":["Invalid or unknown protocol slug returns error or empty result","Misspelled slug (e.g. 'aavev3' instead of 'aave-v3') causes lookup failure","Protocol not indexed by DefiLlama returns no data","Network timeout if DefiLlama upstream is slow","Stale cached data if protocol TVL has changed very recently"],"whenToPreferThis":"Use this endpoint when you need rich, structured DeFi protocol metadata from DefiLlama — including TVL, chain coverage, audits, and market metrics — for a specific protocol by its slug. Prefer this over scraping DefiLlama directly or using a general web search when you need structured JSON output suitable for programmatic analysis, comparison, or downstream agent reasoning. Best when you already know the protocol slug or can derive it.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:51:46.131Z","isFirstParty":false}