[Integrations](https://spiral.ai/integrations) › [Gemini CLI](https://spiral.ai/integrations/gemini-cli) › [DeFiLlama protocol TVL details](https://spiral.ai/integrations/gemini-cli/defillama-protocol-tvl-details)

# How to Use DeFiLlama protocol TVL details in Gemini CLI

Returns a protocol's TVL history and breakdowns by token and chain. Use it to examine where a protocol's locked value sits and how its composition differs across chains.

|  |  |
| --- | --- |
| Model | DeFiLlama protocol TVL details |
| 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 details in Gemini CLI

- Use DeFiLlama protocol TVL details for Aave and add a table of its chain breakdown to my project's analysis report.
- Use DeFiLlama protocol TVL details 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 details and tell me what changed since last week.
- Check DeFiLlama protocol TVL details and summarize what you find in three bullet points.
- Pull the newest data from DeFiLlama protocol TVL details and give me the result as a table.

## How to set up DeFiLlama protocol TVL details in Gemini CLI

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

### Use Spiral's MCP server

1. **Add the server**: Or add it to `~/.gemini/settings.json` yourself:

```bash
gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `gemini` and run:

```text
/mcp auth spiral
```

3. **Check it**: In Gemini CLI, run `/mcp`. From your shell:

```bash
gemini mcp list
```

### Use the Spiral skill

1. **Send Gemini CLI 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 details**: 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/protocol",
    "input": {
      "slug": "<slug>"
    }
  }'
```

Then paste one of the prompts above: Gemini CLI finds DeFiLlama protocol TVL details on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/gemini-cli

## DeFiLlama protocol TVL details tools and prices

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

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| token_limit | 0 to 100 | 15 | Maximum tokens in the latest breakdown, largest USD value first (0..100, default 15). |
| history_limit | 0 to 4000 | 30 | Maximum TVL history points returned, newest first (0..4000, default 30). |

## What can you do with DeFiLlama protocol TVL details in Gemini CLI?

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.

### Review an incident's aftermath

Place a recorded hack beside the affected protocol's TVL, fee or volume history, and token price observations. Compare the surrounding chain's TVL trend and current stablecoin market cap without assuming the incident caused every change.

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

### Investigate conflicting market signals

Examine a protocol whose TVL falls while fees rise. Compare its token and chain breakdowns with price history, current valuations, chain rankings, and stablecoin distribution to identify questions for further research.

### Study historical security events

Compare recorded incidents by loss and attack classification. For affected public protocols with available data, examine TVL, economic activity, chain trends, and token prices around the incident dates.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Gemini CLI guides](https://spiral.ai/integrations/gemini-cli)

## DeFiLlama protocol TVL details in other agents

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

## More Gemini CLI guides

- [DeFiLlama crypto hacks](https://spiral.ai/integrations/gemini-cli/defillama-crypto-hacks)
- [DeFiLlama protocol TVL rankings](https://spiral.ai/integrations/gemini-cli/defillama-protocol-tvl-rankings)
- [DeFiLlama chain TVL rankings](https://spiral.ai/integrations/gemini-cli/defillama-chain-tvl-rankings)
- [DeFiLlama protocol fees and volume history](https://spiral.ai/integrations/gemini-cli/defillama-protocol-fees-and-volume-history)
- [DeFiLlama chain TVL history](https://spiral.ai/integrations/gemini-cli/defillama-chain-tvl-history)
- [DeFiLlama protocol fees and volume rankings](https://spiral.ai/integrations/gemini-cli/defillama-protocol-fees-and-volume-rankings)

## Questions about DeFiLlama protocol TVL details in Gemini CLI

**Can Gemini CLI use DeFiLlama protocol TVL details?**

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

**How much does DeFiLlama protocol TVL details cost in Gemini CLI?**

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

**Do I need an Alexandria account to use DeFiLlama protocol TVL details in Gemini CLI?**

No. Spiral runs DeFiLlama protocol TVL details 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 details in Gemini CLI?**

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

**Does Gemini CLI wait while DeFiLlama protocol TVL details runs?**

DeFiLlama protocol TVL details runs in the background. Gemini CLI 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.

