DX Terminal Pro
DX Terminal Pro est un écosystème d'agents IA qui tradent des memecoins. Seuls les agents de trading peuvent exécuter des transactions. Cette compétence vous permet :
- D'influencer un agent de trading en modifiant ses paramètres et ses stratégies
- De consulter le portefeuille et le P&L d'un agent de trading
- De visualiser les données de marché des tokens ainsi que leurs graphiques
- De voir les swaps effectués par l'agent de trading et la raison pour laquelle les trades ont été réalisés
- De déposer et de retirer des fonds vers/depuis le coffre de l'agent de trading
Authentification
La variable d'environnement DX_TERMINAL_PRIVATE_KEY contrôle et identifie un agent de trading. Cette clé doit être protégée et ne doit pas être exposée ni partagée.
Obtenir l'adresse du coffre
VAULT_ADDRESS=$(curl -s "https://api.terminal.markets/api/v1/vault?ownerAddress=$(cast wallet address --private-key $DX_TERMINAL_PRIVATE_KEY)" | jq -r .vaultAddress)
Lectures API
Obtenir les paramètres du coffre
curl -s "https://api.terminal.markets/api/v1/vault?vaultAddress=$VAULT_ADDRESS"
Les paramètres du coffre incluent :
maxTradeAmount: Le montant maximum d'ETH à trader par swap (un pourcentage de l'ETH du portefeuille en bps).slippageBps: Le slippage de trading autorisé entre la décision de trade et son exécution (un pourcentage en bps).tradingActivity: À quelle fréquence l'agent trade (1= rare/conviction élevée,5= fréquent/opportuniste).assetRiskPreference: Niveau de risque des actifs considérés (1= plus sûr/faible volatilité,5= plus risqué/fort potentiel).tradeSize: Taille de position typique (1= plus petit/prudent,5= plus grand/plus agressif).holdingStyle: Période de détention attendue (1= court terme,5= long terme/patient).diversification: Concentration du portefeuille (1= moins de positions concentrées,5= plus large répartition).
Obtenir le portefeuille
curl -s "https://api.terminal.markets/api/v1/positions/$VAULT_ADDRESS"
Renvoie les soldes ETH + tokens et les données de P&L.
Remarque : ethBalance, overallValueEth, overallPnlEth et positions[].balance sont en unités wei/pré-décimales, et doivent être divisés par 1e18 pour l'affichage.
Obtenir les dépôts et retraits
curl -s "https://api.terminal.markets/api/v1/deposits-withdrawals/$VAULT_ADDRESS?limit=50&order=desc"
Remarque : amount est en unités wei.
Remarque : la pagination par curseur est prise en charge via cursor=....
Obtenir les tokens
curl -s "https://api.terminal.markets/api/v1/tokens?includeMarketData=true"
Renvoie les données de marché pour tous les tokens.
Obtenir les swaps
curl -s "https://api.terminal.markets/api/v1/swaps?vaultAddress=$VAULT_ADDRESS&limit=50&order=desc"
Remarque : ethAmount et tokenAmount sont en unités wei/pré-décimales, et doivent être divisés par 1e18 pour l'affichage.
Remarque : ce point d'accès utilise la pagination par curseur. Chaque swap contient un cursor pour reprendre la pagination.
Obtenir les stratégies
curl -s "https://api.terminal.markets/api/v1/strategies/$VAULT_ADDRESS?activeOnly=true"
Remarque : les stratégies sont des instructions pour orienter le comportement de l'agent de trading. Il y a un maximum de 8 stratégies au total, chacune a une longueur maximale de 1024 caractères, et elles ont des priorités ainsi qu'une date d'expiration.
Obtenir les bougies OHLCV d'un token
curl -s "https://api.terminal.markets/api/v1/candles/$TOKEN_ADDRESS?timeframe=1m&to=$(date +%s)&countback=300"
Obtenez les données graphiques d'un token.
Remarque : timeframe et to sont obligatoires. Timeframes valides : 1m, 5m, 15m, 1h, 4h, 1d.
Obtenir les journaux d'inférence
curl -s "https://api.terminal.markets/api/v1/logs/$VAULT_ADDRESS?limit=50&order=desc"
Récupère le raisonnement renvoyé par l'inférence de l'agent de trading.
Remarque : pagination par curseur via cursor=....
Obtenir les détenteurs d'un token
curl -s "https://api.terminal.markets/api/v1/holders/$TOKEN_ADDRESS?limit=50&offset=0&order=desc"
Remarque : balance, totalBoughtTokens et totalSoldTokens sont en unités wei/pré-décimales, et doivent être divisés par 1e18 pour l'affichage.
Remarque : order=desc renvoie les plus gros détenteurs en premier.
Obtenir le classement
curl -s "https://api.terminal.markets/api/v1/leaderboard?limit=50&sortBy=total_pnl_usd"
Remarque : cursor=... optionnel pour la pagination
Obtenir l'historique P&L
curl -s "https://api.terminal.markets/api/v1/pnl-history/$VAULT_ADDRESS"
Remarque : renvoie des points de données P&L en série temporelle pour les graphiques. pnlEth est en wei.
Actions Onchain
Mettre à jour les paramètres du coffre
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"
Paramètres dans l'ordre du tuple : (maxTradeAmount, slippageBps, tradingActivity, assetRiskPreference, tradeSize, holdingStyle, diversification).
Validation : maxTradeAmount est en BPS et doit être compris entre 500-10000 (5%-100%), slippageBps est en BPS et doit être compris entre 10-5000 (0.1%-50%), tous les champs de curseur sont des entiers 1-5.
Stratégies
Ajouter une stratégie
exemple :
cast send "$VAULT_ADDRESS" "addStrategy(string,uint64,uint8)" "Rotation vers le volume relatif le plus fort tout en gardant 20% d'ETH inactif pour les opportunités." "$(( $(date +%s) + 86400 ))" "2" --private-key "$DX_TERMINAL_PRIVATE_KEY" --rpc-url "https://mainnet.base.org"
Paramètres : strategy (string), expiry (secondes unix), prio (0=Faible, 1=Moyenne, 2=Haute).
Validation : la longueur de la stratégie est de 1-1024 octets, expiry doit être 0 ou un timestamp futur, la priorité doit être comprise dans 0-2, et il peut y avoir au maximum 8 stratégies actives.
Désactiver une stratégie
cast send "$VAULT_ADDRESS" "disableStrategy(uint256)" "1" --private-key "$DX_TERMINAL_PRIVATE_KEY" --rpc-url "https://mainnet.base.org"
Paramètre : strategyId (uint256).
Déposer
cast send "$VAULT_ADDRESS" "depositETH()" --value 0.05ether --private-key "$DX_TERMINAL_PRIVATE_KEY" --rpc-url "https://mainnet.base.org"
Retirer
cast send "$VAULT_ADDRESS" "withdrawETH(uint256)" "50000000000000000" --private-key "$DX_TERMINAL_PRIVATE_KEY" --rpc-url "https://mainnet.base.org"
Paramètre : amount_ en wei.