AntalphaAntalpha

MCP Tools Reference

Complete reference for all tools available on the Antalpha MCP Node. AI agents can connect via the Model Context Protocol to use these tools programmatically.

Server URL
https://mcp-skills.ai.antalpha.com/mcp
Transport
Streamable HTTP / SSE
Protocol
MCP (JSON-RPC 2.0)
Tools Available
136

Quick Start

  1. Connect to the MCP server at https://mcp-skills.ai.antalpha.com/mcp
  2. Send initialize to establish a session
  3. Send notifications/initialized
  4. Call tools/list to discover tools, or tools/call to invoke a tool

Authentication

Call antalpha-register (no parameters) to receive an agent_id and api_key. Include the api_key in the HTTP header x-antalpha-agent-api-key on all subsequent requests when authentication is enabled.

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 risky ERC-20 approvals by sending approve(spender,0) from the user's own wallet. Inputs: `address` (0x owner), `chain_id` (default "1"), `approvals` (list of {token, spender, token_symbol?, spender_label?}). 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. ⚠️ This is the REVOKE/fix action, NOT a scanner — first find risky approvals with wallet-guard-approval-security (→), then pass that wallet + the flagged token/spender pairs here. 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. 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

ParameterTypeRequiredDescription
addressstringrequiredOwner wallet address (the approvals belong to this address)
chain_idintegerrequiredEVM chain ID. Default 1 (Ethereum mainnet).
approvalsarrayrequiredRisky approvals to offer for revocation (one row per token+spender)
hosted_urlstringoptionalOptional URL shown in the page footer only

hyperliquid-sign-trade

ParameterTypeRequiredDescription
actionstringrequired
ownerstringoptional
coinstringoptional
sidestringoptional
order_typestringoptional
sizenumberoptional
pricenumberoptional
slippagenumberoptional
reduce_onlybooleanoptional
leverageintegeroptional
is_crossbooleanoptional
trigger_pricenumberoptional
tpslstringoptional
is_buybooleanoptional
oidintegeroptional
agent_addressstringoptional
signature_chain_idstringoptional
valid_until_msnumberoptional
signed_actionobjectoptional
noncenumberoptional
signaturestringoptional

hyperliquid-price

Get Hyperliquid asset price(s). Omit coin for top-10 prices.

ParameterTypeRequiredDescription
coinstringoptionalSingle asset name (e.g. ETH). For multiple assets pass comma-separated: "ETH,BTC,SOL". Omit for top-10.

hyperliquid-account

Get Hyperliquid account summary: balances, positions, open orders.

ParameterTypeRequiredDescription
addressstringrequiredWallet address (0x...)

hyperliquid-book

Get L2 order book for a Hyperliquid perp asset.

ParameterTypeRequiredDescription
coinstringrequiredAsset name (e.g. ETH)
depthintegeroptionalBook depth

hyperliquid-orders

Get open orders for a Hyperliquid account.

ParameterTypeRequiredDescription
addressstringrequiredWallet address

hyperliquid-positions

Get open perp positions for a Hyperliquid account.

ParameterTypeRequiredDescription
addressstringrequiredWallet address

hyperliquid-funding

Get funding rates for Hyperliquid perp assets, sorted by magnitude.

ParameterTypeRequiredDescription
limitintegeroptionalNumber of results
coinstringoptionalFilter to a single coin (e.g. ETH); omit for the market-wide board

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.

ParameterTypeRequiredDescription
addressstringrequiredWallet address (0x...)
coinstringrequiredAsset to trade (e.g. ETH, BTC)
sizenumberrequiredPlanned order size in asset units
pricenumberrequiredPlanned order price in USD
leverageintegeroptionalLeverage (default: 1, perp only)
order_typestringoptionalspot = Spot balance only; perp = Perp+Spot combined; auto = detect automatically
is_buybooleanoptionaltrue = 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.

ParameterTypeRequiredDescription
agent_keystringrequiredAgent wallet private key (0x...)
ownerstringrequiredOwner wallet address (0x...)
coinstringrequiredAsset name (e.g. ETH, BTC)
sidestringrequiredOrder side
pricenumberrequiredLimit price in USD
sizenumberrequiredOrder size in asset units
tifstringoptionalTime-in-force
reduce_onlybooleanoptionalReduce-only order

hyperliquid-market-order

Place a market order on Hyperliquid. Requires agent_key and owner address.

ParameterTypeRequiredDescription
agent_keystringrequiredAgent wallet private key (0x...)
ownerstringrequiredOwner wallet address (0x...)
coinstringrequiredAsset name
sidestringrequiredOrder side
sizenumberrequiredOrder size
slippagenumberoptionalMax slippage (0.01 = 1%)

hyperliquid-close

Close an existing position at market price. Requires agent_key and owner.

ParameterTypeRequiredDescription
agent_keystringrequiredAgent wallet private key (0x...)
ownerstringrequiredOwner wallet address (0x...)
coinstringrequiredAsset to close
slippagenumberoptionalMax slippage

hyperliquid-cancel

Cancel an open order on Hyperliquid.

ParameterTypeRequiredDescription
agent_keystringrequiredAgent wallet private key (0x...)
ownerstringrequiredOwner wallet address (0x...)
coinstringrequiredAsset name
oidintegerrequiredOrder ID to cancel

hyperliquid-leverage

Set leverage for a Hyperliquid perp asset.

ParameterTypeRequiredDescription
agent_keystringrequiredAgent wallet private key (0x...)
ownerstringrequiredOwner wallet address (0x...)
coinstringrequiredAsset name
leverageintegerrequiredLeverage multiplier
modestringoptionalMargin mode

hyperliquid-tp-sl

Place a take-profit or stop-loss trigger order on Hyperliquid.

ParameterTypeRequiredDescription
agent_keystringrequiredAgent wallet private key (0x...)
ownerstringrequiredOwner wallet address (0x...)
coinstringrequiredAsset name
typestringrequiredtp = take-profit, sl = stop-loss
sidestringrequiredOrder side when triggered
trigger_pricenumberrequiredTrigger price in USD
sizenumberrequiredOrder size

hyperliquid-modify-order

Atomically modify an existing order on Hyperliquid (change price and/or size).

ParameterTypeRequiredDescription
agent_keystringrequiredAgent wallet private key (0x...)
ownerstringrequiredOwner wallet address (0x...)
coinstringrequiredAsset name (e.g. ETH)
oidintegerrequiredOrder ID to modify
sidestringrequiredOrder side
pricenumberrequiredNew limit price in USD
sizenumberrequiredNew order size
tifstringoptionalTime-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

ParameterTypeRequiredDescription
api_keystringrequiredNonce 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

ParameterTypeRequiredDescription
api_keystringrequiredNonce 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

ParameterTypeRequiredDescription
api_keystringrequiredNonce 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

ParameterTypeRequiredDescription
api_keystringrequiredNonce API key
farm_idstringrequiredFarm 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

ParameterTypeRequiredDescription
api_keystringrequiredNonce API key
farm_idstringrequiredFarm ID
from_datestringoptionalStart date ISO8601 (e.g. 2025-01-01)
to_datestringoptionalEnd 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

ParameterTypeRequiredDescription
api_keystringrequiredNonce API key
farm_idstringrequiredFarm 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

ParameterTypeRequiredDescription
api_keystringrequiredNonce API key
miner_idstringrequiredMiner ID
from_datestringoptionalStart date ISO8601
to_datestringoptionalEnd 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

ParameterTypeRequiredDescription
api_keystringrequiredNonce API key
miner_idstringrequiredMiner 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

ParameterTypeRequiredDescription
api_keystringrequiredNonce API key
farm_idstringrequiredFarm ID
pageintegeroptionalPage number
page_sizeintegeroptionalItems 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

ParameterTypeRequiredDescription
api_keystringrequiredNonce API key
farm_idstringrequiredFarm ID
task_namestringrequiredTask type to execute
miner_idsarrayrequiredList of miner IDs to apply task to
paramsobjectoptionalTask-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

ParameterTypeRequiredDescription
api_keystringrequiredNonce API key
task_batch_idstringrequiredTask batch ID from easy-mining-create-task-batch

wallet-balance-query

[Account] Query native token balance for a wallet address across all supported blockchains. Auto-detects chain from address format (EVM 0x / BTC / SOL). ⚠️ ON-CHAIN SELF-CUSTODY wallets only (MetaMask, cold wallets, any 0x/BTC/SOL address). For CEX exchange account balances → cex-account-get-balance. [Read-Only]. [Reasoning: Low]. Keywords: wallet balance, on-chain balance, check address balance, 0x balance, BTC wallet balance, SOL balance

ParameterTypeRequiredDescription
addressstringrequiredWallet address (chain auto-detected from format)

cex-market-get-ticker

[Market Data] Get real-time ticker for an instrument: last price, 24h high/low, 24h volume, best bid/ask. ⚠️ CEX exchange price. For standalone BTC/ETH price without CEX context → data-price-btc / data-price-eth. instId MUST use exchange-native hyphen format — OKX: "INJ-USDT" (spot) / "INJ-USDT-SWAP" (perp); Binance: "INJUSDT" (spot) / "INJUSDT" (perp). Never pass raw ticker like "INJ" or "INJUSDT" to OKX. [Read-Only]. [Reasoning: Low]. Keywords: CEX ticker, last price, 24h change, 24h volume, best bid ask, real-time exchange price

