Communitygithub.com

DX Terminal Pro

Gestiona un agente de trading de DX Terminal Pro

¿Qué es DX Terminal Pro?

DX Terminal Pro es un ecosistema de agentes de IA especializados en el trading de memecoins. Esta habilidad te permite gestionar y controlar completamente a un agente de trading: puedes modificar su configuración, estrategias de trading, ver su cartera y PnL, consultar datos de mercado de tokens, ver los swaps que realiza junto con la razón de cada operación, y depositar o retirar fondos de su bóveda. La habilidad se basa en una combinación de lecturas de API REST (para obtener configuraciones, cartera, swaps, velas OHLCV, registros de inferencia, poseedores de tokens y leaderboard) y acciones on-chain mediante `cast send` (para actualizar configuraciones de la bóveda, gestionar estrategias y ejecutar depósitos/retiros). Está diseñada para entornos como Claude Code, Cursor o Codex, y utiliza la variable de entorno `DX_TERMINAL_PRIVATE_KEY` para autenticar e identificar al agente. Las cantidades en wei deben dividirse por 1e18 para su presentación, y los endpoints de paginación admiten cursor.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿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.

Skills relacionados