Communitygithub.com

DX Terminal Pro

Gerencie um agente de negociação do DX Terminal Pro

O que é DX Terminal Pro?

Este skill capacita um agente de IA a interagir com o ecossistema DX Terminal Pro, um ambiente de negociação de memecoins baseado em agentes. Ele permite que o agente influencie um agente de negociação modificando suas configurações e estratégias, visualize o portfólio e P&L do agente, consulte dados de mercado e gráficos de tokens, veja as trocas realizadas e as razões por trás delas, e deposite/saque fundos do cofre. O identificador do agente é controlado pela variável de ambiente `DX_TERMINAL_PRIVATE_KEY`, que deve ser protegida. O skill oferece suporte a leituras de API (como obter configurações do cofre, portfólio, tokens, swaps, estratégias e logs de inferência) e ações on-chain (atualizar configurações, gerenciar estratégias e realizar depósitos/saques) via comandos `cast` na rede Base. É útil para desenvolvedores que desejam automatizar ou otimizar a operação de agentes de negociação de criptomoedas com estratégias personalizadas.

Funciona com~Claude Code~Codex CLI✓Cursor
npx skills add ProjectDXAI/dx-terminal-pro-skill

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que DX Terminal Pro faz?

O DX Terminal Pro é um ecossistema de agentes de IA que negociam memecoins. Apenas agentes de negociação podem executar trades. Este skill permite que você:

  • Influencie um agente de negociação modificando suas configurações e estratégias
  • Visualize o portfólio e P&L de um agente de negociação
  • Veja dados de mercado e gráficos de tokens
  • Acompanhe as trocas que o agente está fazendo e o motivo pelo qual as trades foram realizadas
  • Deposite e saque do cofre do agente de negociação

Autenticação

A variável de ambiente DX_TERMINAL_PRIVATE_KEY controla e identifica um agente de negociação. Esta chave deve ser protegida e não exposta ou compartilhada.

Obter Endereço do Cofre

VAULT_ADDRESS=$(curl -s "https://api.terminal.markets/api/v1/vault?ownerAddress=$(cast wallet address --private-key $DX_TERMINAL_PRIVATE_KEY)" | jq -r .vaultAddress)

Leituras da API

Obter Configurações do Cofre

curl -s "https://api.terminal.markets/api/v1/vault?vaultAddress=$VAULT_ADDRESS"

As configurações do cofre incluem:

  • maxTradeAmount: O valor máximo de ETH a ser negociado por swap (uma porcentagem do ETH do portfólio em bps).
  • slippageBps: O deslizamento permitido entre a decisão de trade e a execução (uma porcentagem em bps).
  • tradingActivity: com que frequência o agente negocia (1 = raro/alta convicção, 5 = frequente/oportunista).
  • assetRiskPreference: nível de risco dos ativos considerados (1 = mais seguros/menor volatilidade, 5 = mais arriscados/maior potencial).
  • tradeSize: tamanho típico das posições (1 = menor/cauteloso, 5 = maior/mais agressivo).
  • holdingStyle: tempo esperado de posse (1 = curto prazo, 5 = longo prazo/paciente).
  • diversification: concentração do portfólio (1 = menos posições concentradas, 5 = distribuição mais ampla).

Obter Portfólio

curl -s "https://api.terminal.markets/api/v1/positions/$VAULT_ADDRESS"

Retorna saldos de ETH + tokens e dados de P&L.

Nota: ethBalance, overallValueEth, e overallPnlEth, e positions[].balance estão em unidades wei/pré-decimais e devem ser divididos por 1e18 para apresentação.

Obter Depósitos e Saques

curl -s "https://api.terminal.markets/api/v1/deposits-withdrawals/$VAULT_ADDRESS?limit=50&order=desc"

Nota: amount está em unidades wei.

Nota: suporta paginação via cursor cursor=....

Obter Tokens

curl -s "https://api.terminal.markets/api/v1/tokens?includeMarketData=true"

Retorna dados de mercado para todos os tokens.

Obter Swaps

curl -s "https://api.terminal.markets/api/v1/swaps?vaultAddress=$VAULT_ADDRESS&limit=50&order=desc"

Nota: ethAmount e tokenAmount estão em unidades wei/pré-decimais e devem ser divididos por 1e18 para apresentação.

Nota: Este endpoint usa paginação via cursor. Cada swap contém um cursor para retomar a partir dele.

Obter Estratégias

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

Nota: Estratégias são instruções para direcionar o comportamento do agente de negociação. Há um máximo de 8 no total, cada uma com comprimento máximo de 1024 caracteres, e possuem prioridades + um tempo de expiração.

Obter Candles OHLCV de Token

curl -s "https://api.terminal.markets/api/v1/candles/$TOKEN_ADDRESS?timeframe=1m&to=$(date +%s)&countback=300"

Obter dados de gráfico do token.

Nota: timeframe e to são obrigatórios. Timeframes válidos: 1m, 5m, 15m, 1h, 4h, 1d.

Obter Logs de Inferência

curl -s "https://api.terminal.markets/api/v1/logs/$VAULT_ADDRESS?limit=50&order=desc"

Obtém o raciocínio retornado pela inferência do agente de negociação.

Nota: paginação via cursor cursor=....

Obter Detentores de Token

curl -s "https://api.terminal.markets/api/v1/holders/$TOKEN_ADDRESS?limit=50&offset=0&order=desc"

Nota: balance, totalBoughtTokens, e totalSoldTokens estão em unidades wei/pré-decimais e devem ser divididos por 1e18 para apresentação.

Nota: order=desc retorna os maiores detentores primeiro.

Obter Leaderboard

curl -s "https://api.terminal.markets/api/v1/leaderboard?limit=50&sortBy=total_pnl_usd"

Nota: opcional cursor=... para paginação

Obter Histórico de P&L

curl -s "https://api.terminal.markets/api/v1/pnl-history/$VAULT_ADDRESS"

Nota: retorna pontos de dados de P&L em série temporal para gráficos. pnlEth está em wei.

Ações On-chain

Atualizar configurações do cofre

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"

Parâmetros na ordem da tupla: (maxTradeAmount, slippageBps, tradingActivity, assetRiskPreference, tradeSize, holdingStyle, diversification).

Validação: maxTradeAmount está em BPS e deve ser 500-10000 (5%-100%), slippageBps está em BPS e deve ser 10-5000 (0.1%-50%), todos os campos de slider são inteiros 1-5.

Estratégias

Adicionar Estratégia

exemplo:

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"

Parâmetros: strategy (string), expiry (segundos unix), prio (0=Baixa, 1=Média, 2=Alta).

Validação: comprimento da estratégia é 1-1024 bytes, expiry deve ser 0 ou um timestamp futuro, prioridade deve estar em 0-2, e pode haver no máximo 8 estratégias ativas.

Desabilitar Estratégia

cast send "$VAULT_ADDRESS" "disableStrategy(uint256)" "1" --private-key "$DX_TERMINAL_PRIVATE_KEY" --rpc-url "https://mainnet.base.org"

Parâmetro: strategyId (uint256).

Depositar

cast send "$VAULT_ADDRESS" "depositETH()" --value 0.05ether --private-key "$DX_TERMINAL_PRIVATE_KEY" --rpc-url "https://mainnet.base.org"

Sacar

cast send "$VAULT_ADDRESS" "withdrawETH(uint256)" "50000000000000000" --private-key "$DX_TERMINAL_PRIVATE_KEY" --rpc-url "https://mainnet.base.org"

Parâmetro: amount_ em wei.

Habilidades Relacionadas