ParameterTypeRequiredDescription
exchangestringoptionalTarget exchange. Defaults to 'okx' for backward compatibility.
instIdstringrequiredInstrument ID in exchange-native format. OKX (default): hyphen-separated, e.g. "INJ-USDT" (spot), "BTC-USDT-SWAP" (perp). Binance: concatenated, e.g. "INJUSDT" (spot), "INJUSDT" (perp). Convert user-mentioned symbols before calling: "INJ" → "INJ-USDT" (OKX) or "INJUSDT" (Binance).

cex-market-get-kline

[Market Data] Get OHLCV (open/high/low/close/volume) candlestick data for any instrument at a given interval. Supports multiple timeframes. [Read-Only]. [Reasoning: Low]. Keywords: candlestick, OHLCV, price history, kline, 1h 4h daily candles, historical price chart

ParameterTypeRequiredDescription
exchangestringoptionalTarget exchange. Defaults to 'okx' for backward compatibility.
instIdstringrequiredInstrument ID, e.g. BTC-USDT-SWAP
intervalstringoptionalK-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.
limitintegeroptionalNumber of candles (default 100, max 300)

cex-market-get-orderbook

[Market Data] Get the live order book (bids and asks with depth) for an instrument. Use for slippage estimation before placing large orders. [Read-Only]. [Reasoning: Low]. Keywords: order book, bids asks, market depth, buy wall sell wall, depth chart, slippage estimation

ParameterTypeRequiredDescription
exchangestringoptionalTarget exchange. Defaults to 'okx' for backward compatibility.
instIdstringrequiredInstrument ID
depthintegeroptionalOrder book depth per side (default 20)

cex-market-get-instruments

[Market Data] Get the full list of available trading instruments (spot pairs and futures contracts) on the connected CEX. Use to resolve valid instrument IDs before placing orders. [Read-Only]. [Reasoning: Low]. Keywords: trading pairs, instrument list, available markets, futures contracts, spot pairs on exchange

ParameterTypeRequiredDescription
exchangestringoptionalTarget exchange. Defaults to 'okx' for backward compatibility.
instTypestringoptionalInstrument 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

ParameterTypeRequiredDescription
exchangestringoptionalTarget exchange. Defaults to 'okx' for backward compatibility.
instIdstringrequiredInstrument ID, e.g. BTC-USDT
sidestringrequiredOrder side
ordTypestringrequiredOrder type
szstringrequiredOrder size in base currency
pxstringoptionalOrder price (required for limit orders)
quoteOrderQtystringoptionalQuote 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

ParameterTypeRequiredDescription
exchangestringoptionalTarget exchange. Defaults to 'okx' for backward compatibility.
instIdstringrequiredInstrument ID
orderIdstringrequiredOrder 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

ParameterTypeRequiredDescription
exchangestringoptionalTarget exchange. Defaults to 'okx' for backward compatibility.
instIdstringoptional交易对,如 ETH-USDT。Binance 侧未传 instId 时接口直接返回空数组(非报错)。OKX 可省略以查全市场挂单(仅 pending 接口时慎用)。
statestringoptionalOKX:不传时只查当前挂单 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

ParameterTypeRequiredDescription
exchangestringoptionalTarget exchange. Defaults to 'okx' for backward compatibility.
instIdstringrequiredInstrument ID, e.g. BTC-USDT-SWAP
actionstringoptionalSemantic action — use instead of side+posSide for clarity
sidestringoptionalExplicit order side (use with posSide)
posSidestringoptionalPosition side for hedge mode (use with side)
ordTypestringrequiredOrder type
szstringrequiredOrder size (contracts for OKX; base currency qty for Binance e.g. 0.01 BTC)
pxstringoptionalOrder price (required for limit orders)
leverageintegerrequiredLeverage multiplier
mgnModestringrequiredMargin mode
reduceOnlybooleanoptionalReduce-only flag
clientOrderIdstringoptionalCustom 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

ParameterTypeRequiredDescription
exchangestringoptionalTarget exchange. Defaults to 'okx' for backward compatibility.
instIdstringrequiredInstrument ID, e.g. BTC-USDT-SWAP
orderIdstringrequiredOrder ID to cancel

cex-futures-get-positions

[Account] Get open futures/perpetual positions with margin health, liquidation risk flags, and unrealized PnL. ⚠️ FUTURES POSITIONS only. For spot order history → cex-spot-get-orders. For account-level summary → cex-account-get-info. [Read-Only]. [Reasoning: Medium]. Keywords: my futures positions, margin health, liquidation price, unrealized PnL futures, am I near liquidation

ParameterTypeRequiredDescription
exchangestringoptionalTarget exchange. Defaults to 'okx' for backward compatibility.
instIdstringoptionalFilter 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

ParameterTypeRequiredDescription
exchangestringoptionalTarget exchange. Defaults to 'okx' for backward compatibility.
instIdstringrequiredInstrument ID, e.g. BTC-USDT-SWAP
leverageintegerrequiredLeverage multiplier
mgnModestringrequiredMargin 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

ParameterTypeRequiredDescription
exchangestringoptionalTarget exchange. Defaults to 'okx' for backward compatibility.
instIdstringrequiredInstrument ID, e.g. BTC-USDT-SWAP
posSidestringoptionalPosition side for hedge mode: 'long' closes long leg, 'short' closes short leg. Omit for net/one-way mode.

cex-account-get-balance

[Account] Get detailed per-currency balance breakdown for the connected CEX account. Returns available (tradable) and frozen (in-order) amounts for each asset. Requires API keys. ⚠️ Difference from cex-account-get-info: this returns PER-CURRENCY detail; cex-account-get-info returns ACCOUNT-LEVEL totals (equity, PnL). Difference from wallet-balance-query: this queries a CEX custodial account; wallet-balance-query queries a self-custody on-chain address. [Read-Only]. [Reasoning: Low]. PRIORITY: Use when user asks 'how much USDT / BTC do I have on the exchange'. For account-level total → cex-account-get-info. Keywords: CEX per-currency balance, available frozen split, how much USDT do I have, exchange holdings, asset-by-asset balance

ParameterTypeRequiredDescription
exchangestringoptionalTarget exchange. Defaults to 'okx' for backward compatibility.

cex-account-get-info

[Account] Get CEX account summary: total equity (USD), unrealized PnL, net available balance, frozen balance. Single-call portfolio snapshot. Requires API keys. ⚠️ Difference from cex-account-get-balance: this returns ACCOUNT-LEVEL totals; cex-account-get-balance returns PER-CURRENCY detail. [Read-Only]. [Reasoning: Low]. PRIORITY: Use when user asks 'what is my total account value'. For per-currency breakdown → cex-account-get-balance. Keywords: total equity, account summary, net balance, unrealized PnL, exchange portfolio overview, total account value

ParameterTypeRequiredDescription
exchangestringoptionalTarget exchange. Defaults to 'okx' for backward compatibility.

cex-setup-check

[Account] Check whether CEX API credentials are already configured. Returns ready / not-ready status. ⚠️ READ-ONLY status check. To save credentials → cex-setup-save. [Read-Only]. [Reasoning: Low]. Workflow: Step 0 of 2 — CEX Setup Workflow (check first, only save if not configured). Keywords: is API already configured, exchange connection status, credentials exist, setup complete

No parameters required.

cex-setup-save

[Trading] Save CEX API key and secret. Call ONLY after user explicitly provides credentials in chat. ⚠️ Never pre-fill or assume credentials. After saving, verify with cex-setup-verify. [Write]. [Reasoning: Low]. Workflow: Step 1 of 2 — CEX Setup Workflow (after cex-setup-check confirms not yet configured). Keywords: add new API key, enter API secret, store credentials, first time exchange setup

ParameterTypeRequiredDescription
exchangestringrequiredWhich exchange to configure
apiKeystringrequiredAPI Key
apiSecretstringrequiredAPI Secret
apiPassphrasestringoptionalAPI Passphrase (OKX only, not required for Binance)
isDemobooleanoptionalUse demo/simulated trading environment (testnet)

cex-setup-verify

[Trading] Verify saved CEX credentials by making a live API call. Confirms keys are valid before trading. ⚠️ Read-only side-effect-free verification. NOT for saving credentials (→ cex-setup-save). [Read-Only]. [Reasoning: Low]. Workflow: Step 2 of 2 — CEX Setup Workflow (always run after cex-setup-save). Keywords: test API call, confirm key works, validate credentials live, check API not expired

ParameterTypeRequiredDescription
exchangestringrequiredExchange to verify

airdrop-scan

[Research] Sweep the market for ALL currently active airdrop projects. Returns a filterable ranked list (chain, grade S/A/B, TVL, VC backing). Use when no specific project is in mind — this is the broad discovery sweep. ⚠️ Broad discovery sweep. NOT for one specific project (→ airdrop-check-project); NOT for pre-curated daily digest (→ airdrop-daily-report); NOT for checking link safety (→ airdrop-scam-check). [Read-Only]. [Reasoning: Medium]. Workflow: Step 1 of 3 — Airdrop Workflow (airdrop-scan → airdrop-check-project → airdrop-scam-check). PRIORITY: Default entry for airdrop discovery. Use airdrop-daily-report only if user wants curated digest. Keywords: find airdrops, browse airdrops, active airdrop list, airdrop discovery, search all airdrops

