pp-defillama

Defillama — Printing Press CLI

前提条件：CLI をインストールする

このスキルは defillama-pp-cli バイナリを使用します。**このスキルのコマンドを実行する前に、CLI がインストールされていることを必ず確認してください。**インストールされていない場合は、先にインストールしてください。

1. Printing Press インストーラーを使用してインストールします。バイナリのインストール先は、macOS/Linux では $HOME/.local/bin、Windows では %LOCALAPPDATA%\Programs\PrintingPress\bin がデフォルトです。

   npx -y @mvanhorn/printing-press-library install defillama --cli-only
   

2. 確認します：defillama-pp-cli --version
3. このスキルを実行するエージェント／ランタイムで、報告されたインストールディレクトリが $PATH に含まれていることを確認します。

npx によるインストールに失敗した場合（Node がない、オフラインなど）は、Go を直接インストールする方法に切り替えてください（Go 1.26.6 以降が必要です）。

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

インストール後に --version が「command not found」と報告する場合、ランタイムからバイナリのディレクトリが $PATH 経由で参照できません。確認が成功するまで、スキルのコマンドを実行しないでください。

AI をお使いですか？

DefiLlama のデータを AI で利用する方法は 2 つあります。

リソース	対象	説明
llms.txt	AI アシスタント（ChatGPT、Claude、Cursor など）	LLM に最適化されたドキュメントとして、このリンクを AI アシスタントに貼り付けてください
MCP サーバー	AI エージェント	エージェントを DefiLlama のデータに直接接続します — 23 個のツールがあり、API プランが必要です

クイックスタート（MCP） — これを AI エージェントに貼り付けてください。

Read https://raw.githubusercontent.com/DefiLlama/defillama-skills/refs/heads/master/defillama-setup/SKILL.md and follow the instructions to connect to DefiLlama MCP

---

より高いレート制限や優先サポートが必要ですか？月額 300$ のプレミアムプランをご用意しています。利用するには、https://defillama.com/subscription にアクセスしてください。

SDK

JavaScript — npm install @defillama/api — GitHub

Python — pip install defillama-sdk — GitHub

クイックスタート（JavaScript）：

import { DefiLlama } from '@defillama/api'

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

クイックスタート（Python）：

from defillama_sdk import DefiLlama

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

この CLI を使用しない場合

作成、更新、削除、公開、コメント、賛成票の投票、招待、注文、メッセージの送信、予約、購入、またはリモート状態の変更が必要なリクエストでは、この CLI を有効にしないでください。この印刷用 CLI が提供するのは、確認、エクスポート、同期、分析のための読み取り専用コマンドです。

コマンドリファレンス

batch-historical — バッチ履歴データを管理します

• defillama-pp-cli batch-historical — period と searchWidth で受け付ける文字列：通常のチャートのローソク足表記（「4h」など）を使用できます。W = 週、D = 日です。

block — ブロックを管理します

• defillama-pp-cli block <chain> <timestamp> — ブロックチェーンのブロックを二分探索し、指定したタイムスタンプに最も近いブロックを取得します。

bridges — ブリッジを管理します

• defillama-pp-cli bridges get — ブリッジのボリューム概要とチェーン別のボリューム内訳を取得します
• defillama-pp-cli bridges get-bridgedaystats — ブリッジの 24 時間分のトークンおよびアドレス別ボリューム内訳を取得します
• defillama-pp-cli bridges get-bridgevolume — ブリッジ、チェーン、または特定のチェーン上のブリッジの過去のボリュームを取得します
• defillama-pp-cli bridges get-transactions — 指定した期間内のブリッジのすべてのトランザクションを取得します
• defillama-pp-cli bridges list — すべてのブリッジと、最近のブリッジボリュームの概要を一覧表示します。

categories — カテゴリーを管理します

• defillama-pp-cli categories — すべてのプロトコルにわたる全カテゴリーの概要

chain-assets — チェーンのアセットを管理します

• defillama-pp-cli chain-assets — すべてのチェーンのアセットを取得します

chains — チェーンを管理します

• defillama-pp-cli chains — すべてのチェーンの現在の TVL を取得します

chart — チャートを管理します

• defillama-pp-cli chart get — period および searchWidth が受け付ける文字列: ‘4h’ などの通常のチャートローソク足の表記が使用できます。ここで、W = 週、D = 日です
• defillama-pp-cli chart get-fork — 特定のプロトコルのすべてのフォークについて、時間経過に伴う TVL を表す [timestamp, value] ペアの配列を返します。
• defillama-pp-cli chart get-metric — 時間経過に伴うメトリクスの合計値を表す [timestamp, value] ペアの配列を返します。
• defillama-pp-cli chart get-oracle — 特定のチェーンについて、時間経過に伴うオラクル TVL を表す [timestamp, value] ペアの配列を返します。
• defillama-pp-cli chart get-oracle-2 — 特定のオラクル/プロトコルについて、時間経過に伴う TVL を表す [timestamp, value] ペアの配列を返します。
• defillama-pp-cli chart get-oracle-3 — 特定のチェーンについて、タイムスタンプとオラクル/プロトコル別に内訳された TVL 値を持つオブジェクトの配列を返します。
• defillama-pp-cli chart get-oracle-4 — 特定のオラクル/プロトコルについて、タイムスタンプとチェーン別に内訳された TVL 値を持つオブジェクトの配列を返します。
• defillama-pp-cli chart get-pool — プールの過去の APY と TVL を取得します
• defillama-pp-cli chart get-treasury — 時間経過に伴うプロトコルのトレジャリー価値を表す [timestamp, value] ペアの配列を返します。
• defillama-pp-cli chart get-treasury-2 — 時間経過に伴うチェーン別のトレジャリー価値を示す [timestamp, { chain: value }] ペアの配列を返します。
• defillama-pp-cli chart get-treasury-3 — 時間経過に伴うトークン別のトレジャリー価値を示す [timestamp, { token: value }] ペアの配列を返します。
• defillama-pp-cli chart get-tvl — 時間経過に伴うプロトコルの TVL を表す [timestamp, value] ペアの配列を返します。
• defillama-pp-cli chart get-tvl-2 — 時間経過に伴うチェーン別の選択されたメトリクスを示す [timestamp, { chain: value }] ペアの配列を返します。
• defillama-pp-cli chart get-tvl-3 — 時間経過に伴うトークン別の TVL を示す [timestamp, { token: value }] ペアの配列を返します。
• defillama-pp-cli chart list — 時間経過に伴うすべてのオラクル全体の合計 TVL を表す [timestamp, value] ペアの配列を返します。
• defillama-pp-cli chart list-fork — タイムスタンプとフォークプロトコル別に内訳された TVL 値を持つオブジェクトの配列を返します。
• defillama-pp-cli chart list-oracle — タイムスタンプとチェーン別に内訳された TVL 値を持つオブジェクトの配列を返します。
• defillama-pp-cli chart list-oracle-2 — タイムスタンプとオラクル/プロトコル別に内訳された TVL 値を持つオブジェクトの配列を返します。

dat — dat を管理します

• defillama-pp-cli dat get — mNAV 計算（実現値、現実的、最大）を含む、特定の機関の詳細データを返します
• defillama-pp-cli dat list — mNAV 計算（実現値、現実的）を含む、デジタル資産を保有する機関に関する包括的なデータを返します

emission — emission を管理します

• defillama-pp-cli emission <protocol> — 指定されたトークン/プロトコルのアンロックデータを取得します。

emissions — emissions を管理します

• defillama-pp-cli emissions — すべてのトークンのリストとそれぞれの基本情報

entities — entities を管理します

• defillama-pp-cli entities — すべてのエンティティを一覧表示します

equities — equities を管理します

• defillama-pp-cli equities list — DefiLlama が追跡しているすべての上場企業のリストと、それぞれの現在の市場サマリーデータを返します
• defillama-pp-cli equities list-v1 — 指定されたティッカーの SEC 提出書類（10-K、10-Q など）のリストを、提出日の降順（新しい順）で返します。
• defillama-pp-cli equities list-v1-2 — 日次の OHLCV バーを 6 つの数値の配列として返します: Unix タイムスタンプ（秒、UTC）、始値、高値、安値、終値、出来高。
• defillama-pp-cli equities list-v1-3 — 日次の終値を 2 要素の配列として返します: ISO 8601 の日時文字列、次に数値の価格。
• defillama-pp-cli equities list-v1-4 — 指定されたティッカーの損益計算書、貸借対照表、キャッシュフロー計算書を返します
• defillama-pp-cli equities list-v1-5 — 単一のティッカーの現在の市場データを返します。

etfs — etfs を管理します

• defillama-pp-cli etfs list — 資産レベルの過去の資金フロー
• defillama-pp-cli etfs list-snapshot — ETF とその指標（運用資産残高、資金フロー、手数料など）を取得します

fdv — FDV を管理します

• defillama-pp-cli fdv <period> — カテゴリーのパフォーマンスに基づくナラティブのチャートを取得します（個別のコインは時価総額に応じて重み付けされます）

forks — フォークを管理します

• defillama-pp-cli forks — すべてのプロトコルにおけるフォークの概要

hacks — ハッキングを管理します

• defillama-pp-cli hacks — ハッキングダッシュボードに掲載されたすべてのハッキングの概要

historical-chain-tvl — チェーンの過去の TVL を管理します

• defillama-pp-cli historical-chain-tvl get — チェーンの過去の TVL（リキッドステーキングと二重計上された TVL を除く）を取得します
• defillama-pp-cli historical-chain-tvl list — すべてのチェーンにおける DeFi の過去の TVL（リキッドステーキングと二重計上された TVL を除く）を取得します

historical-liquidity — 過去の流動性を管理します

• defillama-pp-cli historical-liquidity <token> — 指定したチェーン上のコントラクト名を取得します

inflows — 資金流入を管理します

• defillama-pp-cli inflows <protocol> <timestamp> — 指定した日時におけるプロトコルの資金流入額と流出額を一覧表示します

metrics — 指標を管理します

• defillama-pp-cli metrics get — 指定したディメンションの集計指標を返します。合計値と、期間ごとの変化率が含まれます
• defillama-pp-cli metrics get-financialstatement — プロトコルのメタデータ、算出方法の詳細、集計された財務諸表データ（年次、四半期、月次）を返します。
• defillama-pp-cli metrics get-treasury — プロトコルのメタデータと、現在のトレジャリーの数値およびチェーン別の内訳を返します。
• defillama-pp-cli metrics get-tvl — プロトコルのメタデータと、現在の TVL の数値、チェーン別の内訳、その他の集計指標を返します。
• defillama-pp-cli metrics list — フォーク名を、各プロトコルのフォークであるプロトコル名の配列に対応付けたオブジェクトを返します。
• defillama-pp-cli metrics list-oracle — オラクル名を、各オラクルを使用するプロトコル名の配列に対応付けたオブジェクトを返します。

oracles — オラクルを管理します

• defillama-pp-cli oracles — すべてのプロトコルにおけるオラクルの概要

overview — 概要を管理します

• defillama-pp-cli overview get — チェーンで絞り込み、すべての DEX とその取引量の概要、および dataType の履歴データを一覧表示します
• defillama-pp-cli overview get-fees — すべてのプロトコルとその手数料および収益の概要、チェーン別の dataType 履歴データを一覧表示します
• defillama-pp-cli overview get-options — チェーンで絞り込み、すべてのオプション DEX とその取引量の概要、および dataType の履歴データを一覧表示します
• defillama-pp-cli overview list — すべての DEX とその取引量の概要、および dataType の履歴データを一覧表示します
• defillama-pp-cli overview list-derivatives — チェーンで絞り込み、すべてのデリバティブとその取引量の概要を一覧表示します
• defillama-pp-cli overview list-fees — すべてのプロトコルとその手数料および収益の概要、dataType の履歴データを一覧表示します
• defillama-pp-cli overview list-openinterest — すべての未決済建玉 DEX 取引所と、その未決済建玉の概要を一覧表示します
• defillama-pp-cli overview list-options — すべてのオプション DEX とその取引量の概要、および dataType の履歴データを一覧表示します

percentage — パーセンテージを管理します

• defillama-pp-cli percentage <coins> — period に指定できる文字列：4h などの一般的なチャートのローソク足表記を使用できます。W は週、D は日、H は時間を表します

pools — プールを管理します

• defillama-pp-cli pools — 予測などの拡充された情報を含む、すべてのプールの最新データを取得します

prices — 価格を管理します

• defillama-pp-cli prices get — 取引されたことのない特殊なトークンも含め、できるだけ多くのトークンを価格付けすることを目的とした API です
• defillama-pp-cli prices get-first — コインの最も古いタイムスタンプの価格レコードを取得します
• defillama-pp-cli prices get-historical — 価格の取得元については /prices/current の説明を参照してください。

protocol — プロトコルを管理します

• defillama-pp-cli protocol <protocol> — プロトコルの過去の TVL と、トークン別・チェーン別の内訳を取得します

protocols — プロトコルを管理します

• defillama-pp-cli protocols — defillama 上のすべてのプロトコルとその TVL を一覧表示します

raises — 資金調達を管理します

• defillama-pp-cli raises — Raises ダッシュボードにあるすべての資金調達の概要を取得します

rwa — RWA を管理します

