Communitygithub.com

Elsa x402 DeFi ツール

Elsa API によるポートフォリオ分析、トークン検索、スワップ実行のための DeFi ツール (x402 マイクロペイメント対応)

Elsa x402 DeFi ツール とは?

このスキルは、Claude Code、Cursor、Codex などの AI エージェント向けに設計された、Elsa DeFi API の統合キットです。ポートフォリオ管理、トークン検索、スワップ実行、指値注文、永久先物取引などの一連の DeFi 操作を提供します。API 呼び出しごとに x402 マイクロペイメントを使用し、予算制御 (1 回あたり最大 $0.05、1 日あたり最大 $2.00) を設定可能で、コスト超過を防止します。特筆すべきは、推奨される 4 段階のスワップ フローです。ユーザーは見積もり取得 → ドライラン (シミュレーション) → 確認 → 実行というプロセスを踏み、誤操作を防止します。Base、Ethereum、Arbitrum、Optimism、Polygon、BSC、Avalanche、zkSync のチェーンをサポートし、トークン価格、残高、ポートフォリオ、ウォレット分析などの読み取り専用ツールと、スワップ実行や注文管理などの実行ツールに分かれています。実行ツールには ELSA_ENABLE_EXECUTION_TOOLS=true の環境変数設定が必要で、ローカル署名モードと外部署名モードの両方をサポートしています。

対応~Claude Code~Codex CLI~Cursor
npx skills add HeyElsa/elsa-openclaw

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Elsa x402 DeFi ツール は何をしますか?

このスキルは、x402 マイクロペイメントを使用したポートフォリオ管理、トークン分析、スワップ実行のための Elsa DeFi API へのアクセスを提供します。

標準運用手順

予算制御

  • API 呼び出しあたりの最大 $0.05 (設定可能)
  • 1 日あたり最大 $2.00 (設定可能)
  • 1 分あたり最大 30 回のレート制限
  • 日次予算は設定されたタイムゾーンの深夜にリセット (デフォルト: UTC)

推奨スワップフロー (OpenClaw)

スワップを実行する際は、以下の 4 段階のフローに従ってください:

┌─────────────────────┐     ┌─────────────────────┐     ┌─────────────┐     ┌─────────────────────┐
│ 1. 見積もり取得     │ ──▶ │ 2. ドライラン       │ ──▶ │ 3. 確認      │ ──▶ │ 4. パイプライン実行 │
│ elsa_get_swap_quote │     │ elsa_execute_swap_  │     │ [ユーザーが  │     │ elsa_pipeline_run_  │
│                     │     │ dry_run             │     │  "はい" と]  │     │ and_wait            │
└─────────────────────┘     └─────────────────────┘     └─────────────┘     └─────────────────────┘

Step 1: 見積もり取得 - ユーザーが受け取るものを表示

npx tsx scripts/index.ts elsa_get_swap_quote '{
  "from_chain": "base", "from_token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "from_amount": "10", "to_chain": "base", "to_token": "0x4200000000000000000000000000000000000006",
  "wallet_address": "0x...", "slippage": 0.5
}'

Step 2: ドライラン - パイプラインを作成し、pipeline_id を取得

npx tsx scripts/index.ts elsa_execute_swap_dry_run '{...同じパラメータ...}'
# 戻り値: { "pipeline_id": "abc-123", "confirmation_token": "..." }

Step 3: ユーザー確認 - 結果を提示し、明示的な "はい" を待つ

Step 4: パイプライン実行 - トランザクションに署名しブロードキャスト

ELSA_ENABLE_EXECUTION_TOOLS=true npx tsx scripts/index.ts elsa_pipeline_run_and_wait '{
  "pipeline_id": "abc-123",
  "timeout_seconds": 180,
  "poll_interval_seconds": 3,
  "mode": "local_signer"
}'
# 自動的に: approve tx に署名 → 送信 → swap tx に署名 → 送信 → tx ハッシュを返す

必要な環境変数

# x402 API 支払い用
PAYMENT_PRIVATE_KEY=0x...

# スワップトランザクション署名用 (オプション - PAYMENT_PRIVATE_KEY にフォールバック)
TRADE_PRIVATE_KEY=0x...

# 実行ツールの有効化
ELSA_ENABLE_EXECUTION_TOOLS=true

重要なルール

  • 絶対に ユーザーに見積もりを表示せずにスワップを実行しないでください
  • 絶対に 実行ツールをループ内で呼び出さないでください
  • 絶対に 予算制限を超えた場合に処理を進めないでください
  • 常に 残りの予算がわからない場合は elsa_budget_status を確認してください
  • 常に スワップ操作の前にドライランモードを使用してください

ツールカタログ

読み取り専用ツール (常に利用可能)

elsa_search_token

サポートされているブロックチェーン全体でトークンを検索します。

npx tsx scripts/index.ts elsa_search_token '{"query": "USDC", "limit": 5}'

