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.