ParameterTypeRequiredDescription
chainstringoptionalFilter by chain name (e.g., 'Ethereum', 'Arbitrum', 'Monad'). Leave empty for all chains. Sentinels 'all' / 'any' / '*' are also accepted as no-filter.
statusstringoptionalFilter by project status. 'active' = currently running, 'upcoming' = announced but not live. Leave empty for both.
limitintegeroptionalMax results to return (default 20)
include_completedbooleanoptionalInclude projects whose token has already launched (airdrop window likely closed). Default false — by definition airdrop-scan returns only claimable opportunities.
include_oldbooleanoptionalInclude 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

ParameterTypeRequiredDescription
chainstringoptionalFilter by chain name. Leave empty or pass 'all' / 'any' for no filter.
gradesarrayoptionalGrades 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

ParameterTypeRequiredDescription
project_namestringrequiredProject 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

ParameterTypeRequiredDescription
chainstringoptionalFilter by chain name. Leave empty or pass 'all' / 'any' for no filter.
limitintegeroptionalMax 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

ParameterTypeRequiredDescription
urlstringoptionalURL to check (e.g., 'https://scroll-airdrop-claim.xyz')
project_namestringoptionalProject name to check for impersonation (e.g., 'Scroll')

crypto-sentiment-score

[Market Data] Get social sentiment for one specific token. Returns: sentiment (0-100), galaxy_score (0-100 overall health), social_volume_24h, bullish_summary, signal_level (HIGH/MEDIUM/LOW). Input: symbol (required, e.g. "BTC"), time_range ("24h"|"7d", default "24h" — label only, data always reflects the 24h window). If the token has no social coverage, returns TOKEN_NOT_FOUND — do not retry with the same symbol. ⚠️ Single-token score. For a ranked trending list → crypto-social-trending. For who's discussing this token → crypto-kol-signals(symbol). [Read-Only]. [Reasoning: Medium].

ParameterTypeRequiredDescription
symbolstringrequiredToken symbol (e.g. BTC, ETH, SOL)
time_rangestringoptionalAnalysis time range label (display only)

crypto-kol-signals

[Market Data] Get KOL creators and news discussing one specific token. Returns: top_creators[] (platform, username, followers per creator), top_news[] (headline, source), sentiment, social_dominance, signal_level. Input: symbol (required, e.g. "BTC"), time_range ("24h"|"7d", default "24h" — label only, data always reflects the 24h window). If the token has no social coverage, returns TOKEN_NOT_FOUND — do not retry with the same symbol. ⚠️ Shows WHO discusses the token and WHAT they say. For sentiment score → crypto-sentiment-score(symbol). For mention volume spikes → crypto-mention-surge. [Read-Only]. [Reasoning: Medium].

ParameterTypeRequiredDescription
symbolstringrequiredToken symbol (e.g. BTC, ETH, SOL)
time_rangestringoptionalAnalysis time range label (display only)

crypto-mention-surge

[Market Data] Detect tokens with sudden social attention shifts. Returns per token: rank_change (positive = rising), alt_rank (current vs previous), social_volume_24h, sentiment, price_change_24h, signal_level. Input: limit (1-50, default 10). No symbol needed. ⚠️ Social MOMENTUM changes — not sentiment (→ crypto-sentiment-score), not KOL discussion (→ crypto-kol-signals), not trending ranking (→ crypto-social-trending). [Read-Only]. [Reasoning: Medium].

ParameterTypeRequiredDescription
limitnumberoptionalMax 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

ParameterTypeRequiredDescription
addressstringrequiredA 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_idstringoptionalOptional 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

ParameterTypeRequiredDescription
addressstringoptionalWallet address to scan for approvals (0x-prefixed)
wallet_addressstringoptionalAlias for address (0x-prefixed wallet address)
chain_idstringrequiredEVM chain ID string. Common values: "1" = Ethereum, "56" = BSC, "137" = Polygon, "8453" = Base, "43114" = Avalanche, "42161" = Arbitrum
typestringoptionalApproval 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

ParameterTypeRequiredDescription
chain_idstringrequiredEVM chain ID string. Common values: "1" = Ethereum, "56" = BSC, "137" = Polygon, "8453" = Base, "43114" = Avalanche, "42161" = Arbitrum
contract_addressstringrequiredNFT contract address (0x-prefixed)
token_idstringoptionalOptional 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

ParameterTypeRequiredDescription
urlstringrequiredURL 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

ParameterTypeRequiredDescription
chain_idstringrequiredEVM chain ID string. Common values: "1" = Ethereum, "56" = BSC, "137" = Polygon, "8453" = Base, "43114" = Avalanche, "42161" = Arbitrum
tokenstringoptionalToken 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 on chain_id; an address is also checked for impersonation of a known ticker.
contract_addressstringoptionalAlias 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.

ParameterTypeRequiredDescription
addressstringrequiredWallet address — raw 0x EVM address only (no ENS / domains).
chain_idstringoptionalEVM chain ID (1=Ethereum, 56=BSC, 137=Polygon, 8453=Base). Supported: 1, 56, 137, 8453. Default "1".
max_txintegeroptionalMax 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.

ParameterTypeRequiredDescription
addressstringrequiredWallet address — raw 0x EVM address only (no ENS / domains).
chain_idstringoptionalEVM chain ID (1=Ethereum, 56=BSC, 137=Polygon, 8453=Base). Supported: 1, 56, 137, 8453. Default "1".
date_fromstringoptionalWindow bound (YYYY-MM-DD). Optional; defaults to the last ~90 days.
date_tostringoptionalWindow 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).

ParameterTypeRequiredDescription
addressstringrequiredWallet address — raw 0x EVM address only (no ENS / domains).
chain_idstringoptionalEVM chain ID (1=Ethereum, 56=BSC, 137=Polygon, 8453=Base). Supported: 1, 56, 137, 8453. Default "1".
date_fromstringoptionalWindow bound (YYYY-MM-DD). Optional; defaults to the last ~90 days.
date_tostringoptionalWindow 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

ParameterTypeRequiredDescription
token_namestringrequiredA meme or community token name or symbol, e.g. PEPE, DOGE, $SHIB, WIF
agent_idstringoptionalOPTIONAL 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

ParameterTypeRequiredDescription
agent_idstringoptionalOPTIONAL 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'.
actionstringrequired
request_textstringoptional
session_idstringoptional
structuredobjectoptional
risk_acknowledgedbooleanoptional
price_unavailable_ackbooleanoptional

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

ParameterTypeRequiredDescription
agent_idstringoptionalOPTIONAL 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_idstringrequired

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

ParameterTypeRequiredDescription
agent_idstringoptionalOPTIONAL 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_idstringrequired

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

ParameterTypeRequiredDescription
querystringrequiredSearch query (3–200 chars). Plain text, no operators.
limitintegeroptionalMax results to return
backendstringoptionalPreferred backend; 'auto' picks based on query characteristics
includeDomainsarrayoptionalRestrict results to these domains (e.g. ['ethereum.org'])
excludeDomainsarrayoptionalExclude these domains
recencystringoptionalTime 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. Routes the backend to news + publish-date filtering so today's results/news surface instead of background pages.

web-search-extract

[Research] Extract the main readable content from a specific URL via Exa. Use when the user provides a URL and asks to read, summarize, or quote a specific webpage. Returns cleaned article text. ⚠️ Input: a URL. For open-ended web search without a URL → web-search-query. [Read-Only]. [Reasoning: Low]. Keywords: read URL, extract article, summarize webpage, fetch page content, read this link

ParameterTypeRequiredDescription
urlstringrequiredURL to extract main content from
maxLengthintegeroptionalTruncate extracted content to this many characters

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

ParameterTypeRequiredDescription
typesarrayoptionalOptional subset: ['unlocks','security']. Omit for all.

data-macro-all

[Market Data] Full US macro snapshot in one call. Returns LATEST values for 12 core indicators: cpi, nfp, m2, yieldSpread, unemployment, sahm, fedRate, sp500, vix, us10y, dxy, gold. Use `series` param with EXACT keys above to select a subset, e.g. ["cpi","sp500","us10y"]. Omit series for all 12. 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, treasury yield, gold, vix

ParameterTypeRequiredDescription
seriesarrayoptionalIndicator keys to return, e.g. ["cpi","sp500","btc"]. Valid keys: cpi, nfp, m2, yieldSpread, unemployment, sahm, fedRate, sp500, vix, us10y, dxy, gold, btc, eth. Omit for all 12 core indicators.

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-get-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

ParameterTypeRequiredDescription
querystringrequiredA 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

ParameterTypeRequiredDescription
protocolstringrequiredProtocol name or slug, e.g. morpho, aave, aave-v3
fieldsarrayoptionalOptional subset of fields to include: tvl, fees, chains, mcap, description

data-technicals

[Market Data] Get price-based technical indicators for an asset (currently BTC): 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. Optional `indicators` subset (['rsi','ma200','macd','bollinger','levels']) — omit for all. [Read-Only]. [Reasoning: Low]. PRIORITY: Default for "BTC technical indicators / RSI / MA200 / MACD / Bollinger / 52-week position". For on-chain valuation (AHR999, Puell) use data-onchain-valuation; for assets not covered, use cex-market-get-kline (OHLCV/klines) or data-token-info (token overview). Keywords: RSI, MA200, moving average, MACD, Bollinger Bands, technical indicators, 52-week high low, ATH, all-time high, overbought, oversold, technical analysis, TA

