# DefiLlama API: Get DeFi project > Gets a DeFi project's current TVL, 1-day and 7-day changes, chain breakdown, token information and daily TVL history from DefiLlama. Parent projects combine their listed versions. Unofficial. Not affiliated with or endorsed by DefiLlama. - Page: https://fous.com/methods/defillama.com/get-defi-project - Method: `defillama.com/get_defi_project`, version 1 - Website: defillama.com - Returns: project name, category, current TVL, 1d/7d change, TVL by chain, token symbol and market cap, website, daily TVL history - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1ยข with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `project` | string | yes | `"Lido"` | Project name, DefiLlama project link, or slug, for example Aave. | | `history_period` | string | no | `"all_time"` | How much daily TVL history to include, for example last_30_days. One of "last_30_days", "last_year", "all_time". Default "last_30_days". | ## Output From a run on Oct 31, 2026, shortened. Its input: ```json { "project": "Lido", "history_period": "all_time" } ``` Its output: ```json { "chains": [ "Ethereum", "Solana", "Terra" ], "website": "https://lido.fi/", "category": "Liquid Staking", "tvl_history": [ { "date": "2020-12-19", "tvl_usd": 1484680 }, { "date": "2020-12-20", "tvl_usd": 2697598 }, { "date": "2020-12-21", "tvl_usd": 3410253 } ], "project_name": "Lido", "token_symbol": "LDO", "tvl_by_chain": [ { "chain": "Ethereum", "tvl_usd": 26325024822.21351 }, { "chain": "Solana", "tvl_usd": 6083551.77746 }, { "chain": "Terra", "tvl_usd": 0 } ], "defillama_link": "https://defillama.com/protocol/lido", "defillama_slug": "lido", "current_tvl_usd": 26331108373, "change_1d_percent": 0.2600612831057614, "change_7d_percent": -2.9147246775027003, "token_market_cap_usd": 362310450.207509 } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"defillama.com/get_defi_project","input":{"project":"Lido","history_period":"all_time"}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - What's Uniswap's current TVL and how much has it moved over the last day and week? - Pull up the DefiLlama page for Lido and give me its TVL broken down by chain, plus the token's market cap. - I need the full all-time daily TVL history for Curve Finance so I can chart it. - How is GMX's locked value split across Arbitrum and Avalanche right now, and what did its TVL look like over the past year? - Check DefiLlama for Pendle: category, website, token symbol, and the last 30 days of TVL data. ## Input schema ```json { "type": "object", "required": [ "project" ], "properties": { "project": { "type": "string", "description": "Project name, DefiLlama project link, or slug, for example Aave." }, "history_period": { "enum": [ "last_30_days", "last_year", "all_time" ], "type": "string", "default": "last_30_days", "description": "How much daily TVL history to include, for example last_30_days." } } } ``` ## Output schema ```json { "type": "object", "required": [ "project_name", "category", "chains", "current_tvl_usd", "change_1d_percent", "change_7d_percent", "tvl_by_chain", "token_symbol", "token_market_cap_usd", "website", "defillama_link", "tvl_history", "defillama_slug" ], "properties": { "chains": { "type": "array", "items": { "type": "string" }, "description": "Chains with TVL, largest first." }, "website": { "type": [ "string", "null" ], "description": "Project website." }, "category": { "type": [ "string", "null" ], "description": "Project category." }, "tvl_history": { "type": "array", "items": { "type": "object", "required": [ "date", "tvl_usd" ], "properties": { "date": { "type": "string", "format": "date" }, "tvl_usd": { "type": "number" } }, "additionalProperties": false }, "description": "Daily total TVL in US dollars, oldest date first." }, "project_name": { "type": "string", "description": "Project name." }, "token_symbol": { "type": [ "string", "null" ], "description": "Project token symbol, or null if there is no token." }, "tvl_by_chain": { "type": "array", "items": { "type": "object", "required": [ "chain", "tvl_usd" ], "properties": { "chain": { "type": "string" }, "tvl_usd": { "type": "number" } }, "additionalProperties": false }, "description": "TVL by chain in US dollars, largest first; borrowed, pool2, and staking extras are excluded." }, "defillama_link": { "type": "string", "description": "Project page on DefiLlama." }, "defillama_slug": { "type": "string", "description": "Project slug on DefiLlama.", "x-fous-developer": true }, "current_tvl_usd": { "type": "number", "description": "Latest total value locked in US dollars." }, "change_1d_percent": { "type": [ "number", "null" ], "description": "Percentage change from the observation one day earlier, if available." }, "change_7d_percent": { "type": [ "number", "null" ], "description": "Percentage change from the observation seven days earlier, if available." }, "token_market_cap_usd": { "type": [ "number", "null" ], "description": "Token market capitalization in US dollars, or null if unavailable." } }, "additionalProperties": false } ``` ## See more - [DefiLlama API: List top blockchains by TVL](https://fous.com/methods/defillama.com/list-top-blockchains.md): Lists blockchains ranked by the total value locked in their DeFi apps on DefiLlama, with one-day and seven-day TVL changes, DeFi project counts and chain token symbols. - [DefiLlama API: List best yields for an asset](https://fous.com/methods/defillama.com/list-best-yields.md): Finds the highest-APY DeFi pools on DefiLlama for a token symbol or name, optionally filtered by chain and minimum pool size. - [DefiLlama API: List stablecoins](https://fous.com/methods/defillama.com/list-stablecoins.md): Lists DefiLlama stablecoins ranked by circulating supply in US dollars. Each coin comes with its peg, price, weekly supply change and chain count. You can filter by peg. - [CamelCamelCamel API: Get Amazon price history](https://fous.com/methods/camelcamelcamel.com/get-price-history.md): Gets an Amazon product's current listed price and lifetime price statistics from CamelCamelCamel (Amazon and third-party new), with dated Amazon low/high points and a comparison to the average. Takes a product name, an Amazon or CamelCamelCamel link, or an ASIN, for eight Amazon stores. - [Product Hunt API: Get product](https://fous.com/methods/producthunt.com/get-product.md): Gets a Product Hunt product profile by product name or Product Hunt link: tagline, description, website, topics, review rating, followers, the five most recent reviews, recent launches with day rank and upvotes, and alternatives. - [CoinGecko API: List crypto categories](https://fous.com/methods/coingecko.com/list-crypto-categories.md): Lists CoinGecko crypto sectors by market cap with daily change, volume, leading coins and category pages, optionally filtered by name or link. - [CoinGecko API: Get coin price history](https://fous.com/methods/coingecko.com/get-coin-price-history.md): Gets a coin's daily prices and price change over the last 7, 30, 90 or 365 days, with UTC dates. Today's price may change. - [CoinMarketCap API: Get coin price](https://fous.com/methods/coinmarketcap.com/get-coin-price.md): Gets a cryptocurrency's price, changes, supply, market cap, volume and all-time high in a chosen currency. If a name or symbol is shared, returns the coin with the largest market cap. - [All DefiLlama methods](https://fous.com/methods/defillama.com.md)