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
123

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

Hyperliquid market data. view=price (default): price for one coin, comma-separated list, or top-10 if omitted. view=book (needs coin): L2 order book. view=funding: funding-rate board (single coin via `coin`, else market-wide).

ParameterTypeRequiredDescription
viewstringoptionalprice = mid price(s); book (needs coin) = L2 order book; funding = funding-rate board
coinstringoptionalprice: single (ETH) or CSV (ETH,BTC,SOL), omit for top-10. book: required asset. funding: optional filter.
depthintegeroptionalOrder book depth (view=book only)
limitintegeroptionalNumber of funding rows (view=funding only)

hyperliquid-account

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

ParameterTypeRequiredDescription
addressstringrequiredWallet address (0x...)

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

ParameterTypeRequiredDescription
exchangestringoptionalTarget exchange. Defaults to 'okx' for backward compatibility.
viewstringoptionalticker = latest price/24h stats; kline = OHLC candles; orderbook = bids/asks depth
instIdstringrequiredInstrument ID in exchange-native format. OKX (default): hyphen-separated, e.g. "INJ-USDT" (spot), "BTC-USDT-SWAP" (perp). Binance: concatenated, e.g. "INJUSDT". Convert user-mentioned symbols before calling: "INJ" → "INJ-USDT" (OKX) or "INJUSDT" (Binance).
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 (view=kline only; default 100, max 300)
depthintegeroptionalOrder book depth per side (view=orderbook only; default 20)

cex-market-get-instruments

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

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

ParameterTypeRequiredDescription
exchangestringoptionalTarget exchange. Defaults to 'okx' for backward compatibility.
viewstringoptionalbalance = per-currency available/frozen/total; summary = equity/PnL/available/frozen totals

cex-setup-check

[Account] Check whether CEX API credentials are already configured. Returns ready / not-ready status. ⚠️ READ-ONLY status check. 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.

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

[Crypto · Market Data] Social sentiment for ONE crypto token/coin (e.g. BTC, ETH, SOL), from LunarCrush social data. Crypto assets ONLY — NOT for stocks, equities, ETFs or indices (e.g. AAPL, NVDA, SK Hynix / 000660.KQ). For stock/equity sentiment this tool does not apply; do not pass stock tickers here. Returns: sentiment (0-100), galaxy_score (0-100 overall health), social_volume_24h, bullish_summary, signal_level (HIGH/MEDIUM/LOW). Input: symbol (required, a crypto symbol, e.g. "BTC"), time_range ("24h"|"7d", default "24h" — label only, data always reflects the 24h window). If the token has no social coverage (or the symbol is not a crypto asset), returns TOKEN_NOT_FOUND — do not retry with the same symbol. ⚠️ Single-token score. For a ranked trending list → crypto-social-trending. For who's discussing this token → crypto-kol-signals(symbol). [Read-Only]. [Reasoning: Medium].

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

crypto-kol-signals

[Crypto · Market Data] Who is discussing ONE crypto token and what they're saying, from LunarCrush. Crypto tokens ONLY — NOT for stocks, equities, ETFs or indices (e.g. AAPL, NVDA, SK Hynix / 000660.KQ); do not pass stock tickers here. Returns: top_creators[] (platform, username, followers per creator), top_news[] (title, url, creator per item), sentiment, social_dominance, signal_level. Input: symbol (required, a crypto symbol, e.g. "BTC"), time_range ("24h"|"7d", default "24h" — label only, data always reflects the 24h window). If the token has no social coverage (or the symbol is not a crypto asset), returns TOKEN_NOT_FOUND — do not retry with the same symbol. ⚠️ Shows WHO discusses the token and WHAT they say. For sentiment score → crypto-sentiment-score(symbol). For mention volume spikes → crypto-mention-surge. [Read-Only]. [Reasoning: Medium].

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

crypto-mention-surge