ParameterTypeRequiredDescription
assetstringoptionalAsset symbol, e.g. btc / eth / sol. Omit for btc.
indicatorsarrayoptionalOptional subset: ['rsi','ma200','macd','bollinger','levels']. Omit for all.

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

ParameterTypeRequiredDescription
assetstringrequiredAsset symbol. Currently only 'btc' is supported.
indicatorsarrayoptionalOptional subset: ['ahr999','puell']. Omit for all (btc).

data-derivatives

[Market Data] Get CEX derivatives market structure for an asset (currently BTC): funding rate, futures premium (annualized basis), aggregated cross-exchange futures open interest (cex_oi; Coinglass total), liquidations, options max pain & open interest. Assess leverage, positioning crowding, liquidation risk. Optional `metrics` subset — omit for all. [Read-Only]. [Reasoning: Low]. PRIORITY: Default for leverage / positioning / liquidation-risk questions. For on-chain DEX open interest use data-onchain-defi; for spot/smart-money flow use data-flows. For assets not covered by this tool, use cex-market-get-kline (price) or 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

ParameterTypeRequiredDescription
assetstringoptionalAsset symbol, e.g. btc / eth / sol. Omit for btc.
metricsarrayoptionalOptional subset. Omit for all.

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

ParameterTypeRequiredDescription
metricsarrayoptionalOptional 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 an asset (currently BTC): spot ETF net flow, Coinbase premium (US institutional bias), and taker buy/sell ratio. Gauge institutional and spot-market directional bias. Optional `metrics` subset (['etf_flow','coinbase_premium','taker_ratio']) — omit for all. [Read-Only]. [Reasoning: Low]. PRIORITY: Default for "are institutions buying / spot-market directional bias". 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 by this tool, use cex-market-get-kline (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

ParameterTypeRequiredDescription
assetstringoptionalAsset symbol. Currently only 'btc' (default btc).
metricsarrayoptionalOptional subset. Omit for all.

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-get-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

ParameterTypeRequiredDescription
assetstringoptionalAsset symbol for exchange_reserve. Currently only 'btc' (default btc). Ignored for stablecoin_exchange_inflow.
metricsarrayoptionalOptional 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

ParameterTypeRequiredDescription
metricsarrayoptionalOptional subset: ['btc_dominance','eth_btc','stablecoin_mcap','stablecoin_supply_change']. Omit (or 'all') for all.

data-price

[Market Data] 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; omit asset → BTC price; pass an array (e.g. ['btc','eth']) → 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 "price of BTC/ETH" question. For market structure (BTC dominance, ETH/BTC ratio, stablecoin market cap) use data-market-structure; for full technical analysis use data-technicals; for any other token use data-token-info. 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

ParameterTypeRequiredDescription
assetoptionalAsset symbol(s): btc / eth. Single symbol → detailed card; array → price list. Omit for btc.
metricsarrayoptionalOptional subset. Default: single asset → ['price','levels']; multiple → ['price']. 'levels' applies to BTC only.
timezoneintegeroptionalInteger 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

ParameterTypeRequiredDescription
metricsarrayoptionalOptional subset. Currently only 'fng'. Omit (or 'all') for all.
daysnumberoptionalFear & Greed history days to include (1-30). Omit for current value only.

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-master-search-market. For volume-ranked trending → poly-trending. [Read-Only]. [Reasoning: Low]. Workflow: Step 1 of 3 — Event Feed Workflow (event-feed-list → event-feed-detail → event-feed-prompts). PRIORITY: Use for curated heat-ranked discovery. For free-text market lookup → poly-master-search-market. Keywords: hot events, trending prediction events, browse events, curated events, event feed list

ParameterTypeRequiredDescription
categorystringoptionalFilter to one of POLITICS/WEB3_FINANCE/SPORTS/CULTURE/TECH; omit for all
keywordstringoptionalOptional 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.
includeClosedbooleanoptionalSet 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.
litebooleanoptionalLean 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).
pageintegeroptional1-indexed page number
pageSizeintegeroptionalItems per page (1–100)
sortBystringoptionalSort key: heatScore (default) / updatedAt / yesProb — all DESC
langstringoptionalUser language preference. Resolved to one of: zh-CN, zh-TW, en, ja, ko (default zh-CN). Accepts BCP-47 tags: `zh`, `zh-CN`, `zh-Hans` → zh-CN; `zh-TW`, `zh-HK`, `zh-Hant` → zh-TW; `en`, `en-US` → en. Localizes title / subTag / aiSummary / suggestedPrompts.

event-feed-detail

[Research] Fetch the complete card for ONE event using a known eventId. Returns: heatScore, yesProb/noProb, trend data, AI summary, category metadata, and extensionData.deepAnalysis — a Digital Oracle structured report with layered market signals, resonance/divergence analysis, time-stratified outlook (0-7d / 7-30d / 30d+), scenario probability ranking, and conclusion with risk factors + monitoring signals. ⚠️ Input: EXACT eventId (from event-feed-list). Does NOT do fuzzy name matching — wrong tool if you only have a name (→ poly-master-search-market). deepAnalysis is pre-generated by backend cron every 2h — NOT real-time LLM. If absent or dataSummary is empty, tell user the analysis is not yet available (~2h cycle). [Read-Only]. [Reasoning: Medium]. Workflow: Step 2 of 2 — Event Feed Workflow (after event-feed-list returns an eventId). A single call returns everything — basic card info AND deep analysis. Use when user asks for event details, probability prediction, signal interpretation, or any combination thereof. Keywords: event card detail, full event data, eventId fetch, heatScore event, prediction event card, deep analysis report, Digital Oracle, probability prediction, signal analysis, multi-source signals, scenario probability, event analysis, prediction market deep dive, Polymarket analysis, market signal interpretation

ParameterTypeRequiredDescription
event_idstringrequiredBusiness-stable event id (e.g. 'poly:0x<64hex>' or 'btc-price-event')
langstringoptionalUser 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

ParameterTypeRequiredDescription
event_idstringrequiredBusiness-stable event id (e.g. 'poly:0x<64hex>' or 'btc-price-event')
langstringoptionalUser 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.

