# DefiLlama API: List top blockchains by TVL

> 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.

Unofficial. Not affiliated with or endorsed by DefiLlama.

- Page: https://fous.com/methods/defillama.com/list-top-blockchains
- Method: `defillama.com/list_top_blockchains`, version 1
- Website: defillama.com
- Returns: rank, chain name, TVL in USD, 1d and 7d change, DeFi project count, token symbol, chain page URL
- 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 |
|---|---|---|---|---|
| `max_results` | integer | no | `200` | Maximum number of top blockchains to return, for example 20. Default 20. |

## Output

From a run on Oct 31, 2026, shortened. Its input:

```json
{
  "max_results": 200
}
```

Its output:

```json
{
  "blockchains": [
    {
      "rank": 1,
      "tvl_usd": 53108335050,
      "page_url": "https://defillama.com/chain/ethereum",
      "chain_name": "Ethereum",
      "defi_projects": 2032,
      "change_1d_percent": -0.1698818443182991,
      "change_7d_percent": -2.6204888468664813,
      "native_token_symbol": "ETH"
    },
    {
      "rank": 2,
      "tvl_usd": 6421423324,
      "page_url": "https://defillama.com/chain/solana",
      "chain_name": "Solana",
      "defi_projects": 643,
      "change_1d_percent": -3.197296255971719,
      "change_7d_percent": -0.43208119414242924,
      "native_token_symbol": "SOL"
    },
    {
      "rank": 3,
      "tvl_usd": 6219474904,
      "page_url": "https://defillama.com/chain/base",
      "chain_name": "Base",
      "defi_projects": 1125,
      "change_1d_percent": -0.7163654151087694,
      "change_7d_percent": -3.5663736335965126,
      "native_token_symbol": null
    }
  ]
}
```

## 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/list_top_blockchains","input":{"max_results":200}}'
```

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

- Which blockchains have the most total value locked in DeFi right now? Give me the top 10.
- Pull the top 50 chains ranked by TVL from DefiLlama, including their 1-day and 7-day changes.
- I need a ranking of L1s and L2s by DeFi TVL with the number of protocols on each and their native token tickers.
- Show me DefiLlama's chain leaderboard by locked value: the top 25 networks.
- How has TVL moved over the past week across the biggest DeFi chains? List the top 100 with weekly percentage change.

## Input schema

```json
{
  "type": "object",
  "properties": {
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 200,
      "minimum": 1,
      "description": "Maximum number of top blockchains to return, for example 20."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "blockchains"
  ],
  "properties": {
    "blockchains": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "rank",
          "chain_name",
          "tvl_usd",
          "change_1d_percent",
          "change_7d_percent",
          "defi_projects",
          "native_token_symbol",
          "page_url"
        ],
        "properties": {
          "rank": {
            "type": "integer",
            "description": "Position in the TVL ranking, starting at 1."
          },
          "tvl_usd": {
            "type": "number",
            "description": "Total value locked in US dollars."
          },
          "page_url": {
            "type": "string",
            "description": "Chain details page."
          },
          "chain_name": {
            "type": "string",
            "description": "Blockchain name."
          },
          "defi_projects": {
            "type": "integer",
            "description": "Number of DeFi projects."
          },
          "change_1d_percent": {
            "type": [
              "number",
              "null"
            ],
            "description": "Reported one-day TVL percentage change, or null if unavailable."
          },
          "change_7d_percent": {
            "type": [
              "number",
              "null"
            ],
            "description": "Reported seven-day TVL percentage change, or null if unavailable."
          },
          "native_token_symbol": {
            "type": [
              "string",
              "null"
            ],
            "description": "Chain token symbol, or null when none is listed."
          }
        },
        "additionalProperties": false
      },
      "minItems": 1
    }
  },
  "additionalProperties": false
}
```

## See more

- [DefiLlama API: Get DeFi project](https://fous.com/methods/defillama.com/get-defi-project.md): 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.
- [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.
- [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.
- [Twitch API: List top categories](https://fous.com/methods/twitch.tv/list-top-categories.md): Lists Twitch games and categories ranked by current live viewers, with content tags, box art and category links.
- [MyAnimeList API: List top anime](https://fous.com/methods/myanimelist.net/list-top-anime.md): Lists MyAnimeList's top anime in rank order for a selected ranking (all, airing, upcoming, TV, movies or most popular), with English title, score, type, episodes, airing dates and members.
- [Twitch API: List top streams](https://fous.com/methods/twitch.tv/list-top-streams.md): Lists the most-watched live Twitch streams, optionally within a category and language. All-category results are limited to 30 streams; category results allow up to 100.
- [CoinMarketCap API: List top coins by market cap](https://fous.com/methods/coinmarketcap.com/list-top-coins.md): Lists the largest cryptocurrencies on CoinMarketCap ranked by market cap. Each coin comes with its price, changes, volume and supply in the chosen currency.
- [Bilibili API: List popular videos](https://fous.com/methods/bilibili.com/list-popular-videos.md): Lists the current Bilibili ranking overall or in a selected category, in rank order. The Movies ranking does not provide uploader, likes, length or BV numbers.
- [All DefiLlama methods](https://fous.com/methods/defillama.com.md)