[Crypto · Market Data] Detect crypto tokens with sudden social attention shifts (AltRank jumps), from LunarCrush. Crypto market ONLY — scans crypto tokens, not stocks, equities or indices. Returns per token: rank_change (positive = rising), alt_rank + alt_rank_previous, social_volume_24h, sentiment, price_change_24h, signal_level. Input: limit (1-50, default 10). No symbol needed. ⚠️ Social MOMENTUM changes — not sentiment (→ crypto-sentiment-score), not KOL discussion (→ crypto-kol-signals), not trending ranking (→ crypto-social-trending). [Read-Only]. [Reasoning: Medium].

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

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"]. 12 core (default): cpi, nfp, m2, yieldSpread, unemployment, sahm, fedRate, sp500, vix, us10y, dxy, gold. Optional extras: btc, eth. Omit to get all 12 core (btc/eth excluded by default).

data-token-info

[Market Data] Look up any crypto token or project by symbol or name (e.g. HYPE, PEPE, Hyperliquid). Returns price, 24h–1y performance, market cap, FDV, volume, ATH, supply, TVL (DeFi tokens), project intro, homepage, contract addresses, community sentiment, and top venues. Returns a candidate list when the symbol is ambiguous. ⚠️ Input must be a token symbol or name — NOT a wallet address or tx hash. NOT for meme ratings (→ meme-analyze), wallet/contract risk (→ wallet-guard-address-security), token security audits (→ wallet-guard-token-deep-scan), or single-pair tickers (→ cex-market-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: funding rate, futures premium (annualized basis), aggregated cross-exchange open interest (cex_oi; Coinglass total), liquidations, options max pain & open interest. Two OPT-IN per-exchange drill-downs (request explicitly in `metrics`): funding_by_exchange — each exchange's funding + cross-exchange spread for arbitrage; oi_by_exchange — per-exchange OI breakdown + venue concentration. BTC is always available; other liquid assets (e.g. ETH, SOL, XRP) are fetched on-demand. Options (max pain / OI) are BTC-only. Assess leverage, positioning crowding, liquidation risk. Optional `metrics` subset — omit for all standard aggregates (the two by_exchange drill-downs return only when explicitly listed). [Read-Only]. [Reasoning: Low]. PRIORITY: Default for leverage / positioning / liquidation-risk questions on any liquid asset, and for cross-exchange funding arbitrage or per-exchange OI concentration. For on-chain DEX open interest use data-onchain-defi; for spot/smart-money flow use data-flows. Illiquid / unknown tokens → data-token-info (token overview). Keywords: funding rate, futures premium, basis, contango, backwardation, open interest, OI, CEX OI, liquidations, options max pain, options open interest, leverage, derivatives, positioning, ETH derivatives, SOL derivatives, altcoin funding, cross-exchange funding, funding arbitrage, funding spread, per-exchange OI, OI concentration

ParameterTypeRequiredDescription
assetstringoptionalAsset symbol, e.g. btc / eth / sol. Omit for btc.
metricsarrayoptionalOptional subset of the standard aggregates (funding_rate, futures_premium, cex_oi, liquidations, options_max_pain, options_oi); omit for all of them. The per-exchange drill-downs funding_by_exchange / oi_by_exchange are OPT-IN — returned ONLY when explicitly listed here, never by default.

data-funding-scan

Scan the WHOLE crypto market for cross-exchange perpetual funding-rate dislocations — the data behind funding-arbitrage discovery. No asset argument: it ranks every symbol in the funding feed. sort='spread' (default) ranks by the cross-exchange funding gap (top venue − bottom venue, equivalent-8h %), the arbitrage-relevant dimension; sort='high' surfaces the most positive funding (crowded longs / short side earns); sort='low' the most negative (crowded shorts / long side earns). eq8h normalizes venues with different settlement cadences and is an extrapolation of the current rate, NOT a settled value. The spread is gross — it ignores trading fees, borrow/margin cost, slippage and the execution risk of holding both legs, so it is a signal, not risk-free profit. For ONE named asset's per-exchange funding breakdown use data-derivatives with metrics=[funding_by_exchange]; for a single asset's full derivatives card use data-derivatives.

ParameterTypeRequiredDescription
top_nintegeroptionalHow many ranked symbols to return. Default 10.
sortstringoptionalRanking dimension. 'spread' (default) = widest cross-exchange funding gap (arbitrage); 'high' = most positive funding; 'low' = most negative funding.
min_exchangesintegeroptionalOnly include symbols quoted on at least this many exchanges. Default 2 (minimum for a spread).
exclude_stablecoinsbooleanoptionalDrop stablecoins / pegged assets (no meaningful funding signal). Default true.

data-onchain-defi

[Market Data] Get on-chain DeFi/DEX market structure in one call: total DeFi TVL (all chains + Ethereum), DEX 24h volume, on-chain DEX open interest, and DeFi yield benchmarks (stETH APY, stablecoin avg APY). Market-level structural data. Optional `metrics` subset (['defi_tvl','dex_volume','dex_oi','yield_benchmark']) — omit for all. [Read-Only]. [Reasoning: Low]. PRIORITY: Default for any DeFi/DEX market-level overview. For a specific protocol's TVL/fees/revenue use data-defi-protocol; to discover/compare specific yield products use investor_discover; for CEX derivatives use data-derivatives. Keywords: DeFi TVL, total value locked, DEX volume, DEX open interest, on-chain OI, stETH yield, stablecoin yield, yield benchmark, Ethereum TVL, DeFi overview

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 BTC: spot ETF net flow, Coinbase premium (US institutional bias), and taker buy/sell ratio. OPT-IN per-exchange drill-down (request explicitly in `metrics`): taker_by_exchange — per-exchange taker buy/sell over a 4h window (taker_ratio is the current aggregate ratio; taker_by_exchange is the per-exchange breakdown, and unlike the other metrics it also covers non-BTC liquid assets on-demand). Gauge institutional and spot-market directional bias. Optional `metrics` subset (['etf_flow','coinbase_premium','taker_ratio','taker_by_exchange']) — omit for all standard aggregates (taker_by_exchange returns only when explicitly listed). [Read-Only]. [Reasoning: Low]. PRIORITY: Default for "are institutions buying / spot-market directional bias", and for per-exchange taker / which exchange is buying. For total stablecoin market cap use data-market-structure; for on-chain exchange reserves use data-onchain-flows; for leverage/funding/open interest use data-derivatives. For assets not covered, use cex-market-quote (price) or data-token-info (token overview). Keywords: ETF flow, ETF net flow, spot ETF, Coinbase premium, taker buy sell ratio, institutional flow, spot flow, smart money flow, directional bias, per-exchange taker, taker by exchange

ParameterTypeRequiredDescription
assetstringoptionalAsset symbol. btc (default); non-BTC liquid assets are supported only for taker_by_exchange.
metricsarrayoptionalOptional subset of the standard metrics (etf_flow, coinbase_premium, taker_ratio); omit for all. taker_by_exchange is OPT-IN — returned ONLY when explicitly listed, never by default.

data-onchain-flows

[Market Data] Get on-chain flow / supply-side indicators for an asset (currently BTC): exchange reserve (total coins held on exchanges — falling reserves imply accumulation / reduced sell pressure). Optional `metrics` (['exchange_reserve']) — omit for all. [Read-Only]. [Reasoning: Low]. PRIORITY: Default for exchange-reserve / sell-pressure / accumulation questions. For off-chain market flow (spot ETF, Coinbase premium, taker ratio) use data-flows. For assets not covered by this tool, use cex-market-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.
daysnumberoptionalDaily F&G history points to also return (1-30). Trend & signal level are ALWAYS included regardless; this only adds the raw daily history array.

data-event-token-unlock

[Market Data] Get upcoming token unlock events in the next 30 days, ranked by USD value, sourced from DefiLlama. Per event returns: token symbol, project name, unlock amount, USD value, date, and unlock size as % of max supply. Large cliff unlocks can signal near-term sell pressure. [Read-Only]. [Reasoning: Low]. Keywords: token unlock, vesting cliff, token release schedule, upcoming sell pressure, unlock calendar, unlock amount USD, percent of supply, cliff unlock, linear unlock, next 30 days unlocks

No parameters required.

event-feed-list

[Research] Browse the curated Antalpha Event Feed: top-N heat-score-ranked prediction events across POLITICS / WEB3_FINANCE / SPORTS / CULTURE / TECH. ⚠️ Top-N CURATED events only — long-tail markets not included. For a specific market by name → poly-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, valuation (pe + historical pe_percentile, pb, ev_ebitda), financial quality (ROE/ROIC, ROIC-vs-WACC spread, FCF yield, leverage, Piotroski/Altman, quality verdict), and base-case DCF intrinsic value & upside. Accepts ticker / name / token symbol. Judge cheap/expensive ONLY from pe_percentile (0-100); null = unknown, do NOT guess. Numbers pre-computed. PRIORITY: Use when the user asks specifically about valuation, earnings, fundamentals, or financial quality/moat of one stock. For DCF intrinsic value or assumption what-ifs use us-stock-dcf; for a full single-stock readout use us-stock-bundle. [Read-Only]. [Reasoning: Low]. Keywords: valuation, PE, PB, EV/EBITDA, earnings, days to earnings, revenue growth, margins, beat rate, fundamentals, ROE, ROIC, FCF yield, Piotroski, Altman Z, quality, moat, DCF, intrinsic value

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, premium_mode, confidence, is_outlier. The differentiated web3 layer. Accepts ticker / name / token symbol. Read premium_mode: realtime = same-instant premium (US market open); offset = token vs the LAST close (off-hours), NOT a same-instant premium and partly overnight drift — don't treat it as a real liquidity premium (low confidence; see underlying_close_date). is_outlier=true = suspected anomaly (FX lag / thin liquidity), not a real signal. Empty = unavailable; on-chain exists for in-pool names only. PRIORITY: Use when the user asks about the tokenized / on-chain side — premium or discount, where to buy, which chain. The only on-chain tool. [Read-Only]. [Reasoning: Low]. Keywords: on-chain premium, discount, tokenized stock, xStocks, where to buy, which chain, premium discount, realtime vs offset

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), financial quality verdict (ROIC vs WACC, Piotroski, Altman) + base-case DCF intrinsic value & upside, 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-dcf for DCF intrinsic value or assumption what-ifs; use us-stock-sector for industry-level queries. [Read-Only]. [Reasoning: Low]. Keywords: stock analysis, tokenized stock, single stock overview, valuation, quality, moat, ROIC, DCF, intrinsic value, earnings, performance, on-chain premium, peers, analyst target

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