ParameterTypeRequiredDescription
intent_fingerprintstringrequiredStable fingerprint of user intent (correlation only; not a secret).
intent_hashstringrequiredCanonical hash of normalized TradeIntent; must match execute_trade.
scenariostringrequiredHigh-level trade scenario derived by the agent (PRD v6.4 §2.1).
base_assetstringrequiredBase asset symbol (e.g. BTC, ETH).
quote_assetstringrequiredQuote asset symbol (e.g. USDT, USDC).
sidestringrequiredOrder side.
amountstringrequiredHuman-readable amount string (e.g. "0.1").
target_pricestringoptionalLimit-order target price (decimal string), required for *_limit scenarios.
spot_inst_idstringoptional[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.

ParameterTypeRequiredDescription
pathstringrequiredRoute path id (must match a quoted candidate).
idempotency_keystringrequiredClient-generated idempotency key; stable across retries.
quote_snapshot_idstringrequiredFrom get_trade_quotes response.
intent_hashstringrequiredMust equal the intent_hash used for get_trade_quotes that produced the snapshot.
executionobjectoptional0x: { 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, and valuation (pe + historical pe_percentile, pb, ev_ebitda). 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, or fundamentals of one stock. 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

ParameterTypeRequiredDescription
inputstringrequiredticker / 名称 / token,如 NVDA / 英伟达 / NVDAx

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

ParameterTypeRequiredDescription
inputstringrequiredticker / 名称 / 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, is_outlier, data_confidence. The differentiated web3 layer. Accepts ticker / name / token symbol. 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

ParameterTypeRequiredDescription
inputstringrequiredticker / 名称 / 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. 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

ParameterTypeRequiredDescription
querystringrequired用户原话,如 半导体 / 科技 / 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, ev_ebitda), performance (1M/3M/1Y, 52-week position, MA50-vs-200), next earnings & days_to_earnings, on-chain premium, and profile (segments, peers, analyst targets). 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-sector for industry-level queries. [Read-Only]. [Reasoning: Low]. Keywords: stock analysis, tokenized stock, single stock overview, valuation, earnings, performance, on-chain premium, peers, analyst target

ParameterTypeRequiredDescription
inputstringrequiredticker / 名称 / token,如 NVDA / 英伟达 / NVDAx

Smart Money

smart-money-signal

[Research] Get aggregated trading signals from ALL monitored wallets. HIGH = buy >$50K or first position; MEDIUM = accumulation ≥2 buys same token / sell >$50K; LOW = $1K–$50K transfer. ETH Mainnet only. ⚠️ Aggregated signals across ALL wallets. For one specific wallet's activity → smart-money-watch. For LP-specific → smart-money-pool. [Read-Only]. [Reasoning: Medium]. Workflow: Step 2 of 3 — Smart Money Workflow (after smart-money-scan or on a regular cadence). Keywords: whale signal, smart money alert, whale buying, large buy HIGH MEDIUM LOW signal

ParameterTypeRequiredDescription
agent_idstringoptionalOPTIONAL 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'.
levelstringoptionalSignal level filter. 'all' excludes silent info events by default.
limitintegeroptionalMax signals to return
sincestringoptionalISO timestamp — only return signals after this time

smart-money-watch

[Account] View a single wallet's recent on-chain activity. Works for ANY address: a wallet on your watchlist (public pool or your private list) returns full history-baselined signals (data_scope=monitored); any other address returns a read-only recent snapshot (data_scope=snapshot, latest transactions, no first-position/accumulation baseline). To track an address over time with accurate signals add it via smart-money-custom (action=add); for aggregated signals across all monitored wallets use smart-money-signal. [Read-Only]. [Reasoning: Low]. Workflow: Step 1 of 3 — Smart Money Workflow (inspect a wallet). Keywords: what is this address doing, recent activity of this wallet, what did this wallet buy or sell, inspect this address, check this wallet recent transactions, view wallet activity, what is this whale doing lately

ParameterTypeRequiredDescription
agent_idstringoptionalOPTIONAL 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'.
addressstringoptionalWallet address to inspect
wallet_addressoptionalWallet address to inspect (alias for address)
limitintegeroptionalNumber of recent activities
chain_idstringoptionalOptional chain for the snapshot path when the address is not monitored (default 0x1)

smart-money-list

[Account] View / list the wallets currently being monitored — the pre-loaded public smart-money wallets (Paradigm, a16z, Wintermute, Vitalik.eth, …) plus your private watchlist. Read-only roster lookup that answers "which wallets am I monitoring / which smart-money addresses are being tracked / show my monitored list". Does NOT add or remove wallets (→ smart-money-custom) and does NOT return trade signals (→ smart-money-signal). [Read-Only]. [Reasoning: Low]. Workflow: Step 0 of 3 — Smart Money Workflow (verify watchlist before scanning). Keywords: which wallets am I monitoring, what addresses are being tracked, show my monitored list, list tracked smart money wallets, my watchlist, monitored addresses, smart money roster, which smart money addresses are monitored, VC whale wallets list

ParameterTypeRequiredDescription
agent_idstringoptionalOPTIONAL 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'.

smart-money-custom

[Trading] Manage your smart-money watchlist & settings — add or remove a private wallet (max 5), get/update signal push settings, manage stablecoin overrides. ⚠️ Primarily a WRITE / management tool (action=add/remove/settings-update/stablecoin-add/stablecoin-remove). To just SEE which wallets are monitored use smart-money-list; for aggregated trade signals use smart-money-signal. [Read+Write]. [Reasoning: Low]. Workflow: Step 0b of 3 — Smart Money Workflow (setup before scanning). Keywords: add wallet to my watchlist, start monitoring this address, track this wallet, remove monitored wallet, manage private smart money, update signal settings, stablecoin overrides

ParameterTypeRequiredDescription
agent_idstringoptionalOPTIONAL 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'.
actionstringrequiredAction to perform
addressstringoptionalWallet address (required for add/remove)
wallet_addressoptionalWallet address (alias for address; required for add/remove)
labelstringoptionalHuman-readable label (required for add)
min_push_amount_usdnumberoptionalPer-agent minimum push amount in USD
push_stablecoin_buybooleanoptionalWhether stablecoin inflows should be surfaced instead of remaining silent
chain_idstringoptionalChain ID for stablecoin overrides (default 0x1)
token_addressoptionalStablecoin contract address for stablecoin-* actions
token_symbolstringoptionalStablecoin symbol for stablecoin-add

smart-money-pool

[Research] View LP (liquidity provider) activity for smart money addresses: pool add/remove events, token pairs, amounts, protocol. ⚠️ LP ACTIVITY only — not trades or transfers. For trades → smart-money-watch or smart-money-signal. [Read-Only]. [Reasoning: Low]. Workflow: Step 2c of 3 — Smart Money Workflow (specific LP drill-down). Keywords: whale LP activity, smart money liquidity, whale add remove liquidity, DeFi pool whales

ParameterTypeRequiredDescription
agent_idstringoptionalOPTIONAL 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'.
addressstringoptionalWhale wallet address (0x...)
wallet_addressoptionalWhale wallet address (alias for address)
event_typestringoptionalFilter by event type (add or remove liquidity). Default: all
dexstringoptionalFilter by DEX protocol. Default: all
limitintegeroptionalMax events to return (1-50)
sincestringoptionalISO 8601 timestamp — only return events after this time

smart-money-token-scan

[Research] Token-centric whale scan: given a TOKEN (contract 0x… or symbol), return its top holders with balance, USD value and % of supply, flag which holders are labeled smart-money (Paradigm/a16z/Wintermute/etc.) or known entities (CEX/bridge), and report holding concentration (top1 / top10%). Optional include_activity adds each top holder’s recent USD inflow / outflow / net + direction. Params: token, chain (hex id, default ETH Mainnet), limit, include_activity. Starts from a TOKEN — no wallet address or watchlist needed, unlike the wallet-centric tools. Pass a contract address; resolve a symbol → contract via data-token-info first. For aggregated signals across watched wallets → smart-money-signal. For ONE wallet’s activity → smart-money-watch. [Read-Only]. [Reasoning: Low]. Workflow: Token-first entry — Smart Money Workflow (use when the user asks “who are the big holders / whales of <token>” and you do NOT have a wallet address). Keywords: token holders, top holders, who holds token, whale holders, big holders of token, token holder distribution, holding concentration, smart money in a token, token whale scan, holder inflow outflow, 按代币查大户, 持币大户, 鲸鱼持仓

ParameterTypeRequiredDescription
agent_idstringoptionalYour agent ID (optional; used to also match your private watchlist labels)
tokenstringrequiredToken contract address (0x...) OR a symbol like ODAI/MON. Contract address is more reliable for new/meme tokens.
symbolstringoptionalHuman-readable symbol for display, e.g. ODAI. Pass it alongside the contract when you resolved it upstream (data-token-info); otherwise it is looked up from the contract.
chainstringoptionalHex chain id (e.g. 0x1 ethereum, 0x38 bsc, 0x2105 base, 0xa4b1 arbitrum). Default: deployment chain.
limitintegeroptionalNumber of top holders to scan (1-100)
include_activitybooleanoptionalAlso fetch recent on-chain activity for the top non-contract holders (slower, more API cost)

DeFi Investor

investor_discover

[Research] Search DeFi yield opportunities by natural language or filters (chain, protocol type, min APY, max risk). Returns ranked list with APY, TVL, protocol, risk score. When user asks for DeFi yield discovery, prefer to fill structured_preferences along with natural_language. ⚠️ Broad discovery. If gate_status: NEEDS_CLARIFICATION is returned, call again with the SAME session_id after user replies — do not re-classify from scratch. NOT for analyzing a known target (→ investor_analyze). [Read-Only]. [Reasoning: High]. Workflow: Step 1 of 2 — DeFi Investment Workflow (investor_discover → investor_analyze / investor_compare). PRIORITY: Default entry for DeFi discovery. After candidate is identified → investor_analyze (one) or investor_compare (multiple). Keywords: find DeFi yield, search DeFi opportunities, high APY search, stable yield filter, DeFi browse

ParameterTypeRequiredDescription
agent_idstringoptionalOPTIONAL 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_idstringoptionalSession ID for stored intent (optional)
natural_languagestringoptionalUser's request in natural language
structured_preferencesobjectoptional
limitnumberoptional

investor_analyze

[Research] Deep analysis of a specific DeFi earn product — historical APY/TVL, LLM risk insights, confidence. ⚠️ Needs a single target: pass a recommendation''s id from investor_discover as product_id, OR the user''s words as query (e.g. ''Aave'' or  ''the USDC pool on Arbitrum'') and it is resolved automatically. Provide product_id OR query. NOT for broad search (→ investor_discover);  for comparing multiple → investor_compare. If the response has resolution.approximate=true, the product was inferred from the query as a  best guess — tell the user which product was analyzed and that the match may be inexact. [Read-Only]. [Reasoning: High].  Workflow: Step 2 of 2 — DeFi Investment Workflow (after investor_discover surfaces a candidate).  PRIORITY: Use when user has ONE target. For ≥2 targets → investor_compare. For discovery → investor_discover.  Keywords: analyze DeFi protocol, protocol risk, APY sustainability, is DeFi safe, yield opportunity analysis

ParameterTypeRequiredDescription
agent_idstringoptionalOPTIONAL 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'.
product_idstringoptionalThe opaque id of a product obtained from a prior investor_discover call (recommendations[].id). Only set this if you actually have such an id — do NOT invent or guess it. If you don't have one, use `query` instead.
querystringoptionalWhat the user wants to analyze, in their own words — a protocol name like 'Aave' or a full request like 'the USDC pool on Arbitrum'. Use this whenever you don't have a product_id from investor_discover.
analysis_depthstringoptional
include_historybooleanoptional

investor_compare

[Research] Side-by-side comparison of 2–5 DeFi opportunities: APY, TVL, risk score, chain, protocol type — normalized for direct comparison. ⚠️ Requires MULTIPLE specific targets. NOT for single analysis (→ investor_analyze); NOT for searching (→ investor_discover). [Read-Only]. [Reasoning: High]. Workflow: Step 2b of 2 — DeFi Investment Workflow (alternative to investor_analyze when multiple candidates exist). PRIORITY: Use when user wants to compare 2–5 specific options. For one option → investor_analyze. Keywords: compare DeFi options, which protocol better, side by side yield, DeFi comparison

ParameterTypeRequiredDescription
agent_idstringoptionalOPTIONAL 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'.
product_idsarrayoptionalExplicit product ids from investor_discover. Optional when natural_language or queries is provided.
natural_languagestringoptionalWhat to compare in natural language, e.g. 'compare Aave and Compound USDC pools'
queriesarrayoptionalArray of product/protocol queries to resolve and compare
dimensionsarrayoptional

Swap & Trading

swap-quote

[Market Data] Get a DEX swap quote: expected output amount, minimum receive after slippage, gas estimate, routing path. Read-only — does NOT execute or generate a signing page. ⚠️ Use ONLY when user wants to check 'how much will I get' before deciding. If user wants to execute → swap-full directly. [Read-Only]. [Reasoning: Medium]. Workflow: Step 1 of 1 — Swap Workflow (optional pre-check only; skip straight to swap-full to execute). PRIORITY: Use only when user explicitly wants to check price without committing. Default to swap-full for execution intent. Keywords: how much will I receive, DEX output estimate, price impact check, minimum receive slippage preview

ParameterTypeRequiredDescription
sell_tokenstringrequiredToken symbol (e.g. "ETH", "USDT") or ERC-20 contract address (0x-prefixed, 40 hex chars)
buy_tokenstringrequiredToken symbol (e.g. "ETH", "USDT") or ERC-20 contract address (0x-prefixed, 40 hex chars)
sell_amountstringrequiredSell amount in human-readable form (e.g. "0.001", "1000")
takerstringoptionalOptional 0x wallet; when set, response includes firm quote transaction fields for eth_sendTransaction
chain_idintegeroptionalEVM chain ID. Default 1 (Ethereum mainnet).

swap-create-page

[Trading] Generate a DEX swap signing page from an existing quote. Returns preview_url. Rare — only used when the quote step and page-generation step need to be separate. ⚠️ In most cases use swap-full instead (does everything in one call). [Read+Write]. [Reasoning: High]. PRIORITY: Lowest priority in swap family. Use only when split quote/page flow is explicitly required. Default to swap-full. Keywords: generate signing page only, hosted DEX swap URL, split flow page generation

ParameterTypeRequiredDescription
sell_tokenstringrequiredToken symbol (e.g. "ETH", "USDT") or ERC-20 contract address (0x-prefixed, 40 hex chars)
buy_tokenstringrequiredToken symbol (e.g. "ETH", "USDT") or ERC-20 contract address (0x-prefixed, 40 hex chars)
sell_amountstringrequiredHuman-readable sell amount
takerstringrequiredTaker address (required for firm quote)
chain_idintegeroptionalEVM chain ID. Default 1 (Ethereum mainnet).
hosted_urlstringoptionalOptional: URL shown in the page footer block only; actual page is still at preview_url on this service

swap-tokens

[Market Data] List all supported DEX tokens: symbol, name, contract address, decimals. Reference lookup only — no trade execution. ⚠️ TOKEN DIRECTORY, not a price/quote tool. For prices → data-price-btc / data-price-eth or cex-market-get-ticker. [Read-Only]. [Reasoning: Low]. Keywords: token contract address lookup, find token by symbol, token directory list, what address is USDC

ParameterTypeRequiredDescription
chain_idintegeroptionalEVM chain ID. Default 1 (Ethereum mainnet).
searchstringoptionalCase-insensitive filter on symbol or name

swap-gas

[Market Data] Get a quick gas estimate (Gwei + units) scoped specifically to the current swap. Single-value fast lookup. ⚠️ SWAP CONTEXT only. For general EVM gas advice across chains → settlement-gas-prediction. [Read-Only]. [Reasoning: Low]. Keywords: gas cost this specific swap, how much gas for my swap, swap gas units Gwei estimate

ParameterTypeRequiredDescription
chain_idintegeroptionalEVM chain ID. Default 1 (Ethereum mainnet).

swap-full

[Trading] Execute a DEX token swap end-to-end: gets firm quote + generates signing page + hosts it. Returns preview_url and QR code. DEFAULT swap tool for execution. ⚠️ This is token A to token B (exchange). NOT for sending tokens to another address (→ transfer-request). For MEV-protected Dutch auction → smart-swap-create. [Read+Write]. [Reasoning: High]. Workflow: Step 1 of 1 — Swap Workflow (default execution path; call directly without swap-quote first). PRIORITY: Default swap execution tool. Use unless user explicitly says 'just checking / how much would I get' (→ swap-quote). Keywords: execute DEX swap, swap tokens now, exchange ETH for USDC, convert crypto, buy sell token DEX

ParameterTypeRequiredDescription
sell_tokenstringrequiredToken symbol (e.g. "ETH", "USDT") or ERC-20 contract address (0x-prefixed, 40 hex chars)
buy_tokenstringrequiredToken symbol (e.g. "ETH", "USDT") or ERC-20 contract address (0x-prefixed, 40 hex chars)
sell_amountstringrequiredHuman-readable sell amount
takerstringrequiredTaker 0x address
chain_idintegeroptionalEVM chain ID. Default 1 (Ethereum mainnet).
hosted_urlstringoptionalOptional future hosted URL for QR hint block

Smart Swap

smart-swap-create

[Trading] Create a 1inch Fusion (Dutch auction) MEV-protected swap order. Returns signing URL. Auction-based — does not execute immediately. ⚠️ Different from swap-full: Fusion uses a Dutch auction (better price, no immediate fill, MEV-protected). Use for large amounts where MEV risk matters. [Read+Write]. [Reasoning: High]. Workflow: Step 1 of 2 — Smart Swap Workflow (smart-swap-create → smart-swap-status). PRIORITY: Prefer swap-full for standard swaps; use smart-swap-create only when MEV protection or Dutch auction pricing is explicitly needed. Keywords: create new fusion order, initiate MEV protected swap, new Dutch auction, new 1inch swap

ParameterTypeRequiredDescription
sell_tokenstringrequiredToken symbol (e.g. "ETH", "USDT") or ERC-20 contract address (0x-prefixed, 40 hex chars)
buy_tokenstringrequiredToken symbol (e.g. "ETH", "USDT") or ERC-20 contract address (0x-prefixed, 40 hex chars)
sell_amountstringrequiredHuman-readable amount to sell (positive numeric string only, e.g. "0.001", "100")
target_pricestringrequiredTarget price in buy_token per 1 sell_token (positive numeric string only, e.g. "3500" for 1 ETH = 3500 USDC). DO NOT include units or natural-language descriptions.
walletstringrequiredMaker wallet address
expirystringoptionalOrder lifetime, e.g. "24h", "7d", "60m", or seconds as string
enginestringoptionalOnly 1inch is implemented
chain_idintegeroptionalEVM chain ID. Default 1 (Ethereum mainnet).

smart-swap-list

[Account] List all smart swap orders for a wallet: active (in auction), filled, cancelled. ⚠️ Use BEFORE smart-swap-create to check if a similar order already exists. [Read-Only]. [Reasoning: Low]. Workflow: Step 0 of 2 — Smart Swap Workflow (optional pre-check before creating a new order). Keywords: browse all fusion orders, smart swap history, active filled cancelled swap list

ParameterTypeRequiredDescription
walletstringrequired
chain_idintegeroptionalEVM chain ID. Default 1 (Ethereum mainnet).

smart-swap-status

[Account] Check current execution status of a smart swap order: auction progress, fill percentage, execution details. ⚠️ Input: order hash. NOT for cancellation/expiry status (→ smart-swap-cancel). [Read-Only]. [Reasoning: Low]. Workflow: Step 2 of 2 — Smart Swap Workflow (after smart-swap-create). Keywords: fusion order fill progress, how much filled, auction status ongoing, is smart swap executed

ParameterTypeRequiredDescription
order_hashstringrequired0x-prefixed order hash
chain_idintegeroptionalEVM chain ID. Default 1 (Ethereum mainnet).

smart-swap-cancel

[Account] Check the cancellation or expiry status of a 1inch Fusion smart swap order. Fusion orders auto-expire after the auction window — this tool queries whether that has occurred. ⚠️ Despite the name, does NOT actively cancel — it is a read-only status check. For live fill progress → smart-swap-status. [Read-Only]. [Reasoning: Low]. Keywords: fusion order expired, 1inch order cancel status, smart swap expiry check, is order done or expired

ParameterTypeRequiredDescription
order_hashstringrequired
walletstringrequired
chain_idintegeroptionalEVM chain ID. Default 1 (Ethereum mainnet).

Polymarket

poly-intel

[Research] Polymarket cross-market and cross-wallet analytics (Arkham-backed cache layer). Valid actions: top-holders (requires conditionId), wallet-profile (requires user-provided 0x address), hotspots (site-wide capital flow — NOT a market search), network-stats, leaderboard. ⚠️ Requires conditionId or wallet address. NOT for free-text market search (→ poly-master-search-market). NOT for top-holders without a conditionId. [Read-Only]. [Reasoning: Medium]. Keywords: top holders conditionId, wallet PnL analysis, Polymarket leaderboard, capital inflow hotspot, Arkham analytics

ParameterTypeRequiredDescription
agent_idstringoptionalOPTIONAL 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'.
actionstringrequiredIntel action. Conditional required fields: wallet-profile→address; top-holders→event_id. Pick by intent: market sentiment/whale distribution on an event→top-holders; where money is flowing right now→hotspots; site-wide stats→network-stats; top historical traders→leaderboard; profile a SPECIFIC known wallet→wallet-profile.
addressstringoptional0x wallet address. REQUIRED when action=wallet-profile; ignored otherwise. Only use when the user gives you a concrete address — do NOT invent one to analyze a market.
event_idstringoptionalPolymarket conditionId (0x... 32-byte hex). REQUIRED when action=top-holders; ignored otherwise. Resolve it first via poly-market-info if you only have the question text or slug.
limitintegeroptionalMax records to return when cached data is a list

poly-master-traders

[Research] Discover top Polymarket traders ranked by win rate, ROI, volume, active markets. ⚠️ Use BEFORE poly-master-follow to identify who to copy. NOT for your own trade history (→ poly-history). [Read-Only]. [Reasoning: Medium]. Workflow: Step 1 of 4 — Copy-Trade Workflow (poly-master-traders → poly-master-follow → poly-master-orders → poly-master-pnl). Keywords: discover top traders, trader win rate ROI, leaderboard who to follow, best performing traders

ParameterTypeRequiredDescription
agent_idstringoptionalOPTIONAL 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'.
min_settled_marketsintegeroptionalMinimum settled market count to qualify; this is not raw trade count
min_win_ratenumberoptionalMinimum win rate %. Default 0 — ranking/quality is handled by copyScore + verdict + min_profit_factor; a hard win-rate floor would hide high-profit-factor traders below it. Set >0 only to force a strict floor.
min_profit_factornumberoptionalMin profit factor (grossWin/grossLoss) for a recommended/trial verdict; below this is flagged poor_profit_ratio
sort_bystringoptionalRanking key: copy_score (suitability), win_rate (Wilson lower bound), or pnl
copyable_onlybooleanoptionalWhen true, return only traders whose verdict is recommended or trial
limitintegeroptionalMax traders to return

poly-master-search-market

[Research] Free-text search across ALL Polymarket prediction markets. Returns conditionId, outcomes, prices, volume, liquidity. Supports zh-CN, zh-TW, en, ja, ko. PRIMARY market lookup tool. ⚠️ Use this FIRST before poly-market-info or poly-buy. event-feed-list only has top-N curated events — long-tail markets require this tool. [Read-Only]. [Reasoning: Low]. Workflow: Step 1 of 4 — Polymarket Trade Workflow (poly-master-search-market → poly-market-info → poly-buy / poly-sell → poly-confirm). PRIORITY: Default for free-text market discovery across full Polymarket universe. For curated heat-ranked events → event-feed-list. Keywords: find market by name, will X win Y, election outcome price, search any prediction topic

ParameterTypeRequiredDescription
agent_idstringoptionalOPTIONAL 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'.
querystringrequiredFree-text query. Examples: 'Tunisia 2026 World Cup', '突尼斯夺冠', 'チュニジア ワールドカップ', '튀니지 월드컵', 'Trump 2028'.
langstringoptionalLanguage of the `query` field. Drives the translation step.
limitintegeroptionalMax markets to return (1–50).
min_liquiditynumberoptionalMinimum USD liquidity. Keep 0 for maximum recall on long-tail markets; set higher only if you want to filter out very thin markets.
include_closedbooleanoptionalInclude closed / no-longer-trading markets in results.

poly-master-follow

[Trading] Follow or unfollow a Polymarket trader. Set copy ratio (e.g. 0.5 = copy at 50% size). ⚠️ Use AFTER poly-master-traders identifies a target. For viewing followed traders → poly-master-status. [Write]. [Reasoning: Medium]. Workflow: Step 2 of 4 — Copy-Trade Workflow (after poly-master-traders). Keywords: follow specific trader address, set copy ratio, start mirroring trader, unfollow trader

ParameterTypeRequiredDescription
agent_idstringoptionalOPTIONAL 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'.
wallet_addressstringrequiredYour wallet address
trader_addressstringrequiredTrader's wallet address to follow
copy_rationumberoptionalCopy ratio: % of trader's position size
actionstringoptionalFollow or unfollow

poly-master-status

[Account] Single-call copy-trading dashboard: followed traders, recent orders, current risk config. [Read-Only]. [Reasoning: Low]. Keywords: copy trading dashboard, who am I following now, followed traders overview, copy status summary

ParameterTypeRequiredDescription
agent_idstringoptionalOPTIONAL 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'.

poly-master-risk

[Trading] View or update copy-trading risk limits: max position size, daily loss limit, copy ratio caps. [Write]. [Reasoning: Medium]. Workflow: Step 2b of 4 — Copy-Trade Workflow (optional risk config alongside poly-master-follow). Keywords: max position size limit, daily loss cap, copy ratio ceiling, risk parameters configuration

ParameterTypeRequiredDescription
agent_idstringoptionalOPTIONAL 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'.
stop_loss_percentnumberoptionalStop loss % (e.g. 20)
take_profit_percentnumberoptionalTake profit %
max_position_per_marketnumberoptionalMax USDC per market
max_total_positionnumberoptionalMax total USDC across all
max_slippage_percentnumberoptionalMax slippage %

poly-master-pnl

[Account] PnL report for copy-trading: breakdown by daily/weekly/total and by followed trader. ⚠️ COPY-TRADING PnL only. For direct trading positions → poly-positions. [Read-Only]. [Reasoning: Low]. Workflow: Step 4 of 4 — Copy-Trade Workflow (review results). Keywords: copy trading profit loss, how much earned copying, copy trade ROI, weekly daily copy PnL

ParameterTypeRequiredDescription
agent_idstringoptionalOPTIONAL 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'.
periodstringoptionalReport period

poly-master-orders

[Account] List copy-trading orders with status filter (pending/filled/cancelled). Shows which trader triggered each. ⚠️ Replaces deprecated poly-orders. NOT for one-off trades (→ poly-history). [Read-Only]. [Reasoning: Low]. Workflow: Step 3 of 4 — Copy-Trade Workflow (monitor orders after following traders). Keywords: copy order history, orders triggered by followed traders, copy trade execution log

ParameterTypeRequiredDescription
agent_idstringoptionalOPTIONAL 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'.
statusstringoptionalFilter by order status
limitintegeroptionalMax orders to return

poly-new

[Research] Get recently created Polymarket markets sorted by creation date. Use to discover new events and early-stage opportunities before they gain liquidity. ⚠️ NEWEST by creation date. For hottest by volume → poly-trending. For curated heat-ranked → event-feed-list. [Read-Only]. [Reasoning: Low]. Keywords: newest markets, just launched predictions, recently created events, early stage low liquidity

ParameterTypeRequiredDescription
agent_idstringoptionalOPTIONAL 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'.
limitintegeroptionalMax markets to return
hoursintegeroptionalLook back hours
categorystringoptionalFilter by category

poly-market-info

[Market Data] Get full detail for ONE known Polymarket market: conditionId, outcomes/prices, volume, liquidity, CLOB token IDs. Accepts conditionId, slug, Gamma ID, or text. ⚠️ Use AFTER poly-master-search-market returns a conditionId. NOT for browsing (→ poly-master-search-market). Translate non-English names to English before calling. [Read-Only]. [Reasoning: Low]. Workflow: Step 2 of 4 — Polymarket Trade Workflow (after search returns a conditionId). Keywords: conditionId details, market prices liquidity, CLOB token IDs, market endDate, slug lookup

ParameterTypeRequiredDescription
agent_idstringoptionalOPTIONAL 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_idstringrequiredMarket reference: index (1,2,3...), conditionId (0x...), Gamma ID, slug, or event/question text

poly-positions

[Account] Get current Polymarket positions: outcome tokens held, cost basis, current market value, unrealized PnL. Requires proxy_wallet address. ⚠️ CURRENT HOLDINGS. For past activity → poly-history. For order status → poly-confirm. For copy-trading PnL → poly-master-pnl. [Read-Only]. [Reasoning: Low]. Keywords: current holdings, active predictions, outcome tokens I own now, unrealized prediction PnL

ParameterTypeRequiredDescription
agent_idstringoptionalOPTIONAL 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'.
proxy_walletstringrequiredPolymarket proxy wallet address (GnosisSafe)

poly-history

[Account] Get recent trade and transfer activity for a Polymarket proxy wallet. Returns a chronological log of buys, sells, and transfers. Requires proxy_wallet address. ⚠️ PAST ACTIVITY log. For current positions → poly-positions. For order fill status → poly-confirm. [Read-Only]. [Reasoning: Low]. Keywords: past trade log, historical buys sells, what I traded before, previous prediction activity

ParameterTypeRequiredDescription
agent_idstringoptionalOPTIONAL 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'.
proxy_walletstringrequiredPolymarket proxy wallet address (GnosisSafe)
limitintegeroptionalMax activities to return

poly-buy

[Trading] Buy outcome tokens on Polymarket. Returns signing URL. Zero custody — private keys never leave wallet. ⚠️ ALWAYS confirm market, outcome, and amount with user before calling. For exiting a position → poly-sell. [Write]. [Reasoning: High]. Workflow: Step 3a of 4 — Polymarket Trade Workflow (after poly-market-info confirms details). Keywords: acquire YES token, acquire NO token, enter prediction, buy into outcome, long prediction

ParameterTypeRequiredDescription
agent_idstringoptionalOPTIONAL 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_idstringrequiredMarket reference: index, conditionId (0x...), Gamma ID, slug, or event/question text
outcomestringrequiredOutcome to buy, e.g. 'Yes', 'No', team name
amount_usdcnumberrequiredAmount to spend in USDC
pricenumberoptionalLimit price per share (omit for market order at current best ask)
wallet_addressstringrequiredUser's EOA (externally-owned account) address — the wallet controlled by a private key in MetaMask / OKX / Trust / TokenPocket. This is the address that will be ASKED TO SIGN in the user's browser. MUST NOT be the user's Polymarket proxy / Safe / deposit-wallet address: Polymarket's UI shows the Safe wallet as the user's account, but a Safe is a smart contract and cannot produce a browser EOA signature. If the user provided an address without saying which kind it is, ask them to confirm it is the EOA from their MetaMask/OKX wallet header (NOT the address Polymarket's website displays).
proxy_walletbooleanoptionalBoolean flag: `true` to sign in Polymarket Safe (proxy-wallet) mode (signatureType=2); omit or `false` for direct EOA signing (signatureType=0). Most Polymarket retail users hold their USDC inside the Safe (any 'deposit on Polymarket' flow uses the Safe), so this should usually be `true` for users trading existing Polymarket balances. The actual Safe address is derived deterministically from wallet_address via the Polymarket Safe factory — NEVER pass a wallet address as the value of this field. If a Safe-style address ends up here it indicates the caller confused this field with wallet_address.

