DX Terminal Pro

intent

dx terminal pro lets you control a memecoin trading agent on base mainnet. use this skill to adjust the agent's trading parameters and risk settings, monitor its portfolio performance and swap history, query token market data and on-chain holder distribution, and manage deposits/withdrawals from the agent's vault. best for traders who want to run autonomous trading strategies with manual oversight and strategy refinement.

inputs

authentication:

• DX_TERMINAL_PRIVATE_KEY (env var): private key that owns and controls the trading agent vault. keep this secret. treat it like an exchange API key. if exposed, the vault can be drained.

external connections:

• base mainnet rpc at https://mainnet.base.org (public, no auth required)
• dx terminal api at https://api.terminal.markets (public, no auth required, rate limit: 100 req/min per ip)

required binaries:

• cast (foundry): onchain tx signing and sending
• curl: http requests to api
• jq: json parsing

derived inputs (computed once, reused):

• VAULT_ADDRESS: retrieved from api using owner address derived from private key

procedure

1. derive owner address from private key: run cast wallet address --private-key $DX_TERMINAL_PRIVATE_KEY. output: 20-byte eth address string.

2. fetch vault address: curl https://api.terminal.markets/api/v1/vault?ownerAddress=<OWNER_ADDRESS> and extract .vaultAddress with jq. output: 20-byte vault contract address. store as $VAULT_ADDRESS for all subsequent calls.

3. read vault settings (if inspecting config): curl https://api.terminal.markets/api/v1/vault?vaultAddress=$VAULT_ADDRESS and parse json. output: object with maxTradeAmount, slippageBps, tradingActivity, assetRiskPreference, tradeSize, holdingStyle, diversification. note: all slider fields are integers 1-5. maxTradeAmount and slippageBps are in basis points (bps).

4. read portfolio (if checking positions): curl https://api.terminal.markets/api/v1/positions/$VAULT_ADDRESS and parse json. output: object with ethBalance, overallValueEth, overallPnlEth (in wei, divide by 1e18 for display), and array positions[] with token balances and pnl. note: may be empty if vault has no positions yet.

5. read deposit/withdrawal history (if auditing flows): curl https://api.terminal.markets/api/v1/deposits-withdrawals/$VAULT_ADDRESS?limit=50&order=desc. output: paginated array of deposit/withdraw events. amount field in wei. use cursor from response for pagination if more than 50 records exist.

6. read all token market data (if screening tokens): curl https://api.terminal.markets/api/v1/tokens?includeMarketData=true. output: array of all tokens with price, volume, 24h change, market cap. note: can be large response (1000+ tokens), consider filtering client-side.

7. read swap history (if reviewing trades): curl https://api.terminal.markets/api/v1/swaps?vaultAddress=$VAULT_ADDRESS&limit=50&order=desc. output: paginated array of swaps. ethAmount and tokenAmount in wei. each swap has cursor for resuming pagination. includes reasoning field showing why trade was taken.

8. read active strategies (if checking instructions): curl https://api.terminal.markets/api/v1/strategies/$VAULT_ADDRESS?activeOnly=true. output: array of up to 8 strategies. each has id, text (instruction string), priority (0-2), expiryTime (unix seconds, 0 = no expiry). note: max 8 active, each max 1024 chars.

9. read token ohlcv candles (if charting): curl https://api.terminal.markets/api/v1/candles/$TOKEN_ADDRESS?timeframe=1m&to=$(date +%s)&countback=300. output: array of candles with open, high, low, close, volume. valid timeframes: 1m, 5m, 15m, 1h, 4h, 1d. to is required (unix seconds).

10. read inference logs (if auditing reasoning): curl https://api.terminal.markets/api/v1/logs/$VAULT_ADDRESS?limit=50&order=desc. output: paginated array of inference events. each has timestamp, reasoning text, decision made. use cursor for pagination.

11. read token holders (if analyzing concentration): curl https://api.terminal.markets/api/v1/holders/$TOKEN_ADDRESS?limit=50&offset=0&order=desc. output: array of holders ranked by balance. balance, totalBoughtTokens, totalSoldTokens in wei. order=desc shows largest first.