us-stock-dcf

[Research] DCF intrinsic value of a tokenized US stock: base-case intrinsic value & upside-vs-price, key assumptions (WACC / perpetual growth / revenue growth), terminal-value share, a bear/base/bull band, and a 3-lever sensitivity (revenue / discount / terminal) marking the main driver. Optionally override assumptions: revenue_growth_pct (live recompute), terminal_growth_pct & discount_rate_pct (instant, local); perpetual growth is auto-clamped below WACC. Banks / insurance / capital-markets are flagged not-applicable (no FCF-DCF). EOD prices. unavailable/null = do NOT guess. PRIORITY: Use when the user asks what a stock is worth / intrinsic / fair value, or wants to adjust DCF assumptions (what-if). For relative cheap-or-expensive (PE percentile) use us-stock-financials; for a full readout use us-stock-bundle. [Read-Only]. [Reasoning: Low]. Keywords: DCF, intrinsic value, fair value, discounted cash flow, WACC, terminal growth, upside, bear base bull, what-if, sensitivity

ParameterTypeRequiredDescription
inputstringrequiredticker / 名称 / token,如 NVDA / 英伟达 / NVDAx
revenue_growth_pctnumberoptional预测期年化营收增速假设%(覆盖 FMP 全部预测年份;改它触发一次实时重算)
terminal_growth_pctnumberoptional永续增长率%,0–6,须显著低于折现率(否则自动钳制)
discount_rate_pctnumberoptional折现率/WACC%,5–30

