Communitygithub.com

DX Terminal Pro

DX Terminal Pro 트레이딩 에이전트를 관리하고 설정, 전략, 포트폴리오 및 거래를 제어합니다.

DX Terminal Pro란 무엇인가요?

이 스킬은 DX Terminal Pro 생태계의 AI 트레이딩 에이전트를 완전히 제어할 수 있게 합니다. 밈코인(memecoin) 거래에 특화된 이 도구를 통해 사용자는 에이전트의 트레이딩 설정(최대 거래 금액, 슬리피지, 거래 빈도, 자산 위험 선호도 등)을 수정하고, 포트폴리오와 손익(PnL)을 조회하며, 실시간 시장 데이터와 차트를 확인하고, 에이전트가 수행한 스왑(swap) 내역과 그 이유를 추적할 수 있습니다. 또한 에이전트의 볼트(vault)에 ETH를 입금 및 출금하는 온체인(on-chain) 작업도 지원합니다. DX Terminal Pro는 Base 메인넷에서 작동하며, 모든 제어는 `DX_TERMINAL_PRIVATE_KEY` 환경 변수로 식별되는 개인 키를 통해 이루어집니다. 이 스킬은 REST API를 통한 읽기 전용 데이터 조회와 `cast` 명령어를 통한 온체인 트랜잭션 실행을 결합하여, 개발자와 고급 사용자가 AI 트레이딩 에이전트를 프로그래밍 방식으로 완전히 관리할 수 있는 강력한 인터페이스를 제공합니다.

지원 대상~Claude Code~Codex CLI✓Cursor
npx skills add ProjectDXAI/dx-terminal-pro-skill

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

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 단위입니다.

관련 스킬