pp-defillama

What this skill does

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/other/defillama/SKILL.md,
     regenerated post-merge by tools/generate-skills/. Hand-edits here are
     silently overwritten on the next regen. Edit the library/ source instead.
     See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". -->

# Defillama — Printing Press CLI

## Prerequisites: Install the CLI

This skill drives the `defillama-pp-cli` binary. **You must verify the CLI is installed before invoking any command from this skill.** If it is missing, install it first:

1. Install via the Printing Press installer. It defaults binaries to `$HOME/.local/bin` on macOS/Linux and `%LOCALAPPDATA%\Programs\PrintingPress\bin` on Windows:
   ```bash
   npx -y @mvanhorn/printing-press-library install defillama --cli-only
   ```
2. Verify: `defillama-pp-cli --version`
3. Ensure the reported install directory is on `$PATH` for the agent/runtime that will invoke this skill.

If the `npx` install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.3 or newer):

```bash
go install github.com/mvanhorn/printing-press-library/library/other/defillama/cmd/defillama-pp-cli@latest
```

If `--version` reports "command not found" after install, the runtime cannot see the binary directory on `$PATH`. Do not proceed with skill commands until verification succeeds.

## Using AI?

DefiLlama offers two ways to use our data with AI:

| Resource | For | Description |
|---|---|---|
| <a href='/llms.txt'><b>llms.txt</b></a> | AI assistants (ChatGPT, Claude, Cursor, etc.) | Paste this link into your AI assistant for LLM-optimized docs |
| <a href='https://defillama.com/mcp'><b>MCP Server</b></a> | AI agents | Connect your agent directly to DefiLlama data — 23 tools, requires an API plan |

**Quick start (MCP)** — paste this into your AI agent:
```
Read https://raw.githubusercontent.com/DefiLlama/defillama-skills/refs/heads/master/defillama-setup/SKILL.md and follow the instructions to connect to DefiLlama MCP
```

---

Need higher rate limits or priority support? We offer a premium plan for 300$/mo. To get it, go to https://defillama.com/subscription

## SDK