oracle-event-detail

ParameterTypeRequiredDescription
event_idstringoptionalReal event id copied from a prior result — 'poly:0x<64hex>' from event-feed-list / event-feed-detail (prediction markets), or 'wc2026_<fixtureId>' from oracle-match-search (a single World Cup match). Never empty, never guessed, never the event title — resolve it via the matching search tool first.

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.
chainstringoptionalChain by plain name — ethereum/eth/以太坊, bsc/币安, base, arbitrum/arb, polygon/matic, optimism (hex id also accepted). No need to know the chain id. Omit to auto-pick: requested chain → Ethereum → first chain where the token exists.
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-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'.
viewstringoptionalrank = copy-trade ranking (default); leaderboard = profit leaderboard; top-holders (needs event_id) = whale distribution on an event; wallet-profile (needs address) = one wallet's stats; hotspots = site-wide money flow
addressstringoptional0x wallet address. REQUIRED when view=wallet-profile; ignored otherwise. Only use a concrete user-given address.
event_idstringoptionalPolymarket conditionId (0x… 32-byte hex). REQUIRED when view=top-holders; resolve via poly-markets (view=info) first.
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-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-markets

Polymarket market discovery & lookup. view=trending (default): trending markets from Gamma (per-market heat). view=new: recently-created markets (last `hours`). view=info (needs market_id): full detail for one market — price/volume/conditionId/slug/tokens; returns not_found|ambiguous|resolved. view=search (needs query): free-text search by name/team/country/candidate/slug, multilingual (zh-CN/zh-TW/en/ja/ko, translated to English first) — use this for long-tail markets the curated feed omits.

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'.
viewstringoptionaltrending = hot markets; new = recently created; info (needs market_id) = one market's full detail; search (needs query) = free-text lookup
limitintegeroptionalMax markets to return (trending/new/search)
categorystringoptionalFilter by category (trending/new)
min_liquiditynumberoptionalMin liquidity in USD. trending default 1000; search default 0 (max recall).
minLiquiditynumberoptionalAlias for min_liquidity (snake_case preferred)
hoursintegeroptionalLook back hours (view=new only)
market_idstringoptionalMarket reference for view=info: index, conditionId (0x…), Gamma ID, slug, or event/question text. REQUIRED when view=info.
querystringoptionalFree-text query for view=search (e.g. 'Tunisia 2026 World Cup', '突尼斯夺冠'). REQUIRED when view=search.
langstringoptionalLanguage of `query` (view=search); drives the translation step.
include_closedbooleanoptionalInclude closed markets (view=search).

