[Integrations](https://spiral.ai/integrations) › [Muse Code](https://spiral.ai/integrations/muse-code) › [DeFiLlama protocol TVL rankings](https://spiral.ai/integrations/muse-code/defillama-protocol-tvl-rankings)

# How to Use DeFiLlama protocol TVL rankings in Muse Code

Returns protocols with current TVL, categories, and supported chains. Use it to find comparable projects or identify a protocol before requesting its detailed TVL history.

|  |  |
| --- | --- |
| Model | DeFiLlama protocol TVL rankings |
| Available through | Alexandria |
| Category | Finance |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with DeFiLlama protocol TVL rankings in Muse Code

- Use DeFiLlama protocol TVL rankings to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from DeFiLlama protocol TVL rankings and tell me what changed since last week.
- Check DeFiLlama protocol TVL rankings and summarize what you find in three bullet points.
- Pull the newest data from DeFiLlama protocol TVL rankings and give me the result as a table.
- Check DeFiLlama protocol TVL rankings every morning and tell me only when something changed.

## How to set up DeFiLlama protocol TVL rankings in Muse Code

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Install Muse Code**

```bash
curl -fsSL https://dev.meta.ai/install.sh | bash
```

2. **Ask Muse to add the server**: Start `muse` and ask:

```text
Add the Spiral MCP server at https://api.spiral.ai/mcp
```

3. **Sign in**: In your terminal, run:

```bash
muse mcp login spiral
```

### Use the Spiral skill

1. **Send Muse Code this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run DeFiLlama protocol TVL rankings**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "defillama-com/crypto/protocols",
    "input": {
      "chain": "<chain>"
    }
  }'
```

Then paste one of the prompts above: Muse Code finds DeFiLlama protocol TVL rankings on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/muse-code

## DeFiLlama protocol TVL rankings tools and prices

- [DeFiLlama · Protocols](https://spiral.ai/tools/alexandria/defillama-com/crypto/protocols) (Alexandria): $0.00873 per call.

## Settings you can ask for

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

## What can you do with DeFiLlama protocol TVL rankings in Muse Code?

Build a personal DeFi research notebook that compares chain activity, protocol economics, token markets, and recorded exploits. A coding agent can turn DeFiLlama responses into tables and charts in your project.

### Weekly DeFi research brief

Prepare a personal research brief covering chain and protocol TVL rankings, historical changes, fees, volume, stablecoin distribution, token market moves, and recorded hacks.

### Compare chain ecosystems

Compare Ethereum, Solana, and Base using chain TVL trends, protocol rankings, fees or volume, and stablecoin market cap. Examine leading protocols to see what contributes to each chain's totals.

### Protocol due diligence

Build a research dossier on Aave or Uniswap with TVL composition, economic activity, comparable protocols, token price context, and recorded incidents. Add chain TVL and stablecoin distribution to describe the surrounding ecosystem.

### Compare lending protocols

Compare Aave, Compound, and Morpho through TVL rankings, chain exposure, fee and revenue history, and available token price observations. Keep retained revenue separate from total user fees.

### Benchmark chain liquidity and activity

Compare current chain TVL with stablecoin market cap, then inspect TVL history, protocol composition, and fee or volume rankings. Use separate columns for each measure so their different meanings remain clear.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Muse Code guides](https://spiral.ai/integrations/muse-code)

## DeFiLlama protocol TVL rankings in other agents

- [Amp](https://spiral.ai/integrations/amp/defillama-protocol-tvl-rankings)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/defillama-protocol-tvl-rankings)
- [Claude](https://spiral.ai/integrations/claude-desktop/defillama-protocol-tvl-rankings)
- [Claude Code](https://spiral.ai/integrations/claude-code/defillama-protocol-tvl-rankings)
- [Cline](https://spiral.ai/integrations/cline/defillama-protocol-tvl-rankings)
- [Codex](https://spiral.ai/integrations/codex/defillama-protocol-tvl-rankings)
- [Cursor](https://spiral.ai/integrations/cursor/defillama-protocol-tvl-rankings)
- [Devin](https://spiral.ai/integrations/devin/defillama-protocol-tvl-rankings)
- [dots](https://spiral.ai/integrations/dots/defillama-protocol-tvl-rankings)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/defillama-protocol-tvl-rankings)
- [Gemini](https://spiral.ai/integrations/gemini/defillama-protocol-tvl-rankings)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/defillama-protocol-tvl-rankings)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/defillama-protocol-tvl-rankings)
- [goose](https://spiral.ai/integrations/goose/defillama-protocol-tvl-rankings)
- [Grok](https://spiral.ai/integrations/grok/defillama-protocol-tvl-rankings)
- [Grok Build](https://spiral.ai/integrations/grok-build/defillama-protocol-tvl-rankings)
- [Hermes](https://spiral.ai/integrations/hermes/defillama-protocol-tvl-rankings)
- [Instinct](https://spiral.ai/integrations/instinct/defillama-protocol-tvl-rankings)
- [Manus](https://spiral.ai/integrations/manus/defillama-protocol-tvl-rankings)
- [Muse](https://spiral.ai/integrations/muse/defillama-protocol-tvl-rankings)
- [n8n](https://spiral.ai/integrations/n8n/defillama-protocol-tvl-rankings)
- [Notion](https://spiral.ai/integrations/notion/defillama-protocol-tvl-rankings)
- [OpenClaw](https://spiral.ai/integrations/openclaw/defillama-protocol-tvl-rankings)
- [opencode](https://spiral.ai/integrations/opencode/defillama-protocol-tvl-rankings)
- [Perplexity](https://spiral.ai/integrations/perplexity/defillama-protocol-tvl-rankings)
- [Raycast](https://spiral.ai/integrations/raycast/defillama-protocol-tvl-rankings)
- [VS Code](https://spiral.ai/integrations/vscode/defillama-protocol-tvl-rankings)
- [Windsurf](https://spiral.ai/integrations/windsurf/defillama-protocol-tvl-rankings)
- [Zapier](https://spiral.ai/integrations/zapier/defillama-protocol-tvl-rankings)

## More Muse Code guides

- [DeFiLlama protocol TVL details](https://spiral.ai/integrations/muse-code/defillama-protocol-tvl-details)
- [DeFiLlama protocol fees and volume history](https://spiral.ai/integrations/muse-code/defillama-protocol-fees-and-volume-history)
- [DeFiLlama crypto hacks](https://spiral.ai/integrations/muse-code/defillama-crypto-hacks)
- [DeFiLlama protocol fees and volume rankings](https://spiral.ai/integrations/muse-code/defillama-protocol-fees-and-volume-rankings)
- [DeFiLlama chain TVL rankings](https://spiral.ai/integrations/muse-code/defillama-chain-tvl-rankings)
- [DeFiLlama stablecoin market cap by chain](https://spiral.ai/integrations/muse-code/defillama-stablecoin-market-cap-by-chain)

## Questions about DeFiLlama protocol TVL rankings in Muse Code

**Can Muse Code use DeFiLlama protocol TVL rankings?**

Yes. Add Spiral to Muse Code as an MCP server, and Muse Code can find and run DeFiLlama protocol TVL rankings like any built-in tool.

**How much does DeFiLlama protocol TVL rankings cost in Muse Code?**

$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Muse Code plan is separate.

**Do I need an Alexandria account to use DeFiLlama protocol TVL rankings in Muse Code?**

No. Spiral runs DeFiLlama protocol TVL rankings on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up DeFiLlama protocol TVL rankings in Muse Code?**

About two minutes: install Muse Code, then ask Muse to add the server, then sign in.

**Does Muse Code wait while DeFiLlama protocol TVL rankings runs?**

DeFiLlama protocol TVL rankings runs in the background. Muse Code starts the run, checks on it and gives you the json when it's ready.

**How often does DeFiLlama update its data?**

TVL and stablecoin supply update hourly. Most fee, revenue, and DEX volume data updates hourly, but some protocols update only daily at midnight UTC.

**Where does DeFiLlama get its data?**

DeFiLlama maintains separate open-source adapter repositories for its metrics. Its TVL methodology says almost all tokens are valued using CoinGecko, with on-chain methods used when needed.

**Does every protocol have the same historical coverage?**

No. An adapter can define its earliest supported timestamp, and some adapters cannot backfill historical data. History therefore depends on the protocol's adapter.

**Does DeFiLlama's TVL include native token staking?**

Native token staking is excluded. DeFiLlama also excludes off-chain assets such as fiat held in a stablecoin issuer's bank account from TVL.

**Are protocol fees and revenue the same measure?**

No. Revenue excludes fees distributed to liquidity providers and other suppliers of capital. A protocol's fee total can therefore exceed what the protocol retains.