poly-sell

[Trading] Sell outcome tokens on Polymarket. Returns signing URL. Zero custody. ⚠️ ALWAYS confirm which position, how much, and estimated proceeds before calling. For entering a position → poly-buy. [Write]. [Reasoning: High]. Workflow: Step 3b of 4 — Polymarket Trade Workflow (after poly-market-info confirms details). Keywords: dispose YES token, dispose NO token, exit prediction, sell out of outcome, close prediction

ParameterTypeRequiredDescription
agent_idstringoptionalOPTIONAL 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_idstringrequiredMarket reference: index, conditionId (0x...), Gamma ID, slug, or event/question text
outcomestringrequiredOutcome to sell, e.g. 'Yes', 'No', team name
sizenumberrequiredNumber of shares to sell
pricenumberoptionalLimit price per share (omit for market order at current best bid)
wallet_addressstringrequiredUser's EOA (externally-owned account) address — the wallet controlled by a private key in MetaMask / OKX / Trust / TokenPocket. This is the address that will be ASKED TO SIGN in the user's browser. MUST NOT be the user's Polymarket proxy / Safe / deposit-wallet address: Polymarket's UI shows the Safe wallet as the user's account, but a Safe is a smart contract and cannot produce a browser EOA signature. If the user provided an address without saying which kind it is, ask them to confirm it is the EOA from their MetaMask/OKX wallet header (NOT the address Polymarket's website displays).
proxy_walletbooleanoptionalBoolean flag: `true` to sign in Polymarket Safe (proxy-wallet) mode (signatureType=2); omit or `false` for direct EOA signing (signatureType=0). Most Polymarket retail users hold their USDC inside the Safe (any 'deposit on Polymarket' flow uses the Safe), so this should usually be `true` for users trading existing Polymarket balances. The actual Safe address is derived deterministically from wallet_address via the Polymarket Safe factory — NEVER pass a wallet address as the value of this field. If a Safe-style address ends up here it indicates the caller confused this field with wallet_address.