**JavaScript** — `npm install @defillama/api` — [GitHub](https://github.com/DefiLlama/api-sdk)

**Python** — `pip install defillama-sdk` — [GitHub](https://github.com/DefiLlama/python-sdk)

Quick start (JavaScript):
```ts
import { DefiLlama } from '@defillama/api'

const client = new DefiLlama()
const protocols = await client.tvl.getProtocols()
```

Quick start (Python):
```py
from defillama_sdk import DefiLlama

client = DefiLlama()
protocols = client.tvl.getProtocols()
```

## When Not to Use This CLI

Do not activate this CLI for requests that require creating, updating, deleting, publishing, commenting, upvoting, inviting, ordering, sending messages, booking, purchasing, or changing remote state. This printed CLI exposes read-only commands for inspection, export, sync, and analysis.

## Command Reference

**batch-historical** — Manage batch historical

- `defillama-pp-cli batch-historical` — Strings accepted by period and searchWidth: Can use regular chart candle notion like ‘4h’ etc where: W = week, D = day

**block** — Manage block

- `defillama-pp-cli block <chain> <timestamp>` — Runs binary search over a blockchain's blocks to get the closest one to a timestamp.

**bridges** — Manage bridges

- `defillama-pp-cli bridges get` — Get summary of bridge volume and volume breakdown by chain
- `defillama-pp-cli bridges get-bridgedaystats` — Get a 24hr token and address volume breakdown for a bridge
- `defillama-pp-cli bridges get-bridgevolume` — Get historical volumes for a bridge, chain, or bridge on a particular chain
- `defillama-pp-cli bridges get-transactions` — Get all transactions for a bridge within a date range
- `defillama-pp-cli bridges list` — List all bridges along with summaries of recent bridge volumes.

**categories** — Manage categories

- `defillama-pp-cli categories` — Overview of all categories accross all protocols

**chain-assets** — Manage chain assets

- `defillama-pp-cli chain-assets` — Get assets of all chains

**chains** — Manage chains

- `defillama-pp-cli chains` — Get current TVL of all chains

**chart** — Manage chart

- `defillama-pp-cli chart get` — Strings accepted by period and searchWidth: Can use regular chart candle notion like ‘4h’ etc where: W = week, D = day
- `defillama-pp-cli chart get-fork` — Returns an array of [timestamp, value] pairs representing TVL over time for all forks of a specific protocol.
- `defillama-pp-cli chart get-metric` — Returns an array of [timestamp, value] pairs representing the total metric value over time.
- `defillama-pp-cli chart get-oracle` — Returns an array of [timestamp, value] pairs representing oracle TVL over time for a specific chain.
- `defillama-pp-cli chart get-oracle-2` — Returns an array of [timestamp, value] pairs representing TVL over time for a specific oracle/protocol.
- `defillama-pp-cli chart get-oracle-3` — Returns an array of objects with a timestamp and TVL values broken down by oracle/protocol for a specific chain.
- `defillama-pp-cli chart get-oracle-4` — Returns an array of objects with a timestamp and TVL values broken down by chain for a specific oracle/protocol.
- `defillama-pp-cli chart get-pool` — Get historical APY and TVL of a pool
- `defillama-pp-cli chart get-treasury` — Returns an array of [timestamp, value] pairs representing the protocol's treasury value over time.
- `defillama-pp-cli chart get-treasury-2` — Returns an array of [timestamp, { chain: value }] pairs showing treasury value per chain over time.
- `defillama-pp-cli chart get-treasury-3` — Returns an array of [timestamp, { token: value }] pairs showing treasury value per token over time.
- `defillama-pp-cli chart get-tvl` — Returns an array of [timestamp, value] pairs representing the protocol's TVL over time.
- `defillama-pp-cli chart get-tvl-2` — Returns an array of [timestamp, { chain: value }] pairs showing the selected metric per chain over time.
- `defillama-pp-cli chart get-tvl-3` — Returns an array of [timestamp, { token: value }] pairs showing TVL per token over time.
- `defillama-pp-cli chart list` — Returns an array of [timestamp, value] pairs representing total TVL across all oracles over time.
- `defillama-pp-cli chart list-fork` — Returns an array of objects with a timestamp and TVL values broken down by fork protocol.
- `defillama-pp-cli chart list-oracle` — Returns an array of objects with a timestamp and TVL values broken down by chain.
- `defillama-pp-cli chart list-oracle-2` — Returns an array of objects with a timestamp and TVL values broken down by oracle/protocol.

**dat** — Manage dat

- `defillama-pp-cli dat get` — Returns detailed data for a specific institution, including mNAV calculations (realized, realistic, maximum)
- `defillama-pp-cli dat list` — Returns comprehensive data about institutions holding digital assets, including mNAV calculations (realized, realistic

**emission** — Manage emission

- `defillama-pp-cli emission <protocol>` — Unlocks data for a given token/protocol.

**emissions** — Manage emissions

- `defillama-pp-cli emissions` — List of all tokens along with basic info for each

**entities** — Manage entities

- `defillama-pp-cli entities` — List all entities

**equities** — Manage equities

- `defillama-pp-cli equities list` — Returns a list of all publicly traded companies tracked by DefiLlama, with current market summary data for each
- `defillama-pp-cli equities list-v1` — Returns a list of SEC filings (10-K, 10-Q, etc.) for the given ticker, sorted by filing date descending (newest first).
- `defillama-pp-cli equities list-v1-2` — Returns daily OHLCV bars as six-number arrays: Unix timestamp in seconds (UTC), open, high, low, close, volume.
- `defillama-pp-cli equities list-v1-3` — Returns daily closing prices as two-element arrays: ISO 8601 date-time s