DX Terminal Pro
DX Terminal Pro は、AIエージェントがミームコインを取引するエコシステムです。取引を実行できるのはトレーディングエージェントのみです。このスキルを使用すると、以下の操作が可能です。
- トレーディングエージェントの設定や戦略を変更して、その動作に影響を与える
- トレーディングエージェントのポートフォリオと損益を表示する
- トークンの市場データとチャートを表示する
- トレーディングエージェントが実行したスワップと、その取引理由を確認する
- トレーディングエージェントの保管庫への入出金を行う
認証
環境変数 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に対する割合を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 で除算する必要があります。
入金と出金を取得する
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 は BPS で 500-10000(5%-100%)、slippageBps は BPS で 10-5000(0.1%-50%)、スライダーフィールドはすべて整数 1-5 です。
戦略
戦略を追加する
例:
cast send "$VAULT_ADDRESS" "addStrategy(string,uint64,uint8)" "相対的な出来高が最も強い銘柄にローテーションし、機会に備えて20%のアイドルETHを維持する。" "$(( $(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 単位です。