poly-confirm

[Account] Check Polymarket order status: signing status (pending/signed/expired) and fill status (unfilled/partial/filled). ⚠️ Input: order ID from poly-buy or poly-sell. NOT for browsing positions (→ poly-positions). Replaces deprecated poly-order-status. [Read-Only]. [Reasoning: Low]. Workflow: Step 4 of 4 — Polymarket Trade Workflow (after poly-buy or poly-sell). Keywords: order fill status, was order signed, pending signed expired, confirm execution after buy sell

ParameterTypeRequiredDescription
agent_idstringoptionalOPTIONAL 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_idstringrequiredOrder ID from poly-buy or poly-sell response

poly-order-status

[DISABLED] Complete alias of poly-confirm. Use poly-confirm directly to check order status. [Read-Only]. [Reasoning: Low]. Keywords: DISABLED, use poly-confirm

ParameterTypeRequiredDescription
agent_idstringoptionalOPTIONAL 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_idstringrequiredOrder ID from poly-buy or poly-sell response

poly-master-strategy-scan

[Research] Scan for logical-implication hedge arbitrage signals across Polymarket. Identifies T1/T2/T3 tier opportunities where related markets are mispriced relative to each other. ⚠️ Very computationally intensive — use sparingly. [Read-Only]. [Reasoning: Very High]. Workflow: Step 1 of 2 — Strategy Engine Workflow (after dry-run is toggled appropriately). Keywords: arbitrage scan, logical implication mispricing, hedge signal T1 T2 T3, computationally intensive scan

