Communitygithub.com

DX Terminal Pro 交易代理管理技能

管理一個 DX Terminal Pro 交易代理,用於交易迷因幣。

DX Terminal Pro 交易代理管理技能 是什麼?

此技能可讓 AI 代理使用者管理 DX Terminal Pro 生態系中的交易代理。該代理專注於迷因幣交易,且僅能透過交易代理執行交易。使用者可以修改代理的設定與策略、檢視投資組合與損益(PNL)、查看代幣市場數據與圖表、監控代理執行的交換(swap)及交易原因,以及從代理的金庫(vault)進行存入與提領。技能支援多個端點,包括取得金庫設定、投資組合、代幣市場數據、交換記錄、策略、OHLCV 燭線圖、推論日誌、代幣持有者、排行榜與 PNL 歷史。此外,也可以直接在鏈上執行金庫設定更新、策略管理、存入與提領操作。所有操作均透過 `DX_TERMINAL_PRIVATE_KEY` 環境變數進行驗證,該私鑰需妥善保管。

相容平台~Claude Code~Codex CLI✓Cursor
npx skills add ProjectDXAI/dx-terminal-pro-skill

在你喜歡的 AI 中提問

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

說明文件

DX Terminal Pro

DX Terminal Pro 是一個交易迷因幣的 AI 代理生態系。只有交易代理才能執行交易。此技能讓您能夠:

  • 修改交易代理的設定與策略來影響其行為
  • 查看交易代理的投資組合與損益(PNL)
  • 查看代幣市場數據與圖表
  • 查看交易代理執行的交換及其交易原因
  • 從交易代理的金庫(vault)存入與提領

驗證

環境變數 DX_TERMINAL_PRIVATE_KEY 用來控制並識別一個交易代理。此金鑰必須妥善保護,不得外洩或共用。

取得金庫地址

VAULT_ADDRESS=$(curl -s "https://api.terminal.markets/api/v1/vault?ownerAddress=$(cast wallet address --private-key $DX_TERMINAL_PRIVATE_KEY)" | jq -r .vaultAddress)

API 讀取

取得金庫設定

curl -s "https://api.terminal.markets/api/v1/vault?vaultAddress=$VAULT_ADDRESS"

金庫設定包括:

  • maxTradeAmount:每次交換(swap)的最大 ETH 交易金額(以投資組合中 ETH 的百分比表示,單位為 bps)。
  • slippageBps:交易決策與執行之間允許的滑點(以百分比表示,單位為 bps)。
  • tradingActivity:代理的交易頻率(1 = 罕見/高信心,5 = 頻繁/機會主義)。
  • assetRiskPreference:考慮的資產風險等級(1 = 較安全/低波動,5 = 較風險/高回報)。
  • tradeSize:典型的倉位大小(1 = 較小/謹慎,5 = 較大/更積極)。
  • holdingStyle:預期持有時間(1 = 短期,5 = 長期/耐心)。
  • diversification:投資組合集中度(1 = 較少集中持倉,5 = 更廣泛分佈)。

取得投資組合

curl -s "https://api.terminal.markets/api/v1/positions/$VAULT_ADDRESS"

返回 ETH + 代幣餘額以及 PNL 數據。

注意:ethBalance、overallValueEth、overallPnlEth 和 positions[].balance 以 wei/十進位前單位表示,顯示時應除以 1e18。

取得存入與提領記錄

curl -s "https://api.terminal.markets/api/v1/deposits-withdrawals/$VAULT_ADDRESS?limit=50&order=desc"

注意:amount 以 wei 為單位。

注意:支援游標分頁(cursor=...)。

取得代幣

curl -s "https://api.terminal.markets/api/v1/tokens?includeMarketData=true"

返回所有代幣的市場數據。

取得交換記錄

curl -s "https://api.terminal.markets/api/v1/swaps?vaultAddress=$VAULT_ADDRESS&limit=50&order=desc"

