DX Terminal Pro

DX Terminal Pro 是一个由 AI 代理交易模因币（memecoins）组成的生态系统。只有交易代理可以执行交易。此技能允许您：

• 通过修改其设置和策略来影响交易代理
• 查看交易代理的持仓组合与盈亏情况
• 查看代币市场数据及图表
• 查看交易代理正在进行的兑换操作及其交易原因
• 向交易代理的钱包存入和提取资金

认证

环境变量 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 总额的百分比，以 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 和代币余额，以及盈亏数据。

注意：ethBalance、overallValueEth、overallPnlEth 以及 positions[].balance 的单位为 wei（未除以 1e18 的原始值），展示时需除以 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 的原始值），展示时需除以 1e18。

注意：此接口使用游标分页。每个兑换记录包含一个 cursor，可用于继续获取后续数据。

获取策略列表

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

注意：策略是指导交易代理行为的指令。最多支持 8 条策略，每条最大长度 1024 字符，具有优先级和过期时间。

获取代币 OHLCV K线数据

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 的原始值），展示时需除以 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 为 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