ParameterTypeRequiredDescription
agent_idstringoptionalOPTIONAL 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'.
limitintegeroptionalMax markets to scan
min_tierstringoptionalMinimum signal tier to return
dry_runbooleanoptionalNo-op alias kept for prompt compatibility; this tool only scans and never places orders.

poly-master-strategy-metrics

[Account] Get the strategy engine monitoring dashboard: signal tier distribution (T1/T2/T3), signal generation rate, order cancellation rate, coverage statistics. [Read-Only]. [Reasoning: Low]. Keywords: T1 T2 T3 signal count, signal generation rate, strategy coverage stats, order cancel rate

ParameterTypeRequiredDescription
agent_idstringoptionalOPTIONAL 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'.

poly-master-strategy-dry-run

[Trading] Toggle dry-run mode for the strategy engine. Input: enabled (boolean). In dry-run, strategy signals are logged but no real orders are placed. Use for testing before going live. [Write]. [Reasoning: Low]. Workflow: Step 0 of 2 — Strategy Engine Workflow (toggle dry-run before scanning live). Keywords: paper trading mode, strategy simulation no real orders, toggle dry run, test before live

ParameterTypeRequiredDescription
agent_idstringoptionalOPTIONAL 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'.
enabledbooleanrequiredtrue = dry-run (log only), false = live execution

Settlement & Gas

settlement-gas

Gas/fee outlook for a chain. EVM (ethereum/arbitrum/optimism/base/polygon): current gas tiers, recommended send window, and optional confirmation-time ETA for a given gwei. Bitcoin (chain=bitcoin): sat/vB fee tiers, and optional ETA for a given sat_per_vb. Replaces settlement-gas-prediction/-predict-time/-optimal-window/-btc-fee/-btc-settlement.

ParameterTypeRequiredDescription
chainstringoptionalEVM chain (ethereum/arbitrum/optimism/base/polygon) or 'bitcoin'. Default ethereum.
gweinumberoptionalEVM only: estimate confirmation time for this gas price (Gwei).
sat_per_vbnumberoptionalBitcoin only: estimate confirmation time for this fee rate (sat/vB).
urgencystringoptionalUrgency for fee tier / optimal window (default medium).

settlement-pending-pool

[Market Data] Analyze a specific DEX liquidity pool for sandwich attack (MEV) risk and return a safe slippage tolerance recommendation. ⚠️ Input is a POOL ADDRESS. NOT a general gas tool — specifically for MEV/slippage risk before a large DEX swap. [Read-Only]. [Reasoning: High]. Keywords: sandwich attack risk, MEV protection slippage, DEX pool safe slippage, front-run risk large swap

ParameterTypeRequiredDescription
chainstringoptionalEVM chain: ethereum, arbitrum, optimism, base, or polygon (default: ethereum)
pool_addressstringrequiredContract or pool address (0x-prefixed, 40 hex chars)
directionstringrequiredTrade direction
amount_usdnumberrequiredTrade amount in USD

settlement-track-tx

Track a transaction by hash — auto-detects EVM vs Bitcoin from the hash format. EVM (0x + 64 hex): status, block number, confirmations, gas used, fee. Bitcoin (64 hex, no 0x): confirmations, fee paid, input/output totals.

ParameterTypeRequiredDescription
tx_hashstringrequiredTransaction hash. EVM: 0x + 64 hex. Bitcoin: 64 hex (no 0x). Chain family is auto-detected.
chainstringoptionalOptional EVM chain hint (ethereum/arbitrum/...). Ignored for Bitcoin.

settlement-verify-contract

[Security] Check if an EVM smart contract's source code is verified on Etherscan and flag security risks from static analysis. ⚠️ Input: SMART CONTRACT ADDRESS (not a token or NFT specifically). For token-specific risk flags → wallet-guard-token-security. [Read-Only]. [Reasoning: Low]. Keywords: Etherscan source verified, smart contract open source, contract audit check, is source code public

ParameterTypeRequiredDescription
chainstringoptionalEVM chain: ethereum, arbitrum, optimism, base, or polygon (default: ethereum)
addressstringrequiredContract address (0x-prefixed)

Machine-readable formats: