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

# How to Use DeFiLlama protocol TVL rankings in opencode

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 opencode

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

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

### Use Spiral's MCP server

1. **Add the server**: Leave out `--global` to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.

```bash
opencode mcp add spiral --global --url https://api.spiral.ai/mcp
```

2. **Sign in**: Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, `/mcps` starts the same sign-in.

```bash
opencode mcp auth spiral
```

3. **Check it**: Spiral shows as connected.

```bash
opencode mcp list
```

### Use the Spiral skill

1. **Send opencode 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: opencode finds DeFiLlama protocol TVL rankings on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/opencode

## 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 opencode?

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 opencode guides](https://spiral.ai/integrations/opencode)

## 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)
- [Muse Code](https://spiral.ai/integrations/muse-code/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)
- [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 opencode guides

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

## Questions about DeFiLlama protocol TVL rankings in opencode

**Can opencode use DeFiLlama protocol TVL rankings?**

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

**How much does DeFiLlama protocol TVL rankings cost in opencode?**

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

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

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 opencode?**

About two minutes: add the server, then sign in, then check it.

**Does opencode wait while DeFiLlama protocol TVL rankings runs?**

DeFiLlama protocol TVL rankings runs in the background. opencode 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.

