---
type: "firecrawl-provider"
description: "DeFiLlama analytics from the free llama.fi JSON APIs behind defillama.com: stablecoin supply and history, protocol and chain TVL, fees/revenue and DEX/options volume, yield pools, token prices and the hacks dataset."
use_when: "DeFiLlama analytics from the free llama.fi JSON APIs behind defillama.com: stablecoin supply and history, protocol and chain TVL, fees/revenue and DEX/options volume, yield pools, token prices and the hacks dataset."
categories: "Finance"
capabilities: 14
credits_per_call: 5
---
# DeFiLlama on Firecrawl Alexandria

DeFiLlama analytics from the free llama.fi JSON APIs behind defillama.com: stablecoin supply and history, protocol and chain TVL, fees/revenue and DEX/options volume, yield pools, token prices and the hacks dataset.

- Categories: Finance
- Category index: [Finance category](https://firecrawl.dev/alexandria/agents/categories/finance)
- Provider key: `defillama-com`
- Access: Firecrawl credits
- Cost: 5 credits per call

## More

- [Human guide](https://firecrawl.dev/app/alexandria/defillama-com)
- [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/defillama-com/openapi.json)

## Capabilities

- [Chain tvl history](https://firecrawl.dev/alexandria/agents/providers/defillama-com/crypto/chain_tvl_history): Daily DeFi TVL history for one chain (api.llama.fi/v2/historicalChainTvl/{chain}) or for all of DeFi (`all`, api.llama.fi/v2/historicalChainTvl), newest first, capped by `limit` and optionally bounded by `from`/`to`.
- [Chains](https://firecrawl.dev/alexandria/agents/providers/defillama-com/crypto/chains): All chains DeFiLlama tracks with current DeFi TVL, sorted largest first, plus gas token symbol and CoinGecko/CMC ids. Source: api.llama.fi/v2/chains.
- [Hacks](https://firecrawl.dev/alexandria/agents/providers/defillama-com/crypto/hacks): DeFiLlama's dataset of crypto hacks and exploits (api.llama.fi/hacks): date, target, classification, technique, amount lost and returned, chains. Newest first; client-side filters by name substring, chain, classification and `since`.
- [Metrics overview](https://firecrawl.dev/alexandria/agents/providers/defillama-com/crypto/metrics_overview): Ranking of protocols by fees/revenue, DEX volume or options volume from api.llama.fi/overview/{metric}[/{chain}] (24h/7d/30d/1y/all-time totals and changes per protocol, plus the aggregate totals). Optional chain scope and client-side name/category filters; sorted by 24h total, largest first.
- [Price chart](https://firecrawl.dev/alexandria/agents/providers/defillama-com/crypto/price_chart): Price series for up to 10 coin keys from coins.llama.fi/chart/{coins}?start=&span=&period=: `span` points at `period` spacing starting at `start`.
- [Prices](https://firecrawl.dev/alexandria/agents/providers/defillama-com/crypto/prices): Current or historical token prices for up to 50 coin keys from coins.llama.fi (/prices/current/{coins}, or /prices/historical/{timestamp}/{coins} when `timestamp` is given). Coins the source does not know are listed in `missing`, not treated as errors; when nothing is known the call fails with not_found.
- [Protocol](https://firecrawl.dev/alexandria/agents/providers/defillama-com/crypto/protocol): One protocol's profile from api.llama.fi/protocol/{slug}: identity, category, chains, current TVL per chain (including the `-borrowed`, `-staking`, `-pool2` buckets DeFiLlama reports separately), the latest token breakdown, a trimmed TVL history (newest first), raises, hacks and hallmarks.
- [Protocol metrics](https://firecrawl.dev/alexandria/agents/providers/defillama-com/crypto/protocol_metrics): One protocol's fees/revenue, DEX volume or options volume from api.llama.fi/summary/{metric}/{slug}: trailing totals, per-chain breakdown, child protocols, methodology and a trimmed daily series (newest first).
- [Protocols](https://firecrawl.dev/alexandria/agents/providers/defillama-com/crypto/protocols): List DeFi protocols tracked by DeFiLlama with current TVL, category, chains and 1d/7d change, sorted by TVL (largest first). Optional client-side filters by name substring, category and chain. Source: api.llama.fi/protocols (one cached dump).
- [Stablecoin chains](https://firecrawl.dev/alexandria/agents/providers/defillama-com/crypto/stablecoin_chains): Current stablecoin supply per chain (USD), largest first, with the breakdown by peg type. Source: stablecoins.llama.fi/stablecoinchains.
- [Stablecoin history](https://firecrawl.dev/alexandria/agents/providers/defillama-com/crypto/stablecoin_history): Historical circulating supply of one stablecoin, across all chains or on one chain, as a daily series (latest points first, capped by `limit`, optionally bounded by `from`/`to`). Identity comes from the stablecoin listing; the series from stablecoins.llama.fi/stablecoincharts/{all|chain}?stablecoin={id}.
- [Stablecoins](https://firecrawl.dev/alexandria/agents/providers/defillama-com/crypto/stablecoins): List stablecoins tracked by DeFiLlama with current circulating supply, peg type, mechanism, price and chains, sorted by circulating supply (largest first). Optional client-side filters by name/symbol substring, peg type and chain. Source: stablecoins.llama.fi/stablecoins?includePrices=true (one cached dump; paging is an offset into the filtered list).
- [Yield pool history](https://firecrawl.dev/alexandria/agents/providers/defillama-com/crypto/yield_pool_history): Daily TVL and APY history of one yield pool from yields.llama.fi/chart/{pool}, newest first, capped by `limit`.
- [Yield pools](https://firecrawl.dev/alexandria/agents/providers/defillama-com/crypto/yield_pools): Yield pools tracked by DeFiLlama (yields.llama.fi/pools) with TVL, APY (base/reward), 30d mean, stablecoin flag, IL risk and prediction. Client-side filters by chain, project, symbol substring, stablecoin-only and minimum TVL; sorted by TVL or APY.

## 1. Choose this provider when

DeFiLlama analytics from the free llama.fi JSON APIs behind defillama.com: stablecoin supply and history, protocol and chain TVL, fees/revenue and DEX/options volume, yield pools, token prices and the hacks dataset.

## 2. Minimal request

Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls.

```json
{
  "provider": "defillama-com",
  "capability": "crypto/chain_tvl_history",
  "options": {
    "chain": "Ethereum",
    "limit": 5
  }
}
```

## 3. Add provider options

Use only the options needed for the task:

- `chain` (string): Chain name as DeFiLlama writes it (e.g. `Ethereum`, `Solana`), or `all` (default). Example: `all`
- `from` (number): Earliest point, unix seconds. Example: `10`
- `limit` (number): Maximum points, newest first (1..4000, default 90). Example: `90`
- `to` (number): Latest point, unix seconds. Example: `10`

## 4. Request through your preferred interface

### JavaScript

```javascript
const result = await firecrawl.scrape({
  alexandria: {
    provider: "defillama-com",
    capability: "crypto/chain_tvl_history",
    options: {
      chain: "Ethereum",
      limit: 5,
    },
  },
});
```

### Python

```python
result = firecrawl.scrape_alexandria({
  "provider": "defillama-com",
  "capability": "crypto/chain_tvl_history",
  "options": {
    "chain": "Ethereum",
    "limit": 5
  }
})
```

### cURL

```sh
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "alexandria": {
    "provider": "defillama-com",
    "capability": "crypto/chain_tvl_history",
    "options": {
      "chain": "Ethereum",
      "limit": 5
    }
  }
}'
```

### CLI

```sh
firecrawl scrape 'defillama-com/crypto/chain_tvl_history' \
  --options '{"chain":"Ethereum","limit":5}'
```


### MCP

Call the FCX MCP retrieve tool with this object:

```json
{
  "provider": "defillama-com",
  "capability": "crypto/chain_tvl_history",
  "options": {
    "chain": "Ethereum",
    "limit": 5
  }
}
```

Ask for only the returned fields needed by the task.

## 5. Full request shape

```json
{
  "provider": "defillama-com",
  "capability": "crypto/chain_tvl_history",
  "options": {
    "chain": "Ethereum",
    "limit": 5
  }
}
```

## 6. Response data

The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`:

```json
{
  "api_url": "https://api.llama.fi/v2/historicalChainTvl/Ethereum",
  "chain": "Ethereum",
  "count": 5,
  "history": [
    {
      "date": 1790035200,
      "tvl_usd": 54398859349
    },
    {
      "date": 1789948800,
      "tvl_usd": 53358066790
    },
    {
      "date": 1789862400,
      "tvl_usd": 52583315573
    },
    {
      "date": 1789776000,
      "tvl_usd": 52268745405
    },
    {
      "date": 1789689600,
      "tvl_usd": 49825476816
    }
  ],
  "observed_at_ms": 1790118306713,
  "source_url": "https://defillama.com/chain/ethereum",
  "total_points": 3283
}
```

## API reference-derived contract

The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec.

### Chain tvl history

- Capability: `crypto/chain_tvl_history`
- Description: Daily DeFi TVL history for one chain (api.llama.fi/v2/historicalChainTvl/{chain}) or for all of DeFi (`all`, api.llama.fi/v2/historicalChainTvl), newest first, capped by `limit` and optionally bounded by `from`/`to`.
- Instructions: TVL trend of a chain or of DeFi overall.
- Cost: 5 credits per call
- Capability file: [Chain tvl history](https://firecrawl.dev/alexandria/agents/providers/defillama-com/crypto/chain_tvl_history)

Accepted options:
- `chain` (string): Chain name as DeFiLlama writes it (e.g. `Ethereum`, `Solana`), or `all` (default). Example: `all`
- `from` (number): Earliest point, unix seconds. Example: `10`
- `limit` (number): Maximum points, newest first (1..4000, default 90). Example: `90`
- `to` (number): Latest point, unix seconds. Example: `10`

Response schema example:
```json
{
  "api_url": "https://api.llama.fi/v2/historicalChainTvl/Ethereum",
  "chain": "Ethereum",
  "count": 5,
  "history": [
    {
      "date": 1790035200,
      "tvl_usd": 54398859349
    },
    {
      "date": 1789948800,
      "tvl_usd": 53358066790
    },
    {
      "date": 1789862400,
      "tvl_usd": 52583315573
    },
    {
      "date": 1789776000,
      "tvl_usd": 52268745405
    },
    {
      "date": 1789689600,
      "tvl_usd": 49825476816
    }
  ],
  "observed_at_ms": 1790118306713,
  "source_url": "https://defillama.com/chain/ethereum",
  "total_points": 3283
}
```

### Chains

- Capability: `crypto/chains`
- Description: All chains DeFiLlama tracks with current DeFi TVL, sorted largest first, plus gas token symbol and CoinGecko/CMC ids. Source: api.llama.fi/v2/chains.
- Instructions: Ranking chains by TVL or finding the exact chain name for `chain_tvl_history`, `stablecoin_history` and the chain filters.
- Cost: 5 credits per call
- Capability file: [Chains](https://firecrawl.dev/alexandria/agents/providers/defillama-com/crypto/chains)

Accepted options:
- `continuation` (string): Opaque cursor from a previous page's `next_continuation`. Pattern: ^[0-9]{1,7}$. Example: `next_continuation`
- `limit` (number): Items per page (1..500, default 50). Example: `50`
- `query` (string): Case-insensitive substring of the chain name. Example: `<query>`

Response schema example:
```json
{
  "api_url": "https://api.llama.fi/v2/chains",
  "chains": [
    {
      "chain_id": 1,
      "cmc_id": "1027",
      "gecko_id": "ethereum",
      "name": "Ethereum",
      "source_url": "https://defillama.com/chain/ethereum",
      "token_symbol": "ETH",
      "tvl_usd": 54491272318.91413
    },
    {
      "chain_id": null,
      "cmc_id": "5426",
      "gecko_id": "solana",
      "name": "Solana",
      "source_url": "https://defillama.com/chain/solana",
      "token_symbol": "SOL",
      "tvl_usd": 6498593007.055775
    },
    {
      "chain_id": 8453,
      "cmc_id": null,
      "gecko_id": null,
      "name": "Base",
      "source_url": "https://defillama.com/chain/base",
      "token_symbol": null,
      "tvl_usd": 6256195977.463819
    },
    {
      "chain_id": 56,
      "cmc_id": "1839",
      "gecko_id": "binancecoin",
      "name": "BSC",
      "source_url": "https://defillama.com/chain/bsc",
      "token_symbol": "BNB",
      "tvl_usd": 5884046331.509543
    },
    {
      "chain_id": null,
      "cmc_id": "1958",
      "gecko_id": "tron",
      "name": "Tron",
      "source_url": "https://defillama.com/chain/tron",
      "token_symbol": "TRX",
      "tvl_usd": 5729864416.831137
    }
  ],
  "count": 5,
  "next_continuation": "5",
  "observed_at_ms": 1790118299992,
  "total_matches": 467
}
```

### Hacks

- Capability: `crypto/hacks`
- Description: DeFiLlama's dataset of crypto hacks and exploits (api.llama.fi/hacks): date, target, classification, technique, amount lost and returned, chains. Newest first; client-side filters by name substring, chain, classification and `since`.
- Instructions: Researching exploits of a protocol, on a chain, or the largest recent hacks.
- Cost: 5 credits per call
- Capability file: [Hacks](https://firecrawl.dev/alexandria/agents/providers/defillama-com/crypto/hacks)

Accepted options:
- `chain` (string): Chain name as DeFiLlama writes it; case-insensitive. Example: `<chain>`
- `classification` (string): Exact DeFiLlama classification (e.g. `Oracle Manipulation`, `Access Control`); case-insensitive. Example: `Oracle Manipulation`
- `continuation` (string): Opaque cursor from a previous page's `next_continuation`. Pattern: ^[0-9]{1,7}$. Example: `next_continuation`
- `limit` (number): Items per page (1..100, default 20). Example: `20`
- `query` (string): Case-insensitive substring of the target name. Example: `<query>`
- `since` (number): Only hacks at or after this unix time (seconds). Example: `10`

Response schema example:
```json
{
  "api_url": "https://api.llama.fi/hacks",
  "count": 5,
  "hacks": [
    {
      "amount_usd": 4400000,
      "bridge_hack": false,
      "chains": [
        "Neutron"
      ],
      "classification": "Governance",
      "date": 1790035200,
      "defillama_id": "4993",
      "language": "Rust",
      "name": "Drop",
      "parent_protocol_id": null,
      "returned_funds_usd": null,
      "source": null,
      "source_url": "https://defillama.com/hacks",
      "target_type": "DeFi Protocol",
      "technique": "Malicious Proposal"
    },
    {
      "amount_usd": 4900000,
      "bridge_hack": false,
      "chains": [
        "Neutron"
      ],
      "classification": "Governance",
      "date": 1790035200,
      "defillama_id": "3117",
      "language": "Rust",
      "name": "Astroport",
      "parent_protocol_id": null,
      "returned_funds_usd": null,
      "source": null,
      "source_url": "https://defillama.com/hacks",
      "target_type": "DeFi Protocol",
      "technique": "Malicious Proposal"
    },
    {
      "amount_usd": 16380,
      "bridge_hack": false,
      "chains": [
        "Base"
      ],
      "classification": "Access Control",
      "date": 1789948800,
      "defillama_id": null,
      "language": "Solidity",
      "name": "The Internet Token",
      "parent_protocol_id": null,
      "returned_funds_usd": null,
      "source": null,
      "source_url": "https://defillama.com/hacks",
      "target_type": "Token",
      "technique": "Arbitrary External Call"
    },
    {
      "amount_usd": 1530000,
      "bridge_hack": true,
      "chains": [
        "Ethereum"
      ],
      "classification": "Key Compromise",
      "date": 1789776000,
      "defillama_id": null,
      "language": "Solidity",
      "name": "Fetch.ai",
      "parent_protocol_id": null,
      "returned_funds_usd": null,
      "source": null,
      "source_url": "https://defillama.com/hacks",
      "target_type": "DeFi Protocol",
      "technique": "Private Key Compromised"
    },
    {
      "amount_usd": 462730,
      "bridge_hack": false,
      "chains": [
        "Ethereum"
      ],
      "classification": "Key Compromise",
      "date": 1789776000,
      "defillama_id": null,
      "language": "Solidity",
      "name": "NuNet",
      "parent_protocol_id": null,
      "returned_funds_usd": null,
      "source": null,
      "source_url": "https://defillama.com/hacks",
      "target_type": "Token",
      "technique": "Private Key Compromised"
    }
  ],
  "next_continuation": "5",
  "observed_at_ms": 1790118424363,
  "total_matches": 1281
}
```

### Metrics overview

- Capability: `crypto/metrics_overview`
- Description: Ranking of protocols by fees/revenue, DEX volume or options volume from api.llama.fi/overview/{metric}[/{chain}] (24h/7d/30d/1y/all-time totals and changes per protocol, plus the aggregate totals). Optional chain scope and client-side name/category filters; sorted by 24h total, largest first.
- Instructions: Which protocols earn the most fees or trade the most volume, overall or on one chain.
- Cost: 5 credits per call
- Capability file: [Metrics overview](https://firecrawl.dev/alexandria/agents/providers/defillama-com/crypto/metrics_overview)

Accepted options:
- `category` (string): Exact DeFiLlama category; case-insensitive. Example: `<category>`
- `chain` (string): Chain to scope to, as DeFiLlama writes it (e.g. `Ethereum`); omit for all chains. Example: `<chain>`
- `continuation` (string): Opaque cursor from a previous page's `next_continuation`. Pattern: ^[0-9]{1,7}$. Example: `next_continuation`
- `data_type` (string): For `fees` only: `dailyFees` (default) or `dailyRevenue`. Example: `dailyFees`
- `limit` (number): Items per page (1..100, default 20). Example: `20`
- `metric` (string, required): `fees` (fees and revenue), `dexs` (spot DEX volume) or `options` (options volume). Example: `fees`
- `query` (string): Case-insensitive substring of the protocol name or slug. Example: `<query>`

Response schema example:
```json
{
  "api_url": "https://api.llama.fi/overview/fees?excludeTotalDataChart=true&excludeTotalDataChartBreakdown=true&dataType=dailyFees",
  "chain": "all",
  "chains_available": 362,
  "count": 5,
  "data_type": "dailyFees",
  "metric": "fees",
  "next_continuation": "5",
  "observed_at_ms": 1790118366763,
  "protocols": [
    {
      "category": "Stablecoin Issuer",
      "chains": [
        "Off Chain"
      ],
      "change_1d": 0.5,
      "change_1m": 7.65,
      "change_7d": 1.76,
      "display_name": "Tether",
      "id": "5009",
      "methodology_url": "https://github.com/DefiLlama/dimension-adapters/blob/master/fees/tether",
      "name": "Tether",
      "parent_protocol": null,
      "protocol_type": "protocol",
      "slug": "tether",
      "source_url": "https://defillama.com/fees/tether",
      "total_1y": 5923224679,
      "total_24h": 17126963,
      "total_30d": 491186694,
      "total_7d": 119475037,
      "total_all_time": 19654767958
    },
    {
      "category": "Stablecoin Issuer",
      "chains": [
        "Ethereum",
        "Off Chain"
      ],
      "change_1d": 0.62,
      "change_1m": 8.67,
      "change_7d": 1.91,
      "display_name": "Circle USDC",
      "id": "5008",
      "methodology_url": "https://github.com/DefiLlama/dimension-adapters/blob/master/fees/circle.ts",
      "name": "Circle USDC",
      "parent_protocol": "parent#circle",
      "protocol_type": "protocol",
      "slug": "circle-usdc",
      "source_url": "https://defillama.com/fees/circle-usdc",
      "total_1y": 2371301734,
      "total_24h": 6996430,
      "total_30d": 199891075,
      "total_7d": 48610971,
      "total_all_time": 7439283290
    },
    {
      "category": "Derivatives",
      "chains": [
        "Hyperliquid L1"
      ],
      "change_1d": 108.7,
      "change_1m": 58.24,
      "change_7d": 57.96,
      "display_name": "Hyperliquid Perps",
      "id": "5507",
      "methodology_url": "https://github.com/DefiLlama/dimension-adapters/blob/master/dexs/hyperliquid-perp",
      "name": "Hyperliquid Perps",
      "parent_protocol": "parent#hyperliquid",
      "protocol_type": "protocol",
      "slug": "hyperliquid-perps",
      "source_url": "https://defillama.com/fees/hyperliquid-perps",
      "total_1y": 879127257,
      "total_24h": 4440326,
      "total_30d": 73924506,
      "total_7d": 20042586,
      "total_all_time": 1486548639
    },
    {
      "category": "Dexs",
      "chains": [
        "Solana"
      ],
      "change_1d": 3.46,
      "change_1m": 11.37,
      "change_7d": 3.05,
      "display_name": "PumpSwap",
      "id": "5936",
      "methodology_url": "https://github.com/DefiLlama/dimension-adapters/blob/master/fees/pump-swap",
      "name": "PumpSwap",
      "parent_protocol": "parent#pump",
      "protocol_type": "protocol",
      "slug": "pumpswap",
      "source_url": "https://defillama.com/fees/pumpswap",
      "total_1y": 656851860,
      "total_24h": 3357626,
      "total_30d": 102350092,
      "total_7d": 24255668,
      "total_all_time": 864697768
    },
    {
      "category": "Dexs",
      "chains": [
        "Ethereum",
        "Unichain",
        "OP Mainnet",
        "Base",
        "Arbitrum",
        "Polygon",
        "Blast",
        "Zora",
        "World Chain",
        "Ink",
        "Soneium",
        "Avalanche",
        "BSC",
        "Monad",
        "X Layer",
        "Celo",
        "Tempo",
        "MegaETH",
        "Robinhood Chain",
        "Arc"
      ],
      "change_1d": 38.04,
      "change_1m": 34.18,
      "change_7d": -7.27,
      "display_name": "Uniswap V4",
      "id": "5690",
      "methodology_url": "https://github.com/DefiLlama/dimension-adapters/blob/master/dexs/uniswap-v4.ts",
      "name": "Uniswap V4",
      "parent_protocol": "parent#uniswap",
      "protocol_type": "protocol",
      "slug": "uniswap-v4",
      "source_url": "https://defillama.com/fees/uniswap-v4",
      "total_1y": 396612914,
      "total_24h": 3034050,
      "total_30d": 133101559,
      "total_7d": 21651807,
      "total_all_time": 474949826
    }
  ],
  "total_matches": 2745,
  "totals": {
    "change_1d": 20.98,
    "change_1m": 30.32,
    "change_7d": 11.84,
    "total_1y": 23996166622.56891,
    "total_24h": 89245247.36999995,
    "total_30d": 2405718858.9699836,
    "total_48h_to_24h": 73771292.37000002,
    "total_7d": 558035999.3499981,
    "total_all_time": 119158852836.27008
  }
}
```

### Price chart

- Capability: `crypto/price_chart`
- Description: Price series for up to 10 coin keys from coins.llama.fi/chart/{coins}?start=&span=&period=: `span` points at `period` spacing starting at `start`.
- Instructions: A token's price over a window (daily or hourly candles as points).
- Cost: 5 credits per call
- Capability file: [Price chart](https://firecrawl.dev/alexandria/agents/providers/defillama-com/crypto/price_chart)

Accepted options:
- `coins` (string[], required): coins Example: `[]`
- `period` (string): Spacing: a number followed by `m`, `h`, `d` or `w` (e.g. `1d`, `4h`); default `1d`. Pattern: ^[0-9]{1,3}[mhdw]$. Example: `1d`
- `span` (number): Number of points (1..500, default 30). Example: `30`
- `start` (number, required): Unix seconds of the first point. Example: `1230768000`

Response schema example:
```json
{
  "api_url": "https://coins.llama.fi/chart/coingecko:bitcoin?start=1700000000&span=5&period=1d",
  "count": 1,
  "missing": [],
  "observed_at_ms": 1790118334606,
  "series": [
    {
      "coin": "coingecko:bitcoin",
      "confidence": 0.99,
      "points": [
        {
          "price": 35625,
          "timestamp": 1700000098
        },
        {
          "price": 37553,
          "timestamp": 1700086497
        },
        {
          "price": 36066,
          "timestamp": 1700172896
        },
        {
          "price": 36463,
          "timestamp": 1700259299
        },
        {
          "price": 36590.13756569477,
          "timestamp": 1700345529
        }
      ],
      "symbol": "BTC"
    }
  ]
}
```

### Prices

- Capability: `crypto/prices`
- Description: Current or historical token prices for up to 50 coin keys from coins.llama.fi (/prices/current/{coins}, or /prices/historical/{timestamp}/{coins} when `timestamp` is given). Coins the source does not know are listed in `missing`, not treated as errors; when nothing is known the call fails with not_found.
- Instructions: Spot or point-in-time USD prices for tokens by CoinGecko id or chain:address.
- Cost: 5 credits per call
- Capability file: [Prices](https://firecrawl.dev/alexandria/agents/providers/defillama-com/crypto/prices)

Accepted options:
- `coins` (string[], required): Coin keys. Example: `[]`
- `timestamp` (number): Unix seconds for a historical price; omit for the current price. Example: `1230768000`

Response schema example:
```json
{
  "api_url": "https://coins.llama.fi/prices/current/coingecko:bitcoin",
  "count": 1,
  "missing": [],
  "observed_at_ms": 1790118327700,
  "prices": [
    {
      "coin": "coingecko:bitcoin",
      "confidence": 0.99,
      "decimals": null,
      "price": 86169.39449305278,
      "symbol": "BTC",
      "timestamp": 1790118220
    }
  ],
  "requested_timestamp": null
}
```

### Protocol

- Capability: `crypto/protocol`
- Description: One protocol's profile from api.llama.fi/protocol/{slug}: identity, category, chains, current TVL per chain (including the `-borrowed`, `-staking`, `-pool2` buckets DeFiLlama reports separately), the latest token breakdown, a trimmed TVL history (newest first), raises, hacks and hallmarks.
- Instructions: Details and TVL history for a protocol whose slug you know (from `protocols`, or from a defillama.com/protocol/{slug} URL).
- Cost: 5 credits per call
- Capability file: [Protocol](https://firecrawl.dev/alexandria/agents/providers/defillama-com/crypto/protocol)

Accepted options:
- `history_limit` (number): Maximum TVL history points returned, newest first (0..4000, default 30). Example: `30`
- `slug` (string, required): Protocol slug as in defillama.com/protocol/{slug} (e.g. `aave`, `lido`). Pattern: ^[a-z0-9][a-z0-9.-]{0,79}$. Example: `<slug>`
- `token_limit` (number): Maximum tokens in the latest breakdown, largest USD value first (0..100, default 15). Example: `15`

Response schema example:
```json
{
  "api_url": "https://api.llama.fi/protocol/lido",
  "category": "Liquid Staking",
  "chains": [
    "Terra",
    "Moonriver",
    "Moonbeam",
    "Ethereum",
    "Solana"
  ],
  "cmc_id": "8000",
  "current_chain_tvls": [
    {
      "chain": "Ethereum",
      "tvl_usd": 26923348741.06953
    },
    {
      "chain": "Solana",
      "tvl_usd": 6080809.55811
    },
    {
      "chain": "Moonbeam",
      "tvl_usd": 0
    },
    {
      "chain": "Moonriver",
      "tvl_usd": 0
    },
    {
      "chain": "Terra",
      "tvl_usd": 0
    }
  ],
  "description": "Liquid staking for Ethereum and Polygon. Daily staking rewards, no lock ups.",
  "gecko_id": "lido-dao",
  "hacks": [],
  "hallmarks": [
    {
      "date": 1610496000,
      "label": "Start of incentives for curve pool"
    },
    {
      "date": 1651881600,
      "label": "UST depeg"
    },
    {
      "date": 1654819200,
      "label": "stETH depeg"
    },
    {
      "date": 1667865600,
      "label": "FTX collapse"
    },
    {
      "date": 1684108800,
      "label": "ETH Withdrawal Activation"
    }
  ],
  "id": "182",
  "is_parent": false,
  "logo": "https://icons.llamao.fi/icons/protocols/lido",
  "mcap_usd": 355671379.4194845,
  "name": "Lido",
  "observed_at_ms": 1790118293234,
  "other_protocols": [],
  "raises": [
    {
      "amount_usd_millions": 73,
      "date": 1620172800,
      "lead_investors": [
        "Paradigm"
      ],
      "other_investors": [
        "Coinbase Ventures",
        "3AC",
        "Jump Trading",
        "Alameda Research",
        "DCG"
      ],
      "round": "Private token sale",
      "source": null
    },
    {
      "amount_usd_millions": 70,
      "date": 1646265600,
      "lead_investors": [
        "a16z"
      ],
      "other_investors": [],
      "round": null,
      "source": null
    },
    {
      "amount_usd_millions": 24,
      "date": 1663113600,
      "lead_investors": [
        "Dragonfly Capital"
      ],
      "other_investors": [],
      "round": "Treasury Diversification",
      "source": null
    }
  ],
  "slug": "lido",
  "source_url": "https://defillama.com/protocol/lido",
  "symbol": "LDO",
  "top_tokens": [
    {
      "symbol": "WETH",
      "value_usd": 26922566762.52227
    },
    {
      "symbol": "SOL",
      "value_usd": 6080809.55811
    },
    {
      "symbol": "WMATIC",
      "value_usd": 781978.54727
    }
  ],
  "tvl_as_of": 1790112095,
  "tvl_history": [
    {
      "date": 1790112095,
      "tvl_usd": 26929429550
    },
    {
      "date": 1790035200,
      "tvl_usd": 27121629192
    },
    {
      "date": 1789948800,
      "tvl_usd": 26285013053
    },
    {
      "date": 1789862400,
      "tvl_usd": 25716468110
    },
    {
      "date": 1789776000,
      "tvl_usd": 25632504262
    }
  ],
  "tvl_history_total_points": 2104,
  "tvl_usd": 26929429550,
  "twitter": "LidoFinance",
  "url": "https://lido.fi/"
}
```

### Protocol metrics

- Capability: `crypto/protocol_metrics`
- Description: One protocol's fees/revenue, DEX volume or options volume from api.llama.fi/summary/{metric}/{slug}: trailing totals, per-chain breakdown, child protocols, methodology and a trimmed daily series (newest first).
- Instructions: Fee, revenue or volume figures and history for a protocol whose slug you know.
- Cost: 5 credits per call
- Capability file: [Protocol metrics](https://firecrawl.dev/alexandria/agents/providers/defillama-com/crypto/protocol_metrics)

Accepted options:
- `data_type` (string): For `fees` only: `dailyFees` (default) or `dailyRevenue`. Example: `dailyFees`
- `history_limit` (number): Maximum daily points, newest first (0..4000, default 30). Example: `30`
- `metric` (string, required): `fees` (fees and revenue), `dexs` (spot DEX volume) or `options` (options volume). Example: `fees`
- `slug` (string, required): Protocol slug (e.g. `aave`, `uniswap`). Pattern: ^[a-z0-9][a-z0-9.-]{0,79}$. Example: `<slug>`

Response schema example:
```json
{
  "api_url": "https://api.llama.fi/summary/fees/aave?excludeTotalDataChartBreakdown=true&dataType=dailyFees",
  "category": null,
  "chain_breakdown": [
    {
      "chain": "Ethereum",
      "total_24h": 1005050,
      "total_30d": 29216545,
      "total_7d": 6950493,
      "total_all_time": 1952676500
    },
    {
      "chain": "Plasma",
      "total_24h": 105911,
      "total_30d": 2884924,
      "total_7d": 697009,
      "total_all_time": 63676787
    },
    {
      "chain": "Base",
      "total_24h": 33810,
      "total_30d": 991932,
      "total_7d": 231967,
      "total_all_time": 42243665
    },
    {
      "chain": "Monad",
      "total_24h": 32900,
      "total_30d": 1136135,
      "total_7d": 239239,
      "total_all_time": 2453404
    },
    {
      "chain": "Arbitrum",
      "total_24h": 32799,
      "total_30d": 914018,
      "total_7d": 261108,
      "total_all_time": 79225895
    },
    {
      "chain": "Avalanche",
      "total_24h": 32679,
      "total_30d": 610092.73,
      "total_7d": 176083,
      "total_all_time": 91581071.5
    },
    {
      "chain": "Mantle",
      "total_24h": 19974,
      "total_30d": 440628,
      "total_7d": 102472,
      "total_all_time": 6237893
    },
    {
      "chain": "Polygon",
      "total_24h": 9970,
      "total_30d": 299636,
      "total_7d": 69166,
      "total_all_time": 31105678
    },
    {
      "chain": "BSC",
      "total_24h": 8495,
      "total_30d": 214655,
      "total_7d": 52830,
      "total_all_time": 9631074
    },
    {
      "chain": "X Layer",
      "total_24h": 8416,
      "total_30d": 221319,
      "total_7d": 62161,
      "total_all_time": 281752.29000000004
    },
    {
      "chain": "Arc",
      "total_24h": 5439,
      "total_30d": 23071.57,
      "total_7d": 23062,
      "total_all_time": 28496.57
    },
    {
      "chain": "OP Mainnet",
      "total_24h": 2196,
      "total_30d": 64048,
      "total_7d": 15512,
      "total_all_time": 12585449
    },
    {
      "chain": "Gnosis",
      "total_24h": 1601,
      "total_30d": 47691,
      "total_7d": 10987,
      "total_all_time": 3602272
    },
    {
      "chain": "MegaETH",
      "total_24h": 1213,
      "total_30d": 28213,
      "total_7d": 6706,
      "total_all_time": 2124195
    },
    {
      "chain": "Sonic",
      "total_24h": 507,
      "total_30d": 10609,
      "total_7d": 3884,
      "total_all_time": 2344565
    },
    {
      "chain": "Linea",
      "total_24h": 490,
      "total_30d": 14481,
      "total_7d": 3237,
      "total_all_time": 8259121
    },
    {
      "chain": "Celo",
      "total_24h": 59.38,
      "total_30d": 1242.12,
      "total_7d": 225.18,
      "total_all_time": 276295.1300000001
    },
    {
      "chain": "Scroll",
      "total_24h": 52.76,
      "total_30d": 1003.2299999999998,
      "total_7d": 388.98,
      "total_all_time": 4186517.04
    },
    {
      "chain": "Metis",
      "total_24h": 10,
      "total_30d": 65.94,
      "total_7d": 41.7,
      "total_all_time": 263927.76000000024
    },
    {
      "chain": "Soneium",
      "total_24h": 6.66,
      "total_30d": 150.72,
      "total_7d": 56.06,
      "total_all_time": 2030.7099999999996
    },
    {
      "chain": "ZKsync Era",
      "total_24h": 0.01,
      "total_30d": 1082.34,
      "total_7d": 699.36,
      "total_all_time": 502832.49000000034
    },
    {
      "chain": "Fantom",
      "total_24h": 0,
      "total_30d": 0,
      "total_7d": 0,
      "total_all_time": 66375.08
    }
  ],
  "chains": [
    "Ethereum",
    "Polygon",
    "Avalanche",
    "Fantom",
    "Arbitrum",
    "OP Mainnet",
    "Metis",
    "Base",
    "Gnosis",
    "BSC",
    "Scroll",
    "ZKsync Era",
    "Linea",
    "Celo",
    "Sonic",
    "Soneium",
    "Plasma",
    "Mantle",
    "MegaETH",
    "X Layer",
    "Monad",
    "Arc"
  ],
  "child_protocols": [
    "Aave V2",
    "Aave V3",
    "Aave V4"
  ],
  "data_type": "dailyFees",
  "display_name": "Aave",
  "gecko_id": "aave",
  "history": [
    {
      "date": 1790812800,
      "value": 1299782
    },
    {
      "date": 1790726400,
      "value": 1301579
    },
    {
      "date": 1790640000,
      "value": 1255586
    },
    {
      "date": 1790553600,
      "value": 1252988
    },
    {
      "date": 1790467200,
      "value": 1278374
    }
  ],
  "history_total_points": 2128,
  "id": "parent#aave",
  "logo": "https://icons.llamao.fi/icons/protocols/aave",
  "methodology": [
    {
      "description": "Include borrow interest, flashloan fee, liquidation fee and penalty paid by borrowers.",
      "name": "Fees",
      "protocol": "Aave V2"
    },
    {
      "description": "Amount of fees go to Aave treasury.",
      "name": "ProtocolRevenue",
      "protocol": "Aave V2"
    },
    {
      "description": "Amount of fees go to Aave treasury.",
      "name": "Revenue",
      "protocol": "Aave V2"
    },
    {
      "description": "Amount of fees distributed to suppliers.",
      "name": "SupplySideRevenue",
      "protocol": "Aave V2"
    },
    {
      "description": "Interest paid by borrowers",
      "name": "UserFees",
      "protocol": "Aave V2"
    },
    {
      "description": "Include borrow interest, flashloan fee, liquidation fee, penalty paid by borrowers, swap fees from Paraswap, and Chainlink SVR (MEV recapture from Ethereum liquidations).",
      "name": "Fees",
      "protocol": "Aave V3"
    },
    {
      "description": "Aave starts buy back AAVE tokens using Aave Treasury after 9th April 2025.",
      "name": "HoldersRevenue",
      "protocol": "Aave V3"
    },
    {
      "description": "Amount of fees go to Aave treasury.",
      "name": "ProtocolRevenue",
      "protocol": "Aave V3"
    },
    {
      "description": "Amount of fees go to Aave treasury.",
      "name": "Revenue",
      "protocol": "Aave V3"
    },
    {
      "description": "Amount of fees distributed to suppliers.",
      "name": "SupplySideRevenue",
      "protocol": "Aave V3"
    },
    {
      "description": "Interest paid by borrowers",
      "name": "UserFees",
      "protocol": "Aave V3"
    },
    {
      "description": "Borrow interest paid by borrowers plus protocol share of liquidation bonuses.",
      "name": "Fees",
      "protocol": "Aave V4"
    },
    {
      "description": "No revenue shared to AAVE holders.",
      "name": "HoldersRevenue",
      "protocol": "Aave V4"
    },
    {
      "description": "Protocol share of borrow interest plus protocol share of liquidation bonuses.",
      "name": "ProtocolRevenue",
      "protocol": "Aave V4"
    },
    {
      "description": "Protocol share of borrow interest plus protocol share of liquidation bonuses.",
      "name": "Revenue",
      "protocol": "Aave V4"
    },
    {
      "description": "Interest distributed to depositors after protocol fee.",
      "name": "SupplySideRevenue",
      "protocol": "Aave V4"
    },
    {
      "description": "Interest paid by borrowers",
      "name": "UserFees",
      "protocol": "Aave V4"
    }
  ],
  "methodology_url": "https://github.com/DefiLlama/dimension-adapters/blob/master/aave.ts",
  "metric": "fees",
  "name": "Aave",
  "observed_at_ms": 1790847634916,
  "parent_protocol": null,
  "protocol_type": "protocol",
  "slug": "aave",
  "source_url": "https://defillama.com/fees/aave",
  "totals": {
    "change_1d": 3.66,
    "change_1m": null,
    "change_7d": null,
    "total_1y": 733340512,
    "total_24h": 1301579,
    "total_30d": 37121539,
    "total_48h_to_24h": 1255586,
    "total_7d": 8907328,
    "total_all_time": 2313355807
  },
  "url": "https://aave.com"
}
```

### Protocols

- Capability: `crypto/protocols`
- Description: List DeFi protocols tracked by DeFiLlama with current TVL, category, chains and 1d/7d change, sorted by TVL (largest first). Optional client-side filters by name substring, category and chain. Source: api.llama.fi/protocols (one cached dump).
- Instructions: Finding a protocol slug for `protocol`/`protocol_metrics`, ranking protocols by TVL, or listing protocols in a category or on a chain.
- Cost: 5 credits per call
- Capability file: [Protocols](https://firecrawl.dev/alexandria/agents/providers/defillama-com/crypto/protocols)

Accepted options:
- `category` (string): Exact DeFiLlama category (e.g. `Lending`, `Dexs`, `Liquid Staking`); case-insensitive. Example: `<category>`
- `chain` (string): Chain name as DeFiLlama writes it (e.g. `Ethereum`); case-insensitive. Example: `<chain>`
- `continuation` (string): Opaque cursor from a previous page's `next_continuation`. Pattern: ^[0-9]{1,7}$. Example: `next_continuation`
- `limit` (number): Items per page (1..100, default 20). Example: `20`
- `query` (string): Case-insensitive substring of the protocol name or slug. Example: `<query>`

Response schema example:
```json
{
  "api_url": "https://api.llama.fi/protocols",
  "count": 5,
  "next_continuation": "5",
  "observed_at_ms": 1790118286364,
  "protocols": [
    {
      "category": "Lending",
      "chains": [
        "Ethereum",
        "Base",
        "Arbitrum",
        "Plasma",
        "Avalanche",
        "Monad",
        "Binance",
        "Polygon",
        "X Layer",
        "xDai",
        "Optimism",
        "Mantle",
        "MegaETH",
        "Linea",
        "Sonic",
        "Celo",
        "Scroll",
        "zkSync Era",
        "Metis",
        "Soneium",
        "Fantom"
      ],
      "change_1d": -0.6045817892898526,
      "change_7d": 11.237335378979068,
      "gecko_id": null,
      "id": "1599",
      "logo": "https://icons.llamao.fi/icons/protocols/aave-v3",
      "mcap_usd": null,
      "name": "Aave V3",
      "parent_protocol": "parent#aave",
      "slug": "aave-v3",
      "source_url": "https://defillama.com/protocol/aave-v3",
      "symbol": "AAVE",
      "tvl_usd": 18697778076.40586,
      "url": "https://aave.com"
    },
    {
      "category": "Lending",
      "chains": [
        "Ethereum",
        "Arc",
        "Avalanche"
      ],
      "change_1d": 0.43310909142226706,
      "change_7d": 49.33173313335399,
      "gecko_id": null,
      "id": "7594",
      "logo": "https://icons.llamao.fi/icons/protocols/aave-v4",
      "mcap_usd": null,
      "name": "Aave V4",
      "parent_protocol": "parent#aave",
      "slug": "aave-v4",
      "source_url": "https://defillama.com/protocol/aave-v4",
      "symbol": "AAVE",
      "tvl_usd": 584925064.2419586,
      "url": "https://aave.com"
    },
    {
      "category": "Lending",
      "chains": [
        "Ethereum"
      ],
      "change_1d": -0.24857596576046603,
      "change_7d": 0.1630914275642965,
      "gecko_id": null,
      "id": "7106",
      "logo": "https://icons.llamao.fi/icons/protocols/aave-horizon-rwa",
      "mcap_usd": null,
      "name": "Aave Horizon RWA",
      "parent_protocol": "parent#aave",
      "slug": "aave-horizon-rwa",
      "source_url": "https://defillama.com/protocol/aave-horizon-rwa",
      "symbol": "AAVE",
      "tvl_usd": 262935018.31128728,
      "url": "https://app.aave.com/markets/?marketName=proto_horizon_v3"
    },
    {
      "category": "Lending",
      "chains": [
        "Ethereum",
        "Polygon",
        "Avalanche"
      ],
      "change_1d": -0.6560329873217796,
      "change_7d": 5.880079451975774,
      "gecko_id": "aave",
      "id": "111",
      "logo": "https://icons.llamao.fi/icons/protocols/aave-v2",
      "mcap_usd": 2234876823.8836174,
      "name": "Aave V2",
      "parent_protocol": "parent#aave",
      "slug": "aave-v2",
      "source_url": "https://defillama.com/protocol/aave-v2",
      "symbol": "AAVE",
      "tvl_usd": 114563159.42405348,
      "url": "https://aave.com"
    },
    {
      "category": "Lending",
      "chains": [
        "Ethereum"
      ],
      "change_1d": -0.3018847106682756,
      "change_7d": 11.41989482135,
      "gecko_id": null,
      "id": "1838",
      "logo": "https://icons.llamao.fi/icons/protocols/aave-v1",
      "mcap_usd": null,
      "name": "Aave V1",
      "parent_protocol": "parent#aave",
      "slug": "aave-v1",
      "source_url": "https://defillama.com/protocol/aave-v1",
      "symbol": "AAVE",
      "tvl_usd": 8234624.51677585,
      "url": "https://aave.com"
    }
  ],
  "total_matches": 8
}
```

### Stablecoin chains

- Capability: `crypto/stablecoin_chains`
- Description: Current stablecoin supply per chain (USD), largest first, with the breakdown by peg type. Source: stablecoins.llama.fi/stablecoinchains.
- Instructions: Comparing chains by stablecoin liquidity or checking how much stablecoin value sits on one chain.
- Cost: 5 credits per call
- Capability file: [Stablecoin chains](https://firecrawl.dev/alexandria/agents/providers/defillama-com/crypto/stablecoin_chains)

Accepted options:
- `continuation` (string): Opaque cursor from a previous page's `next_continuation`. Pattern: ^[0-9]{1,7}$. Example: `next_continuation`
- `limit` (number): Items per page (1..300, default 50). Example: `50`
- `query` (string): Case-insensitive substring of the chain name. Example: `<query>`

Response schema example:
```json
{
  "api_url": "https://stablecoins.llama.fi/stablecoinchains",
  "chains": [
    {
      "by_peg_type": [
        {
          "circulating_usd": 145995667796.31412,
          "peg_type": "peggedUSD"
        },
        {
          "circulating_usd": 590923338.3568476,
          "peg_type": "peggedEUR"
        },
        {
          "circulating_usd": 140392659.80403662,
          "peg_type": "peggedJPY"
        },
        {
          "circulating_usd": 37423809.7566888,
          "peg_type": "peggedCHF"
        },
        {
          "circulating_usd": 20437517.17547164,
          "peg_type": "peggedGBP"
        },
        {
          "circulating_usd": 9432830.244716188,
          "peg_type": "peggedVAR"
        },
        {
          "circulating_usd": 9048758.190968553,
          "peg_type": "peggedSGD"
        },
        {
          "circulating_usd": 8903187.616031654,
          "peg_type": "peggedRUB"
        },
        {
          "circulating_usd": 7914451.915763485,
          "peg_type": "peggedAUD"
        },
        {
          "circulating_usd": 7357388.51661427,
          "peg_type": "peggedARS"
        },
        {
          "circulating_usd": 2385187.140938338,
          "peg_type": "peggedCAD"
        },
        {
          "circulating_usd": 1174728.3135458298,
          "peg_type": "peggedMXN"
        },
        {
          "circulating_usd": 825052.0786513871,
          "peg_type": "peggedCNY"
        },
        {
          "circulating_usd": 692296.7833449361,
          "peg_type": "peggedTRY"
        },
        {
          "circulating_usd": 642175.4132046689,
          "peg_type": "peggedREAL"
        },
        {
          "circulating_usd": 203101.21454193452,
          "peg_type": "peggedKRW"
        },
        {
          "circulating_usd": 128366.88001866432,
          "peg_type": "peggedHKD"
        },
        {
          "circulating_usd": 104835.7381232823,
          "peg_type": "peggedMYR"
        },
        {
          "circulating_usd": 49543.581906150604,
          "peg_type": "peggedCOP"
        },
        {
          "circulating_usd": 4904.387031607396,
          "peg_type": "peggedCLP"
        },
        {
          "circulating_usd": 2028.4398839509752,
          "peg_type": "peggedPEN"
        }
      ],
      "name": "Ethereum",
      "source_url": "https://defillama.com/stablecoins/ethereum",
      "total_circulating_usd": 146833713957.86246
    },
    {
      "by_peg_type": [
        {
          "circulating_usd": 94003429684.60368,
          "peg_type": "peggedUSD"
        },
        {
          "circulating_usd": 458837781.37300986,
          "peg_type": "peggedRUB"
        },
        {
          "circulating_usd": 6863582.858888168,
          "peg_type": "peggedEUR"
        },
        {
          "circulating_usd": 2238939.6,
          "peg_type": "peggedCNY"
        }
      ],
      "name": "Tron",
      "source_url": "https://defillama.com/stablecoins/tron",
      "total_circulating_usd": 94471369988.43558
    },
    {
      "by_peg_type": [
        {
          "circulating_usd": 16064179908.891586,
          "peg_type": "peggedUSD"
        },
        {
          "circulating_usd": 57710037.427156895,
          "peg_type": "peggedEUR"
        },
        {
          "circulating_usd": 2440796.268499252,
          "peg_type": "peggedVAR"
        },
        {
          "circulating_usd": 1247755.1733964223,
          "peg_type": "peggedCHF"
        },
        {
          "circulating_usd": 364613.199723951,
          "peg_type": "peggedGBP"
        },
        {
          "circulating_usd": 165184.2261306445,
          "peg_type": "peggedTRY"
        },
        {
          "circulating_usd": 75196.34214529603,
          "peg_type": "peggedAUD"
        },
        {
          "circulating_usd": 1440.0072217914271,
          "peg_type": "peggedCAD"
        },
        {
          "circulating_usd": 52.74292614335783,
          "peg_type": "peggedJPY"
        },
        {
          "circulating_usd": 0.6978627424923325,
          "peg_type": "peggedKRW"
        }
      ],
      "name": "Solana",
      "source_url": "https://defillama.com/stablecoins/solana",
      "total_circulating_usd": 16126184984.97665
    },
    {
      "by_peg_type": [
        {
          "circulating_usd": 13302881226.197842,
          "peg_type": "peggedUSD"
        },
        {
          "circulating_usd": 10282012.567897802,
          "peg_type": "peggedEUR"
        },
        {
          "circulating_usd": 193745.82315857784,
          "peg_type": "peggedTRY"
        },
        {
          "circulating_usd": 53448.496237219595,
          "peg_type": "peggedARS"
        },
        {
          "circulating_usd": 45677.73958803704,
          "peg_type": "peggedREAL"
        },
        {
          "circulating_usd": 16390.17413316175,
          "peg_type": "peggedGBP"
        },
        {
          "circulating_usd": 9384.877527945471,
          "peg_type": "peggedCOP"
        },
        {
          "circulating_usd": 5327.974567307191,
          "peg_type": "peggedCLP"
        },
        {
          "circulating_usd": 4888.418833937684,
          "peg_type": "peggedMXN"
        },
        {
          "circulating_usd": 1260.766859577141,
          "peg_type": "peggedPEN"
        }
      ],
      "name": "BSC",
      "source_url": "https://defillama.com/stablecoins/bsc",
      "total_circulating_usd": 13313493363.036646
    },
    {
      "by_peg_type": [
        {
          "circulating_usd": 7775804615.446574,
          "peg_type": "peggedUSD"
        },
        {
          "circulating_usd": 0.0035608936252466885,
          "peg_type": "peggedRUB"
        }
      ],
      "name": "Hyperliquid L1",
      "source_url": "https://defillama.com/stablecoins/hyperliquid-l1",
      "total_circulating_usd": 7775804615.450135
    }
  ],
  "count": 5,
  "next_continuation": "5",
  "observed_at_ms": 1790118278819,
  "total_matches": 210
}
```

### Stablecoin history

- Capability: `crypto/stablecoin_history`
- Description: Historical circulating supply of one stablecoin, across all chains or on one chain, as a daily series (latest points first, capped by `limit`, optionally bounded by `from`/`to`). Identity comes from the stablecoin listing; the series from stablecoins.llama.fi/stablecoincharts/{all|chain}?stablecoin={id}.
- Instructions: The issue's named example: historical stablecoin supply for one asset (e.g. Tether id `1`), overall or on a chain like `Ethereum`.
- Cost: 5 credits per call
- Capability file: [Stablecoin history](https://firecrawl.dev/alexandria/agents/providers/defillama-com/crypto/stablecoin_history)

Accepted options:
- `chain` (string): Chain name as DeFiLlama writes it (e.g. `Ethereum`); omit for the all-chain total. Example: `<chain>`
- `from` (number): Earliest point, unix seconds. Example: `10`
- `id` (string, required): DeFiLlama stablecoin id from `stablecoins` (e.g. `1`). Pattern: ^[0-9]{1,6}$. Example: `<id>`
- `limit` (number): Maximum points returned, newest first (1..4000, default 90). Example: `90`
- `to` (number): Latest point, unix seconds. Example: `10`

Response schema example:
```json
{
  "api_url": "https://stablecoins.llama.fi/stablecoincharts/all?stablecoin=1",
  "chain": "all",
  "count": 5,
  "history": [
    {
      "bridged_to_usd": 0,
      "circulating": 183533051217.38,
      "circulating_usd": 183513418345.23,
      "date": 1790035200,
      "minted_usd": 0,
      "unreleased": 9982454244.53
    },
    {
      "bridged_to_usd": null,
      "circulating": 183353983062,
      "circulating_usd": 183313796367,
      "date": 1789948800,
      "minted_usd": null,
      "unreleased": 10161522411
    },
    {
      "bridged_to_usd": null,
      "circulating": 183353983070,
      "circulating_usd": 183305954113,
      "date": 1789862400,
      "minted_usd": null,
      "unreleased": 10161522411
    },
    {
      "bridged_to_usd": null,
      "circulating": 183353983075,
      "circulating_usd": 183279108348,
      "date": 1789776000,
      "minted_usd": null,
      "unreleased": 10161522411
    },
    {
      "bridged_to_usd": null,
      "circulating": 183381945739,
      "circulating_usd": 183329320360,
      "date": 1789689600,
      "minted_usd": null,
      "unreleased": 10137052815
    }
  ],
  "id": "1",
  "name": "Tether",
  "observed_at_ms": 1790118272098,
  "peg_mechanism": "fiat-backed",
  "peg_type": "peggedUSD",
  "source_url": "https://defillama.com/stablecoin/tether",
  "symbol": "USDT",
  "total_points": 3220
}
```

### Stablecoins

- Capability: `crypto/stablecoins`
- Description: List stablecoins tracked by DeFiLlama with current circulating supply, peg type, mechanism, price and chains, sorted by circulating supply (largest first). Optional client-side filters by name/symbol substring, peg type and chain. Source: stablecoins.llama.fi/stablecoins?includePrices=true (one cached dump; paging is an offset into the filtered list).
- Instructions: Finding a stablecoin's id for `stablecoin_history`, ranking stablecoins by supply, or listing the stablecoins on one chain or with one peg.
- Cost: 5 credits per call
- Capability file: [Stablecoins](https://firecrawl.dev/alexandria/agents/providers/defillama-com/crypto/stablecoins)

Accepted options:
- `chain` (string): Chain name as DeFiLlama writes it (e.g. `Ethereum`, `Tron`); case-insensitive match. Example: `<chain>`
- `continuation` (string): Opaque cursor from a previous page's `next_continuation`. Pattern: ^[0-9]{1,7}$. Example: `next_continuation`
- `limit` (number): Items per page (1..100, default 25). Example: `25`
- `peg_type` (string): Exact DeFiLlama peg type (e.g. `peggedUSD`, `peggedEUR`). Pattern: ^pegged[A-Z]{3,4}$. Example: `<peg_type>`
- `query` (string): Case-insensitive substring of the name or symbol (e.g. `USDT`, `dai`). Example: `<query>`

Response schema example:
```json
{
  "api_url": "https://stablecoins.llama.fi/stablecoins?includePrices=true",
  "count": 4,
  "next_continuation": null,
  "observed_at_ms": 1790118263422,
  "stablecoins": [
    {
      "chains": [
        "Tron",
        "Ethereum",
        "BSC",
        "Solana",
        "Plasma",
        "Arbitrum",
        "Polygon",
        "TON",
        "Aptos",
        "Mantle",
        "Avalanche",
        "OP Mainnet",
        "Kaia",
        "X Layer",
        "Hyperliquid L1",
        "Celo",
        "Fantom",
        "Ink",
        "Monad",
        "Kava",
        "Berachain",
        "Near",
        "Polkadot",
        "Mixin",
        "Tezos",
        "Flare",
        "Stable",
        "Conflux",
        "Tempo",
        "OKTChain",
        "KCC",
        "Sui",
        "Morph",
        "Linea",
        "Unichain",
        "Injective",
        "PulseChain",
        "Scroll",
        "Starknet",
        "Katana",
        "Rootstock",
        "ZKsync Era",
        "ICP",
        "CORE",
        "Manta",
        "Sei",
        "Vaulta",
        "Metis",
        "MegaETH",
        "Aurora",
        "Gnosis",
        "IoTeX",
        "Peaq",
        "EDU Chain",
        "Abstract",
        "Algorand",
        "Redbelly",
        "Soneium",
        "Osmosis",
        "MultiversX",
        "Etherlink",
        "Stacks",
        "IOTA EVM",
        "Bittorrent",
        "Oasis Emerald",
        "Movement",
        "Wanchain",
        "Mode",
        "Waves",
        "Kusama",
        "Astar",
        "Hemi",
        "Telos",
        "Meter",
        "Gravity by Galxe",
        "Boba",
        "Zircuit",
        "Cardano",
        "Hedera",
        "Fuse",
        "MANTRA",
        "Syscoin",
        "XDC",
        "ApeChain",
        "Taiko",
        "GOAT",
        "Immutable zkEVM",
        "Somnia",
        "Viction",
        "EthereumClassic",
        "Shiden",
        "Plume Mainnet",
        "Citrea",
        "Data Network",
        "LightLink",
        "Flow",
        "Theta",
        "Vana",
        "Nibiru",
        "Arbitrum Nova",
        "Rayls",
        "0G",
        "Zora",
        "ThunderCore",
        "Corn",
        "Zilliqa",
        "Evmos",
        "SX Network",
        "Milkomeda C1",
        "DefiChain",
        "Ontology",
        "Rari",
        "Kardia",
        "Crab",
        "Harmony",
        "Dogechain",
        "Heco",
        "ZKsync Lite",
        "Moonbeam",
        "Canto",
        "Moonriver",
        "Terra Classic",
        "NEO",
        "Swellchain",
        "Everscale",
        "Loopring",
        "Reinetwork",
        "Statemine",
        "Glue",
        "Omni"
      ],
      "circulating": 183517815137.2799,
      "circulating_prev_day": 183334369345.02417,
      "circulating_prev_month": 183207313187.19012,
      "circulating_prev_week": 183380911917.79025,
      "gecko_id": "tether",
      "id": "1",
      "name": "Tether",
      "peg_mechanism": "fiat-backed",
      "peg_type": "peggedUSD",
      "price": 0.99989302813838,
      "source_url": "https://defillama.com/stablecoin/tether",
      "symbol": "USDT"
    },
    {
      "chains": [
        "Ethereum",
        "Solana"
      ],
      "circulating": 520590689.9217519,
      "circulating_prev_day": 527789574.7156724,
      "circulating_prev_month": 333567945.1523264,
      "circulating_prev_week": 527404373.0486987,
      "gecko_id": "usdtb",
      "id": "221",
      "name": "Ethena USDtb",
      "peg_mechanism": "fiat-backed",
      "peg_type": "peggedUSD",
      "price": 0.999845110266752,
      "source_url": "https://defillama.com/stablecoin/ethena-usdtb",
      "symbol": "USDTB"
    },
    {
      "chains": [
        "Arbitrum",
        "BSC",
        "Linea"
      ],
      "circulating": 238614.6430315023,
      "circulating_prev_day": 238614.6430315023,
      "circulating_prev_month": 238614.6430315023,
      "circulating_prev_week": 238614.6430315023,
      "gecko_id": "usdtplus",
      "id": "112",
      "name": "USDT+",
      "peg_mechanism": "crypto-backed",
      "peg_type": "peggedUSD",
      "price": 0.999580610107606,
      "source_url": "https://defillama.com/stablecoin/usdt",
      "symbol": "USDT+"
    },
    {
      "chains": [
        "Tezos"
      ],
      "circulating": 226665.5042637354,
      "circulating_prev_day": 226665.5042637354,
      "circulating_prev_month": 226665.5042637354,
      "circulating_prev_week": 226665.5042637354,
      "gecko_id": "usdtez",
      "id": "73",
      "name": "USDtez",
      "peg_mechanism": "fiat-backed",
      "peg_type": "peggedUSD",
      "price": 1.0137445929469893,
      "source_url": "https://defillama.com/stablecoin/usdtez",
      "symbol": "USDTZ"
    }
  ],
  "total_matches": 4
}
```

### Yield pool history

- Capability: `crypto/yield_pool_history`
- Description: Daily TVL and APY history of one yield pool from yields.llama.fi/chart/{pool}, newest first, capped by `limit`.
- Instructions: APY/TVL trend of a pool whose uuid you have from `yield_pools`.
- Cost: 5 credits per call
- Capability file: [Yield pool history](https://firecrawl.dev/alexandria/agents/providers/defillama-com/crypto/yield_pool_history)

Accepted options:
- `limit` (number): Maximum points, newest first (1..4000, default 90). Example: `90`
- `pool` (string, required): Pool uuid. Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$. Example: `<pool>`

Response schema example:
```json
{
  "api_url": "https://yields.llama.fi/chart/747c1d2a-c668-4682-b9f9-296708a3dd90",
  "count": 5,
  "history": [
    {
      "apy": 2.211,
      "apy_base": 2.211,
      "apy_base_7d": null,
      "apy_reward": null,
      "il_7d": null,
      "timestamp": "2026-09-22T22:01:23.844Z",
      "tvl_usd": 26835205048
    },
    {
      "apy": 2.218,
      "apy_base": 2.218,
      "apy_base_7d": null,
      "apy_reward": null,
      "il_7d": null,
      "timestamp": "2026-09-21T23:01:59.515Z",
      "tvl_usd": 27140518142
    },
    {
      "apy": 2.231,
      "apy_base": 2.231,
      "apy_base_7d": null,
      "apy_reward": null,
      "il_7d": null,
      "timestamp": "2026-09-20T23:01:33.904Z",
      "tvl_usd": 25713068218
    },
    {
      "apy": 2.25,
      "apy_base": 2.25,
      "apy_base_7d": null,
      "apy_reward": null,
      "il_7d": null,
      "timestamp": "2026-09-19T23:01:19.034Z",
      "tvl_usd": 25532325983
    },
    {
      "apy": 2.252,
      "apy_base": 2.252,
      "apy_base_7d": null,
      "apy_reward": null,
      "il_7d": null,
      "timestamp": "2026-09-18T23:01:34.600Z",
      "tvl_usd": 25615261725
    }
  ],
  "observed_at_ms": 1790118417603,
  "pool": "747c1d2a-c668-4682-b9f9-296708a3dd90",
  "source_url": "https://defillama.com/yields/pool/747c1d2a-c668-4682-b9f9-296708a3dd90",
  "total_points": 1604
}
```

### Yield pools

- Capability: `crypto/yield_pools`
- Description: Yield pools tracked by DeFiLlama (yields.llama.fi/pools) with TVL, APY (base/reward), 30d mean, stablecoin flag, IL risk and prediction. Client-side filters by chain, project, symbol substring, stablecoin-only and minimum TVL; sorted by TVL or APY.
- Instructions: Finding yield opportunities by chain/project/asset, or a pool id for `yield_pool_history`.
- Cost: 5 credits per call
- Capability file: [Yield pools](https://firecrawl.dev/alexandria/agents/providers/defillama-com/crypto/yield_pools)

Accepted options:
- `chain` (string): Chain name as DeFiLlama writes it; case-insensitive. Example: `<chain>`
- `continuation` (string): Opaque cursor from a previous page's `next_continuation`. Pattern: ^[0-9]{1,7}$. Example: `next_continuation`
- `limit` (number): Items per page (1..100, default 20). Example: `20`
- `min_tvl_usd` (number): Drop pools below this TVL. Example: `10`
- `project` (string): Project slug (e.g. `lido`, `aave-v3`); case-insensitive. Example: `<project>`
- `sort` (string): `tvl` (default) or `apy`, both descending. Example: `tvl`
- `stablecoin_only` (boolean): Only pools DeFiLlama flags as stablecoin pools. Example: `false`
- `symbol` (string): Case-insensitive substring of the pool symbol (e.g. `USDC`). Example: `<symbol>`

Response schema example:
```json
{
  "api_url": "https://yields.llama.fi/pools",
  "count": 1,
  "next_continuation": null,
  "observed_at_ms": 1790118404840,
  "pools": [
    {
      "apy": 2.211,
      "apy_base": 2.211,
      "apy_mean_30d": 2.23878,
      "apy_pct_1d": -0.007,
      "apy_pct_30d": -0.004,
      "apy_pct_7d": -0.087,
      "apy_reward": null,
      "chain": "Ethereum",
      "exposure": "single",
      "il_risk": "no",
      "outlier": false,
      "pool": "747c1d2a-c668-4682-b9f9-296708a3dd90",
      "pool_meta": null,
      "prediction": {
        "binned_confidence": 2,
        "predicted_class": "Stable/Up",
        "probability": 72
      },
      "project": "lido",
      "reward_tokens": [],
      "source_url": "https://defillama.com/yields/pool/747c1d2a-c668-4682-b9f9-296708a3dd90",
      "stablecoin": false,
      "symbol": "STETH",
      "tvl_usd": 26835205048,
      "underlying_tokens": [
        "0x0000000000000000000000000000000000000000"
      ]
    }
  ],
  "total_matches": 1
}
```
