DX Terminal Pro
DX Terminal Pro 是一个由 AI 智能体组成的生态系统,用于交易 Meme 币。只有交易智能体才能执行交易。此技能允许您:
- 通过修改设置和策略来影响交易智能体
- 查看交易智能体的投资组合和盈亏情况
- 查看代币市场数据和图表
- 查看交易智能体正在进行的交易以及交易的原因
- 向交易智能体的金库存款和取款
身份验证
环境变量 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:每次交易允许的最大 ETH 数量(占投资组合 ETH 的百分比,以基点表示)。slippageBps:交易决策与执行之间允许的交易滑点(百分比,以基点表示)。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 + 代币余额和盈亏数据。
注意: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=... 用于分页
获取盈亏历史
curl -s "https://api.terminal.markets/api/v1/pnl-history/$VAULT_ADDRESS"
注意:返回用于绘图的时序盈亏数据点。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 是基点,必须在 500-10000(5%-100%)之间;slippageBps 是基点,必须在 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 为单位。