Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
GDEX_API_KEYNoGDEX API key — auto-authenticates on startup
GDEX_API_URLNoOverride 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

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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 dex ("xyz") to see them. The default query does NOT show builder positions; an open builder position will look empty without dex.

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

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

C2.6/5.0

Scored across 117 tools

Disambiguation2/5

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.

Naming Consistency2/5

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.

Tool Count1/5

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.

Completeness4/5

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.

Maintenance

ActivityMaintained
ResponsivenessUnresponsive