• defillama-pp-cli rwa get — 指定したチェーン上でオンチェーン時価総額、アクティブ時価総額、または DeFi アクティブ TVL がある現在の RWA 資産を返します。
• defillama-pp-cli rwa get-chart — チェーンのオンチェーン時価総額、アクティブ時価総額、DeFi アクティブ TVL の合計の履歴を返します。
• defillama-pp-cli rwa list — チェーンごとのオンチェーン時価総額、アクティブ時価総額、DeFi アクティブ TVL のマップを含む、現在の Real World Asset の行を返します。
• defillama-pp-cli rwa list-chart — 選択した RWA 指標について、チェーンごとに列を設けた時系列の行を返します。
• defillama-pp-cli rwa list-list — 検出、検索、フィルターに使用する軽量な RWA リストを返します。
• defillama-pp-cli rwa list-stats — RWA の集計データを返します。デフォルトのチェーン別テーブルについては、byChain[chain].base: assetIssuers を参照してください。

stablecoin — ステーブルコインダッシュボードのデータ

• defillama-pp-cli stablecoin <asset> — ステーブルコインの過去の時価総額とチェーン別分布を取得します

stablecoinchains — stablecoinchains を管理します

• defillama-pp-cli stablecoinchains — 各チェーン上のすべてのステーブルコインの時価総額の現在の合計を取得します

stablecoincharts — stablecoincharts を管理します

• defillama-pp-cli stablecoincharts get — チェーン上のすべてのステーブルコインの時価総額の過去の合計を取得します
• defillama-pp-cli stablecoincharts list — すべてのステーブルコインの時価総額の過去の合計を取得します

stablecoinprices — stablecoinprices を管理します

• defillama-pp-cli stablecoinprices — すべてのステーブルコインの過去の価格を取得します

stablecoins — ステーブルコインダッシュボードのデータ

• defillama-pp-cli stablecoins get — チェーンごとのステーブルコインの占有率と、そのチェーンで最大のコインに関する情報を取得します
• defillama-pp-cli stablecoins list — すべてのステーブルコインとその流通量を一覧表示します

summary — summary を管理します

• defillama-pp-cli summary get — DEX 取引量の概要と過去のデータを取得します
• defillama-pp-cli summary get-derivatives — 特定のパープチュアルプロトコルの取引量の詳細を取得します
• defillama-pp-cli summary get-fees — プロトコルの手数料と収益の概要と過去のデータを取得します
• defillama-pp-cli summary get-options — オプション DEX 取引量の概要と過去のデータを取得します

token-protocols — トークンプロトコルを管理します

• defillama-pp-cli token-protocols <symbol> — すべてのプロトコルにおける特定のトークンの数量を一覧表示します。Token Usage ページのデータです

treasuries — トレジャリーを管理します

• defillama-pp-cli treasuries — Treasuries ダッシュボードにあるすべてのプロトコルを一覧表示します

tvl — TVL データを取得します

• defillama-pp-cli tvl <protocol> — 数値のみを返す簡易エンドポイントで、プロトコルの現在の TVL を取得します

usage — 使用状況を管理します

• defillama-pp-cli usage — API キーに残っているクレジット数を取得します。クレジットは毎月 1 日にリセットされます

yields — yields/APY ダッシュボードのデータ

• defillama-pp-cli yields get — レンディング市場のプールの過去の借入コスト APY を取得します。プール ID は /poolsBorrow から取得してください
• defillama-pp-cli yields list — 複数の LSD の APY レートを取得します
• defillama-pp-cli yields list-perps — 分散型および中央集権型を含む、各取引所のパープチュアルの資金調達率と未決済建玉を取得します
• defillama-pp-cli yields list-poolsborrow — レンディング市場における資産の借入コスト APY を取得します
• defillama-pp-cli yields list-poolsold — /pools と同じですが、新しいパラメーター pool_old も含まれます。通常はプールアドレスが格納されますが、保証はありません。

適切なコマンドを見つける

何をしたいかは分かっていても、どのコマンドを使えばよいか分からない場合は、CLI に直接尋ねてください。

defillama-pp-cli which "<capability in your own words>"

which は自然言語による機能の問い合わせを、この CLI の厳選された機能インデックスから最も一致するコマンドに解決します。終了コード 0 は少なくとも 1 件一致したことを示し、終了コード 2 は確信を持てる一致がなかったことを示します。その場合は --help に切り替えるか、より絞り込んだ問い合わせを使ってください。

認証の設定

認証は必要ありません。

defillama-pp-cli doctor を実行して、セットアップを確認してください。

エージェントモード

任意のコマンドに --agent を追加します。これは次のオプションに展開されます：--json --compact --no-input --no-color --yes。

• パイプ可能 — stdout に JSON、stderr にエラーを出力します

• フィルター可能 — --select でフィールドの一部を残せます。ドット区切りのパスはネストされた構造に降りていき、配列では各要素をたどります。出力が冗長な API でコンテキストを小さく保つために重要です。

  defillama-pp-cli batch-historical --coins example-value --agent --select id,name,status
  

