Communitygithub.com

HeyElsa/elsa-openclaw

透過 Elsa API 與 x402 微支付,提供組合分析、代幣搜尋與交換執行的 DeFi 工具組

elsa-openclaw 是什麼?

此技能整合了 Elsa DeFi API,為 AI 代理(如 Claude Code、Cursor、Codex)提供全面的組合管理、代幣分析與交換執行功能,並使用創新的 x402 微支付模型。它支援唯讀查詢(代幣搜尋、價格查詢、餘額、組合分析、錢包風險評估)以及執行操作(交換報價、模擬交換、確認交換、限價單與永續合約交易)。代理必須遵循嚴格的 SOP:每次交換前先取得報價並進行模擬(乾執行),獲得使用者明確同意後再執行交易。技能包含預算控管(每次 API 呼叫上限 $0.05、每日上限 $2.00)、速率限制(每分鐘 30 次),並透過環境變數 `PAYMENT_PRIVATE_KEY` 與 `TRADE_PRIVATE_KEY` 管理支付與交易簽名。支援 Base、以太坊、Arbitrum、Optimism、Polygon、BSC、Avalanche、zkSync 等主流區塊鏈,讓 AI 代理能夠安全、自動化地執行 DeFi 操作。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add HeyElsa/elsa-openclaw

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

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(字串,必要):要取消的訂單 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 APIs - 預測市場交易與數據

相關技能