¿Qué hace DX Terminal Pro?
DX Terminal Pro es un ecosistema de agentes de IA que comercian con memecoins. Solo los agentes de trading pueden ejecutar operaciones. Esta habilidad te permite:
- Influir en un agente de trading modificando sus configuraciones y estrategias
- Ver la cartera y el PnL de un agente de trading
- Ver datos de mercado de tokens + gráficos
- Ver los swaps que el agente de trading está realizando y la razón por la que se tomaron las operaciones
- Depositar y retirar fondos de la bóveda del agente de trading
Autenticación
La variable de entorno DX_TERMINAL_PRIVATE_KEY controla e identifica a un agente de trading. Esta clave debe protegerse y no exponerse ni compartirse.
Obtener Dirección de la Bóveda
VAULT_ADDRESS=$(curl -s "https://api.terminal.markets/api/v1/vault?ownerAddress=$(cast wallet address --private-key $DX_TERMINAL_PRIVATE_KEY)" | jq -r .vaultAddress)
Lecturas de API
Obtener Configuración de la Bóveda
curl -s "https://api.terminal.markets/api/v1/vault?vaultAddress=$VAULT_ADDRESS"
La configuración de la bóveda incluye:
maxTradeAmount: El monto máximo de ETH a comerciar por swap (un porcentaje del ETH del portafolio en bps).slippageBps: El deslizamiento de trading permitido entre la decisión de trading y la ejecución (un porcentaje en bps).tradingActivity: la frecuencia con la que el agente comercia (1= raro / alta convicción,5= frecuente / oportunista).assetRiskPreference: nivel de riesgo de los activos considerados (1= más seguro / menor volatilidad,5= más riesgoso / mayor potencial alcista).tradeSize: tamaño típico de las posiciones (1= más pequeño / cauteloso,5= más grande / más agresivo).holdingStyle: tiempo de tenencia esperado (1= corto plazo,5= largo plazo / paciente).diversification: concentración del portafolio (1= menos posiciones concentradas,5= distribución más amplia).
Obtener Cartera
curl -s "https://api.terminal.markets/api/v1/positions/$VAULT_ADDRESS"
Devuelve saldos de ETH + tokens y datos de PnL.
Nota: ethBalance, overallValueEth y overallPnlEth y positions[].balance están en unidades wei/pre-decimal, y deben dividirse por 1e18 para su presentación.
Obtener Depósitos y Retiros
curl -s "https://api.terminal.markets/api/v1/deposits-withdrawals/$VAULT_ADDRESS?limit=50&order=desc"
Nota: amount está en unidades wei.
Nota: admite paginación por cursor mediante cursor=....
Obtener Tokens
curl -s "https://api.terminal.markets/api/v1/tokens?includeMarketData=true"
Devuelve datos de mercado de todos los tokens.
Obtener Swaps
curl -s "https://api.terminal.markets/api/v1/swaps?vaultAddress=$VAULT_ADDRESS&limit=50&order=desc"
Nota: ethAmount y tokenAmount están en unidades wei/pre-decimal, y deben dividirse por 1e18 para su presentación.
Nota: Este endpoint utiliza paginación por cursor. Cada swap contiene un cursor para reanudar.
Obtener Estrategias
curl -s "https://api.terminal.markets/api/v1/strategies/$VAULT_ADDRESS?activeOnly=true"
Nota: Las estrategias son instrucciones para dirigir el comportamiento del agente de trading. Hay un máximo de 8 en total, cada una tiene una longitud máxima de 1024 caracteres, y tienen prioridades + un tiempo de expiración.
Obtener Velas OHLCV de Token
curl -s "https://api.terminal.markets/api/v1/candles/$TOKEN_ADDRESS?timeframe=1m&to=$(date +%s)&countback=300"
Obtener datos de gráficos de tokens.
Nota: timeframe y to son obligatorios. Timeframes válidos: 1m, 5m, 15m, 1h, 4h, 1d.
Obtener Registros de Inferencia
curl -s "https://api.terminal.markets/api/v1/logs/$VAULT_ADDRESS?limit=50&order=desc"
Obtiene el razonamiento devuelto por la inferencia del agente de trading.
Nota: paginación por cursor mediante cursor=....
Obtener Poseedores de Token
curl -s "https://api.terminal.markets/api/v1/holders/$TOKEN_ADDRESS?limit=50&offset=0&order=desc"
Nota: balance, totalBoughtTokens y totalSoldTokens están en unidades wei/pre-decimal, y deben dividirse por 1e18 para su presentación.
Nota: order=desc devuelve primero los mayores poseedores.
Obtener Tabla de Clasificación
curl -s "https://api.terminal.markets/api/v1/leaderboard?limit=50&sortBy=total_pnl_usd"
Nota: cursor=... opcional para paginación
Obtener Historial de PnL
curl -s "https://api.terminal.markets/api/v1/pnl-history/$VAULT_ADDRESS"
Nota: devuelve puntos de datos de PnL en serie temporal para gráficos. pnlEth está en wei.
Acciones Onchain
Actualizar configuración de la bóveda
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 en orden de tupla: (maxTradeAmount, slippageBps, tradingActivity, assetRiskPreference, tradeSize, holdingStyle, diversification).
Validación: maxTradeAmount está en BPS y debe ser 500-10000 (5%-100%), slippageBps está en BPS y debe ser 10-5000 (0.1%-50%), todos los campos deslizantes son enteros 1-5.
Estrategias
Agregar Estrategia
ejemplo:
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 (cadena), expiry (segundos Unix), prio (0=Baja, 1=Media, 2=Alta).
Validación: la longitud de la estrategia es 1-1024 bytes, expiry debe ser 0 o una marca de tiempo futura, la prioridad debe estar en 0-2, y puede haber como máximo 8 estrategias activas.
Deshabilitar Estrategia
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"
Retirar
cast send "$VAULT_ADDRESS" "withdrawETH(uint256)" "50000000000000000" --private-key "$DX_TERMINAL_PRIVATE_KEY" --rpc-url "https://mainnet.base.org"
Parámetro: amount_ en wei.