Elsa x402 DeFi 工具組
此技能提供透過 Elsa DeFi API 進行組合管理、代幣分析與交換執行的功能,並使用 x402 微支付。
標準作業流程
預算控制
- 每次 API 呼叫上限 $0.05(可設定)
- 每日上限 $2.00(可設定)
- 每分鐘最多 30 次請求的速率限制
- 每日預算於設定時區的午夜重置(預設:UTC)
建議交換流程 (OpenClaw)
執行交換時,請遵循以下 4 步驟流程:
┌─────────────────────┐ ┌─────────────────────┐ ┌─────────────┐ ┌─────────────────────┐
│ 1. 取得報價 │ ──▶ │ 2. 乾執行 │ ──▶ │ 3. 確認 │ ──▶ │ 4. 執行管線 │
│ elsa_get_swap_quote │ │ elsa_execute_swap_ │ │ [使用者說 │ │ elsa_pipeline_run_ │
│ │ │ dry_run │ │ "是"] │ │ and_wait │
└─────────────────────┘ └─────────────────────┘ └─────────────┘ └─────────────────────┘
步驟 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
}'
步驟 2: 乾執行 - 建立管線,取得 pipeline_id
npx tsx scripts/index.ts elsa_execute_swap_dry_run '{...same params...}'
# 回傳: { "pipeline_id": "abc-123", "confirmation_token": "..." }
步驟 3: 使用者確認 - 顯示結果並等待明確的「是」
步驟 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"
}'
# 自動: 簽署核准交易 → 提交 → 簽署交換交易 → 提交 → 回傳交易雜湊
必要環境變數
# 用於 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:未平倉永續合約持倉陣列,包含盈虧、槓桿與清算價格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 APIs - 預測市場交易與數據