GDEX Trading
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| GDEX_API_KEY | No | GDEX API key — auto-authenticates on startup | |
| GDEX_API_URL | No | Override API base URL (default: https://trade-api.gemach.io/v1) | https://trade-api.gemach.io/v1 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_gdex_docsB | Search GDEX documentation and skill files by keyword. Returns matching skill sections. |
| get_sdk_patternA | Get TypeScript code patterns for common GDEX SDK operations. Returns working code examples. |
| get_api_infoA | Get GDEX API endpoint details — URL, method, parameters, and response format. |
| explain_workflowB | Explain an end-to-end GDEX trading workflow with step-by-step instructions and code. |
| get_chain_infoB | Get supported chains, chain IDs, DEXes, and capabilities. |
| get_trading_guideC | Get a complete trading guide for spot, perp, or limit order trading. |
| get_copy_trade_guideC | Get a copy trading guide for Solana spot or HyperLiquid perp copy trading. |
| get_component_guideC | Get React UI component patterns for GDEX trading interfaces. |
| auth_loginA | Authenticate with a GDEX API key. Sets the Bearer token for all subsequent requests. |
| generate_session_keypairA | Generate a secp256k1 session keypair for managed-custody trade signing. Returns sessionPrivateKey and sessionKey (compressed public key). |
| managed_sign_inC | Sign in to GDEX managed-custody system using encrypted computedData payload. |
| build_sign_in_payloadA | Build the encrypted sign-in computedData payload from raw credentials. Returns the payload to use with managed_sign_in. |
| buy_tokenC | Buy a token on any supported chain (Solana, Sui, Ethereum, Base, Arbitrum, BSC, etc.) using the best DEX route. |
| sell_tokenC | Sell a token on any supported chain. Amount can be absolute ('100') or percentage ('50%'). |
| open_perp_positionC | Open a perpetual futures position on HyperLiquid with leverage, TP/SL. Supports market and limit orders. |
| place_perp_orderC | Place a simple perp order on HyperLiquid without TP/SL. |
| close_perp_positionB | Close a specific perp position using a reduce-only market order. |
| close_all_positionsA | Close all open perpetual positions on HyperLiquid. Note: may be unreliable — prefer closing per-coin. |
| cancel_perp_orderC | Cancel a specific open perp order on HyperLiquid. |
| cancel_all_perp_ordersC | Cancel all open perp orders on HyperLiquid. |
| set_leverageC | Set leverage for a specific asset on HyperLiquid. Supports cross and isolated margin modes. |
| perp_depositC | Deposit USDC into the HyperLiquid perpetual account from Arbitrum. |
| perp_withdrawC | Withdraw USDC from the HyperLiquid perpetual account. |
| get_account_stateB | Get full HyperLiquid account state: positions, margin, balance, withdrawable amount. No auth required. |
| get_perp_positionsB | Get all open perpetual positions for a wallet on HyperLiquid. No auth required. |
| get_mark_priceB | Get the current mark price for a HyperLiquid asset. No auth required. |
| get_all_mid_pricesA | Get all current mid prices across all HyperLiquid assets. No auth required. |
| get_usdc_balanceA | Get USDC balance on HyperLiquid for a wallet. No auth required. |
| get_hl_open_ordersB | Get all open orders on HyperLiquid for a wallet. No auth required. |
| get_hl_trade_historyB | Get trade history on HyperLiquid for a wallet. No auth required. |
| get_hl_spot_stateB | Get HyperLiquid spot trading state for a wallet. No auth required. |
| get_trader_leverageA | Get the active leverage setting a trader uses for a specific coin on HyperLiquid. |
| execute_cross_perpB | Execute a cross-margin perpetual trade directly with a private key (no managed custody). Supports TP/SL and builder fees. |
| execute_isolated_perpC | Execute an isolated-margin perpetual trade directly with a private key. Requires explicit leverage. |
| execute_spotC | Execute a spot trade directly on HyperLiquid with a private key. |
| direct_cancel_orderC | Cancel an open order directly with a private key on HyperLiquid. |
| limit_buyB | Create a limit buy order — buy a token when price drops to target. Uses ABI-encoded + AES-encrypted computedData. |
| limit_sellC | Create a limit sell order — sell a token when price reaches target. Auto-classifies as TP or SL. |
| update_orderB | Update or delete an existing limit order. Set isDelete=true to cancel. |
| get_limit_ordersA | List active limit orders for a user on a specific chain. Requires session-key auth. |
| get_copy_trade_walletsA | Get top 300 wallets ranked by totalPnl for Solana spot copy trade leaderboard. No auth. Cached 2 min. |
| get_copy_trade_custom_walletsA | Get top 300 wallets ranked by net received. No auth. Cached 2 min. |
| get_copy_trade_gemsB | Get hot new tokens heavily traded by top wallets. No auth. Cached 20s. |
| get_copy_trade_dexesA | List supported DEXes for a chain (e.g. Raydium, Pumpfun on Solana). No auth. |
| get_copy_trade_listA | List all copy trade configurations for a user. Requires session-key auth. |
| get_copy_trade_tx_listC | List copy trade transaction history with PnL. Requires session-key auth. |
| create_copy_tradeB | Create a new copy trade to auto-mirror a Solana trader's buys/sells. Solana only. |
| update_copy_tradeA | Update or delete a Solana copy trade. WARNING: Both isDelete and isChangeStatus permanently delete. |
| get_hl_top_tradersA | Get top HyperLiquid perp traders by volume, trade count, or deposit. No auth. Cached 15 min. |
| get_hl_top_traders_by_pnlA | Get top 30 HyperLiquid perp traders ranked by PnL. Data by day/week/month. No auth. Cached 15 min. |
| get_hl_user_statsB | Get detailed trading stats for an HL user: daily PnL, volumes, trade counts, win rates. No auth. Cached 1 hr. |
| get_hl_perp_dexesA | Get available perpetual DEX list on HyperLiquid. No auth. |
| get_hl_all_assetsA | Get all tradeable assets on HyperLiquid with max leverage info. No auth. |
| get_hl_clearinghouse_stateA | Get account state (positions, margin) on a HyperLiquid DEX. No auth. Builder/HIP-3 positions (e.g. xyz:NVDA) live under their own dex — pass |
| get_hl_meta_and_asset_ctxsB | Get market metadata and asset contexts from HyperLiquid. No auth. |
| get_hl_deposit_tokensB | Get supported deposit tokens for HyperLiquid. No auth. |
| get_hl_copy_trade_listA | List all HL perp copy trade configurations for a user. Requires session-key auth. |
| get_hl_copy_trade_tx_listA | Get HL copy trade fill history. Supports pagination (max 100 per page). Session-key auth. Cached 15s. |
| create_hl_copy_tradeC | Create a new HL perp copy trade. Copies a trader's long/short perpetual positions. |
| update_hl_copy_tradeB | Update or delete an HL perp copy trade. WARNING: Both isDelete and isChangeStatus permanently delete. |
| get_portfolioA | Fetch the full cross-chain portfolio for a wallet — all token balances with USD values and perp positions. |
| get_balancesC | Get token balances for a wallet on a specific chain. |
| get_trade_historyB | Get historical trades for a wallet with pagination and time filters. |
| get_token_detailsA | Get detailed token info: price, market cap, liquidity, DEX pools, social links, security info. No auth. |
| get_trending_tokensC | Get trending tokens sorted by volume and price change. No auth. |
| get_ohlcvB | Get OHLCV candlestick data for a token. No auth. |
| get_top_tradersC | Get top performing trader wallets ranked by P&L, win rate, volume, or trade count. |
| get_wallet_infoC | Get wallet information including native token balance. |
| generate_evm_walletA | Generate a new EVM wallet offline (no network call). Returns address, privateKey, and mnemonic. |
| estimate_bridgeA | Get a cross-chain bridge quote without executing. Returns estimated output, provider, and time. |
| execute_bridgeB | Execute a cross-chain bridge transaction. Requires managed-custody auth. |
| get_bridge_ordersB | Get bridge order history for a user. Requires session-key auth. |
| managed_purchaseB | Submit an encrypted managed-custody buy trade via the GDEX backend. |
| managed_sellC | Submit an encrypted managed-custody sell trade via the GDEX backend. |
| managed_trade_statusC | Poll the status of a managed-custody trade by requestId. |
| build_trade_payloadC | Build an encrypted managed-custody trade computedData payload from raw credentials. |
| transfer_nativeB | Transfer native asset (ETH, SOL, SUI, BNB, ...) via managed custody. Requires pre-built encrypted computedData. |
| transfer_tokenB | Transfer ERC20 / SPL token via managed custody. Requires pre-built encrypted computedData. |
| add_commentC | Post a comment on a token. |
| get_commentsC | Get comments for a token. |
| vote_sentimentC | Cast a bullish/bearish sentiment vote on a token. |
| get_watchlistC | Fetch the user's watchlist. |
| change_watchlistC | Add or remove a token from the user's watchlist via managed custody. Requires pre-built encrypted computedData. |
| import_tokenC | Import a user-defined custom token into the platform via managed custody. Requires pre-built encrypted computedData. |
| get_wallet_performanceC | Get wallet performance / PnL summary across recent periods. |
| get_nof1_analyticsC | Get NoF1 advanced trader analytics for a wallet. |
| get_native_pricesB | Get current native token prices (ETH, SOL, SUI, BNB, ...) keyed by chain. |
| generate_pnlC | Trigger backend PnL generation for a wallet. |
| get_newest_tokensC | Get newest tokens across all chains (or a specific chain). |
| get_top_tokensC | Get top tokens by volume / market cap. |
| get_bigbuysC | "Big buy" alert feed for a chain — recent large buy transactions. |
| get_currently_liveC | Currently-livestreaming token launches. |
| get_live_statusC | Livestream status for a single token address. |
| get_xstocksC | List tokenised equities (xStocks). |
| get_zora_tokensC | List Zora-protocol tokens. |
| get_token_tradesC | Recent trades for a specific token. |
| get_token_imageC | Get server-rendered token social-card image metadata. |
| hl_outcomesB | List available HyperLiquid outcome / event markets. Set withVolume=true to enrich each market with volume24hUsd (24h notional, from the HL WS feed) — adds a few seconds. |
| get_hl_outcome_volumesA | Get 24h notional volume (USD) per outcome coin from the HyperLiquid WS feed. Pass coins like ["#1010","#1011"]; returns a { coin: volumeUsd } map. Sum a market's side coins for its total 24h volume. |
| hl_outcome_accountB | Get HyperLiquid outcomes account state for a wallet on a specific outcome market (coins, positions, open orders). |
| hl_create_outcome_orderB | Create an order on a HyperLiquid outcome (HIP-3) market. Pass structured params (apiKey, walletAddress=control address, sessionPrivateKey, outcomeId, coin like "#1010", isBuy, price 0-1, size) and the SDK builds the encrypted payload. A pre-built computedData is also accepted. |
| hl_cancel_outcome_orderC | Cancel a HyperLiquid outcome-market order. Pass structured params (apiKey, walletAddress, sessionPrivateKey, outcomeId, coin, orderId) or a pre-built computedData. |
| hl_close_outcome_orderC | Close a HyperLiquid outcome-market position. Pass structured params (apiKey, walletAddress, sessionPrivateKey, outcomeId, coin, price, size, isMarket) or a pre-built computedData. |
| hl_ref_infoC | Get HyperLiquid referral info (earned, eligibility, code). |
| hl_ref_claimC | Submit a claim request for accrued HL referral rewards. Requires pre-built computedData. |
| trending_listC | List currently promoted / booked trending tokens. |
| trending_optionsB | List available trending-slot packages and prices. |
| trending_registerC | Register / pay for a trending slot. |
| trending_booking_statusC | Check trending-slot booking status (pending payment, active, expired). |
| get_retailersC | List registered retailer integrations / branded onboarding partners. |
| hl_enable_tradingA | Enable HL trading for a managed wallet (one-time, required before outcome/HIP-3 orders). Pass apiKey, walletAddress (control address), sessionPrivateKey and the SDK builds the payload; a pre-built computedData is also accepted. |
| hl_swap_collateralC | Swap collateral between HL clearinghouses/perp DEXes (HIP-3). Pass apiKey, walletAddress, sessionPrivateKey, fromToken, toToken, amount or a pre-built computedData. |
| hl_builder_referralC | Get builder-referral metadata for a wallet. |
| hl_list_user_copy_pnlC | Per-user realised PnL from HL copy-trading. |
| hl_tx_listC | Get HL transaction list (fills / orders) for a wallet. |
| oauth_loginA | Log in or sign up using a Google ID token. Google OIDC only — there is no Apple/GitHub branch. If the wallet has no associated email yet, the backend returns 404 with internal code 108 and the caller must invoke associate_email first (using the same idToken) before retrying. |
| associate_emailA | Link the email claim from a Google ID token to the caller's wallet. Must be called before oauth_login when the wallet has no associated email yet (oauth-login returns 404/code 108). The email is NOT sent by the client — the backend extracts it server-side from the verified Google idToken. computedData must be built with buildAssociateEmailComputedData (managed-custody payload). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 117 tools
117 tools contain many overlapping trading and account tools (e.g., open_perp_position/place_perp_order/execute_cross_perp/execute_isolated_perp; get_account_state/get_hl_clearinghouse_state/get_perp_positions; multiple auth and docs tools). While descriptions differentiate some, the sheer number of similar-purpose tools creates frequent ambiguity for an agent.
Uses snake_case but inconsistently mixes prefixes and verb patterns: get_ vs no get_, hl_ vs get_hl_, managed_ vs execute_ vs direct_, build_ vs generate_. Some names are noun-first (trending_list, hl_outcomes) while most are verb_noun, making predictable tool discovery harder.
117 tools is an extreme mismatch for any single MCP server; many tools cover niche or duplicate workflows. This exceeds the 50+ threshold and forces agents to sift through a sprawling surface.
The surface is broad, covering spot/perp trading, copy trading, bridge, wallet, auth, docs, social, and outcome markets. Most CRUD/lifecycle paths (create, update, cancel, list) exist, though some operations are only reachable via deletion flags or warning-laden tools.