注意:ethAmount 和 tokenAmount 以 wei/十進位前單位表示,顯示時應除以 1e18。

注意:此端點使用游標分頁。每個交換都包含一個 cursor 可用於繼續查詢。

取得策略

curl -s "https://api.terminal.markets/api/v1/strategies/$VAULT_ADDRESS?activeOnly=true"

注意:策略是指導交易代理行為的指令。最多 8 個,每個最長 1024 個字元,具有優先級和到期時間。

取得代幣 OHLCV 燭線

curl -s "https://api.terminal.markets/api/v1/candles/$TOKEN_ADDRESS?timeframe=1m&to=$(date +%s)&countback=300"

取得代幣圖表數據。

注意:timeframe 和 to 為必填。有效時間框架:1m、5m、15m、1h、4h、1d。

取得推論日誌

curl -s "https://api.terminal.markets/api/v1/logs/$VAULT_ADDRESS?limit=50&order=desc"

取得交易代理推論返回的推理過程。

注意:支援游標分頁(cursor=...)。

取得代幣持有者

curl -s "https://api.terminal.markets/api/v1/holders/$TOKEN_ADDRESS?limit=50&offset=0&order=desc"

注意:balance、totalBoughtTokens 和 totalSoldTokens 以 wei/十進位前單位表示,顯示時應除以 1e18。

注意:order=desc 會先返回最大持有者。

取得排行榜

curl -s "https://api.terminal.markets/api/v1/leaderboard?limit=50&sortBy=total_pnl_usd"

注意:可選 cursor=... 用於分頁

取得 PNL 歷史

curl -s "https://api.terminal.markets/api/v1/pnl-history/$VAULT_ADDRESS"

注意:返回時間序列的 PNL 數據點,用於繪製圖表。pnlEth 以 wei 為單位。

鏈上操作

更新金庫設定

cast send "$VAULT_ADDRESS" "updateSettings((uint256,uint256,uint8,uint8,uint8,uint8,uint8))" "(5000,200,3,3,3,3,3)" --private-key "$DX_TERMINAL_PRIVATE_KEY" --rpc-url "https://mainnet.base.org"

參數順序為:(maxTradeAmount, slippageBps, tradingActivity, assetRiskPreference, tradeSize, holdingStyle, diversification)。

驗證:maxTradeAmount 為 BPS,必須在 500-10000(5%-100%)之間,slippageBps 為 BPS,必須在 10-5000(0.1%-50%)之間,所有滑桿欄位為整數 1-5。

策略

新增策略

範例:

cast send "$VAULT_ADDRESS" "addStrategy(string,uint64,uint8)" "Rotate into strongest relative volume while keeping 20% idle ETH for opportunities." "$(( $(date +%s) + 86400 ))" "2" --private-key "$DX_TERMINAL_PRIVATE_KEY" --rpc-url "https://mainnet.base.org"

參數:strategy(字串)、expiry(Unix 秒)、prio(0=低、1=中、2=高)。

驗證:策略長度為 1-1024 位元組,expiry 必須為 0 或未來的時間戳,優先級必須在 0-2 之間,最多可以有 8 個活躍策略。

停用策略

cast send "$VAULT_ADDRESS" "disableStrategy(uint256)" "1" --private-key "$DX_TERMINAL_PRIVATE_KEY" --rpc-url "https://mainnet.base.org"

參數:strategyId(uint256)。

存入

cast send "$VAULT_ADDRESS" "depositETH()" --value 0.05ether --private-key "$DX_TERMINAL_PRIVATE_KEY" --rpc-url "https://mainnet.base.org"

提領

cast send "$VAULT_ADDRESS" "withdrawETH(uint256)" "50000000000000000" --private-key "$DX_TERMINAL_PRIVATE_KEY" --rpc-url "https://mainnet.base.org"

參數:amount_ 以 wei 為單位。

相關技能