Smithery is now a part of Arcade.dev! Read more in our announcement here
Gate Alpha token market skill. Use when the user specifically asks to browse, trade, or check Alpha market tokens. Triggers on 'alpha tokens', 'alpha market', 'buy alpha', 'alpha history'.
gate-cli (binary path)Resolve gate-cli in order: (1) command -v gate-cli and gate-cli --version succeeds; (2) ${HOME}/.local/bin/gate-cli if executable; (3) ${HOME}/.openclaw/skills/bin/gate-cli if executable. Canonical rules: exchange-runtime-rules.md Ā§4 (or gate-runtime-rules.md Ā§4).
This skill is the single entry for Gate Alpha operations. It supports seven modules: Token Discovery, Market Viewing, Trading (Buy), Trading (Sell), Account & Holdings, Account Book, and Order Management. User intent is routed to the matching workflow.
ā ļø STOP ā You MUST read and strictly follow the shared runtime rules before proceeding. Do NOT select or call any tool until all rules are read. These rules have the highest priority. ā Read gate-runtime-rules.md
gate-cli commands explicitly listed in this skill. Commands not documented here must NOT be run for these workflows, even if other interfaces expose them.Query Operations (Read-only)
gate-cli cex alpha order getgate-cli cex alpha account bookgate-cli cex alpha account balancesgate-cli cex alpha market currenciesgate-cli cex alpha order listgate-cli cex alpha market tickersgate-cli cex alpha market tokensgate-cli cex alpha order quoteExecution Operations (Write)
gate-cli cex alpha order placeGATE_API_KEY and GATE_API_SECRET are not both set on the host, run gate-cli config init to complete the wizard for API key, secret, profiles, and defaults (see gate-cli).gate-cli config init is not required when credentials are already supplied ā e.g. both GATE_API_KEY and GATE_API_SECRET set on the host, or --api-key / --api-secret where supported ā never ask the user to paste secrets into chat.gate-cli (run sh ./setup.sh from this skill directory if missing; optional GATE_CLI_SETUP_MODE=release).$HOME/.openclaw/skills/bin to PATH if you invoke gate-cli by name (or the directory where setup.sh installs it).GATE_API_KEY and GATE_API_SECRET are both set (non-empty) for the host, do not require gate-cli config init ā that is equivalent valid config for gate-cli. When both are unset or empty, remind the operator to run gate-cli config init or to configure GATE_API_KEY / GATE_API_SECRET in the matching skill from the skill library (never ask the user to paste secrets into chat).gate-cli --version or a read-only gate-cli cex ... command from this skill); confirm credentials resolve before mutating operations.Read and strictly follow references/gate-cli.md, then execute module routing in this skill.
SKILL.md keeps module dispatch and business boundaries.references/gate-cli.md is the authoritative gate-cli execution contract for quote->confirm->place order flow and post-order verification.| Module | Description | Trigger Keywords |
|---|---|---|
| Token Discovery | Browse tradable currencies, filter tokens by chain/platform/address, check token details | alpha tokens, what coins, which chain, token address, token details |
| Market Viewing | Check all or specific Alpha token tickers, prices, 24h changes | alpha price, market, ticker, how much is, what price |
| Trading (Buy) | Buy Alpha tokens with USDT, support default or custom slippage, optional order tracking | buy, ä¹°, č“ä¹°, å
„ę, åø®ęä¹° |
| Trading (Sell) | Sell Alpha tokens (full or partial), optional order tracking | sell, å, ååŗ, ęø
ä», åę |
| Account & Holdings | View Alpha account balances and calculate portfolio market value | my holdings, my balance, portfolio value, how much do I have |
| Account Book | View Alpha account transaction history by time range | transaction history, ęµę°“, čµäŗ§ååØ, account book, ååØč®°å½ |
| Order Management | Check order status, view historical buy/sell orders, search orders by time | order status, č®¢å, ä¹°å, åå, order history |
| Intent | Example Phrases | Route To |
|---|---|---|
| Token discovery | "What coins can I trade on Alpha?", "Show me Solana tokens", "Look up this address" | Read references/token-discovery.md |
| Market viewing | "What's the price of trump?", "How's the Alpha market?" | Read references/market-viewing.md |
| Trading (buy) | "åø®ęä¹° 5u ELON", "Buy 100u trump with 10% slippage" | Read references/trading-buy.md |
| Trading (sell) | "ę ELON å ØéØåę", "åęäøåē trump" | Read references/trading-sell.md |
| Account & holdings | "What coins do I hold?", "How much is my Alpha portfolio worth?" | Read references/account-holdings.md |
| Account book | "ęčæäøåØēčµäŗ§ååØč®°å½", "ēēęØ天ēčµäŗ§ååØ" | Read references/account-book.md |
| Order management | "ęåęé£ē¬ä¹°åęåäŗåļ¼", "ēēęä¹° ELON ēč®¢å" | Read references/order-management.md |
| Unclear | "Tell me about Alpha", "Help with Alpha" | Clarify: ask which module the user needs |
| # | Tool | Auth | Purpose |
|---|---|---|---|
| 1 | gate-cli cex alpha market currencies |
No | List all tradable Alpha currencies with chain, address, precision, status |
| 2 | gate-cli cex alpha market tokens |
No | Filter tokens by chain, launch platform, or contract address |
| 3 | gate-cli cex alpha market tickers |
No | Get latest price, 24h change, volume, market cap for Alpha tokens |
| 4 | gate-cli cex alpha account balances |
Yes | Query Alpha account balances (available + locked per currency) |
| 5 | gate-cli cex alpha order quote |
Yes | Get a price quote for a buy/sell order (returns quote_id, valid 1 min) |
| 6 | gate-cli cex alpha order place |
Yes | Place a buy/sell order using a quote_id |
| 7 | gate-cli cex alpha order get |
Yes | Get details of a single order by order_id |
| 8 | gate-cli cex alpha order list |
Yes | List orders with filters (currency, side, status, time range) |
| 9 | gate-cli cex alpha account book |
Yes | Query account transaction history by time range |
currency symbol (e.g., memeboxtrump) rather than standard ticker symbols.1 = actively trading, 2 = suspended, 3 = delisted.solana, eth, bsc, base, world, sui, arbitrum, avalanche, polygon, linea, optimism, zksync, gatelayer
Note: Chain names may be returned in different cases depending on the endpoint (e.g., SOLANA vs solana). Normalize to lowercase when comparing.
meteora_dbc, fourmeme, moonshot, pump, raydium_launchlab, letsbonk, gatefun, virtuals
amount="5" means spend 5 USDT).amount="1000" means sell 1000 tokens).quote_id from gate-cli cex alpha order quote expires after 1 minute. Re-quote if expired."speed" (default) or "custom" (with slippage). API returns gasMode as "1" (speed) or "2" (custom).1 = Processing, 2 = Success, 3 = Failed, 4 = Cancelled, 5 = Transferring, 6 = Cancelling transfer. Terminal statuses: 2, 3, 4.All API endpoints use snake_case naming. Key fields by endpoint:
/alpha/currencies: currency, name, chain, address, amount_precision, precision, status/alpha/tickers: currency, last, change, volume, market_cap/alpha/accounts: currency, available, locked, token_address, chain/alpha/account_book: id, time, currency, change, balance/alpha/orders (GET): order_id, tx_hash, side, usdt_amount, currency, currency_amount, status, gas_mode, chain, gas_fee, transaction_fee, create_time, failed_reason[{}, {}] (array with empty objects) instead of []. Check for valid fields before processing.currencies, tickers, tokens) are public and do not require authentication.page and limit parameters for large result sets.Classify the user request into one of seven modules: Token Discovery, Market Viewing, Trading (Buy), Trading (Sell), Account & Holdings, Account Book, or Order Management.
Load the corresponding reference document and follow its workflow.
Return the result using the report template defined in each sub-module.
| Error Type | Typical Cause | Handling Strategy |
|---|---|---|
| Currency not found | Invalid or misspelled currency symbol | Suggest searching via gate-cli cex alpha market currencies or gate-cli cex alpha market tokens |
| Token suspended | Trading status is 2 (suspended) | Inform user that the token is currently suspended from trading |
| Token delisted | Trading status is 3 (delisted) | Inform user that the token has been delisted |
| Empty result | No tokens match the filter criteria | Clarify filter parameters (chain, platform, address) and suggest alternatives |
| Authentication required | Calling authenticated endpoint without credentials | Inform user that API Key authentication is needed; guide to setup |
| Pagination overflow | Requested page beyond available data | Return last available page and inform user of total count |
| Quote expired | quote_id used after 1-minute validity window | Re-call gate-cli cex alpha order quote to obtain a fresh quote_id |
| Insufficient balance | Sell amount exceeds available balance | Inform user of actual available balance and suggest adjusting the amount |
| Order failed | On-chain transaction failed | Report the failed_reason from the order detail and suggest retrying |
| Order timeout | Polling exceeded 60 seconds without terminal status | Inform user the order is still processing; provide order_id for manual follow-up |
| Rate limit exceeded | Too many requests in short period | Wait briefly and retry; inform user if persistent |
status=1 before initiating a trade. Abort if suspended or delisted.available >= sell_amount. Report actual balance if insufficient.