12. read leaderboard (if comparing vaults): curl https://api.terminal.markets/api/v1/leaderboard?limit=50&sortBy=total_pnl_usd. output: ranked list of vaults by pnl. supports cursor for pagination. optional sortBy values: total_pnl_usd, roi_pct, win_rate.

13. read pnl history (if charting returns): curl https://api.terminal.markets/api/v1/pnl-history/$VAULT_ADDRESS. output: time-series array of pnl snapshots. pnlEth in wei. suitable for plotting cumulative pnl over time.

14. update vault settings (if changing strategy): run cast send "$VAULT_ADDRESS" "updateSettings((uint256,uint256,uint8,uint8,uint8,uint8,uint8))" "(<maxTradeAmount>,<slippageBps>,<tradingActivity>,<assetRiskPreference>,<tradeSize>,<holdingStyle>,<diversification>)" --private-key "$DX_TERMINAL_PRIVATE_KEY" --rpc-url "https://mainnet.base.org". output: tx hash. wait for confirmation (15-30s on base). inputs must satisfy: maxTradeAmount 500-10000 bps, slippageBps 10-5000 bps, all slider fields 1-5.

15. add strategy (if issuing a new directive): run cast send "$VAULT_ADDRESS" "addStrategy(string,uint64,uint8)" "<STRATEGY_TEXT>" "<EXPIRY_UNIX>" "<PRIORITY>" --private-key "$DX_TERMINAL_PRIVATE_KEY" --rpc-url "https://mainnet.base.org". output: tx hash. inputs: strategy text 1-1024 chars, expiry 0 (no expiry) or future unix timestamp, priority 0-2 (Low-Med-High). max 8 active strategies at once. example expiry: $(( $(date +%s) + 86400 )) for 24h from now.

16. disable strategy (if revoking a directive): run cast send "$VAULT_ADDRESS" "disableStrategy(uint256)" "<STRATEGY_ID>" --private-key "$DX_TERMINAL_PRIVATE_KEY" --rpc-url "https://mainnet.base.org". output: tx hash. input: numeric strategy id from step 8.

17. deposit eth (if adding capital): run cast send "$VAULT_ADDRESS" "depositETH()" --value <AMOUNT>ether --private-key "$DX_TERMINAL_PRIVATE_KEY" --rpc-url "https://mainnet.base.org". output: tx hash. input: amount in ether units (e.g., 0.05ether, 1.5ether).

18. withdraw eth (if removing capital): run cast send "$VAULT_ADDRESS" "withdrawETH(uint256)" "<AMOUNT_WEI>" --private-key "$DX_TERMINAL_PRIVATE_KEY" --rpc-url "https://mainnet.base.org". output: tx hash. input: amount in wei (e.g., 50000000000000000 wei = 0.05 eth).

decision points

• if private key is missing or invalid: the skill fails immediately at step 1. no fallback. set DX_TERMINAL_PRIVATE_KEY env var or exit.

• if vault address cannot be derived: api may return 404 or empty response at step 2. this means the private key has never been registered with dx terminal. you must first deploy a vault onchain or contact dx terminal support. no read/write operations can proceed without valid VAULT_ADDRESS.

• if api returns rate limit (429): you hit 100 req/min per ip cap. wait 60 seconds and retry. batch read operations (step 6) count heavily towards limit.

• if api response is empty or null (e.g., no positions, no swaps, no strategies): this is not an error. the vault exists but has no data of that type yet. check output contract below for what empty responses look like.

• if updating settings or adding strategy and validation fails: cast will return a contract revert error. check that maxTradeAmount is 500-10000, slippageBps is 10-5000, sliders are 1-5, strategy text is 1-1024 chars, priority is 0-2, and you have fewer than 8 active strategies. fix inputs and retry.

• if deposit/withdraw tx fails with "insufficient balance" or "execution reverted": you lack eth in the sending address, or the vault has insufficient eth to withdraw. check eth balance with cast balance <ADDRESS> and portfolio eth with step 4.