poly-portfolio

Read a Polymarket wallet's portfolio. view=positions (default): current positions enriched with self-aggregated winRate/totalPnl/biggestWin intelligence. view=history: recent trade & transfer activity. Public API — no wallet signing needed.

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)
viewstringoptionalpositions = current holdings + PnL intel; history = recent activity feed
limitintegeroptionalMax activities to return (view=history only)

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-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_idstringoptionalOrder ID from poly-buy/poly-sell. Provided = single order; omitted = list.
statusstringoptionalFilter the order list by status (list mode only)
limitintegeroptionalMax orders to return (list mode only)

poly-strategy

PolyMaster logical-implication hedge strategy. action=scan (default): read-only scan for hedge opportunities — never places orders. action=metrics: strategy monitoring dashboard. action=dry-run: report/advise dry-run vs live execution mode (env-controlled; this tool advises but cannot override env at runtime).

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'.
actionstringoptionalscan = find hedge signals; metrics = dashboard; dry-run = report execution mode
limitintegeroptionalMax markets to scan (action=scan only)
min_tierstringoptionalMinimum signal tier to return (action=scan only)
enabledbooleanoptionalaction=dry-run only: true = dry-run (log only), false = live; omit to just report current mode
dry_runbooleanoptionalNo-op compatibility alias; use action=dry-run instead.

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: