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.
wallet-revoke-page
[Security] Generate a browser-openable page to REVOKE the wallet's ERC-20 approvals by sending approve(spender,0) from the user's own wallet. Inputs: `address` (0x owner) and `chain_id` are all you need. `approvals` is OPTIONAL. The tool fetches the wallet's real on-chain ERC-20 approvals itself (Etherscan V2) and builds the page from those addresses — you do NOT need to supply or repeat token/spender addresses. Returns `preview_url` — hand it to the user as a clickable link; they open it, connect wallet, revoke each entry, and sign in their own wallet.
⚠️ Addresses are ALWAYS taken from the live on-chain scan, never from model input. The optional `approvals` list is only a display-label / filter hint: entries that do not exactly match an on-chain approval are ignored (reported in `dropped_approvals`), so a mistyped or reconstructed address can never end up in the signable page. The page can ONLY emit approve(spender,0) (sets allowance to 0, never transfers assets); calldata is server-locked and non-custodial (Nina never signs or holds keys). [Read+Write]. [Reasoning: Low].
PRIORITY: Use whenever the user wants to actually revoke / cancel / 撤销 / 取消授权 a dangerous approval — just pass the wallet address + chain_id. Preferred over directing the user to revoke.cash; fall back to revoke.cash / wallet built-in manager only if this tool is unavailable.
Keywords: revoke approval, cancel allowance, 撤销授权, 取消授权, one-click revoke page, approve spender 0, zero allowance, fix risky approval, 钱包授权撤销, hosted revoke signing page
| Parameter | Type | Required | Description |
|---|
| address | string | required | Owner wallet address (the approvals belong to this address) |
| chain_id | integer | required | EVM chain ID. Default 1 (Ethereum mainnet). |
| approvals | array | optional | OPTIONAL. Display-label / filter hint only — NOT the address source. The tool fetches real approvals on-chain; each hint must exactly match an on-chain (token, spender) pair or it is ignored. Omit to offer every ERC-20 approval on the chain. |
| hosted_url | string | optional | Optional URL shown in the page footer only |
jupiter-swap-tokens
| Parameter | Type | Required | Description |
|---|
| query | string | optional | 代币搜索词(symbol/名称/mint) |
| top | boolean | optional | true=返回 24h 交易量 Top 榜(选币器默认列表) |
| limit | integer | optional | 结果上限 |
xstock-pool-snapshot
| Parameter | Type | Required | Description |
|---|
| symbol | string | required | xStock symbol or mint (e.g. AAPLx) |
jupiter-swap-quote
| Parameter | Type | Required | Description |
|---|
| input_symbol | string | required | 卖出币 symbol 或 mint(如 USDC) |
| output_symbol | string | required | 买入币 symbol 或 mint(如 AAPLx) |
| amount | string | required | 卖出数量,最小单位(atomic) |
| slippage_bps | integer | optional | 滑点 bps,50=0.5% |
jupiter-trigger-list
| Parameter | Type | Required | Description |
|---|
| user | string | required | Solana wallet public key (base58) |
| status | string | optional | active = open orders (default) |
| page | integer | optional | — |
crosschain-swap-quote
| Parameter | Type | Required | Description |
|---|
| from_chain | integer | required | 源链数字 chainId(EVM 1/8453/42161/137/10;Solana=1151111081099710) |
| to_chain | integer | required | 目的链数字 chainId(同上;同链兑换时与 from_chain 相同) |
| from_token | string | required | 卖出币地址(EVM 0x…;Solana mint) |
| to_token | string | required | 买入币地址(EVM 0x…;Solana mint) |
| from_amount | string | required | 卖出数量,最小单位(atomic) |
| from_address | string | required | 发起(源链)钱包地址 |
| to_address | string | optional | 收款(目的链)地址;跨链尤其 EVM↔Solana 必传,缺省用 from_address |
| slippage | number | optional | 滑点,小数分数(0.005=0.5%) |
| notional_usd | number | optional | 本次兑换美元名义金额;用于金额分档路由(小额成本优先 / 大额≥门槛走可信桥白名单)。缺省/缺失=按小额处理(维持现状、不限桥)——大额若要走白名单保护,务必传本字段。 |
pfun-markets
Browse Predict.fun prediction markets (BNB Chain). view=list (default) lists markets; view=info fetches one market by id; view=search filters the list by question text.
| Parameter | Type | Required | Description |
|---|
| agent_id | string | optional | OPTIONAL authentication id — leave unset unless your operator explicitly gave you one; NEVER ask the user for it and never invent a value. Not needed when an OAuth Bearer token is provided or when calling through the Antalpha chat agent. 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'. |
| view | string | optional | list | info | search |
| market_id | string | optional | Market id (required for view=info) |
| query | string | optional | Text to match in the question (view=search) |
| cursor | string | optional | Pagination cursor from a previous page |
| limit | integer | optional | Max markets to return |
pfun-buy
Buy outcome shares on a Predict.fun market. Builds a limit order and returns a signing URL; the order is signed by the user's wallet (non-custodial) and then submitted.
| Parameter | Type | Required | Description |
|---|
| agent_id | string | optional | OPTIONAL authentication id — leave unset unless your operator explicitly gave you one; NEVER ask the user for it and never invent a value. Not needed when an OAuth Bearer token is provided or when calling through the Antalpha chat agent. 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'. |
| market_id | string | required | Predict.fun market id |
| outcome | string | required | Outcome to trade, e.g. 'Yes' / 'No' / a team name |
| price | number | required | Limit price per share in USDT (0-1) |
| shares | number | required | Number of outcome shares |
| wallet_address | string | required | User's EOA wallet address (BNB Smart Chain) |
| auth_token | string | optional | Predict.fun JWT minted by the agent for wallet_address (optional) |
pfun-sell
Sell outcome shares on a Predict.fun market. Builds a limit order and returns a signing URL; the order is signed by the user's wallet (non-custodial) and then submitted.
| Parameter | Type | Required | Description |
|---|
| agent_id | string | optional | OPTIONAL authentication id — leave unset unless your operator explicitly gave you one; NEVER ask the user for it and never invent a value. Not needed when an OAuth Bearer token is provided or when calling through the Antalpha chat agent. 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'. |
| market_id | string | required | Predict.fun market id |
| outcome | string | required | Outcome to trade, e.g. 'Yes' / 'No' / a team name |
| price | number | required | Limit price per share in USDT (0-1) |
| shares | number | required | Number of outcome shares |
| wallet_address | string | required | User's EOA wallet address (BNB Smart Chain) |
| auth_token | string | optional | Predict.fun JWT minted by the agent for wallet_address (optional) |
pfun-order-status
Check a Predict.fun order's signing/submission status by the order id from pfun-buy/pfun-sell.
| Parameter | Type | Required | Description |
|---|
| agent_id | string | optional | OPTIONAL authentication id — leave unset unless your operator explicitly gave you one; NEVER ask the user for it and never invent a value. Not needed when an OAuth Bearer token is provided or when calling through the Antalpha chat agent. 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'. |
| order_id | string | required | Order id returned by pfun-buy / pfun-sell |
hyperliquid-market
[Market Data] Hyperliquid perp market data — `view` selects the feed. view=price (default): mark price for one coin, a comma-separated list, or top-10 if coin omitted. view=book (needs coin): L2 order book (bids/asks with depth). view=funding: funding-rate board sorted by magnitude (single coin via coin, else market-wide).
⚠️ Hyperliquid perps only. For CEX (OKX/Binance) market data → cex-market-quote. [Read-Only]. [Reasoning: Low].
Keywords: Hyperliquid price, HL mark price, perp order book L2 depth, funding rate board, top funding rates, HL market data
| Parameter | Type | Required | Description |
|---|
| view | string | optional | price = mid price(s); book (needs coin) = L2 order book; funding = funding-rate board |
| coin | string | optional | price: single (ETH) or CSV (ETH,BTC,SOL), omit for top-10. book: required asset. funding: optional filter. |
| depth | integer | optional | Order book depth (view=book only) |
| limit | integer | optional | Number of funding rows (view=funding only) |
hyperliquid-account
Get Hyperliquid account summary: balances, positions, open orders.
| Parameter | Type | Required | Description |
|---|
| address | string | required | Wallet address (0x-prefixed 20-byte hex) |
hyperliquid-orders
Get open orders for a Hyperliquid account.
| Parameter | Type | Required | Description |
|---|
| address | string | required | Wallet address (0x-prefixed 20-byte hex) |
hyperliquid-positions
Get open perp positions for a Hyperliquid account.
| Parameter | Type | Required | Description |
|---|
| address | string | required | Wallet address (0x-prefixed 20-byte hex) |
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-prefixed 20-byte hex) |
| 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 (view=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) |
| fresh | boolean | optional | Bypass the server-side balance cache and read the chain RPC directly (result still refreshes the cache). Use right after a transaction when the post-trade balance must be observed; omit for normal reads. |
wallet-activity-query
Fetch EVM wallet transaction history (sends, receives, trades, approvals) across all supported chains via DeBank. Returns up to 20 entries per page; use next_start_time to paginate to older entries.
| Parameter | Type | Required | Description |
|---|
| address | string | required | EVM wallet address (0x followed by 40 hex characters) |
| start_time | integer | optional | Unix timestamp (seconds) to fetch history older than this point. Omit for the most recent page. |
cex-market-quote
[Market Data] Public market data for OKX / Binance — `view` selects the feed. view=ticker (default): real-time last price, 24h high/low, 24h volume, best bid/ask. view=kline: OHLCV candlesticks at a given interval/limit (1h/4h/daily…). view=orderbook: live bids/asks with depth, for slippage estimation before large orders.
⚠️ 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". Never pass a raw ticker like "INJ" to OKX. [Read-Only]. [Reasoning: Low].
Keywords: CEX ticker last price, 24h change volume, best bid ask, candlestick OHLCV kline, 1h 4h daily candles, price history, order book bids asks, market depth, slippage estimation
| Parameter | Type | Required | Description |
|---|
| exchange | string | optional | Target exchange. Defaults to 'okx' for backward compatibility. |
| view | string | optional | ticker = latest price/24h stats; kline = OHLC candles; orderbook = bids/asks depth |
| 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".
Convert user-mentioned symbols before calling: "INJ" → "INJ-USDT" (OKX) or "INJUSDT" (Binance).
If the pair is listed as a perpetual only (no spot), the tool retries the -SWAP contract automatically and flags it via `note` in the response. |
| 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 (view=kline only; default 100, max 300) |
| depth | integer | optional | Order book depth per side (view=orderbook only; 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 (view=summary). [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
[Account] Read a CEX account (OKX or Binance) — `view` selects granularity. view=balance (default): PER-CURRENCY breakdown — available (tradable) and frozen (in-order) per asset. view=summary: ACCOUNT-LEVEL snapshot — total equity (USD), unrealized PnL, net available, frozen balance. Requires API keys.
⚠️ 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: view=balance for 'how much USDT/BTC do I have on the exchange'; view=summary for 'what is my total account value'.
Keywords: CEX per-currency balance, available frozen split, how much USDT do I have, total equity, account summary, net balance, unrealized PnL, exchange portfolio overview
| Parameter | Type | Required | Description |
|---|
| exchange | string | optional | Target exchange. Defaults to 'okx' for backward compatibility. |
| view | string | optional | balance = per-currency available/frozen/total; summary = equity/PnL/available/frozen totals |
cex-setup-check
[Account] Check whether CEX API credentials are already configured. Returns ready / not-ready status.
⚠️ READ-ONLY status check. [Read-Only]. [Reasoning: Low].
Keywords: is API already configured, exchange connection status, credentials exist, setup complete
No parameters required.
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
[Crypto · Market Data] Ranked list of crypto tokens by social activity (AltRank — composite of social volume × market performance), from LunarCrush. Crypto market ONLY — this lists crypto tokens, not stocks, equities or indices.
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
[Crypto · Market Data] Social sentiment for ONE crypto token/coin (e.g. BTC, ETH, SOL), from LunarCrush social data. Crypto assets ONLY — NOT for stocks, equities, ETFs or indices (e.g. AAPL, NVDA, SK Hynix / 000660.KQ). For stock/equity sentiment this tool does not apply; do not pass stock tickers here.
Returns: sentiment (0-100), galaxy_score (0-100 overall health), social_volume_24h, bullish_summary, signal_level (HIGH/MEDIUM/LOW). Input: symbol (required, a crypto symbol, e.g. "BTC"), time_range ("24h"|"7d", default "24h" — label only, data always reflects the 24h window).
If the token has no social coverage (or the symbol is not a crypto asset), 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 | Data window: "24h" (live snapshot) or "7d" (7-day aggregate). Genuinely selects the window. |
crypto-kol-signals
[Crypto · Market Data] Who is discussing ONE crypto token and what they're saying, from LunarCrush. Crypto tokens ONLY — NOT for stocks, equities, ETFs or indices (e.g. AAPL, NVDA, SK Hynix / 000660.KQ); do not pass stock tickers here.
Returns: top_creators[] (platform, username, followers per creator), top_news[] (title, url, creator per item), sentiment, social_dominance, signal_level.
Input: symbol (required, a crypto symbol, e.g. "BTC"), time_range ("24h"|"7d", default "24h" — label only, data always reflects the 24h window).
If the token has no social coverage (or the symbol is not a crypto asset), 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) |
crypto-mention-surge
[Crypto · Market Data] Detect crypto tokens with sudden social attention shifts (AltRank jumps), from LunarCrush. Crypto market ONLY — scans crypto tokens, not stocks, equities or indices.
Returns per token: rank_change (positive = rising), alt_rank + alt_rank_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 |
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 | optional | OPTIONAL. Leave EMPTY when the user does not explicitly name a chain — the tool then auto-detects which chain the contract/token lives on (do NOT assume Ethereum for a bare 0x address). Only set it when the user names a chain. EVM chain ID string. Common values: "1" = Ethereum, "56" = BSC, "137" = Polygon, "8453" = Base, "43114" = Avalanche, "42161" = Arbitrum |
| token | string | optional | Token to screen: a contract address (0x-prefixed, 42 chars) OR a symbol/name (e.g. USDC, PEPE). A symbol is resolved to the official contract; an address is also checked for impersonation of a known ticker. When chain_id is omitted the chain is auto-detected. |
| contract_address | string | optional | Alias for `token` (contract address or symbol/name). |
wallet-tx-history
Transaction profile for a wallet from on-chain history: type distribution, distinct counterparty count, possible-spam count, and lifetime span. Read-only; scans a bounded recent sample. EVM only.
| Parameter | Type | Required | Description |
|---|
| address | string | required | Wallet address — raw 0x EVM address only (no ENS / domains). |
| chain_id | string | optional | EVM chain ID (1=Ethereum, 56=BSC, 137=Polygon, 8453=Base). Supported: 1, 56, 137, 8453. Default "1". |
| max_tx | integer | optional | Max recent transactions to scan (default 100, capped at 300). |
wallet-pnl
Realized PnL / ROI / win rate / traded counts + top tokens for a wallet over a date window (Nansen). Meaningful for DEX-trading wallets. Read-only.
| Parameter | Type | Required | Description |
|---|
| address | string | required | Wallet address — raw 0x EVM address only (no ENS / domains). |
| chain_id | string | optional | EVM chain ID (1=Ethereum, 56=BSC, 137=Polygon, 8453=Base). Supported: 1, 56, 137, 8453. Default "1". |
| date_from | string | optional | Window bound (YYYY-MM-DD). Optional; defaults to the last ~90 days. |
| date_to | string | optional | Window bound (YYYY-MM-DD). Optional; defaults to the last ~90 days. |
wallet-counterparties
Labeled top counterparties for a wallet over a date window (Nansen): entity / smart-money labels, total volume, in/out direction, tokens. Read-only; deep add-on to wallet-tx-history (which already gives the counterparty count).
| Parameter | Type | Required | Description |
|---|
| address | string | required | Wallet address — raw 0x EVM address only (no ENS / domains). |
| chain_id | string | optional | EVM chain ID (1=Ethereum, 56=BSC, 137=Polygon, 8453=Base). Supported: 1, 56, 137, 8453. Default "1". |
| date_from | string | optional | Window bound (YYYY-MM-DD). Optional; defaults to the last ~90 days. |
| date_to | string | optional | Window bound (YYYY-MM-DD). Optional; defaults to the last ~90 days. |
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 | OPTIONAL authentication id — leave unset unless your operator explicitly gave you one; NEVER ask the user for it and never invent a value. Not needed when an OAuth Bearer token is provided or when calling through the Antalpha chat agent. 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'. |
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 | OPTIONAL authentication id — leave unset unless your operator explicitly gave you one; NEVER ask the user for it and never invent a value. Not needed when an OAuth Bearer token is provided or when calling through the Antalpha chat agent. 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'. |
| 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 | OPTIONAL authentication id — leave unset unless your operator explicitly gave you one; NEVER ask the user for it and never invent a value. Not needed when an OAuth Bearer token is provided or when calling through the Antalpha chat agent. 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'. |
| 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 | OPTIONAL authentication id — leave unset unless your operator explicitly gave you one; NEVER ask the user for it and never invent a value. Not needed when an OAuth Bearer token is provided or when calling through the Antalpha chat agent. 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'. |
| 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 |
| includeDomains | array | optional | Restrict results to these domains (e.g. ['ethereum.org']) |
| excludeDomains | array | optional | Exclude these domains |
| recency | string | optional | Time window for time-sensitive queries. Pass for 'today/now/latest results' (→ day), 'this week / recent' (→ week), 'latest proposals / past month' (→ month). Omit for evergreen/conceptual queries. |
| country | string | optional | Boost results from a specific country. Lowercase English country name (e.g. 'united states', 'japan'). Only meaningful for region-specific queries; omit for global topics. Ignored when recency is set. |
research-financial-comparison
[Present] Submit a multi-year financial comparison table for SEC 20-F / 10-K style due diligence. Does NOT fetch data — you must already have extracted numbers from document slices. Call once BEFORE final_answer when the user needs cross-year revenue / net income / operating cash flow / debt balance (or similar) aligned in one table. Every non-null value requires a source (metric.source or per-cell source). Keywords: financial comparison, multi-year, 20-F, 10-K, revenue, net income, cash flow, debt. [Read-Only]. [Reasoning: Low].
| Parameter | Type | Required | Description |
|---|
| title | string | optional | Card title, e.g. 三年财务对照 |
| entity | string | optional | Company / issuer name |
| currency | string | optional | Reporting currency, e.g. USD |
| years | array | required | Column headers in render order, e.g. ["2023","2024","2025"] |
| metrics | array | required | One row per financial metric |
| generated_at | string | optional | ISO timestamp; server fills if omitted |
| source_meta | object | optional | Document-level provenance (SEC EDGAR / Form 20-F / …) |
| footnotes | array | optional | Optional footnotes shown under the table |
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-macro-all
[Market Data] Full US macro snapshot in one call. Returns LATEST values for 13 core indicators: cpi, nfp, m2, yieldSpread, unemployment, sahm, fedRate, sp500, nasdaq, vix, us10y, dxy, gold. Use `series` param with EXACT keys above to select a subset, e.g. ["cpi","sp500","nasdaq"]. Omit series for all 13.
BTC/ETH price NOT included by default — add "btc"/"eth" to series when needed.
PRIORITY: Default when the user asks about macro indicators — this is the only macro tool, supporting both single-indicator and multi-indicator queries.
[Read-Only]. [Reasoning: Low].
Keywords: macro overview, economic indicators, macro snapshot, fed rate, cpi, sp500, nasdaq, 纳斯达克, treasury yield, gold, vix
| Parameter | Type | Required | Description |
|---|
| series | array | optional | Indicator keys to return, e.g. ["cpi","sp500","nasdaq"]. 13 core (default): cpi, nfp, m2, yieldSpread, unemployment, sahm, fedRate, sp500, nasdaq, vix, us10y, dxy, gold. Optional extras: silver, wti, btc, eth. Omit to get all 13 core (extras excluded by default). |
data-token-info
[Market Data] Look up any crypto token or project by symbol or name (e.g. HYPE, PEPE, Hyperliquid). Returns price, 24h–1y performance, market cap, FDV, volume, ATH, supply, TVL (DeFi tokens), project intro, homepage, contract addresses, community sentiment, and top venues. Returns a candidate list when the symbol is ambiguous.
⚠️ Input must be a token symbol or name — NOT a wallet address or tx hash. NOT for meme ratings (→ meme-analyze), wallet/contract risk (→ wallet-guard-address-security), token security audits (→ wallet-guard-token-deep-scan), or single-pair tickers (→ cex-market-quote (view=ticker)). For a DeFi protocol's TVL/fees use data-defi-protocol; for market-wide DeFi structure use data-onchain-defi. [Read-Only]. [Reasoning: Low].
Keywords: token lookup, coin info, project intro, what is this project, what does this coin do, circulating supply, FDV, fully diluted valuation, ATH all-time high, contract address, homepage, market cap rank, altcoin info, HYPE PEPE SOL DOGE token info
| Parameter | Type | Required | Description |
|---|
| query | string | required | A token symbol or project name, e.g. HYPE, PEPE, $DOGE, Hyperliquid, Bitcoin |
data-defi-protocol
[Market Data] Look up ONE specific DeFi protocol by name or slug (e.g. morpho, aave, aave-v3). Returns a protocol overview: category, chains, short description, current TVL with 30-day trend, market cap, FDV, and 24h / 7d / 30d fees and revenue. When the name matches multiple protocols it returns a candidate list to disambiguate.
⚠️ Per-protocol on-chain fundamentals (TVL / fees / revenue / category / chains). For the protocol's TOKEN price / market cap / supply → data-token-info; for all-chain DeFi TVL aggregate → data-structure-defi-tvl; for DeFi yield-product discovery → investor_discover; for rug-pull / contract risk → wallet-guard-rugpull-detection. Input: a protocol NAME or slug, NOT a token symbol or wallet address. [Read-Only]. [Reasoning: Low].
Keywords: DeFi protocol fundamentals, TVL, total value locked, protocol fees, protocol revenue, market cap, FDV, chains, category, protocol overview, morpho aave compound
| Parameter | Type | Required | Description |
|---|
| protocol | string | required | Protocol name or slug, e.g. morpho, aave, aave-v3 |
| fields | array | optional | Optional subset of fields to include: tvl, fees, chains, mcap, description |
data-technicals
[Market Data] Get price-based technical indicators for an asset: RSI (14), MA200 (+ deviation %), MACD, Bollinger Bands, plus 52-week high/low range and ATH (with distance). Each indicator includes a pre-computed level label. BTC is always available (incl. the 52-week / ATH anchors); other liquid assets (e.g. ETH, SOL) are computed on-demand from CoinGecko OHLC — for those the 52-week / ATH `levels` are BTC-only. Optional `indicators` subset (['rsi','ma200','macd','bollinger','levels']) — omit for all. `indicators` ONLY supports the 200-day MA as `ma200`; do NOT pass any other maNN (e.g. ma20 / ma7 / ma50) here. Optional `ma_periods` (number[], in days, e.g. [20] or [7,30,60], 2–200, ≤8): custom-period daily moving averages returned under `indicators.moving_averages` — use THIS (not `indicators`) for EVERY specific-period average the user names, e.g. "20MA / 30-day MA / 近30日均价 / MA7"; never substitute MA200. [Read-Only]. [Reasoning: Low].
PRIORITY: Default for "technical indicators / RSI / MA / MA20 / MA50 / MA200 / MACD / Bollinger / 52-week position" on any liquid asset. For on-chain valuation (AHR999, Puell) use data-onchain-valuation. Illiquid / unknown tokens → cex-market-quote (OHLCV/klines) or data-token-info (token overview).
Keywords: RSI, MA200, MA7, MA20, MA30, MA50, 20MA, moving average, 20日均线, 30日均价, MACD, Bollinger Bands, technical indicators, 52-week high low, ATH, all-time high, overbought, oversold, technical analysis, TA, ETH technicals, SOL technicals, altcoin RSI
| Parameter | Type | Required | Description |
|---|
| asset | string | optional | Asset symbol, e.g. btc / eth / sol. Omit for btc. |
| indicators | array | optional | Optional subset: ['rsi','ma200','macd','bollinger','levels']. Omit for all. |
| ma_periods | array | optional | Custom simple-moving-average periods in DAYS, e.g. [30] for the 30-day average, [7,30,60] for several. 2–200 days (bounded by 200d of daily history), up to 8 periods. Returned under indicators.moving_averages as {period,value,deviation_pct,level,available}; a period beyond available history is flagged available:false rather than substituted. Omit for none. |
data-onchain-valuation
[Market Data] Get on-chain valuation indicators: whether BTC is over/undervalued based on on-chain data — AHR999 (DCA valuation) and Puell Multiple (miner-revenue valuation), each with a pre-computed level label. Optional `indicators` subset (['ahr999','puell']) — omit for all. [Read-Only]. [Reasoning: Low].
PRIORITY: Default for "is BTC cheap/expensive on-chain / accumulation zone / miner valuation". AHR999/Puell are BTC-specific on-chain metrics. For price-based technical indicators (RSI/MACD/Bollinger) use data-technicals; for assets not covered, use data-token-info (token overview).
Keywords: AHR999, Puell Multiple, on-chain valuation, BTC valuation, overvalued, undervalued, accumulation zone, DCA index, miner revenue, cycle position
| Parameter | Type | Required | Description |
|---|
| asset | string | required | Asset symbol. Currently only 'btc' is supported. |
| indicators | array | optional | Optional subset: ['ahr999','puell']. Omit for all (btc). |
data-derivatives
[Market Data] Get CEX derivatives market structure for an asset: funding rate, futures premium (annualized basis), aggregated cross-exchange open interest (cex_oi; Coinglass total), liquidations, options max pain & open interest. Two OPT-IN per-exchange drill-downs (request explicitly in `metrics`): funding_by_exchange — each exchange's funding + cross-exchange spread for arbitrage; oi_by_exchange — per-exchange OI breakdown + venue concentration. BTC is always available; other liquid assets (e.g. ETH, SOL, XRP) are fetched on-demand. Options (max pain / OI) are BTC-only. Assess leverage, positioning crowding, liquidation risk. Optional `metrics` subset — omit for all standard aggregates (the two by_exchange drill-downs return only when explicitly listed). [Read-Only]. [Reasoning: Low].
PRIORITY: Default for leverage / positioning / liquidation-risk questions on any liquid asset, and for cross-exchange funding arbitrage or per-exchange OI concentration. For on-chain DEX open interest use data-onchain-defi; for spot/smart-money flow use data-flows. Illiquid / unknown tokens → data-token-info (token overview).
Keywords: funding rate, futures premium, basis, contango, backwardation, open interest, OI, CEX OI, liquidations, options max pain, options open interest, leverage, derivatives, positioning, ETH derivatives, SOL derivatives, altcoin funding, cross-exchange funding, funding arbitrage, funding spread, per-exchange OI, OI concentration
| Parameter | Type | Required | Description |
|---|
| asset | string | optional | Asset symbol, e.g. btc / eth / sol. Omit for btc. |
| metrics | array | optional | Optional subset of the standard aggregates (funding_rate, futures_premium, cex_oi, liquidations, options_max_pain, options_oi); omit for all of them. The per-exchange drill-downs funding_by_exchange / oi_by_exchange are OPT-IN — returned ONLY when explicitly listed here, never by default. |
data-funding-scan
[Market Data] Scan the WHOLE crypto market for cross-exchange perpetual funding-rate dislocations — the screener behind funding-arbitrage discovery. No asset argument; ranks every symbol in the funding feed. sort='spread' (default) = widest cross-exchange gap (top venue − bottom venue, eq8h %); sort='high' = most positive funding (crowded longs); sort='low' = most negative (crowded shorts). Each row carries the top/bottom venue + rate, exchange_count, both_legs_earn, arbitrageable, extreme_legs and excluded_outliers. eq8h extrapolates the current rate and the spread is gross (pre-fees) — a signal, not risk-free profit. [Read-Only]. [Reasoning: Low].
PRIORITY: Default for market-wide funding screening when NO specific asset is named. For ONE named asset's per-exchange funding breakdown or full derivatives card → data-derivatives.
Keywords: funding rate scan, cross-exchange funding, funding arbitrage, funding spread, highest funding, most negative funding, crowded longs, crowded shorts, perp funding screener, market-wide funding
| Parameter | Type | Required | Description |
|---|
| top_n | integer | optional | How many ranked symbols to return. Default 10. |
| sort | string | optional | Ranking dimension. 'spread' (default) = widest cross-exchange funding gap (arbitrage); 'high' = most positive funding; 'low' = most negative funding. |
| min_exchanges | integer | optional | Only include symbols quoted on at least this many exchanges. Default 2 (minimum for a spread). |
| exclude_stablecoins | boolean | optional | Drop stablecoins / pegged assets (no meaningful funding signal). Default true. |
data-onchain-defi
[Market Data] Get on-chain DeFi/DEX market structure in one call: total DeFi TVL (all chains + Ethereum), DEX 24h volume, on-chain DEX open interest, and DeFi yield benchmarks (stETH APY, stablecoin avg APY). Market-level structural data. Optional `metrics` subset (['defi_tvl','dex_volume','dex_oi','yield_benchmark']) — omit for all. [Read-Only]. [Reasoning: Low].
PRIORITY: Default for any DeFi/DEX market-level overview. For a specific protocol's TVL/fees/revenue use data-defi-protocol; to discover/compare specific yield products use investor_discover; for CEX derivatives use data-derivatives.
Keywords: DeFi TVL, total value locked, DEX volume, DEX open interest, on-chain OI, stETH yield, stablecoin yield, yield benchmark, Ethereum TVL, DeFi overview
| Parameter | Type | Required | Description |
|---|
| metrics | array | optional | Optional subset: ['defi_tvl','dex_volume','dex_oi','yield_benchmark']. Omit (or 'all') for all. |
data-flows
[Market Data] Get off-chain / market money flow for BTC: spot ETF net flow, Coinbase premium (US institutional bias), and taker buy/sell ratio. OPT-IN per-exchange drill-down (request explicitly in `metrics`): taker_by_exchange — per-exchange taker buy/sell over a 4h window (taker_ratio is the current aggregate ratio; taker_by_exchange is the per-exchange breakdown, and unlike the other metrics it also covers non-BTC liquid assets on-demand). Gauge institutional and spot-market directional bias. Optional `metrics` subset (['etf_flow','coinbase_premium','taker_ratio','taker_by_exchange']) — omit for all standard aggregates (taker_by_exchange returns only when explicitly listed). [Read-Only]. [Reasoning: Low].
PRIORITY: Default for "are institutions buying / spot-market directional bias", and for per-exchange taker / which exchange is buying. For total stablecoin market cap use data-market-structure; for on-chain exchange reserves use data-onchain-flows; for leverage/funding/open interest use data-derivatives. For assets not covered, use cex-market-quote (price) or data-token-info (token overview).
Keywords: ETF flow, ETF net flow, spot ETF, Coinbase premium, taker buy sell ratio, institutional flow, spot flow, smart money flow, directional bias, per-exchange taker, taker by exchange
| Parameter | Type | Required | Description |
|---|
| asset | string | optional | Asset symbol. btc (default); non-BTC liquid assets are supported only for taker_by_exchange. |
| metrics | array | optional | Optional subset of the standard metrics (etf_flow, coinbase_premium, taker_ratio); omit for all. taker_by_exchange is OPT-IN — returned ONLY when explicitly listed, never by default. |
data-onchain-flows
[Market Data] Get on-chain flow / supply-side indicators for an asset (currently BTC): exchange reserve (total coins held on exchanges — falling reserves imply accumulation / reduced sell pressure). Optional `metrics` (['exchange_reserve']) — omit for all. [Read-Only]. [Reasoning: Low].
PRIORITY: Default for exchange-reserve / sell-pressure / accumulation questions. For off-chain market flow (spot ETF, Coinbase premium, taker ratio) use data-flows. For assets not covered by this tool, use cex-market-quote (view=kline) (price) or data-token-info (token overview).
Keywords: exchange reserve, exchange balance, coins on exchanges, BTC on exchanges, sell pressure, accumulation, outflow, on-chain supply, reserves
| Parameter | Type | Required | Description |
|---|
| asset | string | optional | Asset symbol for exchange_reserve: 'btc' or 'eth' (default btc). Other assets (e.g. sol, bnb) are not covered and return an explicit note. Ignored for stablecoin_exchange_inflow (cross-chain aggregate). |
| metrics | array | optional | Optional subset. Omit for all available metrics. |
data-market-structure
[Market Data] Get crypto market structure / relative-strength indicators: BTC dominance (BTC share of total crypto market cap), ETH/BTC ratio (ETH relative strength), and total stablecoin market cap (structural liquidity / dry powder). Market-composition metrics, not quotes. Optional `metrics` subset (['btc_dominance','eth_btc','stablecoin_mcap']) — omit for all. [Read-Only]. [Reasoning: Low].
PRIORITY: Default for "altseason / BTC dominance trend / stablecoin dry powder". For asset prices use data-price; for money flow (spot ETF, Coinbase premium, taker ratio) use data-flows.
Keywords: BTC dominance, bitcoin dominance, altcoin season, altseason, ETH/BTC ratio, ETH relative strength, stablecoin market cap, stablecoin supply, dry powder, market structure
| Parameter | Type | Required | Description |
|---|
| metrics | array | optional | Optional subset: ['btc_dominance','eth_btc','stablecoin_mcap','stablecoin_supply_change']. Omit (or 'all') for all. |
data-coin-cap-ranking
Get the top N cryptocurrencies ranked by market capitalization (largest first), each with price, market cap, 24h & 7d change, and 24h volume. `limit` chooses how many (1–100, default 10). This is the market-cap leaderboard for questions like "top 10 coins / 市值前十 / largest cryptocurrencies". The ranking is as CoinGecko reports it, so it includes stablecoins (USDT/USDC) and wrapped/RWA tokens — they rank by market cap too. For ONE named coin's details (price, FDV, supply, rank) use data-token-info; for social/trending hype (which is NOT market cap) use crypto-social-trending; for BTC dominance or total stablecoin market cap use data-market-structure.
| Parameter | Type | Required | Description |
|---|
| limit | integer | optional | How many top coins to return, ranked by market cap. 1–100, default 10. |
data-price
[Market Data] BTC/ETH are always available (prefetched); other tokens (bnb, sol, xrp, doge, ada, etc.) are fetched on-demand. Get crypto price quotes. asset='btc' → BTC price + valuation/level anchors (MA200, RSI, AHR999, 52-week high/low, ATH under `levels`); asset='eth' → ETH price; on-demand tokens get price only (no level anchors); omit asset → BTC price; pass an array (e.g. ['btc','eth','sol']) → per-asset price list. Judge high/low ONLY from the level anchors — a null field means the anchor is unavailable, so say the level is unknown rather than guessing. [Read-Only]. [Reasoning: Low].
PRIORITY: Default for any crypto price question. For market structure (BTC dominance, ETH/BTC ratio, stablecoin market cap) use data-market-structure; for full technical analysis use data-technicals.
Keywords: BTC price, ETH price, crypto price, coin price, MA200, RSI, AHR999, 52-week high low, ATH, all-time high, price level, how much is bitcoin, BNB price, SOL price, XRP price, DOGE price
| Parameter | Type | Required | Description |
|---|
| asset | | optional | Asset symbol(s): btc / eth / bnb / sol / xrp / ... . Single symbol → detailed card; array → price list. Omit for btc. BTC/ETH are prefetched; others fetched on-demand. |
| metrics | array | optional | Optional subset. Default: single asset → ['price','levels']; multiple → ['price']. 'levels' applies to BTC only. |
| timezone | integer | optional | Integer UTC offset hours (-12 to +14) to format timestamps. Omit for UTC. |
data-sentiment
[Market Data] Get crypto market sentiment — the Crypto Fear & Greed Index (0-100; 0=Extreme Fear, 100=Extreme Greed). Pass `days` (1-30) to also get recent F&G history + trend (improving/worsening/stable) + signal level. Optional `metrics` (['fng']) — omit for all. [Read-Only]. [Reasoning: Low].
PRIORITY: Default for market-sentiment / fear-and-greed questions. For social sentiment (trending coins, KOL signals, mention surge) use the crypto-* tools; for funding rate / futures premium use data-derivatives.
Keywords: Fear and Greed Index, FNG, fear greed, market sentiment, crypto sentiment, sentiment trend, extreme fear, extreme greed, market mood
| Parameter | Type | Required | Description |
|---|
| metrics | array | optional | Optional subset. Currently only 'fng'. Omit (or 'all') for all. |
| days | number | optional | Daily F&G history points to also return (1-30). Trend & signal level are ALWAYS included regardless; this only adds the raw daily history array. |
data-event-token-unlock
[Market Data] Get upcoming token unlock events in the next 30 days, ranked by USD value, sourced from DefiLlama. Per event returns: token symbol, project name, unlock amount, USD value, date, and unlock size as % of max supply. Large cliff unlocks can signal near-term sell pressure. [Read-Only]. [Reasoning: Low].
Keywords: token unlock, vesting cliff, token release schedule, upcoming sell pressure, unlock calendar, unlock amount USD, percent of supply, cliff unlock, linear unlock, next 30 days unlocks
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-markets (view=search). For volume-ranked trending → poly-markets (view=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-markets (view=search).
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. |
| lite | boolean | optional | Lean list mode (default true). When true, each item returns ONLY the header fields needed for discovery / sorting / comparison tables — eventId, title, category, subTag, heatScore, yesProb, noProb, participantCount, commentCount, updatedAt — and OMITS the heavy per-card fields (description, aiSummary, trendGraphData, extensionData incl. deepAnalysis, suggestedPrompts, detailPreview). Keep it true for event discovery and building yes-prob comparison tables, then fetch the heavy fields for the ONE card you care about via event-feed-detail. Set false only if you genuinely need every field inline for many cards at once — rarely needed and the response is an order of magnitude larger (a SPORTS page can exceed 190 KB and get truncated). |
| 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 copied verbatim from a prior tool result (event-feed-list,
poly-master-search-market, etc.). poly:0x<hex> IDs are cryptographic hashes — they CANNOT
be inferred from event names or user input. DO NOT guess or construct the eventId. If you
do not yet have an eventId, call event-feed-list with keyword first.
Does NOT do fuzzy name matching — wrong tool if you only have a name (→ poly-markets).
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
Fetch and compare executable trade-route quotes for a single spot/futures trade intent across all supported venues in one call. Given a normalized trade intent (base/quote asset, side, amount, and one of scenarios: spot_market, spot_limit, futures_market, futures_limit; target_price required for *_limit), it queries on-chain DEX aggregators (0x, 1inch Fusion), Hyperliquid, and CEX tickers (OKX, Binance) in parallel and returns ranked candidates, each carrying route path id, estimated price, fees, USD notional, and execution metadata (in-app executable vs off-platform redirect, speed/risk/confidence). It also persists a short-lived quote snapshot and returns a quote_snapshot_id that must be passed to execute_trade. Read-only: places no orders. Call this first, before execute_trade, whenever the user wants to trade and you need price discovery or route comparison. Pass the same intent_hash to the later execute_trade call so quote and execution stay bound.
| 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
Execute a previously quoted on-chain trade route by producing a non-custodial browser signing page — never signs or custodies user keys server-side. Takes a route path id from a get_trade_quotes candidate plus its quote_snapshot_id, the matching intent_hash, and a client idempotency_key. Only on-chain DEX paths are supported: swap-full (0x swap) and smart-swap-create (1inch Fusion limit/swap); Hyperliquid and CEX routes are rejected here (Hyperliquid must be routed via hyperliquid-sign-trade / hyperliquid order tools, CEX is off-platform). Validates the quote snapshot (freshness, intent_hash, and issuing-user binding) and enforces idempotency to prevent duplicate submissions, then builds the signing payload and returns a preview_url that the user opens to review and sign the transaction in their own wallet, plus an execution_state and order_ref. Call only after get_trade_quotes, using a candidate whose path is in-app executable.
| 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. |
us-stock-financials
[Research] Financials of a tokenized US stock: earnings calendar (next_report_date, days_to_earnings) + recent beat_rate, revenue & revenue_cagr, gross/net margins, valuation (pe + historical pe_percentile, pb, ev_ebitda), financial quality (ROE/ROIC, ROIC-vs-WACC spread, FCF yield, leverage, Piotroski/Altman, quality verdict), base-case DCF intrinsic value & upside, plus optional last-8-quarters revenue sequence with YoY growth (include_quarters=true).
Accepts ticker / name / token symbol. Judge cheap/expensive ONLY from pe_percentile (0-100); null = unknown, do NOT guess. Numbers pre-computed.
PRIORITY: Use when the user asks specifically about valuation, earnings, fundamentals, or financial quality/moat of one stock. For DCF intrinsic value or assumption what-ifs use us-stock-dcf; for a full single-stock readout use us-stock-bundle.
[Read-Only]. [Reasoning: Low].
Keywords: valuation, PE, PB, EV/EBITDA, earnings, days to earnings, revenue growth, margins, beat rate, fundamentals, ROE, ROIC, FCF yield, Piotroski, Altman Z, quality, moat, DCF, intrinsic value, quarters, quarterly revenue
| Parameter | Type | Required | Description |
|---|
| input | string | required | ticker / 名称 / token,如 NVDA / 英伟达 / NVDAx |
| include_quarters | boolean | optional | 是否返回近8季营收/利润序列(会增加 text 长度) |
us-stock-technicals
[Research] Price performance & technicals of a tokenized US stock, from EOD adjusted prices (NOT real-time). Returns 1W/1M/3M/6M/1Y/YTD returns, 52-week high/low & position, MA50/MA200 relation, annualized volatility, 1Y max drawdown. Accepts ticker / name / token symbol. null = insufficient history.
PRIORITY: Use when the user asks about price performance, returns, trend, or risk of one stock. For a full single-stock readout use us-stock-bundle. This is NOT a real-time quote tool.
[Read-Only]. [Reasoning: Low].
Keywords: performance, returns, YTD, 52-week, moving average, MA50 MA200, volatility, max drawdown, technicals
| Parameter | Type | Required | Description |
|---|
| input | string | required | ticker / 名称 / token,如 NVDA / 英伟达 / NVDAx |
us-stock-onchain
[Research] On-chain premium/discount of a tokenized US stock vs its underlying, per platform, with where to buy / which chain. Returns platforms[] with token_symbol, chain, premium_pct, premium_mode, confidence, is_outlier. The differentiated web3 layer. Accepts ticker / name / token symbol. Read premium_mode: realtime = same-instant premium (US market open); offset = token vs the LAST close (off-hours), NOT a same-instant premium and partly overnight drift — don't treat it as a real liquidity premium (see underlying_close_date). confidence: high=realtime, low=offset, medium=bitget_reality@realtime. source_meta.dataAvailability: ok=realtime, stale=offset, no_data=no platform / not a US stock. Outside US market hours (incl. nights/weekends) low+stale is EXPECTED (comparison vs last close), NOT a data outage or source degradation; high+ok only during market hours with a fresh underlying quote. is_outlier=true = suspected anomaly (FX lag / thin liquidity), not a real signal. Empty = unavailable; on-chain exists for in-pool names only.
PRIORITY: Use when the user asks about the tokenized / on-chain side — premium or discount, where to buy, which chain. The only on-chain tool.
[Read-Only]. [Reasoning: Low].
Keywords: on-chain premium, discount, tokenized stock, xStocks, where to buy, which chain, premium discount, realtime vs offset
| Parameter | Type | Required | Description |
|---|
| input | string | required | ticker / 名称 / token,如 NVDA / 英伟达 / NVDAx |
us-stock-sector
[Research] US sector overview: whole-market GICS sector P/E & recent performance (FMP aggregate, NOT pool-limited) plus which pool stocks are tokenizable on-chain in that sector. sector_pe_rank / sector_ranking are sorted by P/E ASCENDING — rank 1 = lowest P/E = cheapest (payload carries rank_order="pe_asc"). Pass the user's raw words (e.g. semiconductors, financials); the tool maps to a GICS sector internally. matched=false ⇒ no standard sector ⇒ it's a theme (AI, robotics) → use web-search instead.
PRIORITY: Default for sector- or industry-level questions. Do NOT use for a single named stock — use us-stock-bundle for that.
[Read-Only]. [Reasoning: Low].
Keywords: sector, industry, GICS, sector PE, semiconductors, technology, financials, sector performance
| Parameter | Type | Required | Description |
|---|
| query | string | required | 用户原话,如 半导体 / 科技 / semiconductors / financial |
us-stock-bundle
[Research] One-shot single-stock bundle — the primary path for analyzing one tokenized US stock. Returns identity, valuation (pe + pe_percentile, pb, ps, ev_ebitda), financial quality verdict (ROIC vs WACC, Piotroski, Altman) + base-case DCF intrinsic value & upside, performance (1W/1M/3M/6M/1Y, 52-week position, MA50-vs-200), key resistance/support, next earnings & days_to_earnings, on-chain premium, profile (segments, peers, analyst targets), and verdict (tri-score technical/fundamental + PE/DCF valuation dual-axis). Accepts ticker / name / token symbol. In-pool served from pre-stored data; out-of-pool is a live lite view (no on-chain). EOD prices, not real-time. Judge cheap/expensive ONLY from pe_percentile.
PRIORITY: Default for any single-stock question. Use financials / technicals / onchain only when the user asks about one specific dimension; use us-stock-dcf for DCF intrinsic value or assumption what-ifs; use us-stock-sector for industry-level queries.
[Read-Only]. [Reasoning: Low].
Keywords: stock analysis, tokenized stock, single stock overview, valuation, quality, moat, ROIC, DCF, intrinsic value, earnings, performance, on-chain premium, peers, analyst target, verdict, tri-score, PE axis, DCF axis
| Parameter | Type | Required | Description |
|---|
| input | string | required | ticker / 名称 / token,如 NVDA / 英伟达 / NVDAx |
us-stock-dcf
[Research] DCF intrinsic value of a tokenized US stock: base-case intrinsic value & upside-vs-price, key assumptions (WACC / perpetual growth / revenue growth), terminal-value share, a bear/base/bull band, and a 3-lever sensitivity (revenue / discount / terminal) marking the main driver. Optionally override assumptions: revenue_growth_pct (live recompute), terminal_growth_pct & discount_rate_pct (instant, local); perpetual growth is auto-clamped below WACC. Banks / insurance / capital-markets are flagged not-applicable (no FCF-DCF). EOD prices. unavailable/null = do NOT guess.
PRIORITY: Use when the user asks what a stock is worth / intrinsic / fair value, or wants to adjust DCF assumptions (what-if). For relative cheap-or-expensive (PE percentile) use us-stock-financials; for a full readout use us-stock-bundle.
[Read-Only]. [Reasoning: Low].
Keywords: DCF, intrinsic value, fair value, discounted cash flow, WACC, terminal growth, upside, bear base bull, what-if, sensitivity
| Parameter | Type | Required | Description |
|---|
| input | string | required | ticker / 名称 / token,如 NVDA / 英伟达 / NVDAx |
| revenue_growth_pct | number | optional | 预测期年化营收增速假设%(覆盖 FMP 全部预测年份;改它触发一次实时重算) |
| terminal_growth_pct | number | optional | 永续增长率%,0–6,须显著低于折现率(否则自动钳制) |
| discount_rate_pct | number | optional | 折现率/WACC%,5–30 |
us-stock-consensus
[Research] Analyst consensus for one tokenized US stock: rating (strong-buy/buy/hold/sell/strong-sell) with analyst count, average price target & upside/downside %, forward estimates (EPS/revenue next quarter & fiscal year), revision trend (last month/quarter/year avg + direction), and recent analyst actions (firm, new target, title, date). Pre-computed from DB-stored analyst data; in-pool only.
Accepts ticker / name / token symbol.
PRIORITY: Use when the user asks about analyst ratings, price targets, Wall Street consensus, or earnings estimates. For actual reported earnings or financial quality use us-stock-financials; for a full single-stock readout use us-stock-bundle.
[Read-Only]. [Reasoning: Low].
Keywords: analyst, consensus, rating, price target, strong buy, buy, hold, sell, EPS estimate, revenue estimate, Wall Street, forward estimates, revision
| Parameter | Type | Required | Description |
|---|
| input | string | required | ticker / 名称 / token,如 NVDA / 英伟达 / NVDAx |
us-stock-events
[Research] Stock event feed for one tokenized US stock: recent news (title, source, sentiment sentiment label/confidence) + SEC filings (8-K, 10-K, 10-Q, etc. with form_type and URL), merged and reverse-chronological within a 90-day window. Sentiment only shown at high confidence (>=0.85, aligned with radar page). Returns top N headlines in text + full event list in structuredContent. In-pool only (DB-backed); out-of-pool returns empty.
Accepts ticker / name / token symbol.
PRIORITY: Use when the user asks about recent news, events, SEC filings, or what's happening with a stock. For earnings dates or financial fundamentals use us-stock-financials; for a full single-stock readout use us-stock-bundle.
[Read-Only]. [Reasoning: Low].
Keywords: news, events, SEC filing, 8-K, 10-K, 10-Q, sentiment, headlines, announcements, corporate events
| Parameter | Type | Required | Description |
|---|
| input | string | required | ticker / 名称 / token,如 NVDA / 英伟达 / NVDAx |
| limit | number | optional | 返回条数(默认 20) |
us-stock-radar-scores
[Research] Radar map scores for one tokenized US stock: momentum_score (pool percentile 0-100, 50=pool median, higher=stronger momentum), opp_score (opportunity percentile 0-100, 50=pool median), core_score (absolute composite, NOT percentile), rs_20d (stock − SPY 20-day excess return in pp), and rank_delta (prev rank − current rank, positive=moved up). Includes pool context (pool_rank / pool_size) from the current published snapshot run. Data comes from pre-computed metrics_snapshot table (no external calls). as_of is the snapshot trade date, caliber=daily.
Accepts ticker / name / token symbol.
PRIORITY: Use when the user asks "how strong is this stock in the radar map", "what's its momentum rank", "is it in the top quadrant", or "how does it compare to SPY recently". For full single-stock readout use us-stock-bundle; for sector-level ranking use us-stock-sector.
[Read-Only]. [Reasoning: Low].
Keywords: radar, scoring, momentum, opportunity, core score, percentile, ranking, relative strength, rs_20d, rank delta, pool rank, quadrant
| Parameter | Type | Required | Description |
|---|
| input | string | required | ticker / 名称 / token,如 NVDA / 英伟达 / NVDAx |
us-stock-smart-money
[Research] Smart-money / chip-side data for one tokenized US stock, by type: insiders=insider Form4 buys/sells last 90 days (P-Purchase buy, S-Sale sell, net summary + top transactions); beneficial=13D/G blockholder filings last 180 days (>5% ownership, subject-CIK filtered for direction); institutions=13F institutional holdings latest quarter (top 15 holders + summary: institution count, QoQ change, top adds/cuts). DB-backed, no external calls.
Accepts ticker / name / token symbol.
PRIORITY: Use when the user asks "who is buying/selling", "insider transactions", "institutional holdings", "13F", "blockholder", or "smart money flow". For full single-stock readout use us-stock-bundle; for real order-flow imbalance use us-stock-order-flow.
[Read-Only]. [Reasoning: Low].
Keywords: smart money, insider trading, Form 4, 13D, 13G, 13F, institutional holdings, blockholder, beneficial ownership, insider buys, insider sells, chip side, Vanguard, BlackRock
| Parameter | Type | Required | Description |
|---|
| input | string | required | ticker / 名称 / token,如 NVDA / 英伟达 / NVDAx |
| type | string | required | 数据类型 |
us-stock-order-flow
[Research] Real order-flow imbalance (lit market, tick-test directional) for one tokenized US stock: trade imbalance in USD, as % of volume, and as % of total eligible volume. Daily frequency, sourced from published snapshot run's daily_flow row. Positive = buyer-dominated, negative = seller-dominated. This is objective market microstructure data — NOT a scoring signal and does NOT feed into verdict.chips. Distinct from us-stock-technicals money_flow which is price-volume derived.
Accepts ticker / name / token symbol.
PRIORITY: Use when the user asks about "real order flow", "buy/sell imbalance", "who is dominating", "lit flow", or "tick test". For insider/institutional flow use us-stock-smart-money; for price-volume-derived money flow use us-stock-technicals.
[Read-Only]. [Reasoning: Low].
Keywords: order flow, trade imbalance, lit market, tick test, buy sell imbalance, flow imbalance, microstructure, buyer dominated, seller dominated
| Parameter | Type | Required | Description |
|---|
| input | string | required | ticker / 名称 / token,如 NVDA / 英伟达 / NVDAx |
us-stock-onchain-liquidity
[Research] On-chain liquidity for one tokenized US stock: TVL, 24h volume, holder count, token market cap, tradable tier (ample/thin/illiquid), and DEX pool info (dex, pool name, address). Sourced from GeckoTerminal + Jupiter, 30-min refresh. Fields showing as null/? mean upstream data unavailable (NOT zero liquidity — has_pool=0 or has_catalog=0 flags suppress false zeros). Distinct from us-stock-onchain which checks premium/discount vs underlying.
Accepts ticker / name / token symbol.
PRIORITY: Use when the user asks about "on-chain depth", "can I trade this token", "DEX liquidity", "TVL", "holder count", or "where to buy". For premium/discount vs stock price use us-stock-onchain; for full single-stock readout use us-stock-bundle.
[Read-Only]. [Reasoning: Low].
Keywords: on-chain liquidity, TVL, DEX, holder count, tradable, GeckoTerminal, Jupiter, pool, market depth, onchain, Solana, token liquidity
| Parameter | Type | Required | Description |
|---|
| input | string | required | ticker / 名称 / token,如 NVDA / 英伟达 / NVDAx |
oracle-match-search
[Research] Find a specific 2026 FIFA World Cup MATCH (single fixture, e.g. 'Portugal vs Croatia') by team names and return its event_id (wc2026_<fixtureId>). Returns matching fixtures with event_id, kickoff, stage, status, team names/flags and a nina_probability hint (the authoritative four-source win probabilities come from oracle-event-detail). Team names in any language; widen window to 'all' for matches >7 days out. [Read-Only]. [Reasoning: Low].
Workflow: Step 1 of 2 — WC2026 single-match (oracle-match-search → oracle-event-detail for the four-source win probabilities).
PRIORITY: Entry point for "A vs B, who wins / analyze this game" on a single World Cup fixture. For championship / advancement / props markets → event-feed-list.
Keywords: world cup match search, find fixture by teams, Portugal vs Croatia, who will win match, single match lookup, wc2026 fixture id, resolve match event id
| Parameter | Type | Required | Description |
|---|
| teams | array | optional | Team names to narrow the search, any supported language (e.g. ['葡萄牙','克罗地亚'] or ['Portugal','Croatia']). Omit to list all matches in the window. |
| window | string | optional | Time window from today. Default '7d'. Use 'all' to search the whole tournament. |
| include_resolved | boolean | optional | Include already-finished matches. Default false (upcoming/in-play only). |
| lang | string | optional | Language for the returned team names. Match the user's message language. |
oracle-event-detail
[Research] Complete detail card for ONE 2026 FIFA World Cup MATCH (single fixture): four-source home/draw/away WIN PROBABILITIES (our model / Polymarket / Pinnacle / Betfair) + max divergence, plus ELO, FIFA rank, H2H, weather, venue, stage and kickoff. The quantitative core for "who will win / analyze this match".
⚠️ Input: EXACT event_id in wc2026_<fixtureId> format from oracle-match-search. Resolves World Cup fixtures ONLY — does NOT accept Polymarket poly:0x ids, slugs or event names. Have a poly:0x id → event-feed-detail; have only team names → oracle-match-search first. [Read-Only]. [Reasoning: Medium].
Workflow: Step 2 of 2 — WC2026 single-match (oracle-match-search → oracle-event-detail).
Keywords: world cup match detail, match win probability, home draw away odds, four-source probabilities, Pinnacle Betfair odds, ELO H2H weather, wc2026 fixture, who will win this match
| Parameter | Type | Required | Description |
|---|
| event_id | string | optional | Real event id copied from a prior result — 'poly:0x<64hex>' from event-feed-list / event-feed-detail (prediction markets), or 'wc2026_<fixtureId>' from oracle-match-search (a single World Cup match). Never empty, never guessed, never the event title — resolve it via the matching search tool first. |