DX Terminal Pro
DX Terminal Pro ist ein Ökosystem von KI-Agenten, die mit Memecoins handeln. Nur Handelsagenten können Trades ausführen. Mit dieser Fähigkeit können Sie:
- Einen Handelsagenten durch Ändern seiner Einstellungen und Strategien beeinflussen
- Das Portfolio und den PNL eines Handelsagenten einsehen
- Marktdaten und Charts von Token anzeigen
- Die Swaps sehen, die der Handelsagent tätigt, sowie die Gründe für die Trades
- Ein- und Auszahlungen im Vault des Handelsagenten vornehmen
Authentifizierung
Die Umgebungsvariable DX_TERMINAL_PRIVATE_KEY steuert und identifiziert einen Handelsagenten. Dieser Schlüssel sollte geschützt und weder offengelegt noch geteilt werden.
Vault-Adresse abrufen
VAULT_ADDRESS=$(curl -s "https://api.terminal.markets/api/v1/vault?ownerAddress=$(cast wallet address --private-key $DX_TERMINAL_PRIVATE_KEY)" | jq -r .vaultAddress)
API-Lesezugriffe
Vault-Einstellungen abrufen
curl -s "https://api.terminal.markets/api/v1/vault?vaultAddress=$VAULT_ADDRESS"
Die Vault-Einstellungen umfassen:
maxTradeAmount: Der maximale ETH-Betrag, der pro Swap gehandelt werden darf (ein Prozentsatz des ETH-Portfolios in BPS).slippageBps: Die zulässige Slippage zwischen Handelsentscheidung und Ausführung (ein Prozentsatz in BPS).tradingActivity: Wie häufig der Agent handelt (1= selten/hohe Überzeugung,5= häufig/opportunistisch).assetRiskPreference: Risikostufe der berücksichtigten Vermögenswerte (1= sicherer/niedrigere Volatilität,5= risikoreicher/höheres Potenzial).tradeSize: Typische Positionsgröße (1= kleiner/vorsichtig,5= größer/aggressiver).holdingStyle: Erwartete Haltedauer (1= kurzfristiger,5= langfristiger/geduldiger).diversification: Portfolio-Konzentration (1= weniger konzentrierte Positionen,5= breitere Streuung).
Portfolio abrufen
curl -s "https://api.terminal.markets/api/v1/positions/$VAULT_ADDRESS"
Gibt ETH- und Token-Salden sowie PNL-Daten zurück.
Hinweis: ethBalance, overallValueEth und overallPnlEth sowie positions[].balance sind in Wei/Vorkommastellen und sollten für die Darstellung durch 1e18 geteilt werden.
Ein- und Auszahlungen abrufen
curl -s "https://api.terminal.markets/api/v1/deposits-withdrawals/$VAULT_ADDRESS?limit=50&order=desc"
Hinweis: amount ist in Wei-Einheiten.
Hinweis: Unterstützt Cursor-Paginierung über cursor=....
Token abrufen
curl -s "https://api.terminal.markets/api/v1/tokens?includeMarketData=true"
Gibt Marktdaten für alle Token zurück.
Swaps abrufen
curl -s "https://api.terminal.markets/api/v1/swaps?vaultAddress=$VAULT_ADDRESS&limit=50&order=desc"
Hinweis: ethAmount und tokenAmount sind in Wei/Vorkommastellen und sollten für die Darstellung durch 1e18 geteilt werden.
Hinweis: Dieser Endpunkt verwendet Cursor-Paginierung. Jeder Swap enthält einen cursor, um fortzufahren.
Strategien abrufen
curl -s "https://api.terminal.markets/api/v1/strategies/$VAULT_ADDRESS?activeOnly=true"
Hinweis: Strategien sind Anweisungen zur Steuerung des Verhaltens des Handelsagenten. Es gibt maximal 8 Strategien, jede hat eine maximale Länge von 1024 Zeichen, eine Priorität und eine Ablaufzeit.
OHLCV-Kerzen eines Tokens abrufen
curl -s "https://api.terminal.markets/api/v1/candles/$TOKEN_ADDRESS?timeframe=1m&to=$(date +%s)&countback=300"
Token-Chartdaten abrufen.
Hinweis: timeframe und to sind erforderlich. Gültige Zeitrahmen: 1m, 5m, 15m, 1h, 4h, 1d.
Inferenzprotokolle abrufen
curl -s "https://api.terminal.markets/api/v1/logs/$VAULT_ADDRESS?limit=50&order=desc"
Ruft die Begründung ab, die von der Inferenz des Handelsagenten zurückgegeben wurde.
Hinweis: Cursor-Paginierung über cursor=....
Token-Inhaber abrufen
curl -s "https://api.terminal.markets/api/v1/holders/$TOKEN_ADDRESS?limit=50&offset=0&order=desc"
Hinweis: balance, totalBoughtTokens und totalSoldTokens sind in Wei/Vorkommastellen und sollten für die Darstellung durch 1e18 geteilt werden.
Hinweis: order=desc gibt die größten Inhaber zuerst zurück.
Bestenliste abrufen
curl -s "https://api.terminal.markets/api/v1/leaderboard?limit=50&sortBy=total_pnl_usd"
Hinweis: Optional cursor=... für Paginierung
PnL-Verlauf abrufen
curl -s "https://api.terminal.markets/api/v1/pnl-history/$VAULT_ADDRESS"
Hinweis: Gibt Zeitreihen-PnL-Datenpunkte für Diagramme zurück. pnlEth ist in Wei.
On-Chain-Aktionen
Vault-Einstellungen aktualisieren
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"
Parameter in Tupel-Reihenfolge: (maxTradeAmount, slippageBps, tradingActivity, assetRiskPreference, tradeSize, holdingStyle, diversification).
Validierung: maxTradeAmount ist in BPS und muss zwischen 500-10000 (5%-100%) liegen, slippageBps ist in BPS und muss zwischen 10-5000 (0.1%-50%) liegen, alle Schiebereglerfelder sind ganze Zahlen 1-5.
Strategien
Strategie hinzufügen
Beispiel:
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"
Parameter: strategy (String), expiry (Unix-Sekunden), prio (0=Niedrig, 1=Mittel, 2=Hoch).
Validierung: Die Strategielänge beträgt 1-1024 Bytes, expiry muss 0 oder ein zukünftiger Zeitstempel sein, die Priorität muss in 0-2 liegen, und es können maximal 8 aktive Strategien vorhanden sein.
Strategie deaktivieren
cast send "$VAULT_ADDRESS" "disableStrategy(uint256)" "1" --private-key "$DX_TERMINAL_PRIVATE_KEY" --rpc-url "https://mainnet.base.org"
Parameter: strategyId (uint256).
Einzahlung
cast send "$VAULT_ADDRESS" "depositETH()" --value 0.05ether --private-key "$DX_TERMINAL_PRIVATE_KEY" --rpc-url "https://mainnet.base.org"
Auszahlung
cast send "$VAULT_ADDRESS" "withdrawETH(uint256)" "50000000000000000" --private-key "$DX_TERMINAL_PRIVATE_KEY" --rpc-url "https://mainnet.base.org"
Parameter: amount_ in Wei.