入力:

  • query (文字列, 必須): トークン名、シンボル、またはアドレス
  • limit (数値, オプション): 最大結果数 (デフォルト: 10)

elsa_get_token_price

トークンの現在価格を取得します。

npx tsx scripts/index.ts elsa_get_token_price '{"token_address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "chain": "base"}'

入力:

  • token_address (文字列, 必須): トークンコントラクトアドレス
  • chain (文字列, オプション): チェーン名 (デフォルト: "base")

elsa_get_balances

ウォレットのトークン残高を取得します。

npx tsx scripts/index.ts elsa_get_balances '{"wallet_address": "0x..."}'

入力:

  • wallet_address (文字列, 必須): 照会するウォレットアドレス

elsa_get_portfolio

包括的なポートフォリオ分析を取得します。

npx tsx scripts/index.ts elsa_get_portfolio '{"wallet_address": "0x..."}'

入力:

  • wallet_address (文字列, 必須): 分析するウォレットアドレス

elsa_analyze_wallet

ウォレットの動作とリスク評価を取得します。

npx tsx scripts/index.ts elsa_analyze_wallet '{"wallet_address": "0x..."}'

入力:

  • wallet_address (文字列, 必須): 分析するウォレットアドレス

elsa_get_swap_quote

最適ルーティングでスワップ見積もりを取得します。

npx tsx scripts/index.ts elsa_get_swap_quote '{
  "from_chain": "base",
  "from_token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "from_amount": "100",
  "to_chain": "base",
  "to_token": "0x4200000000000000000000000000000000000006",
  "wallet_address": "0x...",
  "slippage": 0.5
}'

入力:

  • from_chain (文字列, 必須): 送金元チェーン
  • from_token (文字列, 必須): 送金元トークンアドレス
  • from_amount (文字列, 必須): スワップする金額
  • to_chain (文字列, 必須): 送金先チェーン
  • to_token (文字列, 必須): 送金先トークンアドレス
  • wallet_address (文字列, 必須): ウォレットアドレス
  • slippage (数値, 必須): スリッページ許容範囲 (0-50)

elsa_execute_swap_dry_run

実行せずにスワップをシミュレートします。後続の確認済み実行用の確認トークンを返します。

npx tsx scripts/index.ts elsa_execute_swap_dry_run '{
  "from_chain": "base",
  "from_token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "from_amount": "100",
  "to_chain": "base",
  "to_token": "0x4200000000000000000000000000000000000006",
  "wallet_address": "0x...",
  "slippage": 0.5
}'

出力に含まれるもの:

  • スワップシミュレーション結果
  • confirmation_token (ELSA_REQUIRE_CONFIRMATION_TOKEN=true の場合)
  • トークンは ELSA_CONFIRMATION_TTL_SECONDS 後に期限切れ

elsa_budget_status

現在の予算使用量と残りの制限を確認します。

npx tsx scripts/index.ts elsa_budget_status '{}'

出力:

  • spent_today_usd: 本日使った金額
  • remaining_today_usd: 残りの日次予算
  • calls_last_minute: 最近の呼び出し回数
  • last_calls: 最近の呼び出しの詳細

elsa_get_limit_orders

ウォレットのすべての指値注文を取得します。

npx tsx scripts/index.ts elsa_get_limit_orders '{"wallet_address": "0x...", "chain": "base"}'

入力:

  • wallet_address (文字列, 必須): 照会するウォレットアドレス
  • chain (文字列, オプション): チェーン名 (デフォルト: "base")

出力:

  • orders: ステータス、価格、有効期限を含む指値注文の配列

elsa_get_perp_positions

ウォレットの永久先物ポジションを取得します。

npx tsx scripts/index.ts elsa_get_perp_positions '{"wallet_address": "0x..."}'

入力:

  • wallet_address (文字列, 必須): 照会するウォレットアドレス

出力:

  • positions: PnL、レバレッジ、清算価格を含むオープンな永久先物ポジションの配列
  • total_unrealized_pnl: 未実現損益の合計
  • total_margin: 使用マージンの合計

elsa_get_transaction_history

ウォレットのトランザクション履歴を取得します。

npx tsx scripts/index.ts elsa_get_transaction_history '{"wallet_address": "0x...", "chain": "base", "limit": 20}'

入力:

  • wallet_address (文字列, 必須): 照会するウォレットアドレス
  • chain (文字列, オプション): チェーンでフィルター
  • limit (数値, オプション): 最大結果数 (デフォルト: 20, 最大: 100)

出力:

  • transactions: 詳細、トークン転送、ステータスを含むトランザクションの配列

実行ツール (ELSA_ENABLE_EXECUTION_TOOLS=true が必要)

elsa_execute_swap_confirmed

確認済みスワップを実行します。事前のドライランと確認トークンが必要です。

npx tsx scripts/index.ts elsa_execute_swap_confirmed '{
  "from_chain": "base",
  "from_token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "from_amount": "100",
  "to_chain": "base",
  "to_token": "0x4200000000000000000000000000000000000006",
  "wallet_address": "0x...",
  "slippage": 0.5,
  "confirmation_token": "abc123..."
}'

