DX Terminal Pro은(는) 무엇을 하나요?
DX Terminal Pro는 밈코인을 거래하는 AI 에이전트들의 생태계입니다. 트레이딩 에이전트만이 거래를 실행할 수 있습니다. 이 스킬을 사용하면 다음을 수행할 수 있습니다.
- 설정 및 전략 수정을 통해 트레이딩 에이전트에 영향 주기
- 트레이딩 에이전트의 포트폴리오 및 손익(PnL) 조회
- 토큰 시장 데이터 + 차트 보기
- 트레이딩 에이전트가 수행하는 스왑과 거래 체결 이유 확인
- 트레이딩 에이전트 볼트에 입금 및 출금
인증
환경 변수 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 + 토큰 잔액 및 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)" "가장 강한 상대 거래량으로 전환하고 기회를 위해 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 단위입니다.