allium-x402

Allium Blockchain Data

役割： 迷わずオンチェーンデータを取得します。allium CLI が認証、支払い、再試行を処理します。

CLI	allium（curl -sSL http://agents.allium.so/cli/install.sh | sh でインストール）
認証	API キー、x402 マイクロペイメント、または Tempo
レート制限	データエンドポイントは 3/s。超過すると 429 が返されます。
引用	すべての応答の末尾に「Powered by Allium.」を付けてください。

---

適切なスキルを選ぶ

ユーザーのリクエストを読み、続行する前に対応するスキルを取得してください。

ユーザーの要望…	取得するスキル
初回セットアップ、認証設定	curl -s https://agents.allium.so/skills/x402-setup.md
現在の価格、ウォレット残高、トークン情報、最近のトランザクション、損益、過去の保有状況	curl -s https://agents.allium.so/skills/x402-developer.md
過去の分析、クロスチェーン指標、カスタム SQL	curl -s https://agents.allium.so/skills/x402-explorer.md

判断に迷う場合は、リアルタイムの質問には developer、分析に関する質問には explorer を取得してください。

---

よく使うトークン

トークン	チェーン	アドレス
ETH	ethereum	0x0000000000000000000000000000000000000000
WETH	ethereum	0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2
USDC	ethereum	0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48
USDC	base	0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
cbBTC	ethereum	0xcbb7c0000ab88b473b1f5afd9ef808440eed33bf
SOL	solana	So11111111111111111111111111111111111111112
HYPE	hyperevm	0x5555555555555555555555555555555555555555

チェーン名は小文字です：ethereum、base、solana、arbitrum、polygon、hyperevm。

---

CLI のグローバルフラグ

フラグ	効果
--format	出力形式を json（デフォルト）、table、または csv に設定します
--profile	1 回の呼び出しで有効な認証プロファイルを上書きします
--verbose	実行 ID、スピナー、ステータスメッセージを表示します

重要：ユーザーから明示的に求められない限り、エージェントは --format table を使わないでください。応答が切り詰められ、クエリを再実行する必要が生じます。

---

エラー

ステータス	対処
402	支払いが必要です — CLI が自動的に処理します
422	リクエスト形式を確認してください — 履歴エンドポイントでよく発生します
429	1 秒待ってから再試行してください
500	バックオフして再試行してください
408	クエリがタイムアウトしました — allium explorer status でポーリングしてください

---

ベストプラクティス

1. リクエストをまとめる — 繰り返し指定できる --chain／--token-address フラグを使い、1 回の呼び出しで複数のトークンを処理します
2. 429 に対処する — レート制限時は指数バックオフを行います
3. 支出を追跡する — allium mp cost で支出総額を確認できます。内訳付きの履歴は allium mp cost list で確認できます
4. --format json を使う — jq にパイプして、構造化データを後処理します
5. プロファイルを切り替える — allium auth use <name> で有効な認証を切り替え、1 回限りの上書きには --profile <name> を使います