elsa_pipeline_get_status

パイプライン/トランザクションのステータスを確認します。

npx tsx scripts/index.ts elsa_pipeline_get_status '{"pipeline_id": "pip_123456789"}'

elsa_pipeline_submit_tx_hash

署名済みトランザクションハッシュをパイプラインに送信します。

npx tsx scripts/index.ts elsa_pipeline_submit_tx_hash '{"task_id": "task_123", "tx_hash": "0x..."}'

elsa_pipeline_run_and_wait

自動署名と送信による完全なパイプライン実行をオーケストレーションします。

npx tsx scripts/index.ts elsa_pipeline_run_and_wait '{
  "pipeline_id": "pip_123456789",
  "timeout_seconds": 120,
  "poll_interval_seconds": 2,
  "mode": "local_signer"
}'

モード:

  • local_signer: TRADE_PRIVATE_KEY を使用してトランザクションに署名しブロードキャスト
  • external_signer: 外部署名用に未署名の tx_data を返す

elsa_create_limit_order

価格が目標に達したときに実行される指値注文を作成します。

ELSA_ENABLE_EXECUTION_TOOLS=true npx tsx scripts/index.ts elsa_create_limit_order '{
  "wallet_address": "0x...",
  "chain": "base",
  "from_token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "to_token": "0x4200000000000000000000000000000000000006",
  "from_amount": "100",
  "limit_price": "0.0004",
  "expiry_hours": 24
}'

入力:

  • wallet_address (文字列, 必須): ウォレットアドレス
  • chain (文字列, 必須): チェーン名
  • from_token (文字列, 必須): 売却するトークン
  • to_token (文字列, 必須): 購入するトークン
  • from_amount (文字列, 必須): 売却する金額
  • limit_price (文字列, 必須): 実行をトリガーする目標価格
  • expiry_hours (数値, オプション): 注文が期限切れになるまでの時間 (デフォルト: 24, 最大: 720)

elsa_cancel_limit_order

既存の指値注文をキャンセルします。

ELSA_ENABLE_EXECUTION_TOOLS=true npx tsx scripts/index.ts elsa_cancel_limit_order '{
  "wallet_address": "0x...",
  "order_id": "order_123",
  "chain": "base"
}'

入力:

  • wallet_address (文字列, 必須): ウォレットアドレス
  • order_id (文字列, 必須): キャンセルする注文 ID
  • chain (文字列, オプション): チェーン名 (デフォルト: "base")

elsa_open_perp_position

永久先物ポジションを開きます。

ELSA_ENABLE_EXECUTION_TOOLS=true npx tsx scripts/index.ts elsa_open_perp_position '{
  "wallet_address": "0x...",
  "market": "ETH-USD",
  "side": "long",
  "size_usd": "100",
  "leverage": 5,
  "take_profit": "4000",
  "stop_loss": "2800"
}'

入力:

  • wallet_address (文字列, 必須): ウォレットアドレス
  • market (文字列, 必須): マーケットペア (例: "ETH-USD", "BTC-USD")
  • side (列挙型, 必須): "long" または "short"
  • size_usd (文字列, 必須): USD 建てのポジションサイズ
  • leverage (数値, オプション): レバレッジ倍率 (デフォルト: 1, 最大: 100)
  • take_profit (文字列, オプション): 利益確定価格
  • stop_loss (文字列, オプション): ストップロス価格

elsa_close_perp_position

オープンな永久先物ポジションをクローズします。

ELSA_ENABLE_EXECUTION_TOOLS=true npx tsx scripts/index.ts elsa_close_perp_position '{
  "wallet_address": "0x...",
  "position_id": "pos_123",
  "close_percentage": 100
}'

入力:

  • wallet_address (文字列, 必須): ウォレットアドレス
  • position_id (文字列, 必須): クローズするポジション ID
  • close_percentage (数値, オプション): クローズする割合 (デフォルト: 100, 範囲: 1-100)

サポートされているチェーン

  • base (デフォルト)
  • ethereum
  • arbitrum
  • optimism
  • polygon
  • bsc
  • avalanche
  • zksync

API コスト

ツール推定コスト
elsa_search_token$0.002
elsa_get_token_price$0.002
elsa_get_balances$0.002
elsa_get_portfolio$0.002
elsa_analyze_wallet$0.005
elsa_get_swap_quote$0.002
elsa_execute_swap_dry_run$0.005
elsa_get_limit_orders$0.002
elsa_get_perp_positions$0.002
elsa_get_transaction_history$0.002
elsa_create_limit_order$0.05
elsa_cancel_limit_order$0.01
elsa_open_perp_position$0.05
elsa_close_perp_position$0.05
elsa_execute_swap_confirmed$0.05

近日公開予定

  • Polymarket API - 予測市場の取引とデータ

関連スキル