• if candles request has invalid timeframe: api returns 400. use only 1m, 5m, 15m, 1h, 4h, 1d.

• if to parameter is omitted from candles request: api returns 400. to is required and must be a unix timestamp in seconds.

• if network rpc times out or is unreachable: cast will hang or error after ~30s. check mainnet.base.org is up. fallback to a different base rpc like https://base.publicnode.com.

• if you attempt to disable a strategy that is already disabled or does not exist: contract will revert silently. check step 8 first to confirm strategy id is active.

• if you attempt to add strategy but already have 8 active: contract will revert. disable one strategy first.

output contract

read endpoints (curl + jq) return json objects or arrays. specific contracts:

• step 2 (vault address): { "vaultAddress": "0x..." }. extract .vaultAddress as string.
• step 3 (settings): { "maxTradeAmount": 5000, "slippageBps": 200, "tradingActivity": 3, "assetRiskPreference": 3, "tradeSize": 3, "holdingStyle": 3, "diversification": 3 }.
• step 4 (portfolio): { "ethBalance": "1000000000000000000", "overallValueEth": "2500000000000000000", "overallPnlEth": "500000000000000000", "positions": [ { "tokenAddress": "0x...", "balance": "100000000000000000000", "pnlEth": "50000000000000000" } ] }. divide wei fields by 1e18 for display.
• step 5 (deposits/withdrawals): { "deposits": [ { "amount": "50000000000000000", "timestamp": 1699564800, "txHash": "0x..." } ], "cursor": "next_page_token" }. amount in wei.
• step 6 (tokens): { "tokens": [ { "address": "0x...", "symbol": "MEME", "price": 0.0025, "volume24h": 5000000, "change24h": 12.5, "marketCap": 25000000 } ] }.
• step 7 (swaps): { "swaps": [ { "ethAmount": "100000000000000000", "tokenAmount": "50000000000000000000", "timestamp": 1699564800, "reasoning": "...", "tokenAddress": "0x..." } ], "cursor": "next_page_token" }. amounts in wei.
• step 8 (strategies): { "strategies": [ { "id": 1, "text": "...", "priority": 2, "expiryTime": 1699651200 } ] }. priority is 0-2. expiryTime 0 means no expiry.
• step 9 (candles): { "candles": [ { "time": 1699564800, "open": 0.0020, "high": 0.0025, "low": 0.0020, "close": 0.0024, "volume": 1000000 } ] }.
• step 10 (logs): { "logs": [ { "timestamp": 1699564800, "reasoning": "...", "decision": "buy", "cursor": "..." } ] }.
• step 11 (holders): { "holders": [ { "address": "0x...", "balance": "1000000000000000000000", "totalBoughtTokens": "...", "totalSoldTokens": "..." } ] }. balances in wei.
• step 12 (leaderboard): { "leaderboard": [ { "vaultAddress": "0x...", "totalPnlUsd": 50000, "roiPct": 12.5, "winRate": 0.65 } ], "cursor": "..." }.
• step 13 (pnl history): { "pnlHistory": [ { "timestamp": 1699564800, "pnlEth": "500000000000000000" } ] }. pnlEth in wei.

write endpoints (cast send) return a tx hash string on success. example: 0xabc123def456. wait 15-30s for confirmation on base.

outcome signal

• successful read: curl returns 200 with valid json. jq extracts data without error. data is non-null (may be empty array, but structure is correct).
• successful write: cast returns a tx hash (0x-prefixed hex string, 66 chars). within 15-30s, the tx appears on basescan and shows "success" status.
• portfolio updated: after deposit (step 17) or withdraw (step 18), re-run step 4 and confirm ethBalance increased or decreased by the amount in wei.
• strategy added: after step 15, re-run step 8 and confirm new strategy appears in array with matching text, priority, expiry.
• settings changed: after step 14, re-run step 3 and confirm values match what you sent.
• vault trades: after adding strategy or adjusting settings, run step 7 (swaps) every 10-30s. new swaps will appear with matching reasoning. this confirms the agent is active and responding to changes.