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(文字列, 必須): キャンセルする注文 IDchain(文字列, オプション): チェーン名 (デフォルト: "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(文字列, 必須): クローズするポジション IDclose_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 - 予測市場の取引とデータ