• プレビュー可能 — --dry-run で送信せずにリクエストを表示します

• オフラインに対応 — 同期／検索コマンドは、利用可能な場合にローカルの SQLite ストアを使用できます

• 非対話型 — プロンプトは表示されず、すべての入力をフラグで指定します

• 読み取り専用 — 作成、更新、削除、公開、コメント、賛成票、招待、注文、送信、その他の変更を伴うリクエストには、この CLI を使用しないでください

レスポンスエンベロープ

ローカルストアまたは API からデータを読み取るコマンドは、出力を出所情報のエンベロープでラップします。

{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}

データには .results を、データがライブかローカルかを確認するには .meta.source を解析してください。人間が読みやすい N results (live) の概要は、stdout がターミナルであり、かつ機械可読形式のフラグ（--json、--csv、--compact、--quiet、--plain、--select）が設定されていない場合にのみ stderr に出力されます。パイプやエージェントの利用者、および明示的な形式指定での実行では、stdout に純粋な JSON が出力されます。

エージェントからのフィードバック

この CLI に問題があることに気づいた場合は（エージェントが気づいた場合も同様に）、記録してください。

defillama-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
defillama-pp-cli feedback --stdin < notes.txt
defillama-pp-cli feedback list --json --limit 10

記録はローカルの ~/.local/share/defillama-pp-cli/feedback.jsonl に保存されます。DEFILLAMA_FEEDBACK_ENDPOINT が設定され、かつ --send が渡されるか DEFILLAMA_FEEDBACK_AUTO_SEND=true が設定されている場合を除き、POST されることはありません。デフォルトではローカルのみに保存されます。

バグ報告ではなく、意外だったことを書いてください。短く、具体的に、1 行で。それが積み重なっていく情報です。

出力の配信

すべてのコマンドで --deliver <sink> を指定できます。出力は stdout に加えて（または stdout の代わりに）指定したシンクに送られるため、エージェントはコマンド結果を手動でパイプせずに振り分けられます。対応するシンクは 3 種類です。

シンク	効果
stdout	デフォルト。stdout のみに書き込みます
file:<path>	出力を <path> にアトミックに書き込みます（tmp + rename）
webhook:<url>	出力本文を URL に POST します（--compact の場合は application/json または application/x-ndjson）

不明なスキームは、対応するスキームを示す構造化エラーとともに拒否されます。Webhook の失敗時はゼロ以外の終了コードが返され、stderr に URL と HTTP ステータスが記録されます。

名前付きプロファイル

プロファイルとは、保存して呼び出し間で再利用できるフラグ値のセットです。スケジュールされたエージェントが毎回同じ設定で同じコマンドを実行する場合に使用します。HeyGen の「Beacon」パターンがその例です。

defillama-pp-cli profile save briefing --json
defillama-pp-cli --profile briefing batch-historical --coins example-value
defillama-pp-cli profile list --json
defillama-pp-cli profile show briefing
defillama-pp-cli profile delete briefing --yes

明示的なフラグは常にプロファイルの値より優先され、プロファイルの値はデフォルトより優先されます。agent-context は、利用可能なすべてのプロファイルを available_profiles の下に一覧表示するため、情報を調べるエージェントは実行時にプロファイルを検出できます。

終了コード

コード	意味
0	成功
2	使用方法のエラー（引数が不正）
3	リソースが見つかりません
5	API エラー（上流の問題）
7	レート制限中（待機して再試行してください）
10	設定エラー

引数の解析

$ARGUMENTS を解析します。

1. 空、help、または --help → defillama-pp-cli --help の出力を表示します
2. install で始まる → mcp で終わる場合は MCP のインストール、それ以外の場合は上記の前提条件を参照してください
3. その他すべて → 直接使用（--agent を付けて CLI コマンドとして実行します）

MCP サーバーのインストール

1. MCP サーバーをインストールします。

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

2. Claude Code に登録します。

   claude mcp add defillama-pp-mcp -- defillama-pp-mcp
   

3. 確認します：claude mcp list

直接使用

1. インストールされているか確認します：which defillama-pp-cli 見つからない場合は、インストールを提案します（このスキルの冒頭にある前提条件を参照してください）。
2. ユーザーのクエリに最適なコマンドを、上記の「独自の機能」と「コマンドリファレンス」から選びます。
3. --agent フラグを付けて実行します：

   defillama-pp-cli <command> [subcommand] [args] --agent
   

4. 曖昧な場合は、サブコマンドのヘルプを確認します：defillama-pp-cli <command> --help。