General
antalpha-register
[Trading] Register this agent with Antalpha platform. Returns agent_id required by Polymarket tools.
⚠️ Call ONCE per session BEFORE using any poly-* tool. Without agent_id, all Polymarket calls will fail. [Write]. [Reasoning: Low].
Workflow: Step 1 of 2 — Session Init (after test-ping).
Keywords: register agent, get agent ID, antalpha setup, initialize Polymarket session, agent_id
No parameters required.
test-ping
[Account] Connectivity test — confirms MCP server is reachable. Returns server time (UTC+8). [Read-Only]. [Reasoning: Low].
Workflow: Step 0 of 2 — Session Init (test-ping → antalpha-register).
Keywords: ping, server check, connectivity test, MCP health check, is server online
No parameters required.
hyperliquid-price
Get Hyperliquid asset price(s). Omit coin for top-10 prices.
| Parameter | Type | Required | Description |
|---|
| coin | string | optional | Single asset name (e.g. ETH). For multiple assets pass comma-separated: "ETH,BTC,SOL". Omit for top-10. |
hyperliquid-account
Get Hyperliquid account summary: balances, positions, open orders.
| Parameter | Type | Required | Description |
|---|
| address | string | required | Wallet address (0x...) |
hyperliquid-book
Get L2 order book for a Hyperliquid perp asset.
| Parameter | Type | Required | Description |
|---|
| coin | string | required | Asset name (e.g. ETH) |
| depth | integer | optional | Book depth |
hyperliquid-orders
Get open orders for a Hyperliquid account.
| Parameter | Type | Required | Description |
|---|
| address | string | required | Wallet address |
hyperliquid-positions
Get open perp positions for a Hyperliquid account.
| Parameter | Type | Required | Description |
|---|
| address | string | required | Wallet address |
hyperliquid-funding
Get funding rates for Hyperliquid perp assets, sorted by magnitude.
| Parameter | Type | Required | Description |
|---|
| limit | integer | optional | Number of results |
hyperliquid-balance-check
Pre-check if account has sufficient balance for a trade. order_type=""spot"" checks Spot USDC/coin balance; order_type=""perp"" checks Perp margin accountValue.
| Parameter | Type | Required | Description |
|---|
| address | string | required | Wallet address (0x...) |
| coin | string | required | Asset to trade (e.g. ETH, BTC) |
| size | number | required | Planned order size in asset units |
| price | number | required | Planned order price in USD |
| leverage | integer | optional | Leverage (default: 1, perp only) |
| order_type | string | optional | spot = Spot balance only; perp = Perp+Spot combined; auto = detect automatically |
| is_buy | boolean | optional | true = buy (need USDC for spot); false = sell (need coin for spot) |
hyperliquid-limit-order
Place a limit order on Hyperliquid. Requires agent_key and owner address.
| Parameter | Type | Required | Description |
|---|
| agent_key | string | required | Agent wallet private key (0x...) |
| owner | string | required | Owner wallet address (0x...) |
| coin | string | required | Asset name (e.g. ETH, BTC) |
| side | string | required | Order side |
| price | number | required | Limit price in USD |
| size | number | required | Order size in asset units |
| tif | string | optional | Time-in-force |
| reduce_only | boolean | optional | Reduce-only order |
hyperliquid-market-order
Place a market order on Hyperliquid. Requires agent_key and owner address.
| Parameter | Type | Required | Description |
|---|
| agent_key | string | required | Agent wallet private key (0x...) |
| owner | string | required | Owner wallet address (0x...) |
| coin | string | required | Asset name |
| side | string | required | Order side |
| size | number | required | Order size |
| slippage | number | optional | Max slippage (0.01 = 1%) |
hyperliquid-close
Close an existing position at market price. Requires agent_key and owner.
| Parameter | Type | Required | Description |
|---|
| agent_key | string | required | Agent wallet private key (0x...) |
| owner | string | required | Owner wallet address (0x...) |
| coin | string | required | Asset to close |
| slippage | number | optional | Max slippage |
hyperliquid-cancel
Cancel an open order on Hyperliquid.
| Parameter | Type | Required | Description |
|---|
| agent_key | string | required | Agent wallet private key (0x...) |
| owner | string | required | Owner wallet address (0x...) |
| coin | string | required | Asset name |
| oid | integer | required | Order ID to cancel |
hyperliquid-leverage
Set leverage for a Hyperliquid perp asset.
| Parameter | Type | Required | Description |
|---|
| agent_key | string | required | Agent wallet private key (0x...) |
| owner | string | required | Owner wallet address (0x...) |
| coin | string | required | Asset name |
| leverage | integer | required | Leverage multiplier |
| mode | string | optional | Margin mode |
hyperliquid-tp-sl
Place a take-profit or stop-loss trigger order on Hyperliquid.
| Parameter | Type | Required | Description |
|---|
| agent_key | string | required | Agent wallet private key (0x...) |
| owner | string | required | Owner wallet address (0x...) |
| coin | string | required | Asset name |
| type | string | required | tp = take-profit, sl = stop-loss |
| side | string | required | Order side when triggered |
| trigger_price | number | required | Trigger price in USD |
| size | number | required | Order size |
hyperliquid-modify-order
Atomically modify an existing order on Hyperliquid (change price and/or size).
| Parameter | Type | Required | Description |
|---|
| agent_key | string | required | Agent wallet private key (0x...) |
| owner | string | required | Owner wallet address (0x...) |
| coin | string | required | Asset name (e.g. ETH) |
| oid | integer | required | Order ID to modify |
| side | string | required | Order side |
| price | number | required | New limit price in USD |
| size | number | required | New order size |
| tif | string | optional | Time-in-force |
easy-mining-get-workspace
[Mining] Verify API connectivity and get workspace metadata (name, ID).
⚠️ Always call FIRST to confirm API key is valid. [Read-Only]. [Reasoning: Low].
Workflow: Step 0 of 4 — Mining Task Workflow (verify connection before any other call).
Keywords: Nonce workspace ID, verify API key mining, workspace name, first mining call
| Parameter | Type | Required | Description |
|---|
| api_key | string | required | Nonce API key (from https://app.nonce.app) |
easy-mining-list-farms
[Mining] List all mining farms and their IDs. farm_id is required by most other easy-mining tools.
⚠️ Prerequisite for most other mining tools — call this if farm_id is unknown. [Read-Only]. [Reasoning: Low].
Workflow: Step 1 of 4 — Mining Task Workflow (get farm_id before listing miners or creating tasks).
Keywords: get farm_id, list all farms, farm names overview, which farms do I have
| Parameter | Type | Required | Description |
|---|
| api_key | string | required | Nonce API key |
easy-mining-list-agents
[Mining] List Nonce automation agents: IDs, names, status. [Read-Only]. [Reasoning: Low].
Keywords: automation agents list, Nonce agent names, agent IDs status
| Parameter | Type | Required | Description |
|---|
| api_key | string | required | Nonce API key |
easy-mining-list-miners
[Mining] Real-time status of ALL miners in a farm: hashrate, power, temperature, model. Primary health dashboard. Requires farm_id.
⚠️ Farm-level live overview. For single miner history → easy-mining-list-history. [Read-Only]. [Reasoning: Low].
Workflow: Step 2 of 4 — Mining Task Workflow (check status before creating tasks).
Keywords: live miner status all, which miners offline, current hashrate all miners, farm health dashboard
| Parameter | Type | Required | Description |
|---|
| api_key | string | required | Nonce API key |
| farm_id | string | required | Farm ID from easy-mining-list-farms |
easy-mining-list-metrics-history
[Mining] Daily historical metrics for an entire FARM: aggregate hashrate, online count, BTC earnings over time. Requires farm_id.
⚠️ FARM-LEVEL, historical. For single miner history → easy-mining-list-history. For live miner status → easy-mining-list-miners. [Read-Only]. [Reasoning: Low].
Keywords: farm-level daily metrics, aggregate hashrate over time, total BTC earned farm, whole farm trend
| Parameter | Type | Required | Description |
|---|
| api_key | string | required | Nonce API key |
| farm_id | string | required | Farm ID |
| from_date | string | optional | Start date ISO8601 (e.g. 2025-01-01) |
| to_date | string | optional | End date ISO8601 |
easy-mining-list-pool-diffs
[Mining] Pool configuration change records for a farm: when and what pool settings changed. [Read-Only]. [Reasoning: Low].
Keywords: pool config change log, when pool was switched, mining pool history records
| Parameter | Type | Required | Description |
|---|
| api_key | string | required | Nonce API key |
| farm_id | string | required | Farm ID |
easy-mining-list-history
[Mining] Historical performance for ONE specific miner: hashrate curve, power, temperature, uptime. For diagnosing hardware issues. Requires miner_id.
⚠️ SINGLE MINER, historical. For all miners live status → easy-mining-list-miners. For farm-level history → easy-mining-list-metrics-history. [Read-Only]. [Reasoning: Low].
Keywords: single miner history, one miner hashrate curve, individual miner uptime, diagnose specific miner
| Parameter | Type | Required | Description |
|---|
| api_key | string | required | Nonce API key |
| miner_id | string | required | Miner ID |
| from_date | string | optional | Start date ISO8601 |
| to_date | string | optional | End date ISO8601 |
easy-mining-list-miner-tasks
[Mining] Task execution history for ONE specific miner: reboots, firmware upgrades, pool changes and their outcomes. Requires miner_id.
⚠️ SINGLE MINER task audit. For farm-level task batches → easy-mining-list-task-batches. [Read-Only]. [Reasoning: Low].
Keywords: one miner task log, past reboots on miner, firmware history single miner, audit miner_id operations
| Parameter | Type | Required | Description |
|---|
| api_key | string | required | Nonce API key |
| miner_id | string | required | Miner ID |
easy-mining-list-task-batches
[Mining] List all task batches for a farm (paginated). Use to find task_batch_id for status checks.
⚠️ Use to find existing task_batch_id before calling easy-mining-get-task-batch. [Read-Only]. [Reasoning: Low].
Workflow: Step 3b of 4 — Mining Task Workflow (find task_batch_id to then monitor).
Keywords: find task_batch_id, all task batches list, paginated task history farm
| Parameter | Type | Required | Description |
|---|
| api_key | string | required | Nonce API key |
| farm_id | string | required | Farm ID |
| page | integer | optional | Page number |
| page_size | integer | optional | Items per page |
easy-mining-create-task-batch
[Mining] Create a batch task across multiple miners: reboot, power mode change, firmware upgrade, pool config update. Requires farm_id.
⚠️ WRITE operation affecting multiple miners simultaneously. ALWAYS confirm exact scope with user before calling. To monitor result → easy-mining-get-task-batch. [Write]. [Reasoning: High].
Workflow: Step 3 of 4 — Mining Task Workflow (after confirming miner status in step 2).
Keywords: reboot all miners, bulk firmware upgrade, change mining pool all miners, batch power mode, execute task farm
| Parameter | Type | Required | Description |
|---|
| api_key | string | required | Nonce API key |
| farm_id | string | required | Farm ID |
| task_name | string | required | Task type to execute |
| miner_ids | array | required | List of miner IDs to apply task to |
| params | object | optional | Task-specific parameters (e.g. {mode: 'low_power'} for power_mode.update) |
easy-mining-get-task-batch
[Mining] Get status and per-miner results for a specific task batch.
⚠️ Input: task_batch_id from easy-mining-create-task-batch or easy-mining-list-task-batches. [Read-Only]. [Reasoning: Low].
Workflow: Step 4 of 4 — Mining Task Workflow (monitor after creating a batch task).
Keywords: task batch result, did reboot succeed, batch execution status, check specific task_batch_id
| Parameter | Type | Required | Description |
|---|
| api_key | string | required | Nonce API key |
| task_batch_id | string | required | Task batch ID from easy-mining-create-task-batch |
wallet-balance-query
[Account] Query native token balance for a wallet address across all supported blockchains. Auto-detects chain from address format (EVM 0x / BTC / SOL).
⚠️ ON-CHAIN SELF-CUSTODY wallets only (MetaMask, cold wallets, any 0x/BTC/SOL address). For CEX exchange account balances → cex-account-get-balance. [Read-Only]. [Reasoning: Low].
Keywords: wallet balance, on-chain balance, check address balance, 0x balance, BTC wallet balance, SOL balance
| Parameter | Type | Required | Description |
|---|
| address | string | required | Wallet address (chain auto-detected from format) |
cex-market-get-ticker
[Market Data] Get real-time ticker for an instrument: last price, 24h high/low, 24h volume, best bid/ask.
⚠️ CEX exchange price. For standalone BTC/ETH price without CEX context → data-price-btc / data-price-eth. instId MUST use exchange-native hyphen format — OKX: "INJ-USDT" (spot) / "INJ-USDT-SWAP" (perp); Binance: "INJUSDT" (spot) / "INJUSDT" (perp). Never pass raw ticker like "INJ" or "INJUSDT" to OKX. [Read-Only]. [Reasoning: Low].
Keywords: CEX ticker, last price, 24h change, 24h volume, best bid ask, real-time exchange price
| Parameter | Type | Required | Description |
|---|
| exchange | string | optional | Target exchange. Defaults to 'okx' for backward compatibility. |
| instId | string | required | Instrument ID in exchange-native format.
OKX (default): hyphen-separated, e.g. "INJ-USDT" (spot), "BTC-USDT-SWAP" (perp).
Binance: concatenated, e.g. "INJUSDT" (spot), "INJUSDT" (perp).
Convert user-mentioned symbols before calling: "INJ" → "INJ-USDT" (OKX) or "INJUSDT" (Binance). |
cex-market-get-kline
[Market Data] Get OHLCV (open/high/low/close/volume) candlestick data for any instrument at a given interval. Supports multiple timeframes. [Read-Only]. [Reasoning: Low].
Keywords: candlestick, OHLCV, price history, kline, 1h 4h daily candles, historical price chart
| Parameter | Type | Required | Description |
|---|
| exchange | string | optional | Target exchange. Defaults to 'okx' for backward compatibility. |
| instId | string | required | Instrument ID, e.g. BTC-USDT-SWAP |
| interval | string | optional | K-line bar interval. Use normalized format (Binance-style): 1m/3m/5m/15m/30m/1h/2h/4h/6h/8h/12h/1d/3d/1w/1M. The skill maps to each exchange's native format internally — do NOT pass OKX-style uppercase (1H, 4H, 1D); Zod will reject those. |
| limit | integer | optional | Number of candles (default 100, max 300) |
cex-market-get-orderbook
[Market Data] Get the live order book (bids and asks with depth) for an instrument. Use for slippage estimation before placing large orders. [Read-Only]. [Reasoning: Low].
Keywords: order book, bids asks, market depth, buy wall sell wall, depth chart, slippage estimation
| Parameter | Type | Required | Description |
|---|
| exchange | string | optional | Target exchange. Defaults to 'okx' for backward compatibility. |
| instId | string | required | Instrument ID |
| depth | integer | optional | Order book depth per side (default 20) |
cex-market-get-instruments
[Market Data] Get the full list of available trading instruments (spot pairs and futures contracts) on the connected CEX. Use to resolve valid instrument IDs before placing orders. [Read-Only]. [Reasoning: Low].
Keywords: trading pairs, instrument list, available markets, futures contracts, spot pairs on exchange
| Parameter | Type | Required | Description |
|---|
| exchange | string | optional | Target exchange. Defaults to 'okx' for backward compatibility. |
| instType | string | optional | Instrument type |
cex-spot-place-order
[Trading] Place a spot buy or sell order on CEX (no leverage).
⚠️ SPOT only — no leverage, no long/short. For leveraged futures → cex-futures-place-order. NOT for viewing existing orders (→ cex-spot-get-orders). [Write]. [Reasoning: High].
PRIORITY: Default for 'buy / sell' without leverage keywords. If user mentions long/short/perp/leverage → cex-futures-place-order.
Keywords: place new spot order, create buy sell, enter spot market, submit spot trade, no leverage buy
| Parameter | Type | Required | Description |
|---|
| exchange | string | optional | Target exchange. Defaults to 'okx' for backward compatibility. |
| instId | string | required | Instrument ID, e.g. BTC-USDT |
| side | string | required | Order side |
| ordType | string | required | Order type |
| sz | string | required | Order size in base currency |
| px | string | optional | Order price (required for limit orders) |
| quoteOrderQty | string | optional | Quote currency amount for market buy (Binance only) |
cex-spot-cancel-order
[Trading] Cancel a spot order by order ID.
⚠️ SPOT orders only. For futures orders → cex-futures-cancel-order. [Write]. [Reasoning: Low].
Keywords: cancel pending order, delete unfilled order, remove queued buy sell, abort spot order
| Parameter | Type | Required | Description |
|---|
| exchange | string | optional | Target exchange. Defaults to 'okx' for backward compatibility. |
| instId | string | required | Instrument ID |
| orderId | string | required | Order ID to cancel |
cex-spot-get-orders
[Account] Get spot order history: open (pending) and historical (filled / cancelled).
⚠️ SPOT ORDERS only. For futures positions → cex-futures-get-positions. NOT for placing orders (→ cex-spot-place-order). [Read-Only]. [Reasoning: Low].
Keywords: spot order history, filled orders, open pending orders, past spot trades, order list
| Parameter | Type | Required | Description |
|---|
| exchange | string | optional | Target exchange. Defaults to 'okx' for backward compatibility. |
| instId | string | optional | 交易对,如 ETH-USDT。Binance 侧未传 instId 时接口直接返回空数组(非报错)。OKX 可省略以查全市场挂单(仅 pending 接口时慎用)。 |
| state | string | optional | OKX:不传时只查当前挂单 orders-pending;市价单若已瞬间成交则不在挂单里,列表会为空——查成交请传 state=filled(或 cancelled)。Binance:不传 state 时只查该 instId 的未成交挂单。 |
cex-futures-place-order
[Trading] Place a futures/perpetual order on CEX (leveraged, with long/short). Supports semantic inputs (e.g. 'open long').
⚠️ FUTURES / PERPETUAL with leverage. For un-leveraged spot buy/sell → cex-spot-place-order. ALWAYS confirm side, size, leverage with user before calling. [Write]. [Reasoning: High].
PRIORITY: Use when user explicitly mentions leverage, perp, futures, long/short. Default to cex-spot-place-order if user just says 'buy/sell'.
Keywords: open long, open short, create new position, enter market, go long go short, new futures order, leveraged trade
| Parameter | Type | Required | Description |
|---|
| exchange | string | optional | Target exchange. Defaults to 'okx' for backward compatibility. |
| instId | string | required | Instrument ID, e.g. BTC-USDT-SWAP |
| action | string | optional | Semantic action — use instead of side+posSide for clarity |
| side | string | optional | Explicit order side (use with posSide) |
| posSide | string | optional | Position side for hedge mode (use with side) |
| ordType | string | required | Order type |
| sz | string | required | Order size (contracts for OKX; base currency qty for Binance e.g. 0.01 BTC) |
| px | string | optional | Order price (required for limit orders) |
| leverage | integer | required | Leverage multiplier |
| mgnMode | string | required | Margin mode |
| reduceOnly | boolean | optional | Reduce-only flag |
| clientOrderId | string | optional | Custom client order ID for idempotency |
cex-futures-cancel-order
[Trading] Cancel a futures/perpetual order by order ID.
⚠️ FUTURES orders only. For spot orders → cex-spot-cancel-order. For closing an existing position (not an order) → cex-futures-close-position. [Write]. [Reasoning: Low].
Keywords: cancel futures order, remove pending futures, revoke perp order, abort unfilled futures
| Parameter | Type | Required | Description |
|---|
| exchange | string | optional | Target exchange. Defaults to 'okx' for backward compatibility. |
| instId | string | required | Instrument ID, e.g. BTC-USDT-SWAP |
| orderId | string | required | Order ID to cancel |
cex-futures-get-positions
[Account] Get open futures/perpetual positions with margin health, liquidation risk flags, and unrealized PnL.
⚠️ FUTURES POSITIONS only. For spot order history → cex-spot-get-orders. For account-level summary → cex-account-get-info. [Read-Only]. [Reasoning: Medium].
Keywords: my futures positions, margin health, liquidation price, unrealized PnL futures, am I near liquidation
| Parameter | Type | Required | Description |
|---|
| exchange | string | optional | Target exchange. Defaults to 'okx' for backward compatibility. |
| instId | string | optional | Filter by instrument ID |
cex-futures-set-leverage
[Trading] Set leverage multiplier and margin mode (isolated/cross) for a futures instrument. Affects all subsequent orders on that instrument.
⚠️ Setting only — does NOT place an order. Call BEFORE cex-futures-place-order if leverage change is needed. [Write]. [Reasoning: Medium].
Keywords: set leverage multiplier, isolated cross margin mode, change leverage ratio, 10x 20x 50x
| Parameter | Type | Required | Description |
|---|
| exchange | string | optional | Target exchange. Defaults to 'okx' for backward compatibility. |
| instId | string | required | Instrument ID, e.g. BTC-USDT-SWAP |
| leverage | integer | required | Leverage multiplier |
| mgnMode | string | required | Margin mode |
cex-futures-close-position
[Trading] Market-close ALL futures positions for an instrument. Full exit.
⚠️ Closes POSITIONS (not orders). To cancel a pending order → cex-futures-cancel-order. Always confirm scope with user before calling — this is an immediate full exit. [Write]. [Reasoning: High].
Keywords: close existing futures position, exit active trade, flatten all, full exit perp, close out instrument
| Parameter | Type | Required | Description |
|---|
| exchange | string | optional | Target exchange. Defaults to 'okx' for backward compatibility. |
| instId | string | required | Instrument ID, e.g. BTC-USDT-SWAP |
| posSide | string | optional | Position side for hedge mode: 'long' closes long leg, 'short' closes short leg. Omit for net/one-way mode. |
cex-account-get-balance
[Account] Get detailed per-currency balance breakdown for the connected CEX account. Returns available (tradable) and frozen (in-order) amounts for each asset. Requires API keys.
⚠️ Difference from cex-account-get-info: this returns PER-CURRENCY detail; cex-account-get-info returns ACCOUNT-LEVEL totals (equity, PnL). Difference from wallet-balance-query: this queries a CEX custodial account; wallet-balance-query queries a self-custody on-chain address. [Read-Only]. [Reasoning: Low].
PRIORITY: Use when user asks 'how much USDT / BTC do I have on the exchange'. For account-level total → cex-account-get-info.
Keywords: CEX per-currency balance, available frozen split, how much USDT do I have, exchange holdings, asset-by-asset balance
| Parameter | Type | Required | Description |
|---|
| exchange | string | optional | Target exchange. Defaults to 'okx' for backward compatibility. |
cex-account-get-info
[Account] Get CEX account summary: total equity (USD), unrealized PnL, net available balance, frozen balance. Single-call portfolio snapshot. Requires API keys.
⚠️ Difference from cex-account-get-balance: this returns ACCOUNT-LEVEL totals; cex-account-get-balance returns PER-CURRENCY detail. [Read-Only]. [Reasoning: Low].
PRIORITY: Use when user asks 'what is my total account value'. For per-currency breakdown → cex-account-get-balance.
Keywords: total equity, account summary, net balance, unrealized PnL, exchange portfolio overview, total account value
| Parameter | Type | Required | Description |
|---|
| exchange | string | optional | Target exchange. Defaults to 'okx' for backward compatibility. |
cex-setup-check
[Account] Check whether CEX API credentials are already configured. Returns ready / not-ready status.
⚠️ READ-ONLY status check. To save credentials → cex-setup-save. [Read-Only]. [Reasoning: Low].
Workflow: Step 0 of 2 — CEX Setup Workflow (check first, only save if not configured).
Keywords: is API already configured, exchange connection status, credentials exist, setup complete
No parameters required.
cex-setup-save
[Trading] Save CEX API key and secret. Call ONLY after user explicitly provides credentials in chat.
⚠️ Never pre-fill or assume credentials. After saving, verify with cex-setup-verify. [Write]. [Reasoning: Low].
Workflow: Step 1 of 2 — CEX Setup Workflow (after cex-setup-check confirms not yet configured).
Keywords: add new API key, enter API secret, store credentials, first time exchange setup
| Parameter | Type | Required | Description |
|---|
| exchange | string | required | Which exchange to configure |
| apiKey | string | required | API Key |
| apiSecret | string | required | API Secret |
| apiPassphrase | string | optional | API Passphrase (OKX only, not required for Binance) |
| isDemo | boolean | optional | Use demo/simulated trading environment (testnet) |
cex-setup-verify
[Trading] Verify saved CEX credentials by making a live API call. Confirms keys are valid before trading.
⚠️ Read-only side-effect-free verification. NOT for saving credentials (→ cex-setup-save). [Read-Only]. [Reasoning: Low].
Workflow: Step 2 of 2 — CEX Setup Workflow (always run after cex-setup-save).
Keywords: test API call, confirm key works, validate credentials live, check API not expired
| Parameter | Type | Required | Description |
|---|
| exchange | string | required | Exchange to verify |
airdrop-scan
[Research] Sweep the market for ALL currently active airdrop projects. Returns a filterable ranked list (chain, grade S/A/B, TVL, VC backing). Use when no specific project is in mind — this is the broad discovery sweep.
⚠️ Broad discovery sweep. NOT for one specific project (→ airdrop-check-project); NOT for pre-curated daily digest (→ airdrop-daily-report); NOT for checking link safety (→ airdrop-scam-check). [Read-Only]. [Reasoning: Medium].
Workflow: Step 1 of 3 — Airdrop Workflow (airdrop-scan → airdrop-check-project → airdrop-scam-check).
PRIORITY: Default entry for airdrop discovery. Use airdrop-daily-report only if user wants curated digest.
Keywords: find airdrops, browse airdrops, active airdrop list, airdrop discovery, search all airdrops
| Parameter | Type | Required | Description |
|---|
| chain | string | optional | Filter by chain name (e.g., 'Ethereum', 'Arbitrum', 'Monad'). Leave empty for all chains. Sentinels 'all' / 'any' / '*' are also accepted as no-filter. |
| status | string | optional | Filter by project status. 'active' = currently running, 'upcoming' = announced but not live. Leave empty for both. |
| limit | integer | optional | Max results to return (default 20) |
| include_completed | boolean | optional | Include projects whose token has already launched (airdrop window likely closed). Default false — by definition airdrop-scan returns only claimable opportunities. |
| include_old | boolean | optional | Include projects listed on DeFiLlama more than 24 months ago. Default false — older projects without a token are usually dormant. |
airdrop-daily-report
[Research] Get today's pre-curated airdrop digest: top S/A-grade picks, zero-cost options, upcoming deadlines, and active scam alerts. AI-filtered and ROI-ranked — no browsing needed.
⚠️ Curated daily digest. NOT for open-ended market sweep (→ airdrop-scan); NOT for evaluating one specific project (→ airdrop-check-project). [Read-Only]. [Reasoning: High].
Workflow: Step 1 of 3 — Airdrop Workflow (alternative entry to airdrop-scan).
PRIORITY: Use when user wants today's picks. For broad discovery → airdrop-scan.
Keywords: daily airdrop report, today best airdrops, morning briefing, curated digest, airdrop summary
| Parameter | Type | Required | Description |
|---|
| chain | string | optional | Filter by chain name. Leave empty or pass 'all' / 'any' for no filter. |
| grades | array | optional | Grades to include, as a list. For an "S and A" request pass ["S","A"]. A single grade like ["S"] returns only that grade. Omit to default to the top picks (S and A). |
airdrop-check-project
[Research] Deep-dive analysis of ONE specific named airdrop project. Grades it S/A/B/C on VC quality, funding, TVL, token status. Returns scam probability and verdict. Requires a specific project name or ID.
⚠️ Single-project deep dive. NOT for browsing the market (→ airdrop-scan); NOT for the curated daily digest (→ airdrop-daily-report). [Read-Only]. [Reasoning: High].
Workflow: Step 2 of 3 — Airdrop Workflow (after airdrop-scan or airdrop-daily-report surfaces a candidate).
Keywords: check specific airdrop, airdrop grade, project rating, is this airdrop legit, S A B C rating, scam probability
| Parameter | Type | Required | Description |
|---|
| project_name | string | required | Project name or slug (e.g., 'Monad', 'berachain', 'scroll') |
airdrop-zero-cost
[Research] Find airdrops that require zero capital: gas-free testnets and free mainnet tasks. Returns time estimate, anti-Sybil tips, faucet links.
⚠️ Filters for $0-cost only. NOT a general airdrop scan (→ airdrop-scan). [Read-Only]. [Reasoning: Low].
Keywords: free airdrop, zero cost, no gas, testnet airdrop, gas-free participation
| Parameter | Type | Required | Description |
|---|
| chain | string | optional | Filter by chain name. Leave empty or pass 'all' / 'any' for no filter. |
| limit | integer | optional | Max results (default 10) |
airdrop-scam-check
[Security] Check whether a specific URL is a phishing site or fake airdrop claim page. Returns SAFE / WARNING / CRITICAL and the verified official URL. Input: URL string.
⚠️ Input is a URL, not a project name. NOT for project evaluation (→ airdrop-check-project); NOT for finding airdrops (→ airdrop-scan). [Read-Only]. [Reasoning: Low].
Workflow: Step 3 of 3 — Airdrop Workflow (always call before connecting wallet to any claim page).
Keywords: airdrop link safe, phishing URL check, fake claim page, safe to connect wallet, verify airdrop URL
| Parameter | Type | Required | Description |
|---|
| url | string | optional | URL to check (e.g., 'https://scroll-airdrop-claim.xyz') |
| project_name | string | optional | Project name to check for impersonation (e.g., 'Scroll') |
crypto-social-trending
[Market Data] Get a ranked list of tokens by social activity (AltRank — composite of
social volume × market performance). Returns per token: rank, symbol,
alt_rank, social_volume_24h, sentiment (0-100), price_change_24h,
signal_level (HIGH/MEDIUM/LOW).
Input: limit (1-50, default 10). No symbol needed — this is a list query.
⚠️ RANKED LIST. For a single token's sentiment score → crypto-sentiment-score(symbol).
For social momentum shifts → crypto-mention-surge.
[Read-Only]. [Reasoning: Low].
| Parameter | Type | Required | Description |
|---|
| limit | number | optional | Number of results (1-50) |
crypto-sentiment-score
[Market Data] Get social sentiment for one specific token. Returns: sentiment (0-100),
galaxy_score (0-100 overall health), social_volume_24h, bullish_summary,
signal_level (HIGH/MEDIUM/LOW).
Input: symbol (required, e.g. "BTC"), time_range ("24h"|"7d", default "24h" —
label only, data always reflects the 24h window).
If the token has no social coverage, returns TOKEN_NOT_FOUND — do not retry
with the same symbol.
⚠️ Single-token score. For a ranked trending list → crypto-social-trending.
For who's discussing this token → crypto-kol-signals(symbol).
[Read-Only]. [Reasoning: Medium].
| Parameter | Type | Required | Description |
|---|
| symbol | string | required | Token symbol (e.g. BTC, ETH, SOL) |
| time_range | string | optional | Analysis time range label (display only) |
crypto-kol-signals
[Market Data] Get KOL creators and news discussing one specific token. Returns: top_creators[]
(platform, username, followers per creator), top_news[] (headline, source),
sentiment, social_dominance, signal_level.
Input: symbol (required, e.g. "BTC"), time_range ("24h"|"7d", default "24h" —
label only, data always reflects the 24h window).
If the token has no social coverage, returns TOKEN_NOT_FOUND — do not retry
with the same symbol.
⚠️ Shows WHO discusses the token and WHAT they say. For sentiment score →
crypto-sentiment-score(symbol). For mention volume spikes → crypto-mention-surge.
[Read-Only]. [Reasoning: Medium].
| Parameter | Type | Required | Description |
|---|
| symbol | string | required | Token symbol (e.g. BTC, ETH, SOL) |
| time_range | string | optional | Analysis time range label (display only) |
crypto-mention-surge
[Market Data] Detect tokens with sudden social attention shifts. Returns per token:
rank_change (positive = rising), alt_rank (current vs previous),
social_volume_24h, sentiment, price_change_24h, signal_level.
Input: limit (1-50, default 10). No symbol needed.
⚠️ Social MOMENTUM changes — not sentiment (→ crypto-sentiment-score),
not KOL discussion (→ crypto-kol-signals), not trending ranking (→ crypto-social-trending).
[Read-Only]. [Reasoning: Medium].
| Parameter | Type | Required | Description |
|---|
| limit | number | optional | Max results |
crypto-fear-greed
[DISABLED] Deprecated. Use data-sentiment-fng instead — both return the identical Crypto Fear & Greed Index (0–100). [Read-Only]. [Reasoning: Low].
Keywords: DISABLED, use data-sentiment-fng
| Parameter | Type | Required | Description |
|---|
| days | number | optional | History days to return (1-30, default 7) |
wallet-guard-token-security
[Security] Quick scan of an ERC20 token contract across 20+ risk flags: honeypot, hidden mint, abnormal tax, blacklist, trading restrictions. Fast result, flag-based output.
⚠️ Input: TOKEN CONTRACT ADDRESS. NOT for wallet addresses (→ wallet-guard-address-security); NOT for NFTs (→ wallet-guard-nft-security); NOT for DeFi protocols (→ wallet-guard-rugpull-detection). For a scored deep report → wallet-guard-token-deep-scan. [Read-Only]. [Reasoning: High].
Workflow: Step 1 of 2 — Token Security Workflow (quick check first, deep scan only if ambiguous).
PRIORITY: Default token contract scan. Escalate to wallet-guard-token-deep-scan only if results ambiguous or user wants scored report.
Keywords: quick token risk flags, honeypot check fast, hidden mint tax blacklist, ERC20 token 20 indicators
| Parameter | Type | Required | Description |
|---|
| chain_id | string | required | EVM chain ID string. Common values: "1" = Ethereum, "56" = BSC, "137" = Polygon, "8453" = Base, "43114" = Avalanche, "42161" = Arbitrum |
| contract_addresses | string | required | One or more token contract addresses, comma-separated (0x-prefixed) |
wallet-guard-address-security
[Security] Check if a wallet address is flagged malicious across 12+ categories: hacker, scammer, sanctions, darknet, phishing. Output: risk categories found.
⚠️ Input: wallet ADDRESS (0x EVM only). Does NOT support Bitcoin (BTC), Solana (SOL), or other non-EVM chain addresses — if user provides a BTC or Solana address, do NOT call this tool, respond: "This tool supports EVM (0x) addresses only. Bitcoin and Solana addresses are not supported." NOT for URLs (→ wallet-guard-phishing-site); NOT for token contracts (→ wallet-guard-token-security); NOT for DeFi protocol contracts (→ wallet-guard-rugpull-detection). [Read-Only]. [Reasoning: Medium].
Keywords: malicious wallet address, hacker scammer address, is 0x address safe, sanctions blacklist check address
| Parameter | Type | Required | Description |
|---|
| address | string | required | A wallet/contract address OR a transaction hash to screen. Addresses: EVM (0x-prefixed) get full on-chain risk data; Bitcoin / Solana / Tron and other chains get a sanctions / watch-list check. Transaction hashes (EVM / Bitcoin / Solana) are screened by extracting the involved counterparty addresses and checking each. |
| chain_id | string | optional | Optional chain ID to narrow an EVM address check. EVM chain ID string. Common values: "1" = Ethereum, "56" = BSC, "137" = Polygon, "8453" = Base, "43114" = Avalanche, "42161" = Arbitrum |
wallet-guard-approval-security
[Security] Scan a wallet for dangerous token/NFT approvals: unlimited ERC20 allowances, suspicious spenders, ERC721/1155 risks. Returns revocation recommendations.
⚠️ Input: WALLET ADDRESS to audit its approvals. NOT for checking a token contract itself (→ wallet-guard-token-security). [Read-Only]. [Reasoning: High].
Keywords: token approvals scan, revoke ERC20 allowance, unlimited approval risk, spender contract dangerous
| Parameter | Type | Required | Description |
|---|
| address | string | optional | Wallet address to scan for approvals (0x-prefixed) |
| wallet_address | string | optional | Alias for address (0x-prefixed wallet address) |
| chain_id | string | required | EVM chain ID string. Common values: "1" = Ethereum, "56" = BSC, "137" = Polygon, "8453" = Base, "43114" = Avalanche, "42161" = Arbitrum |
| type | string | optional | Approval type to scan: erc20, erc721, erc1155, or all (default) |
wallet-guard-nft-security
[Security] Detect NFT collection contract risks: transfer locks, trading pause, blacklist controls, fake floor inflation.
⚠️ Input: NFT CONTRACT ADDRESS. NOT for fungible tokens (→ wallet-guard-token-security); NOT for wallet approvals (→ wallet-guard-approval-security); NOT for DeFi protocols (→ wallet-guard-rugpull-detection). [Read-Only]. [Reasoning: High].
Keywords: NFT collection contract risk, transfer lock NFT, trading pause NFT, fake floor NFT, mint safe collection
| Parameter | Type | Required | Description |
|---|
| chain_id | string | required | EVM chain ID string. Common values: "1" = Ethereum, "56" = BSC, "137" = Polygon, "8453" = Base, "43114" = Avalanche, "42161" = Arbitrum |
| contract_address | string | required | NFT contract address (0x-prefixed) |
| token_id | string | optional | Optional specific token ID to check |
wallet-guard-phishing-site
[Security] Check if a URL is a phishing or impersonation website. Output: safe/warning/critical verdict.
⚠️ Input: URL (website). NOT for wallet addresses (→ wallet-guard-address-security); NOT for token contracts (→ wallet-guard-token-security). [Read-Only]. [Reasoning: Low].
Keywords: phishing URL, fake website crypto, is this domain safe, URL before wallet connect
| Parameter | Type | Required | Description |
|---|
| url | string | required | URL to check for phishing risk (e.g. https://uniswap-airdrop.com) |
wallet-guard-token-deep-scan
[Security] Comprehensive token security analysis with 0–100 risk score and scenario classification (Stablecoin / Ecosystem / Meme). Detects honeypot, self-destruct, ownership reclaim, balance manipulation with cross-validation.
⚠️ Slower than wallet-guard-token-security. Use ONLY when: (a) quick scan returned ambiguous results, or (b) user explicitly needs a scored report. [Read-Only]. [Reasoning: Very High].
Workflow: Step 2 of 2 — Token Security Workflow (only after wallet-guard-token-security).
PRIORITY: Use only as escalation from wallet-guard-token-security or when user explicitly asks for a scored deep report. Default to wallet-guard-token-security.
Keywords: comprehensive token audit, 0-100 risk score, stablecoin ecosystem meme classification, deep honeypot cross-validation
| Parameter | Type | Required | Description |
|---|
| chain_id | string | required | EVM chain ID string. Common values: "1" = Ethereum, "56" = BSC, "137" = Polygon, "8453" = Base, "43114" = Avalanche, "42161" = Arbitrum |
| contract_address | string | required | Token contract address to deep-scan (0x-prefixed EVM address, 42 chars) |
wallet-guard-rugpull-detection
[Security] Detect DeFi protocol rug-pull risk: liquidity lock status, admin mint/pause/blacklist privileges. Beta accuracy.
⚠️ Input: DEFI PROTOCOL CONTRACT. NOT for fungible tokens (→ wallet-guard-token-security); NOT for NFTs (→ wallet-guard-nft-security). [Read-Only]. [Reasoning: High].
Keywords: DeFi rug pull risk, liquidity locked check, owner mint pause blacklist power, can team rug
| Parameter | Type | Required | Description |
|---|
| chain_id | string | required | EVM chain ID string. Common values: "1" = Ethereum, "56" = BSC, "137" = Polygon, "8453" = Base, "43114" = Avalanche, "42161" = Arbitrum |
| contract_address | string | required | DeFi protocol contract address (0x-prefixed) |
meme-analyze
[Research] Analyze a meme token's 'wealth gene' — 4-dimensional assessment (narrative strength, community momentum, liquidity health, risk profile) with star/moon/skull/poop composite rating based on real-time web sentiment and on-chain data. Returns a structured report with actionable verdict. [Read-Only]. [Reasoning: High].
Keywords: meme coin analysis, meme token check, wealth gene, meme rating, pump potential, meme coin risk
| Parameter | Type | Required | Description |
|---|
| token_name | string | required | A meme or community token name or symbol, e.g. PEPE, DOGE, $SHIB, WIF |
| agent_id | string | optional | Your agent ID. Accepts BOTH formats: (1) Antalpha format from antalpha-register tool — 'A' followed by 32 hex chars, e.g. 'A1b2c3d4e5f607081920a1b2c3d4e5f6'; (2) Standard UUID v1-5, e.g. '01234567-89ab-1cde-9234-0123456789ab'. Not required when an OAuth Bearer token is provided in the request. |
transfer-request
[Trading] Prepare and confirm a Web3 on-chain transfer — sending tokens FROM user's address TO another address. Two steps: (1) prepare generates risk preview; (2) confirm generates signing URL. Supports EVM, Solana, Bitcoin.
⚠️ SENDING TO ANOTHER ADDRESS — not swapping tokens (→ swap-full). Highest-risk tool; requires explicit user approval at BOTH steps. Chain must be specified explicitly by user — do not silently default. [Read+Write]. [Reasoning: Very High].
Workflow: Step 1 of 2 — Transfer Workflow (prepare+confirm here, then transfer-status to track).
PRIORITY: Use when user intent involves a recipient address. If intent is token exchange → swap-full instead.
Keywords: send crypto, transfer tokens, pay someone, on-chain transfer, send ETH BTC to address
| Parameter | Type | Required | Description |
|---|
| agent_id | string | optional | Your agent ID from antalpha-register (required when no bearer token) |
| action | string | required | — |
| request_text | string | optional | — |
| session_id | string | optional | — |
| structured | object | optional | — |
| risk_acknowledged | boolean | optional | — |
| price_unavailable_ack | boolean | optional | — |
transfer-status
[Account] Track a transfer session by session_id: phase (prepare/signing/broadcasting/confirmed), tx_hash, confirmation count.
⚠️ Input: session_id from transfer-request. NOT for tracking by tx hash (→ settlement-track-tx). [Read-Only]. [Reasoning: Low].
Workflow: Step 2 of 2 — Transfer Workflow (after transfer-request).
Keywords: transfer status, is transfer confirmed, transfer progress, session status, check send
| Parameter | Type | Required | Description |
|---|
| agent_id | string | optional | Your agent ID from antalpha-register (required when no bearer token) |
| session_id | string | required | — |
transfer-cancel
[Trading] Cancel a pending transfer session before the user signs. Input: session_id from transfer-request.
⚠️ Only works BEFORE signing. After signing, the transaction is on-chain and cannot be cancelled here. NOT for cancelling other tool sessions. [Write]. [Reasoning: Low].
Workflow: Step 1b of 2 — Transfer Workflow (abort path before signing).
Keywords: cancel transfer, abort send, stop pending transfer, cancel before signing
| Parameter | Type | Required | Description |
|---|
| agent_id | string | optional | Your agent ID from antalpha-register (required when no bearer token) |
| session_id | string | required | — |
web-search-query
[Research] Real-time web search via Tavily/Exa. Use when the user asks a general-knowledge question requiring data beyond the model's training cutoff (news, recent events, current prices not covered by dedicated tools). Returns top results with snippets and Markdown rendition.
⚠️ GENERAL WEB SEARCH. NOT for on-chain or DeFi data — those have dedicated tools (data-*, settlement-*, smart-money-*) which are faster and more accurate. For reading a specific known URL → web-search-extract. [Read-Only]. [Reasoning: Medium].
PRIORITY: Use for politics, web3 news, finance, sports, pop culture, tech queries. For on-chain / DeFi data, prefer dedicated tools.
Keywords: web search, current news, recent events, latest information, real-time search, what happened
| Parameter | Type | Required | Description |
|---|
| query | string | required | Search query (3–200 chars). Plain text, no operators. |
| limit | integer | optional | Max results to return |
| backend | string | optional | Preferred backend; 'auto' picks based on query characteristics |
| includeDomains | array | optional | Restrict results to these domains (e.g. ['ethereum.org']) |
| excludeDomains | array | optional | Exclude these domains |
data-macro-cpi
No parameters required.
data-macro-nfp
No parameters required.
data-macro-m2
No parameters required.
data-macro-yield-spread
No parameters required.
data-macro-unemployment
No parameters required.
data-macro-sahm
No parameters required.
data-macro-fed-rate
No parameters required.
data-macro-all
[Market Data] Full US macro snapshot in one call. Returns LATEST values for 12 core indicators: cpi, nfp, m2, yieldSpread, unemployment, sahm, fedRate, sp500, vix, us10y, usd-broad, gold.
Optional `series` param selects a subset — use EXACT keys above, e.g. [“cpi”,“sp500",“us10y”]. Omit for all 12.
BTC/ETH are NOT included by default: add “btc”/“eth” to series, or call data-price-btc.
:warning: Use when user needs 2+ macro indicators. For a single indicator, prefer the sub-tool. [Read-Only]. [Reasoning: Low].
PRIORITY: Default when ≥2 macro indicators are needed.
Keywords: macro overview, economic indicators, macro snapshot, fed rate, cpi, sp500, treasury yield, gold
| Parameter | Type | Required | Description |
|---|
| series | array | optional | Indicator keys to return, e.g. ["cpi","sp500","btc"]. Omit for all 12 core indicators. |
data-market-pulse
[Market Data] Get a comprehensive crypto market overview in one call: BTC/ETH prices (updated every minute), Fear & Greed Index, BTC dominance, ETH/BTC ratio, and stablecoin market cap. This is the FIRST tool to call when asked about current market conditions. Optional params: include_eth (default true), include_sentiment (default true), include_structure (default true) — set to false to skip sections and reduce response size. [Read-Only]. [Reasoning: Low].
PRIORITY: Default entry for any market overview question. Use before drilling into specifics.
Keywords: market overview, BTC ETH price, fear greed index, BTC dominance, ETH/BTC ratio, stablecoin market cap, crypto market snapshot
| Parameter | Type | Required | Description |
|---|
| include_eth | boolean | optional | Include ETH price |
| include_sentiment | boolean | optional | Include Fear & Greed Index |
| include_structure | boolean | optional | Include BTC dominance, ETH/BTC ratio, stablecoin market cap |
data-btc-technicals
[Market Data] Get ALL BTC technical indicators in one call: RSI (14), MA200, MACD, Bollinger Bands, AHR999, Puell Multiple, plus 52-week range and ATH. Every indicator includes a pre-computed level label (e.g. RSI → oversold/neutral/overbought) so you don't need to apply thresholds yourself. Optional `indicators` param to select a subset (["rsi","ma200","macd","bollinger","ahr999","puell","levels"]) — omit for all. Requires current BTC price from cache internally. [Read-Only]. [Reasoning: Medium].
PRIORITY: Use when user asks about BTC technicals, price levels, or indicator values. For quick single-indicator lookup, use the shortcut tools (data-price-btc for MA200/52w, etc.).
Keywords: BTC technical indicators, RSI MA200 MACD, Bollinger bands, AHR999 Puell, 52 week range, ATH, crypto TA
| Parameter | Type | Required | Description |
|---|
| indicators | array | optional | Optional subset: ['rsi','ma200','macd','bollinger','ahr999','puell','levels']. Omit for all. |
data-btc-flow
[Market Data] Get BTC smart-money positioning in one call: ETF flows (M USD, inflow/outflow), exchange reserves (M BTC), Coinbase premium (premium/discount/neutral), and taker buy/sell ratio (buy_dominant/sell_dominant/neutral). Use this to understand institutional and whale directional bias. Optional `indicators` param to select a subset. For leverage and derivatives data, use data-btc-derivatives. For a quick ETF-only check, use the shortcut data-whale-* tools (if still registered). [Read-Only]. [Reasoning: Medium].
PRIORITY: Use when analyzing institutional flows and whale positioning.
Keywords: ETF flow, institutional flow, exchange reserve, Coinbase premium, taker ratio, whale positioning, BTC smart money
| Parameter | Type | Required | Description |
|---|
| indicators | array | optional | Optional subset: ['etf_flow','exchange_reserve','coinbase_premium','taker_ratio']. Omit for all. |
data-btc-derivatives
[Market Data] Get BTC derivatives market structure in one call: funding rate (neutral/high_positive/high_negative), futures premium (contango/backwardation/neutral), CEX & DEX open interest (B USD), 24h liquidations (M USD), and options max pain & OI. Use this to assess market leverage, positioning crowding, and liquidation risk. Optional `indicators` param to select a subset. For smart-money directional flow, use data-btc-flow. For a quick funding rate check only, use the shortcut data-sentiment-funding-btc. [Read-Only]. [Reasoning: Medium].
PRIORITY: Use when assessing leverage risk or derivatives market health.
Keywords: funding rate, futures premium, open interest, OI, liquidations, options max pain, derivatives leverage, BTC perp
| Parameter | Type | Required | Description |
|---|
| indicators | array | optional | Optional subset: ['funding_rate','futures_premium','cex_oi','dex_oi','liquidations','options_max_pain','options_oi']. Omit for all. |
data-defi
[Market Data] Get DeFi ecosystem overview in one call: total TVL across all chains, Ethereum TVL, DEX 24h trading volume, stETH yield (APY), stablecoin yield (APY), and top DeFi yield opportunities. Optional `categories` param to select a subset (["tvl","volume","yields"]) — omit for all. [Read-Only]. [Reasoning: Low].
PRIORITY: Default for any DeFi overview question. Use before drilling into specific protocols.
Keywords: DeFi TVL, total value locked, DEX volume, stETH yield, stablecoin yield, DeFi yields, Ethereum TVL
| Parameter | Type | Required | Description |
|---|
| categories | array | optional | Optional subset: ['tvl','volume','yields']. Omit for all. |
data-events
[Market Data] Get upcoming and recent on-chain events in one call: scheduled token unlocks and recent security incidents (hacks, exploits). Optional `types` param to select a subset (["unlocks","security"]) — omit for both. Note: token unlock data is currently a placeholder (P2) and may return empty results. For token unlock events only, use the shortcut data-event-token-unlock. [Read-Only]. [Reasoning: Low].
PRIORITY: Use for risk assessment and calendar-aware trading decisions.
Keywords: token unlock, vesting events, crypto hacks, security incidents, exploit losses, on-chain events
| Parameter | Type | Required | Description |
|---|
| types | array | optional | Optional subset: ['unlocks','security']. Omit for all. |
data-token-info
[Market Data] Query detailed token/project information by name or symbol. Returns price, market cap, 24h/7d/30d/1y changes, ATH/ATL, supply data, project description, categories, and contract addresses. Supports fuzzy name matching with candidate list. Uses Singleflight deduplication and 5-min Redis cache. [Read-Only]. [Reasoning: Medium].
Keywords: token info, coin lookup, project research, CoinGecko data, crypto token details, price market cap
| Parameter | Type | Required | Description |
|---|
| query | string | required | A token symbol or project name, e.g. HYPE, PEPE, $DOGE, Hyperliquid, Bitcoin |
data-price-btc
[Market Data] Get BTC real-time price in USD. Single-value fast lookup. ⚠️ Single-value lookup. For richer context (technical indicators, whale data) use data-btc-technicals or data-btc-flow. For CEX-sourced ticker → cex-market-get-ticker. [Read-Only]. [Reasoning: Low].
Keywords: Bitcoin BTC price, BTC/USD rate, Bitcoin quote, current BTC USD
| Parameter | Type | Required | Description |
|---|
| timezone | integer | optional | Integer UTC offset hours (-12 to +14) to format the timestamp. Omit for UTC. |
data-price-eth
[Market Data] Get ETH real-time price in USD. Single-value fast lookup. ⚠️ Single-value lookup. For richer context use data-market-pulse. For CEX-sourced ticker → cex-market-get-ticker. [Read-Only]. [Reasoning: Low].
Keywords: Ethereum ETH price, ETH/USD rate, Ethereum quote, current ETH USD
| Parameter | Type | Required | Description |
|---|
| timezone | integer | optional | Integer UTC offset hours (-12 to +14) to format the timestamp. Omit for UTC. |
data-sentiment-fng
[Market Data] Get Crypto Fear & Greed Index (0–100). 0 = Extreme Fear, 100 = Extreme Greed. Primary sentiment gauge for the overall crypto market. ⚠️ Single-value lookup. For comprehensive market overview including FNG, use data-market-pulse. [Read-Only]. [Reasoning: Low].
Keywords: fear greed index, FNG, market sentiment, crypto mood, extreme fear greed
No parameters required.
data-sentiment-funding-btc
[Market Data] Get the current BTC perpetual futures funding rate. Positive = longs paying shorts (bullish bias but crowded). Negative = shorts paying longs (bearish bias). Extreme values signal potential mean-reversion. ⚠️ Single-value lookup. For comprehensive derivatives data, use data-btc-derivatives. [Read-Only]. [Reasoning: Low].
Keywords: BTC funding rate, perp funding, longs paying shorts, funding fee, perpetual swap rate
No parameters required.
data-macro-vix
[Market Data] Get the VIX (CBOE Volatility Index) — the fear gauge for US equity markets. Elevated VIX (>20) signals broad market fear that spills into crypto. [Read-Only]. [Reasoning: Low].
Keywords: VIX, volatility index, fear gauge, equity fear, market panic indicator
No parameters required.
data-event-token-unlock
[Market Data] Get upcoming token unlock and vesting schedule events. Returns unlock dates, amounts, and affected tokens. High unlocks can signal near-term sell pressure. [Read-Only]. [Reasoning: Low].
Keywords: token unlock, vesting cliff, token release schedule, upcoming sell pressure, unlock calendar
No parameters required.
event-feed-list
[Research] Browse the curated Antalpha Event Feed: top-N heat-score-ranked prediction events across POLITICS / WEB3_FINANCE / SPORTS / CULTURE / TECH.
⚠️ Top-N CURATED events only — long-tail markets not included. For a specific market by name → poly-master-search-market. For volume-ranked trending → poly-trending. [Read-Only]. [Reasoning: Low].
Workflow: Step 1 of 3 — Event Feed Workflow (event-feed-list → event-feed-detail → event-feed-prompts).
PRIORITY: Use for curated heat-ranked discovery. For free-text market lookup → poly-master-search-market.
Keywords: hot events, trending prediction events, browse events, curated events, event feed list
| Parameter | Type | Required | Description |
|---|
| category | string | optional | Filter to one of POLITICS/WEB3_FINANCE/SPORTS/CULTURE/TECH; omit for all |
| keyword | string | optional | Optional title search. Space-separated tokens are matched case-insensitively against the English / Simplified / Traditional Chinese titles (all tokens first, then automatically any-token if nothing matches all). Prefer 1-2 DISTINCTIVE proper nouns from the user's message — team/person/asset names like 'Portugal' or '葡萄牙' — over generic words; titles mix languages (e.g. '葡萄牙能否夺得 2026 FIFA World Cup 冠军?'), so '世界杯' may not appear literally. Use this FIRST to resolve an event the user names in chat into its eventId, then pass that eventId to event-feed-detail / oracle-* tools — never guess or leave an eventId empty. |
| includeClosed | boolean | optional | Set true to also match closed/cancelled/expired (non-archived) events — retry with this when the user references a past or settled event and the default active-only search returns 0 hits. |
| page | integer | optional | 1-indexed page number |
| pageSize | integer | optional | Items per page (1–100) |
| sortBy | string | optional | Sort key: heatScore (default) / updatedAt / yesProb — all DESC |
| lang | string | optional | User language preference. Resolved to one of: zh-CN, zh-TW, en, ja, ko (default zh-CN). Accepts BCP-47 tags: `zh`, `zh-CN`, `zh-Hans` → zh-CN; `zh-TW`, `zh-HK`, `zh-Hant` → zh-TW; `en`, `en-US` → en. Localizes title / subTag / aiSummary / suggestedPrompts. |
event-feed-detail
[Research] Fetch the complete card for ONE event using a known eventId. Returns: heatScore, yesProb/noProb, trend data, AI summary, category metadata, and extensionData.deepAnalysis — a Digital Oracle structured report with layered market signals, resonance/divergence analysis, time-stratified outlook (0-7d / 7-30d / 30d+), scenario probability ranking, and conclusion with risk factors + monitoring signals.
⚠️ Input: EXACT eventId (from event-feed-list). Does NOT do fuzzy name matching — wrong tool if you only have a name (→ poly-master-search-market). deepAnalysis is pre-generated by backend cron every 2h — NOT real-time LLM. If absent or dataSummary is empty, tell user the analysis is not yet available (~2h cycle). [Read-Only]. [Reasoning: Medium].
Workflow: Step 2 of 2 — Event Feed Workflow (after event-feed-list returns an eventId). A single call returns everything — basic card info AND deep analysis. Use when user asks for event details, probability prediction, signal interpretation, or any combination thereof.
Keywords: event card detail, full event data, eventId fetch, heatScore event, prediction event card, deep analysis report, Digital Oracle, probability prediction, signal analysis, multi-source signals, scenario probability, event analysis, prediction market deep dive, Polymarket analysis, market signal interpretation
| Parameter | Type | Required | Description |
|---|
| event_id | string | required | Business-stable event id (e.g. 'poly:0x<64hex>' or 'btc-price-event') |
| lang | string | optional | User language preference. Resolved to one of: zh-CN, zh-TW, en, ja, ko (default zh-CN). Accepts BCP-47 tags: `zh`, `zh-CN`, `zh-Hans` → zh-CN; `zh-TW`, `zh-HK`, `zh-Hant` → zh-TW; `en`, `en-US` → en. Localizes title / subTag / aiSummary / suggestedPrompts. |
event-feed-prompts
[Research] Return 2–3 AI-generated follow-up question strings for a known eventId. For UI chip rendering only — returns strings, does NOT answer questions or return market data.
⚠️ UI HELPER ONLY — returns question text for display, not answers. Input: EXACT eventId. [Read-Only]. [Reasoning: Low].
Workflow: Step 3 of 3 — Event Feed Workflow (after event-feed-detail is displayed).
Keywords: follow-up questions, event prompt chips, suggested questions, next questions event
| Parameter | Type | Required | Description |
|---|
| event_id | string | required | Business-stable event id (e.g. 'poly:0x<64hex>' or 'btc-price-event') |
| lang | string | optional | User language preference. Resolved to one of: zh-CN, zh-TW, en, ja, ko (default zh-CN). Accepts BCP-47 tags: `zh`, `zh-CN`, `zh-Hans` → zh-CN; `zh-TW`, `zh-HK`, `zh-Hant` → zh-TW; `en`, `en-US` → en. Localizes title / subTag / aiSummary / suggestedPrompts. |
get_trade_quotes
[Trade Route] Aggregate A-class (in-app: 0x swap-full, 1inch smart-swap-create, HL hyperliquid-market-order/hyperliquid-limit-order) and B-class (off-platform: cex-spot-okx/binance, cex-futures-okx/binance) candidates for a normalized trade intent. Each candidate carries execution_engine in {execute_trade, hl, off_platform} so the agent trade-route-node can route to the correct dispatch (PRD v6.4 §2.3 D-1). Persists a quote_snapshot in Redis for subsequent execute_trade. [Read-Only].
| Parameter | Type | Required | Description |
|---|
| intent_fingerprint | string | required | Stable fingerprint of user intent (correlation only; not a secret). |
| intent_hash | string | required | Canonical hash of normalized TradeIntent; must match execute_trade. |
| scenario | string | required | High-level trade scenario derived by the agent (PRD v6.4 §2.1). |
| base_asset | string | required | Base asset symbol (e.g. BTC, ETH). |
| quote_asset | string | required | Quote asset symbol (e.g. USDT, USDC). |
| side | string | required | Order side. |
| amount | string | required | Human-readable amount string (e.g. "0.1"). |
| target_price | string | optional | Limit-order target price (decimal string), required for *_limit scenarios. |
| spot_inst_id | string | optional | [Deprecated v6.4] Override CEX instrument id. If omitted, derived from base_asset + quote_asset. |
execute_trade
[Trade Route] Execute a selected route after get_trade_quotes. Enforces whitelist, quote snapshot validity, and Redis idempotency. Only on-chain paths `swap-full` (0x) and `smart-swap-create` (1inch Fusion) are accepted; pass `execution` to build the signing preview (server does not custody private keys). HL paths are not whitelisted here — the agent dispatches them directly to hyperliquid-market-order / hyperliquid-limit-order (PRD v6.4 §2.3 D-1).
| Parameter | Type | Required | Description |
|---|
| path | string | required | Route path id (must match a quoted candidate). |
| idempotency_key | string | required | Client-generated idempotency key; stable across retries. |
| quote_snapshot_id | string | required | From get_trade_quotes response. |
| intent_hash | string | required | Must equal the intent_hash used for get_trade_quotes that produced the snapshot. |
| execution | object | optional | 0x: { sell_token, buy_token, sell_amount, taker, chain_id? }. 1inch Fusion: { sell_token, buy_token, sell_amount, target_price, wallet, expiry? }. Required for in-app swap routes. |