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 為單位。