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
125

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.

wallet-revoke-page

[Security] Generate a browser-openable page to REVOKE the wallet's ERC-20 approvals by sending approve(spender,0) from the user's own wallet. Inputs: `address` (0x owner) and `chain_id` are all you need. `approvals` is OPTIONAL. The tool fetches the wallet's real on-chain ERC-20 approvals itself (Etherscan V2) and builds the page from those addresses — you do NOT need to supply or repeat token/spender addresses. Returns `preview_url` — hand it to the user as a clickable link; they open it, connect wallet, revoke each entry, and sign in their own wallet. ⚠️ Addresses are ALWAYS taken from the live on-chain scan, never from model input. The optional `approvals` list is only a display-label / filter hint: entries that do not exactly match an on-chain approval are ignored (reported in `dropped_approvals`), so a mistyped or reconstructed address can never end up in the signable page. The page can ONLY emit approve(spender,0) (sets allowance to 0, never transfers assets); calldata is server-locked and non-custodial (Nina never signs or holds keys). [Read+Write]. [Reasoning: Low]. PRIORITY: Use whenever the user wants to actually revoke / cancel / 撤销 / 取消授权 a dangerous approval — just pass the wallet address + chain_id. Preferred over directing the user to revoke.cash; fall back to revoke.cash / wallet built-in manager only if this tool is unavailable. Keywords: revoke approval, cancel allowance, 撤销授权, 取消授权, one-click revoke page, approve spender 0, zero allowance, fix risky approval, 钱包授权撤销, hosted revoke signing page

ParameterTypeRequiredDescription
addressstringrequiredOwner wallet address (the approvals belong to this address)
chain_idintegerrequiredEVM chain ID. Default 1 (Ethereum mainnet).
approvalsarrayoptionalOPTIONAL. Display-label / filter hint only — NOT the address source. The tool fetches real approvals on-chain; each hint must exactly match an on-chain (token, spender) pair or it is ignored. Omit to offer every ERC-20 approval on the chain.
hosted_urlstringoptionalOptional URL shown in the page footer only

rh-kline

Robinhood 链(4663)现货 K线(GeckoTerminal 主池 OHLCV,与 xStock 同源多周期,read-only)。图表专用。

ParameterTypeRequiredDescription
symbolstringrequiredRH 股票代币符号("NVDA"/"TSM"…)或 0x 合约地址
intervalstringoptionalK线周期,默认 1h
limitintegeroptional蜡烛数量,默认 300
beforeintegeroptional历史翻页游标(UNIX 秒);只返回严格早于该时间的蜡烛

rh-swap-tokens

列出 Robinhood 链(4663)可交易代币。asset=stock(默认):USDG + 上架股票(美股页);asset=crypto:USDG + 加密资产(ETH/WETH/USDe/wstETH/VIRTUAL,兑换模块,不含股票)。

ParameterTypeRequiredDescription
searchstringoptional按符号/名称过滤(可选)
assetstringoptional资产类别:stock(默认,股票+USDG)/crypto(加密+USDG);省略=stock

rh-swap-quote

Robinhood 链(4663)现货报价 / firm quote(KyberSwap 聚合器,路由 v3/v4/propAMM 全池)。传 taker 时返回可直接签名的下单 tx(Kyber router)+ approve 提示。asset=stock(默认):股票 ↔ USDG;asset=crypto:加密资产互换(USDG/ETH/WETH/USDe/wstETH/VIRTUAL,自动经 USDG 中转,不含股票)。

ParameterTypeRequiredDescription
sell_tokenstringrequiredRobinhood 代币符号("NVDA"/"TSM"/"AAPL"/"USDG"/"ETH"/"WETH"…)或 0x 合约地址
buy_tokenstringrequiredRobinhood 代币符号("NVDA"/"TSM"/"AAPL"/"USDG"/"ETH"/"WETH"…)或 0x 合约地址
sell_amountstringrequired卖出数量(人类可读)
takerstringoptional下单钱包地址;传了才返回可签名 tx
slippage_bpsintegeroptional最大滑点 bps(50=0.5%);省略用默认
assetstringoptional资产类别:stock(默认,股票↔USDG)/crypto(加密互换);省略=stock

rh-market

Robinhood 链(4663)股票代币行情(read-only,顶栏/详情用):链上现价·24h成交量·市值·24h最高/最低·24h涨跌 + 正股最近收盘价 + 较收盘偏离。私司(SPCX)/未入 universe 的票无正股价 → 相关字段 null(前端「—」),链上字段仍返回。

ParameterTypeRequiredDescription
symbolstringrequiredRobinhood 代币符号("NVDA"/"TSM"/"AAPL"/"USDG"/"ETH"/"WETH"…)或 0x 合约地址

jupiter-swap-tokens

[Trading · Solana] Token catalog for Jupiter swaps on Solana, including tokenized US equities (xStock, e.g. AAPLx). query=<symbol/name/mint> → verified-token search; top=true → 24h volume Top list; no params → preset catalog (commons + xStock). Read-only lookup used to resolve symbols/mints before quoting. [Read-Only]. [Reasoning: Low].

ParameterTypeRequiredDescription
querystringoptional代币搜索词(symbol/名称/mint)
topbooleanoptionaltrue=返回 24h 交易量 Top 榜(选币器默认列表)
limitintegeroptional结果上限

xstock-pool-snapshot

[Market Data · xStock] On-chain snapshot for a tokenized US equity (xStock, e.g. AAPLx): market cap, holder count, and the main DEX pool's TVL, 24h volume, 24h high/low and last USDC price. Solana on-chain data (Jupiter + GeckoTerminal), NOT the underlying stock's exchange quote — for the real equity use us-stock-* tools or web search. [Read-Only]. [Reasoning: Low].

ParameterTypeRequiredDescription
symbolstringrequiredxStock symbol or mint (e.g. AAPLx)

jupiter-swap-quote

[Trading · Solana] Quote a token swap on Solana via Jupiter (incl. xStock tokenized equities): input_symbol + output_symbol + amount (atomic units) → expected output, price impact and route. Quote only — does NOT place an order or sign anything. For EVM-chain swaps use swap-quote / swap-full instead. [Read-Only]. [Reasoning: Low].

ParameterTypeRequiredDescription
input_symbolstringrequired卖出币 symbol 或 mint(如 USDC)
output_symbolstringrequired买入币 symbol 或 mint(如 AAPLx)
amountstringrequired卖出数量,最小单位(atomic)
slippage_bpsintegeroptional滑点 bps,50=0.5%

jupiter-trigger-list

[Trading · Solana] List a Solana wallet's Jupiter trigger (limit) orders: user=<base58 wallet pubkey>, status=active (default, open orders) or history. Read-only order listing — creating/cancelling trigger orders happens in the trading desk, not via chat. [Read-Only]. [Reasoning: Low].

ParameterTypeRequiredDescription
userstringrequiredSolana wallet public key (base58)
statusstringoptionalactive = open orders (default)
pageintegeroptional—

crosschain-swap-quote

[Trading · Cross-chain] Cross-chain (or same-chain) swap quote via LI.FI bridge routing: from/to chain + token + amount → bridge route, expected output, fees and ETA. Quote only — no signing, no custody; execution is client-signed in the trading desk. Solana-only swaps → jupiter-swap-quote; single-EVM-chain swaps → swap-quote / swap-full. [Read-Only]. [Reasoning: Low].

ParameterTypeRequiredDescription
from_chainintegerrequired源链数字 chainId(EVM 1/8453/42161/137/10;Solana=1151111081099710)
to_chainintegerrequired目的链数字 chainId(同上;同链兑换时与 from_chain 相同)
from_tokenstringrequired卖出币地址(EVM 0x…;Solana mint)
to_tokenstringrequired买入币地址(EVM 0x…;Solana mint)
from_amountstringrequired卖出数量,最小单位(atomic)
from_addressstringrequired发起(源链)钱包地址
to_addressstringoptional收款(目的链)地址;跨链尤其 EVM↔Solana 必传,缺省用 from_address
slippagenumberoptional滑点,小数分数(0.005=0.5%)
notional_usdnumberoptional本次兑换美元名义金额;用于金额分档路由(小额成本优先 / 大额≥门槛走可信桥白名单)。缺省/缺失=按小额处理(维持现状、不限桥)——大额若要走白名单保护,务必传本字段。

hyperliquid-market

[Market Data] Hyperliquid perp market data — `view` selects the feed. view=price (default): mark price for one coin, a comma-separated list, or top-10 if coin omitted. view=book (needs coin): L2 order book (bids/asks with depth). view=funding: funding-rate board sorted by magnitude (single coin via coin, else market-wide). ⚠️ Hyperliquid perps only. For CEX (OKX/Binance) market data → cex-market-quote. [Read-Only]. [Reasoning: Low]. Keywords: Hyperliquid price, HL mark price, perp order book L2 depth, funding rate board, top funding rates, HL market data

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

[Market Data] Hyperliquid candlestick (OHLCV) snapshot for a perp market — REST source for charts / TradingView datafeed. Supports HIP-3 builder-dex markets via dex:coin (e.g. "xyz:RDDT") and main-dex bare names (e.g. BTC). interval 1m..1M; start_time/end_time in unix ms. Returns an empty list when the requested range is outside Hyperliquid's retained window (~5000 candles per interval, no paging further back) — surface no-data instead of retrying. [Read-Only].

ParameterTypeRequiredDescription
coinstringrequiredAsset (dex:coin for builder markets, e.g. "xyz:RDDT"; bare for main dex e.g. BTC)
intervalstringrequiredCandle interval
start_timeintegerrequiredRange start (unix ms)
end_timeintegeroptionalRange end (unix ms); omit = now

hyperliquid-market-catalog

[Market Data] Full Hyperliquid perp market catalog across the main dex and all HIP-3 builder dexs (perpDexs × metaAndAssetCtxs), each market tagged with asset category (stock/index/commodity/forex/crypto) + sub-category, leverage/margin metadata, and latest mark/oracle/funding/OI. Powers the perp market selector and GET /perp/markets. Optional filters: category, dex ("" or "main" = main-dex crypto), include_delisted (default false). Snapshot cached ~30s. [Read-Only].

ParameterTypeRequiredDescription
categorystringoptionalFilter by top-level category
dexstringoptionalFilter by dex (e.g. "xyz"; "" or "main" = main dex crypto)
include_delistedbooleanoptionalInclude delisted markets (default false)

hyperliquid-spot-market-catalog

[Market Data] Full Hyperliquid SPOT market catalog (spotMetaAndAssetCtxs). Market keys are HL raw names — "@<index>" (e.g. "@107" = HYPE/USDC) or the one named pair "PURR/USDC" — which is what HL's l2Book/candle/allMids/fills/WS all require; each entry also carries a human `displayName` ("HYPE/USDC", bridge suffix 0 stripped: USDT0→USDT), the spot assetId (10000 + index), base/quote token info (szDecimals, weiDecimals, HyperEVM contract address), latest mark/mid/prevDay price, 24h volume, supply and marketCapUsd (circulatingSupply × markPx). Powers the spot market selector and GET /spot/markets. Optional filters: quote (raw token name, e.g. "USDC"/"USDT0"), coin (single market by raw key). Snapshot cached ~30s. Perps live in hyperliquid-market-catalog instead. [Read-Only].

ParameterTypeRequiredDescription
quotestringoptionalFilter by quote token **raw** name (e.g. "USDC", "USDT0"; display name strips the bridge suffix)
coinstringoptionalSingle market lookup by HL raw key (e.g. "@107" or "PURR/USDC")

hyperliquid-account

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

ParameterTypeRequiredDescription
addressstringrequiredWallet address (0x-prefixed 20-byte hex)

hyperliquid-orders

Get open orders for a Hyperliquid account.

ParameterTypeRequiredDescription
addressstringrequiredWallet address (0x-prefixed 20-byte hex)

hyperliquid-positions

Get open perp positions for a Hyperliquid account.

ParameterTypeRequiredDescription
addressstringrequiredWallet address (0x-prefixed 20-byte hex)

hyperliquid-balance-check

Pre-check if account has sufficient balance for a trade. order_type=""spot"" checks Spot USDC/coin balance; order_type=""perp"" checks Perp margin accountValue.

ParameterTypeRequiredDescription
addressstringrequiredWallet address (0x-prefixed 20-byte hex)
coinstringrequiredAsset to trade: perp coin (ETH/BTC/xyz:RDDT) or spot market key (@107 / PURR/USDC)
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 (spot: need the pair's quote token); false = sell (spot: need the base token)

wallet-balance-query

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

ParameterTypeRequiredDescription
addressstringrequiredWallet address (chain auto-detected from format)
freshbooleanoptionalBypass the server-side balance cache and read the chain RPC directly (result still refreshes the cache). Use right after a transaction when the post-trade balance must be observed; omit for normal reads.

wallet-activity-query

Fetch EVM wallet transaction history (sends, receives, trades, approvals) across all supported chains via DeBank. Returns up to 20 entries per page; use next_start_time to paginate to older entries.

ParameterTypeRequiredDescription
addressstringrequiredEVM wallet address (0x followed by 40 hex characters)
start_timeintegeroptionalUnix timestamp (seconds) to fetch history older than this point. Omit for the most recent page.

rh-swap-activity

Fetch Robinhood chain (chain 4663) on-chain swap activity for an EVM address via DeBank (chain_id=hood). Returns two-legged swaps (sell + buy leg per tx) used by the trading desk to replay cost basis / unrealized PnL for Robinhood US-equity holdings. Read-only; paginated server-side to cover the current position.

ParameterTypeRequiredDescription
addressstringrequiredEVM wallet address (0x followed by 40 hex characters)

cex-market-quote

[Market Data] Public market data for OKX / Binance — `view` selects the feed. view=ticker (default): real-time last price, 24h high/low, 24h volume, best bid/ask. view=kline: OHLCV candlesticks at a given interval/limit (1h/4h/daily…); add format='closes' for a compact `date close` series (no chart/raw rows) when computing an indicator in-context over a long window (TD Sequential counts, custom averages, consecutive runs). view=orderbook: live bids/asks with depth, for slippage estimation before large orders. ⚠️ For standalone BTC/ETH price without CEX context → data-price. instId MUST use exchange-native hyphen format — OKX: "INJ-USDT" (spot) / "INJ-USDT-SWAP" (perp); Binance: "INJUSDT". Never pass a raw ticker like "INJ" to OKX. [Read-Only]. [Reasoning: Low]. Keywords: CEX ticker last price, 24h change volume, best bid ask, candlestick OHLCV kline, 1h 4h daily candles, price history, order book bids asks, market depth, slippage estimation

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). If the pair is listed as a perpetual only (no spot), the tool retries the -SWAP contract automatically and flags it via `note` in the response.
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)
formatstringoptionalview=kline only. 'closes' returns a compact `date close` line series (no chart, no raw OHLCV rows) — use it when you need a LONG close series to compute an indicator in-context (TD Sequential counts, custom averages, consecutive up/down runs): 300 bars fit in a few KB instead of tens of KB. Default 'full'.
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 (view=summary). [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

[Account] Read a CEX account (OKX or Binance) — `view` selects granularity. view=balance (default): PER-CURRENCY breakdown — available (tradable) and frozen (in-order) per asset. view=summary: ACCOUNT-LEVEL snapshot — total equity (USD), unrealized PnL, net available, frozen balance. Requires API keys. ⚠️ Difference from wallet-balance-query: this queries a CEX custodial account; wallet-balance-query queries a self-custody on-chain address. [Read-Only]. [Reasoning: Low]. PRIORITY: view=balance for 'how much USDT/BTC do I have on the exchange'; view=summary for 'what is my total account value'. Keywords: CEX per-currency balance, available frozen split, how much USDT do I have, total equity, account summary, net balance, unrealized PnL, exchange portfolio overview

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. [Read-Only]. [Reasoning: Low]. Keywords: is API already configured, exchange connection status, credentials exist, setup complete

No parameters required.

airdrop-scan

[Research] Sweep the market for ALL currently active airdrop projects. Returns a filterable ranked list (chain, grade S/A/B, TVL, VC backing). Use when no specific project is in mind — this is the broad discovery sweep. ⚠️ Broad discovery sweep. NOT for one specific project (→ airdrop-check-project); NOT for pre-curated daily digest (→ airdrop-daily-report); NOT for checking link safety (→ airdrop-scam-check); NOT for projects whose token has ALREADY launched / post-TGE — those are no longer airdrop opportunities (→ data-token-universe for a sector list, data-token-info for one coin). Leave include_completed unset: it is a slow legacy opt-in that scans every launched protocol, not a way to list launched tokens. [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-social

[Crypto · Social] LunarCrush social intel for crypto tokens ONLY — not stocks, equities, ETFs or indices (e.g. AAPL, NVDA, SK Hynix / 000660.KQ). `view` selects the slice. view=score: sentiment (0-100) + galaxy_score for ONE token. Requires symbol. time_range "24h"|"7d" (default 24h). TOKEN_NOT_FOUND if no coverage — do not retry. view=trending: ranked list by AltRank (social volume × market performance). limit 1-50, default 10. No symbol. view=kol: who is discussing ONE token (top_creators) and which headlines (top_news). Requires symbol. No per-KOL post content or stance. TOKEN_NOT_FOUND if no coverage. view=surge: tokens with sudden AltRank jumps (social momentum). limit 1-50, default 10. No symbol. ⚠️ Crypto tokens only. For market-cap top-N → data-token-universe (view=ranking) (trending is hype, not cap). For Fear & Greed → data-sentiment. [Read-Only]. [Reasoning: Medium]. Keywords: social sentiment, galaxy score, social trending, AltRank, KOL signals, mention surge, social volume, social dominance, 社交情绪, 社交热度, 谁在讨论

ParameterTypeRequiredDescription
viewstringrequiredscore = one-token sentiment/galaxy; trending = AltRank list; kol = creators + headlines for one token; surge = AltRank jumps
symbolstringoptionalToken symbol (e.g. BTC, ETH, SOL). Required for view=score and view=kol.
time_rangestringoptionalview=score only: "24h" (live snapshot) or "7d" (7-day aggregate).
limitnumberoptionalview=trending|surge only: number of results (1-50)

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-deep-scan); NOT for DeFi protocol contracts (→ wallet-guard-token-deep-scan). [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-deep-scan). [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-deep-scan); NOT for wallet approvals (→ wallet-guard-approval-security); NOT for DeFi protocols (→ wallet-guard-token-deep-scan). [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-deep-scan). [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. ⚠️ Token-contract / honeypot / permission / DeFi rug-pull risk. The former quick scan and rug-pull tools were folded into this one — this is the remaining token-security path. [Read-Only]. [Reasoning: Very High]. PRIORITY: Default for token-contract security, honeypot, and DeFi rug-pull questions. Keywords: comprehensive token audit, 0-100 risk score, stablecoin ecosystem meme classification, deep honeypot cross-validation

ParameterTypeRequiredDescription
chain_idstringoptionalOPTIONAL. Leave EMPTY when the user does not explicitly name a chain — the tool then auto-detects which chain the contract/token lives on (do NOT assume Ethereum for a bare 0x address). Only set it when the user names a chain. EVM chain ID string. Common values: "1" = Ethereum, "56" = BSC, "137" = Polygon, "8453" = Base, "43114" = Avalanche, "42161" = Arbitrum
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; an address is also checked for impersonation of a known ticker. When chain_id is omitted the chain is auto-detected.
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. Supported chains: ethereum (1), bnb (56), polygon (137), base (8453).

ParameterTypeRequiredDescription
addressstringrequiredWallet address — raw 0x EVM address only (no ENS / domains).
chain_idstringoptionalChain name or EVM chain_id. Supported: ethereum (1), bnb (56), polygon (137), base (8453). Default "1" (ethereum).
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. Supported chains: ethereum (1), bnb (56), polygon (137), base (8453), solana.

ParameterTypeRequiredDescription
addressstringrequiredWallet address on the selected chain (EVM 0x, or native bitcoin / solana / tron). No ENS / domains.
chain_idstringoptionalChain name or EVM chain_id. Supported: ethereum (1), bnb (56), polygon (137), base (8453), solana. Default "1" (ethereum).
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). Supported chains: ethereum (1), bnb (56), polygon (137), base (8453), bitcoin, solana, tron.

ParameterTypeRequiredDescription
addressstringrequiredWallet address on the selected chain (EVM 0x, or native bitcoin / solana / tron). No ENS / domains.
chain_idstringoptionalChain name or EVM chain_id. Supported: ethereum (1), bnb (56), polygon (137), base (8453), bitcoin, solana, tron. Default "1" (ethereum).
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.
countrystringoptionalBoost results from a specific country. Lowercase English country name (e.g. 'united states', 'japan'). Only meaningful for region-specific queries; omit for global topics. Ignored when recency is set.

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 (per slice)
offsetintegeroptionalCharacter offset into the cached full-text snapshot (requires docRef on follow-up)
lengthintegeroptionalSlice length in characters; defaults to maxLength
includeOutlinebooleanoptionalWhen true (default on first fetch), include outline[] of section boundaries
docRefstringoptionalSnapshot id from a prior extract. When set, only slices the cached doc — never re-fetches.

research-financial-comparison

[Present] Submit a multi-year financial comparison table for SEC 20-F / 10-K style due diligence. Does NOT fetch data — you must already have extracted numbers from document slices. Call once BEFORE final_answer when the user needs cross-year revenue / net income / operating cash flow / debt balance (or similar) aligned in one table. Every non-null value requires a source (metric.source or per-cell source). Keywords: financial comparison, multi-year, 20-F, 10-K, revenue, net income, cash flow, debt. [Read-Only]. [Reasoning: Low].

ParameterTypeRequiredDescription
titlestringoptionalCard title, e.g. 三年财务对照
entitystringoptionalCompany / issuer name
currencystringoptionalReporting currency, e.g. USD
yearsarrayrequiredColumn headers in render order, e.g. ["2023","2024","2025"]
metricsarrayrequiredOne row per financial metric
generated_atstringoptionalISO timestamp; server fills if omitted
source_metaobjectoptionalDocument-level provenance (SEC EDGAR / Form 20-F / …)
footnotesarrayoptionalOptional footnotes shown under the table

data-macro-all

[Market Data] Full US macro snapshot in one call. Returns LATEST values for 13 core indicators: cpi, nfp, m2, yieldSpread, unemployment, sahm, fedRate, sp500, nasdaq, vix, us10y, dxy, gold. Use `series` param with EXACT keys above to select a subset, e.g. ["cpi","sp500","nasdaq"]. Omit series for all 13. ⚠️ CALIBER — each indicator ships the caliber the market actually quotes, and the tags are load-bearing: CPI-family MoM is a PERCENT and seasonally adjusted (tagged SA) while its YoY is NOT seasonally adjusted (tagged NSA) — that split is the BLS convention, not an inconsistency. nfp's MoM is an ABSOLUTE delta in thousands (the headline "+X thousand jobs"), NOT a percent, and its headline value is the payroll LEVEL. fedRate reports the effective rate (DFF, a market outcome) alongside the FOMC target range (the policy instrument) — a rate forecast or consensus is quoted against the target's UPPER bound, never against the effective rate. ⚠️ EXPECTATIONS — when a requested indicator has one, the response carries a separate `expectations` block: the economists' consensus (FMP), a model nowcast (Cleveland Fed, inflation only) and the next scheduled release instant. These are for an UNPUBLISHED reference period (today's CPI reading is July's; the consensus is August's), so NEVER difference an expectation against the snapshot's headline number. Each row names the one published field it IS comparable to in `compares_to` — use only that. A row without `compares_to` (e.g. m2) has no comparable published figure and carries a release date only — and a row whose `compares_to` target is missing from the snapshot, or whose caliber that snapshot does not declare, has its consensus and nowcast withheld for the same reason. If a row shows only a release date, that is the tool saying there is nothing here you may difference; do not substitute a nearby number. Coverage is upstream-limited: cpi, coreCpi, nfp, unemployment, fedRate, m2 and sahm have entries; the continuously-quoted series (sp500, nasdaq, vix, us10y, dxy, gold, silver, wti, btc, eth) have none, because a scheduled release is not a concept that applies to them. The expectation rows appear ONLY when you name the series you want in `series` — the default 13-indicator snapshot omits them entirely (its text has no room). So for any question about a forecast, a consensus, a nowcast or an upcoming release, call this tool with the specific series, e.g. `series: ["cpi"]` or `series: ["fedRate"]`, and ask for AT MOST 2-3 at a time — a wider call pushes the later rows out of the response you can read. Asking for cpi also covers coreCpi only if you name coreCpi too. Release times are SCHEDULED, never guaranteed: a print can be postponed or cancelled (the 2025-10 US CPI never appeared at all), so say "scheduled for", not "will be released". `next_release_scheduled_at` is canonical UTC and `next_release_et` is the same moment on the US Eastern clock — quote the ET one when explaining the schedule, because that is where it is anchored (08:30 ET year-round) while the UTC instant shifts an hour at each DST change. A row with `next_release_precision: "day"` carries an ET calendar date with no clock time; do not invent one. Optional extras, excluded from the default snapshot — request them explicitly via `series`: coreCpi (CPI ex food and energy — the gauge the FOMC targets, same SA/NSA split as headline), silver, wti, btc, eth, and jpyNetPositioning (CFTC weekly Commitments of Traders: Japanese Yen non-commercial net position in contracts — the yen carry-trade crowding gauge, plus its historical percentile since 1986 and the Leveraged Funds cut. This is POSITIONING, not the USD/JPY exchange rate). 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, market expectations, 市场预期, consensus, 共识预期, nowcast, 模型预测, next release, 下次公布, economic calendar, 财经日历(宏观数据发布,**不是美股财报名单**;问哪些公司在某天发财报用 us-stock-earnings-calendar), fed rate, fed funds target range, effective fed funds rate, core CPI, 核心CPI, seasonally adjusted, cpi, sp500, nasdaq, 纳斯达克, treasury yield, gold, vix, yen carry trade, JPY positioning, CFTC, Commitments of Traders, speculative net position, futures positioning

ParameterTypeRequiredDescription
seriesarrayoptionalIndicator keys to return, e.g. ["cpi","sp500","nasdaq"]. 13 core (default): cpi, nfp, m2, yieldSpread, unemployment, sahm, fedRate, sp500, nasdaq, vix, us10y, dxy, gold. Optional extras: coreCpi, silver, wti, btc, eth, jpyNetPositioning. Omit to get all 13 core (extras excluded by default).

data-token-info

[Market Data] Look up any crypto token or project by symbol or name (e.g. HYPE, PEPE, Hyperliquid). Returns price, 24h–1y performance, market cap, FDV, volume, ATH, supply, TVL (DeFi tokens), project intro, homepage, contract addresses, community sentiment, and top venues. Returns a candidate list when the symbol is ambiguous. ⚠️ Input must be a token symbol or name — NOT a wallet address or tx hash. NOT for meme ratings (→ meme-analyze), wallet/contract risk (→ wallet-guard-address-security), token security audits (→ wallet-guard-token-deep-scan), or single-pair tickers (→ cex-market-quote (view=ticker)). For a DeFi protocol's TVL/fees use data-defi-protocol; for market-wide DeFi structure use data-onchain-defi. [Read-Only]. [Reasoning: Low]. Keywords: token lookup, coin info, project intro, what is this project, what does this coin do, circulating supply, FDV, fully diluted valuation, ATH all-time high, contract address, homepage, market cap rank, altcoin info, HYPE PEPE SOL DOGE token info

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-onchain-defi; for DeFi yield-product discovery → investor_discover; for rug-pull / contract risk → wallet-guard-token-deep-scan. 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: RSI (14), MA200 (+ deviation %), MACD, Bollinger Bands, plus 52-week high/low range and ATH (with distance). Each indicator includes a pre-computed level label. BTC is always available (incl. the 52-week / ATH anchors); other liquid assets (e.g. ETH, SOL) are computed on-demand from CoinGecko OHLC, including their 52-week range and ATH (a newer coin's window may be < 1 year — see `is_full_52w`). Optional `indicators` subset (['rsi','ma200','macd','bollinger','levels']) — omit for all. OPT-IN 'td_sequential' (request explicitly in `indicators`): TD Sequential (TD9/TD13, Tom DeMark) setup counting on daily AND weekly bars + same-week daily/weekly confluence — use for EVERY TD9 / TD Sequential / 神奇九转 question; NOT related to T3 trendline. `indicators` ONLY supports the 200-day MA as `ma200`; do NOT pass any other maNN (e.g. ma20 / ma7 / ma50) here. Optional `ma_periods` (number[], in days, e.g. [20] or [7,30,60], 2–200, ≤8): custom-period daily moving averages returned under `indicators.moving_averages` — use THIS (not `indicators`) for EVERY specific-period average the user names, e.g. "20MA / 30-day MA / 近30日均价 / MA7"; never substitute MA200. Optional `rsi_periods` (number[], in days, e.g. [21] or [7,21], 2–200, ≤8): custom-period RSI returned under `indicators.rsi_series` — use THIS for EVERY RSI period the user names other than 14, e.g. "RSI21 / RSI(7) / 21日RSI"; `indicators.rsi` is ALWAYS the 14-day reading, so never relabel it as another period. Optional `macd_fast`/`macd_slow`/`macd_signal` (default 12/26/9) and `bollinger_period`/`bollinger_mult` (default 20 / 2σ): pass these for ANY MACD or Bollinger setting the user names, e.g. "MACD(5,35,5)" or "布林带 2.5 倍标准差"; the values under `indicators.macd.params` / `indicators.bollinger.params` always say which settings produced the number. Optional `timeframe:'weekly'`: same indicators on COMPLETED ISO weekly bars (Mon 00:00 UTC, the Binance/OKX convention) — use it for "周线 RSI / 周线 MACD / weekly chart"; every period is then in WEEKS, and it is BTC-only (other assets get a notice rather than a too-short reading). 'td_sequential' does NOT follow it — that reading already covers daily AND weekly, so request it on its own. The weekly series spans ~104 completed weeks (data-plan ceiling), so weekly RSI/Bollinger/MA work while weekly MACD and MA200 report available:false. [Read-Only]. [Reasoning: Low]. PRIORITY: Default for "technical indicators / RSI / RSI21 / MA / MA20 / MA50 / MA200 / MACD / Bollinger / 52-week position" on any liquid asset. For on-chain valuation (AHR999, Puell) use data-onchain-valuation. Illiquid / unknown tokens → cex-market-quote (OHLCV/klines) or data-token-info (token overview). Keywords: RSI, RSI7, RSI21, RSI(21), 21日RSI, 多周期RSI, custom RSI period, 周线, 周线RSI, 周线MACD, weekly timeframe, weekly chart, 周K, MACD参数, MACD(5,35,5), 布林周期, 布林带倍数, custom MACD, custom Bollinger, TD9, TD13, TD Sequential, 神奇九转, 神奇九轉, 九转序列, DeMark, MA200, MA7, MA20, MA30, MA50, 20MA, moving average, 20日均线, 30日均价, MACD, Bollinger Bands, technical indicators, 52-week high low, ATH, all-time high, overbought, oversold, technical analysis, TA, ETH technicals, SOL technicals, altcoin RSI.

ParameterTypeRequiredDescription
assetstringoptionalAsset symbol, e.g. btc / eth / sol. Omit for btc.
indicatorsarrayoptionalOptional subset: ['rsi','ma200','macd','bollinger','levels']. Omit for all of those. 'td_sequential' (TD9/TD13 setup counting, daily + weekly + same-week confluence) is OPT-IN — returned ONLY when explicitly listed here, never by default.
ma_periodsarrayoptionalCustom simple-moving-average periods in BARS of the current timeframe (DAYS by default, WEEKS when timeframe:'weekly'), e.g. [30] for the 30-day average, [7,30,60] for several. 2–200 bars, up to 8 periods (on the weekly frame the warmed series is ~104 weeks, so anything beyond that is flagged available:false). Returned under indicators.moving_averages as {period,value,deviation_pct,level,available}; a period beyond available history is flagged available:false rather than substituted. Omit for none.
rsi_periodsarrayoptionalCustom RSI periods in BARS of the current timeframe (DAYS by default, WEEKS when timeframe:'weekly'), e.g. [21] for RSI(21), [7,21] for several. 2–200 bars, up to 8 periods. Use this whenever the user names a period other than 14 — do NOT report RSI(14) as if it were the period they asked for. Returned under indicators.rsi_series as {period,value,level,available,min_bars} — read `available` FIRST: a period the series can't support comes back available:false with value:null and a neutral placeholder level, never substituted with another period's reading, and `min_bars` states how many bars that period actually needs: Wilder's period+1 on the daily frame, and on weekly the convergence floor of 5x the period. Since the warmed weekly series is only ~104 completed weeks (our data plan's 2-year ceiling), weekly RSI is served for periods up to ~20 (5x20=100) and refused above that — a weekly RSI(21) needs 105 bars and a weekly RSI(60) needs 300, so both come back available:false. Daily is unaffected. Independent of the `indicators` subset. Omit for none (the default RSI(14) still ships under indicators.rsi).
timeframestringoptionalBar frame for RSI / MA200 / MACD / Bollinger and the ma_periods / rsi_periods ladders. 'weekly' = completed ISO weeks (Mon 00:00 UTC, the Binance/OKX-1Wutc convention), so every period you pass is counted in WEEKS. Omit for daily. BTC only — other assets return a notice. Two things do NOT follow this switch: `levels` (52-week range / ATH) is calendar-based, and 'td_sequential' always reads the daily series — its result already contains daily AND weekly TD readings, so ask for it on its own rather than expecting timeframe to change it. DEPTH: the weekly series spans ~2 years (~104 completed weeks) because that is our data plan's historical ceiling, so weekly MACD (needs ~130 bars to converge) and a weekly MA200 (needs 200) come back available:false — weekly RSI, Bollinger and MA(n≤104) are served normally.
macd_fastintegeroptionalMACD fast EMA length in BARS of the current timeframe (DAYS by default, WEEKS when timeframe:'weekly') (default 12). Must be shorter than macd_slow.
macd_slowintegeroptionalMACD slow EMA length in BARS of the current timeframe (DAYS by default, WEEKS when timeframe:'weekly') (default 26).
macd_signalintegeroptionalMACD signal (DEA) EMA length in BARS of the current timeframe (DAYS by default, WEEKS when timeframe:'weekly') (default 9).
bollinger_periodintegeroptionalBollinger moving-average length in BARS of the current timeframe (DAYS by default, WEEKS when timeframe:'weekly') (default 20).
bollinger_multnumberoptionalBollinger standard-deviation multiplier (default 2; 2.5 = wider bands).

data-onchain-valuation

[Market Data] Get on-chain valuation indicators for BTC, NETWORK-wide and by HOLDER COHORT. Network-wide: AHR999 (DCA valuation), Puell Multiple (miner-revenue valuation), MVRV Z-Score and MVRV Ratio (market-value vs realized-value), each with a pre-computed level label. Cohort (holder age band — a DIFFERENT measurement, never a substitute for the network figures): cohort_realized_price_sth / cohort_realized_price_lth are that cohort's realized price, i.e. its average cost basis in USD — the 「解套墙」 level where the cohort breaks even; cohort_mvrv_sth / cohort_mvrv_lth are that day's close divided by the same cost basis, so above 1 means the cohort is in aggregate profit. STH = coins last moved within 155 days, LTH = coins untouched for 155 days or more (this is COIN AGE, not how long an account has held). Cohort values are daily closes against that day's cost basis, not intraday. Optional `indicators` subset (['ahr999','puell','mvrv_zscore','mvrv_ratio','cohort_realized_price_sth','cohort_realized_price_lth','cohort_mvrv_sth','cohort_mvrv_lth']; 'mvrv' is shorthand for both NETWORK MVRV indicators only and never includes the cohort ones, 'cohort' is shorthand for all four cohort indicators) — omit for all. [Read-Only]. [Reasoning: Low]. PRIORITY: Default for "is BTC cheap/expensive on-chain / accumulation zone / miner valuation / MVRV" — an unqualified "MVRV" means the NETWORK ratio, which is the one wired into token-intel as cycle.mvrv_ratio. Use the cohort indicators for "short-term holder cost basis / long-term holder cost basis / 解套墙 / 某持币年龄段的平均成本 / STH MVRV / LTH MVRV"; never report a cohort value as the network MVRV or vice versa. These 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: MVRV, MVRV Z-Score, MVRV Ratio, AHR999, Puell Multiple, on-chain valuation, overvalued, undervalued, accumulation zone, realized price, cost basis, 成本线, 解套墙, cohort MVRV, STH, LTH, short-term holder, long-term holder, 短期持有者, 长期持有者, STH realized price, LTH realized price, holder cohort, coin age, 持币年龄

ParameterTypeRequiredDescription
assetstringrequiredAsset symbol. Currently only 'btc' is supported.
indicatorsarrayoptionalOptional subset. NETWORK-wide: 'ahr999','puell','mvrv_zscore','mvrv_ratio' ('mvrv' is shorthand for both MVRV indicators and NEVER includes the cohort ones). COHORT (holder age band, a different measurement): 'cohort_realized_price_sth'/'cohort_realized_price_lth' are the cohort cost basis in USD — the level a cohort breaks even at — and 'cohort_mvrv_sth'/'cohort_mvrv_lth' are that day's close divided by it ('cohort' is shorthand for all four). STH = coins last moved within 155 days, LTH = coins untouched for 155 days or more; this is coin age, not how long an account has held. Omit for all (btc).

data-derivatives

[Market Data] Get CEX derivatives market structure for an asset: funding rate, futures premium (annualized), aggregated all-venue futures open interest (cex_oi; Coinglass total — a COIN COUNT, not USD: e.g. 701,834 BTC. Despite the metric name it spans CEX + CME + on-chain perps, not CEX only), rolling 24h liquidations with long/short split (imbalance), and options metrics. COVERAGE FOLLOWS THE UPSTREAM, not a fixed asset list: funding_rate, futures_premium, cex_oi, liquidations, funding_by_exchange and oi_by_exchange work for BTC and every other liquid asset (btc, eth, bnb, sol, xrp, doge, ada verified; others are fetched on-demand and return a notice if they fail the liquidity gate). The three options metrics are served wherever their upstream carries them — options_max_pain and options_oi from Coinglass, options_skew_25d from Deribit — whether or not a warm cache exists for that asset, so do NOT assume they are BTC-only. When a metric has no value the response says WHY via `coverage`: "not_covered" = the upstream itself reports no such market for that asset (e.g. Deribit lists no BNB options in either its coin-margined or its USDC-margined chain), "unwired" = an upstream has it but we have not connected it. Neither is an error, and a plain error_reason WITHOUT `coverage` is a transient failure that says nothing about coverage — do not read it as "this market does not exist". options_skew_25d is the 25-delta risk reversal at a 30-day constant maturity, in volatility points, convention call minus put (POSITIVE = the call wing is bid over the put wing). It ships with its own `convention`, `tenor_days` and `chain` fields — always read the sign and the tenor from those, never assume. `chain` says which Deribit book the reading came from: "coin_margined" (BTC, ETH) or "usdc_linear" (SOL and other altcoins). The two books quote independently and differ by a few percent on the same asset, so compare values across assets with that in mind. options_skew_25d is NOT the futures premium and NOT max pain. Opt-in per-exchange drill-downs (request via metrics): funding_by_exchange — each exchange's funding rate + cross-exchange spread for arbitrage (eq8h = equivalent-8h cost at the current rate, an extrapolation); oi_by_exchange — per-exchange OI breakdown + venue concentration. Illiquid / unknown tokens return a notice — use data-token-info for those. A cold on-demand read returns immediately: cached metrics are included, anything still missing is 暂缺 while a background fetch fills the cache. Do not call data-derivatives again for that same asset in the same turn; a later turn reads the cache. Assess leverage, positioning crowding, liquidation risk, options-market sentiment. For on-chain DEX open interest use data-onchain-defi; for smart-money flow use data-flows. 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, for cross-exchange funding arbitrage or per-exchange OI concentration, and for options skew / risk reversal / volatility-smile / max pain questions on any asset whose upstream carries them. 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, liquidation imbalance, long vs short liquidations, 24h liquidations, options max pain, options open interest, 25 delta skew, risk reversal, options skew, volatility skew, put call skew, implied volatility smile, leverage, derivatives, positioning, ETH derivatives, SOL derivatives

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, options_skew_25d); omit for all of them. The per-exchange drill-downs funding_by_exchange / oi_by_exchange are OPT-IN — returned ONLY when explicitly listed here, never by default.

data-funding-scan

[Market Data] Scan the WHOLE crypto market for cross-exchange perpetual funding-rate dislocations — the screener behind funding-arbitrage discovery. No asset argument; ranks every symbol in the funding feed. sort='spread' (default) = widest cross-exchange gap (top venue − bottom venue, eq8h %); sort='high' = most positive funding (crowded longs); sort='low' = most negative (crowded shorts). Each row carries the top/bottom venue + rate, exchange_count, both_legs_earn, arbitrageable, extreme_legs and excluded_outliers. eq8h extrapolates the current rate and the spread is gross (pre-fees) — a signal, not risk-free profit. [Read-Only]. [Reasoning: Low]. PRIORITY: Default for market-wide funding screening when NO specific asset is named. For ONE named asset's per-exchange funding breakdown or full derivatives card → data-derivatives. Keywords: funding rate scan, cross-exchange funding, funding arbitrage, funding spread, highest funding, most negative funding, crowded longs, crowded shorts, perp funding screener, market-wide funding

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: spot ETF net flow covers BTC, ETH and SOL; Coinbase premium (US institutional bias) and taker buy/sell ratio stay BTC-only. 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), eth, or sol for etf_flow; coinbase_premium and taker_ratio are btc-only; other 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: exchange reserve (BTC and ETH — total coins held on exchanges; falling reserves imply accumulation / reduced sell pressure); stablecoin exchange net inflow (USDT+USDC daily net flow into exchanges — positive = inflow, negative = outflow; market-level, no asset required). Optional `metrics` (['exchange_reserve','stablecoin_exchange_inflow']) — omit for all. [Read-Only]. [Reasoning: Low]. PRIORITY: Default for exchange-reserve / sell-pressure / accumulation questions, and for stablecoin exchange inflow/outflow questions. For stablecoin minting/burning (supply change) use data-market-structure. For off-chain market flow (spot ETF, Coinbase premium, taker ratio) use data-flows. For assets not covered by this tool, use cex-market-quote (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, stablecoin exchange inflow, stablecoin exchange outflow, USDT inflow, USDC inflow.

ParameterTypeRequiredDescription
assetstringoptionalAsset symbol for exchange_reserve: 'btc' or 'eth' (default btc). Other assets (e.g. sol, bnb) are not covered and return an explicit note. Ignored for stablecoin_exchange_inflow (cross-chain aggregate).
metricsarrayoptionalOptional subset. Omit for all available metrics.

data-miner-treasury

[Market Data] Get the aggregate BTC treasury held by LISTED MINING COMPANIES and its day-over-day change — a slow-supply / sell-pressure gauge (steady, strategic selling rather than panic). ⚠️ Sourced from COMPANY DISCLOSURES (CoinGecko's public-treasury list, compiled from 10-Q/10-K/8-K and press releases), NOT from on-chain observation. ⚠️ The upstream publishes NO date of its own, so as_of is OUR observation day (as_of_basis: observation_day) and the lag cannot be bounded — measured against SEC quarter-ends it runs in BOTH directions. Never present as_of as an upstream data date. `metrics`: 'miner_treasury' (default — total BTC + USD, day-over-day change with the baseline's own date, roster entered/exited, and a coverage block naming how many of the tracked public holders are counted plus any company set aside from the total); 'miner_treasury_companies' (OPT-IN — the full per-company breakdown with each company's classification evidence); 'miner_treasury_filings' (OPT-IN — the quarterly SEC-filings cross-check; a DIFFERENT caliber, 41+ days older by construction and scoped to SEC filers, which must never be added to or reconciled against the daily total). BTC only. [Read-Only]. [Reasoning: Low]. PRIORITY: Default for "how much BTC do listed miners hold / are miners selling / miner treasury / 矿企金库 / 矿工持仓". A roster change moves the total without anyone trading a coin — read entered/exited before calling a jump a flow. For coins held on exchanges use data-onchain-flows (exchange reserve); for miner-revenue valuation use data-onchain-valuation (Puell Multiple); for hashrate or mining economics this tool has nothing. Keywords: miner treasury, listed miners, mining companies, public miners, 矿企金库, 矿工持仓, 上市矿企, miner holdings, miner selling, miner sell pressure, MARA, Riot, CleanSpark, Hut 8, corporate bitcoin holdings, treasury holdings

ParameterTypeRequiredDescription
assetstringoptionalAsset symbol; only 'btc' is covered (the upstream is a bitcoin-treasury list). Default btc.
metricsarrayoptionalOptional subset. Omit for the daily aggregate only — the per-company breakdown and the quarterly filings cross-check are OPT-IN and returned only when listed explicitly.

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-token-universe

[Market Data] Cross-sectional multi-factor snapshot of a crypto universe. Each row: raw market fields (market_cap, FDV, volume, returns 7d/30d/200d/1y, ATH change, circ_ratio, turnover, amplitude_24h, excess returns vs BTC) PLUS 10 clean-subset z-scores (z_ret_7d, z_ret_30d, z_ret_200d, z_ret_1y, z_excess_7d, z_excess_30d, z_turnover, z_amplitude, z_ath_change, z_circ_ratio) computed over the non-stable/non-wrapped/non-LST subset with 5/95 winsorization. Stablecoin / wrapped / LST flags per row. `universe` accepts "top50" (default), "top100", or a sector category alias: layer-1, layer-2, decentralized-finance-defi, meme-token, liquid-staking, artificial-intelligence, real-world-assets-rwa, gaming, smart-contract-platform, oracle. Category requests fetch up to 100 coins by market_cap_desc within that sector; `count` reflects the actual number returned. Any other universe value is rejected. `symbols` (or `ids` for exact CoinGecko ids, max 100) replaces the slice with a custom coin list — e.g. compare a specific holding set; every row echoes `coin_id` because a symbol can belong to several coins upstream, and unresolvable entries are returned in `unresolved`. z-scores still require >= 10 non-stable/wrapped/LST rows, so a short custom list returns all z fields null. Pass only ONE of universe / symbols / ids. Optional `metrics` selects factor groups — default ["spot"], the 5-min cross-section, which is the BASE group and is always included (row identity comes from it, so ["timeseries"] is treated as ["spot","timeseries"] and echoed that way in factor_groups). "timeseries" adds the daily-updated ret_90d / volatility_60d (annualized) / max_drawdown_90d / beta_vs_btc and their z-scores, pre-computed once a day for the market-cap top100 pool: rows outside that pool are null with timeseries_reason=out_of_daily_universe, and before the day lands every row reads job_not_run (still a normal response, not an error). "fundamentals" adds tvl (+tvl_source: chain|parent|protocol) / mcap_tvl / fees_annualized / fees_mcap, from DefiLlama, with z ONLY on the two ratios (z_mcap_tvl, z_fees_mcap) — the absolutes span orders of magnitude so their z would just re-rank by size. Availability is reported per PRODUCER, not per group: if the fundamentals fetch failed for a day while the timeseries factors landed, fundamentals reads job_not_run and its four fields stay in missing_factors; and since TVL and fees come from different endpoints that fail independently, missing_factors reports the pairs separately (a dead fees endpoint leaves fees_annualized/fees_mcap listed while tvl/mcap_tvl serve normally). A failed fetch therefore never masquerades as "these coins have no TVL/fees" — check missing_factors before reading a null as zero; and a slice where no coin has the metric (a memecoin sector) reports reason=not_applicable rather than insufficient_history, since retrying cannot help. This group is sparse by nature: roughly half the top100 (stablecoins, CEX platform tokens, wrapped/LST, memecoins) has no TVL concept, so those rows are null with no reason, and the two z fields may be null when the valid sample is under 10. tvl is DefiLlama's own deduped figure at the caliber named in tvl_source (a chain token gets its chain's TVL, a protocol token its whole protocol family's), a point-in-time reading taken minutes after the trade_date close (DefiLlama publishes no dated point to read instead), and fees_annualized is a trailing-1y window; mcap_tvl / fees_mcap divide by the LIVE market_cap in this response so the arithmetic checks out against the fields shown. Custom lists (symbols/ids) support only ["spot"]. Per-group freshness + caliber are reported under `source_meta.groups`, and `factor_groups` echoes which groups the response covers. Optional `sort` ("market_cap" default, "volume", or "change_24h") changes display order only; membership is always market_cap top-N (or category market_cap_desc) first then sorted. `view=ranking` is the market-cap leaderboard (limit 1–100, default 10) — NOT crypto-social view=trending (hype, not cap). The two views take disjoint params: mixing `limit` with universe/sort/symbols/ids/metrics is rejected with a message naming them, never silently ignored. For one coin's full detail use data-token-info. [Read-Only]. [Reasoning: Medium]. PRIORITY: Default for "top N by market cap / top 10 coins / 市值前十 / 市值排行" → view=ranking. Multi-factor / sector / custom list → view=universe (default). Keywords: token universe, cross-sectional, multi-factor, z-score, factor groups, metrics groups, per-group freshness, custom coin list, compare these coins, my holdings comparison, specific symbols, coin_id, top 50 coins, top 100 coins, factor snapshot, winsorized returns, excess returns, turnover z-score, amplitude, circ ratio, stablecoin flag, wrapped token, LST flag, sector category, layer-1, layer-2, defi, meme token, liquid staking, AI, RWA, gaming, oracle, smart contract platform, top coins, top 10 coins, top N by market cap, market cap ranking, 市值排行, 市值前十, 90 day return, annualized volatility, max drawdown, beta vs BTC, risk adjusted momentum, daily factors, as_of_date, TVL, mcap to TVL, market cap to TVL ratio, protocol fees, annualized fees, fees to mcap, DefiLlama, fundamentals group, 协议基本面, 锁仓量, 市值锁仓比

ParameterTypeRequiredDescription
viewstringoptionaluniverse (default) = multi-factor snapshot; ranking = market-cap leaderboard for "top N / 市值前十".
limitintegeroptionalview=ranking only: how many top coins (1–100, default 10). Passing it together with universe/sort/symbols/ids/metrics is rejected — those belong to view="universe".
universestringoptionalUniverse slice: "top50" (default), "top100", or a sector category alias (layer-1, layer-2, decentralized-finance-defi, meme-token, liquid-staking, artificial-intelligence, real-world-assets-rwa, gaming, smart-contract-platform, oracle). Any other value is rejected with the list of valid values.
metricsarrayoptionalFactor groups to include. Default ["spot"] — the 5-min cross-section, which is the BASE group and is always included (row identity and universe membership come from it), so ["timeseries"] is treated as ["spot","timeseries"] and echoed that way in factor_groups. "timeseries" adds the daily-updated ret_90d / volatility_60d (annualized) / max_drawdown_90d / beta_vs_btc and their z-scores. "fundamentals" adds tvl (+tvl_source: chain|parent|protocol) / mcap_tvl / fees_annualized / fees_mcap, with z only on the two ratios — the absolutes span orders of magnitude, so their z would just re-rank by size. Both daily groups are pre-computed for the market-cap top100 pool: rows outside it are null with <group>_reason=out_of_daily_universe, and before the day lands every row reads job_not_run (a normal response, not an error). Availability is reported per PRODUCER, not per group: if the fundamentals fetch failed for a day while the timeseries factors landed, fundamentals reads job_not_run and its four fields stay listed in missing_factors; and because TVL and fees come from different endpoints that fail independently, missing_factors reports the pairs separately — a dead fees endpoint leaves fees_annualized/fees_mcap listed while tvl/mcap_tvl are served normally. So a failed fetch never masquerades as "these coins have no TVL/fees"; always check missing_factors before concluding a null means zero. At group level, a slice where no coin has the metric at all (e.g. a memecoin sector asked for fundamentals) reports reason=not_applicable rather than insufficient_history: retrying will not help, because a stock metric has no window to fill. Expect fundamentals to be sparse by nature — roughly half the pool (stablecoins, CEX platform tokens, wrapped/LST, memecoins) has no TVL concept at all, so those rows are null with no reason, and z_mcap_tvl / z_fees_mcap may be null when the valid sample is under 10. tvl and fees are point-in-time readings taken minutes after the trade_date close (DefiLlama publishes no dated point), and fees_annualized is a trailing-1y window; mcap_tvl / fees_mcap divide by the LIVE market_cap in this response, so the arithmetic checks out against the fields shown. Custom lists (symbols/ids) support only ["spot"]. Per-group freshness + as_of_date + caliber live under source_meta.groups.
symbolsarrayoptionalCustom universe from an explicit symbol list (max 100), e.g. ["sol","jup","wif"]. Mutually exclusive with `universe` and `ids`. Symbols are resolved by CoinGecko's own disambiguation and a symbol can belong to several coins, so every row echoes `coin_id` — check it, or use `ids` for exact addressing. Unresolvable entries come back in `unresolved`. If the list contains no BTC row, the excess-vs-BTC factors read the shared top100 snapshot (one extra upstream call on a cold cache). NOTE: z-scores need >= 10 non-stable/wrapped/LST rows (unchanged N<10 rule), so a short list returns all z fields null.
idsarrayoptionalCustom universe from an explicit CoinGecko id list (max 100), e.g. ["solana","jupiter-exchange-solana"]. Exact — no symbol ambiguity. Mutually exclusive with `universe` and `symbols`. Same N<10 z rule as `symbols`.
sortstringoptionalSort order of returned rows: "market_cap" (default, desc), "volume" (desc), or "change_24h" (desc). Sort only changes display order — universe membership is always market_cap top-N (or category market_cap_desc) first. Nulls sort last.

data-price

[Market Data] BTC/ETH are always available (prefetched); other tokens (bnb, sol, xrp, doge, ada, etc.) are fetched on-demand. Get crypto price quotes. asset='btc' → BTC price + valuation/level anchors (MA200, RSI, AHR999, 52-week high/low, ATH under `levels`); asset='eth' → ETH price; on-demand tokens get price only (no level anchors); omit asset → BTC price; pass an array (e.g. ['btc','eth','sol']) → per-asset price list. Judge high/low ONLY from the level anchors — a null field means the anchor is unavailable, so say the level is unknown rather than guessing. [Read-Only]. [Reasoning: Low]. PRIORITY: Default for any crypto price question. For market structure (BTC dominance, ETH/BTC ratio, stablecoin market cap) use data-market-structure; for full technical analysis use data-technicals. Keywords: BTC price, ETH price, crypto price, coin price, MA200, RSI, AHR999, 52-week high low, ATH, all-time high, price level, how much is bitcoin, BNB price, SOL price, XRP price, DOGE price

ParameterTypeRequiredDescription
assetoptionalAsset symbol(s): btc / eth / bnb / sol / xrp / ... . Single symbol → detailed card; array → price list. Omit for btc. BTC/ETH are prefetched; others fetched on-demand.
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 crypto-social; 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 circulating supply and % of total 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 circulating supply, percent of total supply, cliff unlock, linear unlock, next 30 days unlocks

No parameters required.

whale-flow

[Research] Whale-sized trades — who bet/traded big, with direction. Covers TWO venues: Polymarket prediction markets (venue=poly) and tokenized US stocks on Solana (venue=us_onchain); omit venue to merge both. Every row has an explicit BUY/SELL side, USD notional, the market/ticker, the trader's wallet, and — for Polymarket rows — `outcome`: WHICH SIDE the money went on (Yes/No or the candidate name; null when the collector missed it, and null for US stocks). Group by `outcome` to answer 'which side are whales on', not just 'how much'. Use it for 'what are whales betting on', 'any big money on <market or ticker>', or 'what did <wallet> just do'. Filter by min_usd / days / subject / wallet / side. DB-prestored, no external call — collection lags by minutes, so this is NOT a live quote. [Read-Only].

ParameterTypeRequiredDescription
venuestringoptional场所:poly=预测市场 / us_onchain=代币化美股 / 不传=两者合并
min_usdintegeroptional成交额下限 USD(底座入库门槛 Poly $10,000、美股 $5,000,这里只能更严)
daysintegeroptional回看天数,默认 30,上限 90(保留期)
subjectstringoptional只看某标的:Poly 传 conditionId,美股传 ticker
walletstringoptional只看某个钱包地址的动作
sidestringoptional只看买入或卖出
limitintegeroptional条数,默认 20,上限 50
cursorstringoptional上次返回的 next_cursor,用于翻下一页

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), base-case DCF intrinsic value & upside, plus optional last-8-quarters revenue sequence with YoY growth (include_quarters=true). In-pool names also carry the same three blocks the stock page shows: cashflow_bridge (net-income-to-cash bridge: CFO/net-income ratio + trend, FCF, buyback/dividends, and 5 red-flag observations, each {value,status} — a status other than "ok" means not-applicable / not-enough-sample, NOT a clean bill of health), balance_safety (quick ratio, net-debt-to-EBITDA, interest coverage EBIT-over-interest, short-debt coverage; each {value,status} with net_cash / no_interest_burden / no_short_term_debt / inapplicable-for-financials; net debt here = total debt minus cash and short-term investments, annual — a different caliber from quality.net_debt_to_ebitda which is TTM and cash-only, do not mix them in one sentence), and governance (highest-paid executive with pay mix and up-to-3-year total trend — proxy filings lag months, status stale / foreign_issuer / no_proxy_data; capital allocation buyback/dividends/net-debt-issuance; control = largest 13D/G holder filed within 3 years, where single_holder_majority=false only means the largest KNOWN filer is under 50%, NOT that there is no controlling shareholder). 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 NAMED stock. This tool ALWAYS needs a ticker — for date-driven questions with no ticker (who reports today / tomorrow / this week) use us-stock-earnings-calendar instead. For DCF intrinsic value or assumption what-ifs use us-stock-dcf; for a full single-stock readout use us-stock-bundle. [Read-Only]. [Reasoning: Low]. Keywords: valuation, PE, PB, EV/EBITDA, earnings, days to earnings, revenue growth, margins, beat rate, fundamentals, ROE, ROIC, FCF yield, Piotroski, Altman Z, quality, moat, DCF, intrinsic value, quarters, quarterly revenue, cash conversion, CFO to net income, accruals, red flags, receivables, inventory, payables, stock-based compensation dilution, solvency, quick ratio, interest coverage, net debt, short-term debt, can it pay its debts, governance, executive compensation, CEO pay, pay mix, buyback, dividend, capital allocation, controlling shareholder, largest holder, 13D 13G

ParameterTypeRequiredDescription
inputstringrequiredticker / 名称 / token,如 NVDA / 英伟达 / NVDAx
include_quartersbooleanoptional是否返回近8季营收/利润序列(会增加 text 长度)

us-stock-technicals

[Research] Latest EOD quote + price performance & technicals of a tokenized US stock (EOD close, NOT real-time/intraday). Returns: current price ($) and volume (daily / trailing-5-day / 5- & 20-day average), RAW/UNADJUSTED nominal close as shown on brokers; plus 1W/1M/3M/6M/1Y/YTD returns, 52-week high/low & position, MA50/MA200 relation, annualized volatility, 1Y max drawdown — these are split/dividend-ADJUSTED, so do NOT reconcile the price against the returns. Accepts ticker / name / token symbol. null = insufficient history. PRIORITY: Use when the user asks about the current price ($), volume, price performance, returns, trend, or risk of one stock. For a full single-stock readout use us-stock-bundle. Gives the latest EOD close price/volume, NOT a live intraday quote. [Read-Only]. [Reasoning: Low]. Keywords: price, current price, volume, share volume, quote, 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 (see underlying_close_date). confidence: high=realtime, low=offset, medium=bitget_reality@realtime. source_meta.dataAvailability: ok=realtime, stale=offset, no_data=no platform / not a US stock. Outside US market hours (incl. nights/weekends) low+stale is EXPECTED (comparison vs last close), NOT a data outage or source degradation; high+ok only during market hours with a fresh underlying quote. is_outlier=true = suspected anomaly (FX lag / thin liquidity), not a real signal. Empty = unavailable; on-chain exists for in-pool names only. PRIORITY: Use when the user asks about the tokenized / on-chain side — premium or discount, where to buy, which chain. The only on-chain tool. [Read-Only]. [Reasoning: Low]. Keywords: on-chain premium, discount, tokenized stock, xStocks, where to buy, which chain, premium discount, realtime vs offset

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. sector_pe_rank / sector_ranking are sorted by P/E ASCENDING — rank 1 = lowest P/E = cheapest (payload carries rank_order="pe_asc"). Pass the user's raw words (e.g. semiconductors, financials); the tool maps to a GICS sector internally. matched=false ⇒ no standard sector ⇒ it's a theme (AI, robotics) → use web-search instead. PRIORITY: Default for sector- or industry-level questions ("半导体板块怎么样" / how is the tech sector). Do NOT use for a SINGLE named stock — not its PE, price, or cheap-or-expensive ("NVDA 的 PE 是多少" / "NVDA 现在贵不贵"). Those belong to us-stock-analyze (depth=quick for one number; facet=full for cheap-or-expensive). us-stock-bundle is internal to that skill and is not a classifier target. [Read-Only]. [Reasoning: Low]. Keywords: 板块怎么样, industry-level P/E ranking, GICS sector overview, sector performance, not a single-stock PE

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, ps, ev_ebitda), financial quality verdict (ROIC vs WACC, Piotroski, Altman) + base-case DCF intrinsic value & upside, performance (1W/1M/3M/6M/1Y, 52-week position, MA50-vs-200), key resistance/support, next earnings & days_to_earnings, on-chain premium, profile (peers), analyst consensus under `company.analyst` (SAME block as us-stock-consensus: consensus/high/low target + upside vs last close, rating split with analyst count, and `forward` = the next TWO fiscal years ONLY, each with low/avg/high + analyst count + forward P/E and P/S, each carrying a status — never read a later-year row as the forward year), business mix under `company.segments` (SAME numbers as the stock page: revenue share %, YoY, trend and a largest/fastest/shrinking tag per segment, product & geography, top-3 + Other with shares recomputed after the merge; shares are over DISCLOSED segment revenue, not total revenue; `latest_partial=true` = newest period under-disclosed, do not draw share conclusions), and verdict (tri-score technical/fundamental + PE/DCF valuation dual-axis). Accepts ticker / name / token symbol. In-pool served from pre-stored data; out-of-pool is a live lite view (no on-chain). EOD prices, not real-time. Judge cheap/expensive ONLY from pe_percentile. PRIORITY: Default for any single-stock question. Use financials / technicals / onchain only when the user asks about one specific dimension; use us-stock-dcf for DCF intrinsic value or assumption what-ifs; use us-stock-sector for industry-level queries. [Read-Only]. [Reasoning: Low]. Keywords: stock analysis, tokenized stock, single stock overview, valuation, quality, moat, ROIC, DCF, intrinsic value, earnings, performance, on-chain premium, peers, analyst target, verdict, tri-score, PE axis, DCF axis, business mix, revenue by segment, revenue by geography, what does the company sell, where does revenue come from, segment growth, analyst consensus, price target, upside, rating split, forward PE, forward PS, forward estimates

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

us-stock-consensus

[Research] Analyst consensus for one tokenized US stock: rating (strong-buy/buy/hold/sell/strong-sell) with analyst count, average price target & upside/downside %, forward estimates (EPS/revenue next quarter & fiscal year), revision trend (last month/quarter/year avg + direction), and recent analyst actions (firm, new target, title, date). Pre-computed from DB-stored analyst data; in-pool only. Accepts ticker / name / token symbol. PRIORITY: Use when the user asks about analyst ratings, price targets, Wall Street consensus, or earnings estimates. For actual reported earnings or financial quality use us-stock-financials; for a full single-stock readout use us-stock-bundle. [Read-Only]. [Reasoning: Low]. Keywords: analyst, consensus, rating, price target, strong buy, buy, hold, sell, EPS estimate, revenue estimate, Wall Street, forward estimates, revision

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

us-stock-events

[Research] Stock event feed for one tokenized US stock: recent news (title, source, sentiment sentiment label/confidence) + SEC filings (8-K, 10-K, 10-Q, etc. with form_type and URL), merged and reverse-chronological within a 90-day window. Sentiment only shown at high confidence (>=0.85, aligned with radar page). Returns top N headlines in text + full event list in structuredContent. In-pool only (DB-backed); out-of-pool returns empty. Accepts ticker / name / token symbol. PRIORITY: Use when the user asks about recent news, events, SEC filings, or what's happening with a stock. For earnings dates or financial fundamentals use us-stock-financials; for a full single-stock readout use us-stock-bundle. [Read-Only]. [Reasoning: Low]. Keywords: news, events, SEC filing, 8-K, 10-K, 10-Q, sentiment, headlines, announcements, corporate events

ParameterTypeRequiredDescription
inputstringrequiredticker / 名称 / token,如 NVDA / 英伟达 / NVDAx
limitnumberoptional返回条数(默认 20)

us-stock-radar-scores

[Research] Radar map scores for one tokenized US stock: momentum_score (pool percentile 0-100, 50=pool median, higher=stronger momentum), opp_score (opportunity percentile 0-100, 50=pool median), core_score (absolute composite, NOT percentile), rs_20d (stock − SPY 20-day excess return in pp), and rank_delta (prev rank − current rank, positive=moved up). Includes pool context (pool_rank / pool_size) from the current published snapshot run. Data comes from pre-computed metrics_snapshot table (no external calls). as_of is the snapshot trade date, caliber=daily. Accepts ticker / name / token symbol. PRIORITY: Use when the user asks "how strong is this stock in the radar map", "what's its momentum rank", "is it in the top quadrant", or "how does it compare to SPY recently". For full single-stock readout use us-stock-bundle; for sector-level ranking use us-stock-sector. [Read-Only]. [Reasoning: Low]. Keywords: radar, scoring, momentum, opportunity, core score, percentile, ranking, relative strength, rs_20d, rank delta, pool rank, quadrant

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

us-stock-smart-money

[Research] Smart-money / chip-side data for one tokenized US stock, by type: insiders=insider Form4 buys/sells last 90 days (P-Purchase buy, S-Sale sell, net summary + top transactions); beneficial=13D/G blockholder filings last 180 days (>5% ownership, subject-CIK filtered for direction); institutions=13F institutional holdings latest quarter (top 15 holders + summary: institution count, QoQ change, top adds/cuts). DB-backed, no external calls. Accepts ticker / name / token symbol. PRIORITY: Use when the user asks "who is buying/selling", "insider transactions", "institutional holdings", "13F", "blockholder", or "smart money flow". For full single-stock readout use us-stock-bundle; for real order-flow imbalance use us-stock-order-flow. [Read-Only]. [Reasoning: Low]. Keywords: smart money, insider trading, Form 4, 13D, 13G, 13F, institutional holdings, blockholder, beneficial ownership, insider buys, insider sells, chip side, Vanguard, BlackRock

ParameterTypeRequiredDescription
inputstringrequiredticker / 名称 / token,如 NVDA / 英伟达 / NVDAx
typestringrequired数据类型

us-stock-lockup-events

[Research] 禁售期开放:IPO 发行前股东的解禁档位(日期/股数/占流通盘/折合几天量)+ 招股书条款原文片段。覆盖任意美股(不限于池内);上市超过两年、借壳上市、或招股书取不到时按状态码降级,**不会用「上市+180 天」推算日期**。Accept ticker / name / token symbol. [Read-Only].

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

us-stock-order-flow

[Research] Real order-flow imbalance (lit market, aggressor-side directional) for one tokenized US stock: trade imbalance in USD, as % of volume, and as % of total eligible volume. Daily frequency, sourced from published snapshot run's daily_flow row. Positive = buyer-dominated, negative = seller-dominated. This is objective market microstructure data — NOT a scoring signal and does NOT feed into verdict.chips. Distinct from us-stock-technicals money_flow which is price-volume derived. Accepts ticker / name / token symbol. PRIORITY: Use when the user asks about "real order flow", "buy/sell imbalance", "who is dominating", "lit flow", or "order flow direction". For insider/institutional flow use us-stock-smart-money; for price-volume-derived money flow use us-stock-technicals. [Read-Only]. [Reasoning: Low]. Keywords: order flow, trade imbalance, lit market, aggressor side, buy sell imbalance, flow imbalance, microstructure, buyer dominated, seller dominated

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

us-stock-onchain-liquidity

[Research] On-chain liquidity for one tokenized US stock: TVL, 24h volume, holder count, token market cap, tradable tier (ample/thin/illiquid), and DEX pool info (dex, pool name, address). Sourced from GeckoTerminal + Jupiter, 30-min refresh. Fields showing as null/? mean upstream data unavailable (NOT zero liquidity — has_pool=0 or has_catalog=0 flags suppress false zeros). Distinct from us-stock-onchain which checks premium/discount vs underlying. Accepts ticker / name / token symbol. PRIORITY: Use when the user asks about "on-chain depth", "can I trade this token", "DEX liquidity", "TVL", "holder count", or "where to buy". For premium/discount vs stock price use us-stock-onchain; for full single-stock readout use us-stock-bundle. [Read-Only]. [Reasoning: Low]. Keywords: on-chain liquidity, TVL, DEX, holder count, tradable, GeckoTerminal, Jupiter, pool, market depth, onchain, Solana, token liquidity

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

xstock-market-snapshot

[Market Data · xStock] Unified page snapshot for a tokenized US equity: P_ref (cleaned CoinGecko then stock fallback), premium vs underlying, pool_health, true 24h change, NYSE session/holiday. Not the Jupiter execution price. Trading-desk detail pages should prefer this over composing xstock-pool-snapshot + us-stock-onchain. [Read-Only]. [Reasoning: Low].

ParameterTypeRequiredDescription
symbolstringrequiredxStock symbol or mint, e.g. APPx / AAPLx

us-stock-earnings-calendar

[Research] US earnings calendar BY DATE — which companies report on a given day. Answers "who reports today / tomorrow / this week" with NO ticker needed; this is the ONLY tool that can look up earnings by date (every other us-stock tool takes a single ticker). Two tiers, deliberately separated because their data depth differs: tracked-pool names carry consensus EPS, actuals and beat/miss comparison; ALL OTHER US companies come with session (pre/post-market) ONLY in the text you read — no consensus, no actuals. Market cap is used to order and truncate that list, not printed per row. Per-day totals are market-wide (earnings season peaks above 500 companies a day). The "others" list is ordered by market cap and truncated — names beyond the cut are NOT missing. When the user asks for the full list or for more names, CALL THIS TOOL AGAIN with limit=30 (or page with offset) — do not answer from the previous, truncated result, and NEVER tell the user the full list is unavailable. Params: ahead (default 1 = today+tomorrow, max 14), back (default 0, max 7), limit (default 8, max 30), offset. PRIORITY: Use for ANY date-driven earnings question — 今天/明天谁发财报, 本周哪些股票发财报, 美股财报日历, 财报档期, 昨夜谁发了财报. Do NOT fall back to web-search for these. For ONE named stock's next report date use us-stock-financials instead (that one needs a ticker). CANNOT filter by sector or industry — upstream has no sector field for out-of-pool names; do not claim a sector-filtered list. [Read-Only]. [Reasoning: Low]. Keywords: 财报日历, 财报档期, 今天谁发财报, 明天谁发财报, 本周财报, 发财报的标的, 财报标的, 盘前盘后发财报, 財報日曆, 財報檔期, 今天誰發財報, 明天誰發財報, 財報標的, 會公開財報的標的, 本週財報, earnings calendar by date, who reports today, who reports tomorrow, earnings this week, earnings schedule, reporting companies, earnings date lookup

ParameterTypeRequiredDescription
aheadintegeroptional未来几天(含今天),默认 1 = 今天+明天,上限 14
backintegeroptional往回几天(看「昨夜谁发了」),默认 0,上限 7
limitintegeroptional「其余」那段每天列几家(按市值降序),默认 8,上限 30
offsetintegeroptional「还有哪些」续页,默认 0

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. Hyperliquid named whales: if the address is a publicly-named Hyperliquid trader on the watchlist (James Wynn, 麻吉大哥, qwatio, …) this returns their REAL Hyperliquid perp positions — main crypto dex + US-stock dex, with side/size/USD/entry/uPnL/leverage and identity disclosure (data_scope=hyperliquid_named). Identity comes from public X posts and is NOT verified; positions are on-chain truth, hourly-grade freshness (check as_of). When the user asks about a trader BY NAME ("what is 麻吉 long on Hyperliquid"), first resolve name → address via smart-money-list (the watchlist roster carries trader names), then call this tool. [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, named whale positions, James Wynn position, 麻吉 仓位, 具名巨鲸 持仓, what is this trader long or short on Hyperliquid, HL 大V 仓位

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 (EVM 0x... or Solana base58 mint) OR a symbol like ODAI/MON/JUP. Contract/mint 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, solana/sol (hex id also accepted for EVM). 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

[Read-Only] Discover yield opportunities across DeFi, RWA, CeFi and commodity products. When asset_class, risk_screen ("strict"/"balanced"/"all"), or product_type are provided, returns the curated catalog with per-product APY, TVL, risk_facts (depeg_history, audit_status, tvl_band, issuer_type, custody), the active screen_criteria list, eligibility, deposit assets and affiliation. The deprecated risk_tier_max (A/B/C) still maps to screens for compatibility: A→strict, B→balanced, C→all; risk_screen takes precedence when both are set. Otherwise returns real-time DeFiLlama-sourced recommendations. Keywords: yield, discover, stablecoin, lending, savings, RWA, gold, APY, TVL, risk_screen.

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—
product_idstringoptionalLook up a single curated catalog product by id; bypasses filters and limit
asset_classstringoptionalFilter curated catalog by asset class
risk_tier_maxstringoptionalDeprecated: maps to risk_screen (A→strict, B→balanced, C→all). Prefer risk_screen.
risk_screenstringoptionalPublic risk screen filter: "strict" | "balanced" | "all". Takes precedence over risk_tier_max.
product_typestringoptionalFilter curated catalog by product type

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

[Read-Only] Compare two to five yield products by APY, risk, TVL, eligibility, deposit assets, redemption terms and affiliation. Accepts both DeFiLlama pool ids and curated catalog ids from investor_discover. Keywords: yield, compare, APY, risk, eligibility, deposit, redemption.

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—

investor_position_checkup

[Read-Only] Evaluate existing yield positions against the curated catalog and suggest safer or higher-yield alternatives. risk_profile maps to public risk screens: conservative→strict, moderate→balanced, aggressive→all. Returns per-position candidate lists, estimated annual gain, migration-friction notes, and for candidates outside the selected screen a list of unmet_criteria. Each product carries risk_facts (depeg_history, audit_status, tvl_band, issuer_type, custody). Keywords: yield, position, checkup, portfolio, recommendation, risk profile, alternatives, migrate, unmet_criteria.

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'.
positionsarrayrequiredPositions to evaluate
risk_profilestringrequiredconservative=strict screen, moderate=balanced screen, aggressive=all (deprecated: conservative=A, moderate=A+B, aggressive=A+B+C)

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).
slippage_bpsintegeroptionalMax slippage in basis points (50 = 0.5%); omit for 0x default

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 or cex-market-quote (view=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. [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 received per 1 sell_token (positive numeric string only). This is inverted vs typical quote-per-base speech ("BTC at 100000" means 100000 USDT per 1 BTC). Example: sell ETH / buy USDC at 3500 USDC per ETH → "3500". Reverse (sell USDC / buy ETH at that same 3500 USDC/ETH): pass "0.00028571" (1/3500), or swap the two tokens so sell_token is the base and pass "3500". 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] Polymarket trader intelligence (Arkham-backed cache) — `view` selects the lens. view=rank (default): top traders ranked for copy-trading (winRate, winRateLB, profitFactor, verdict, copyScore). view=leaderboard: site-wide profit leaderboard. view=top-holders: whale distribution. Pass event_id (a Gamma numeric event id such as 79041, exactly as poly-analysis-list returns it) for a WHOLE event — returns every traded market ranked by volume with holder lists for the leaders, plus a coverage figure saying how much of the volume the detailed markets represent. Pass condition_id (0x + 64 hex) instead to scope to ONE market. Prefer event_id when the user asks about an event rather than a specific market; never present a single market as the whole event. view=wallet-profile (needs address): a specific 0x wallet's stats. view=hotspots: site-wide capital-flow hotspots (not a market search). ⚠️ Use view=rank/leaderboard BEFORE poly-master-follow to pick who to copy. NOT for your own trade history (→ poly-portfolio view=history). NOT for free-text market search (→ poly-markets view=search). NOT for copy-order monitoring (→ poly-order-status). [Read-Only]. [Reasoning: Medium]. Workflow: Step 1 of 4 — Copy-Trade Workflow (poly-master-traders → poly-master-follow → poly-order-status → poly-master-pnl). Keywords: discover top traders, trader win rate ROI, leaderboard who to follow, top holders of a market, whales across a whole event, who is betting on this event, wallet PnL analysis, capital inflow hotspot, Arkham analytics

ParameterTypeRequiredDescription
agent_idstringoptionalOPTIONAL authentication id — leave unset unless your operator explicitly gave you one; NEVER ask the user for it and never invent a value. Not needed when an OAuth Bearer token is provided or when calling through the Antalpha chat agent. Accepts BOTH formats: (1) Antalpha format from antalpha-register tool — 'A' followed by 32 hex chars, e.g. 'A1b2c3d4e5f607081920a1b2c3d4e5f6'; (2) Standard UUID v1-5, e.g. '01234567-89ab-1cde-9234-0123456789ab'.
viewstringoptionalrank = copy-trade ranking (default); leaderboard = profit leaderboard; top-holders = whale distribution — give event_id for a whole event, or condition_id for one market; 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.
condition_idstringoptionalPolymarket market conditionId (0x + 64 hex) — scopes view=top-holders to ONE market. Give either this or `event_id`. Use this when the user asks about a specific market; for a whole event ("who is betting on this?") pass `event_id` instead and get every market ranked. Copy the id verbatim from a previous result — never construct one.
event_idstringoptionalGamma numeric event id (e.g. 79041) — scopes view=top-holders to a WHOLE event and returns every traded market ranked by volume, with full holder lists for the leaders. This is the id poly-analysis-list / poly-markets return as `event_id`; pass it verbatim. A 0x + 64 hex conditionId is also accepted here for backwards compatibility, but new callers should put that in `condition_id`.
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
min_investednumberoptionalMinimum BUY notional (USD cost basis) to filter out dust/farming accounts (a $124 account with 28570% ROI is not a real signal). Default 0 = no filter.
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-portfolio (view=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

[Research] Polymarket market discovery & lookup — one tool, four views via `view`. view=trending (default): hottest markets by 24h volume, optional category filter (politics/sports/crypto/etc.). view=new: recently-created markets (last `hours`), early-stage low-liquidity opportunities. view=info (needs market_id): full detail for ONE market — conditionId, outcomes/prices, volume, liquidity, CLOB token IDs, slug, endDate; accepts conditionId/slug/Gamma ID/text. view=search (needs query): multilingual free-text search (zh-CN/zh-TW/en/ja/ko) across the FULL market universe, the primary lookup for long-tail markets. ⚠️ For curated heat-ranked events → poly-analysis-list. For a wallet's holdings/history → poly-portfolio. For trader discovery → poly-master-traders. Translate non-English market names to English before view=info. [Read-Only]. [Reasoning: Low]. Workflow: view=search → view=info → poly-buy / poly-sell → poly-order-status. PRIORITY: Default for free-text market discovery and lookup across the full Polymarket universe. For curated heat-ranked events → poly-analysis-list. Keywords: trending markets, highest volume predictions, newest markets just launched, find market by name, will X win Y, election outcome price, conditionId details, market prices liquidity, search any prediction topic

ParameterTypeRequiredDescription
agent_idstringoptionalOPTIONAL authentication id — leave unset unless your operator explicitly gave you one; NEVER ask the user for it and never invent a value. Not needed when an OAuth Bearer token is provided or when calling through the Antalpha chat agent. Accepts BOTH formats: (1) Antalpha format from antalpha-register tool — 'A' followed by 32 hex chars, e.g. 'A1b2c3d4e5f607081920a1b2c3d4e5f6'; (2) Standard UUID v1-5, e.g. '01234567-89ab-1cde-9234-0123456789ab'.
viewstringoptionaltrending = hot markets; new = recently created; info (needs market_id) = one market's full detail; search (needs query) = free-text lookup; event (needs market_id = link/slug/conditionId) = resolve a pasted Polymarket link to the event + all its child markets (exact, no fuzzy fallback)
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. view=info: index, conditionId (0x…), Gamma ID, slug, or event/question text. view=event: a full polymarket.com link, an event slug, or a 0x conditionId (the slug is auto-extracted from any URL shape). REQUIRED when view=info or view=event.
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

[Account] Read a Polymarket wallet's portfolio — `view` selects the slice. view=positions (default): current holdings — outcome tokens held, cost basis, current value, unrealized PnL, enriched with self-aggregated winRate/totalPnl/biggestWin. view=history: chronological log of past buys, sells, and transfers. Requires proxy_wallet address; public API, no wallet signing. ⚠️ For order signing/fill status → poly-order-status. For copy-trading PnL → poly-master-pnl. [Read-Only]. [Reasoning: Low]. Keywords: current holdings, active predictions, outcome tokens I own, unrealized prediction PnL, past trade log, historical buys sells, previous prediction activity

ParameterTypeRequiredDescription
agent_idstringoptionalOPTIONAL authentication id — leave unset unless your operator explicitly gave you one; NEVER ask the user for it and never invent a value. Not needed when an OAuth Bearer token is provided or when calling through the Antalpha chat agent. Accepts BOTH formats: (1) Antalpha format from antalpha-register tool — 'A' followed by 32 hex chars, e.g. 'A1b2c3d4e5f607081920a1b2c3d4e5f6'; (2) Standard UUID v1-5, e.g. '01234567-89ab-1cde-9234-0123456789ab'.
proxy_walletstringrequiredPolymarket proxy wallet address (GnosisSafe)
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-markets (view=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-markets (view=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

[Account] Check PolyMaster / Polymarket orders. Give order_id to fetch ONE order's signing status (pending/signed/expired) and fill status (unfilled/partial/filled). Omit order_id to LIST recent orders (optional status filter pending/filled/cancelled, limit 1-100), showing which trader triggered each copy order. ⚠️ order_id comes from poly-buy / poly-sell. For positions/holdings or one-off trade history → poly-portfolio. [Read-Only]. [Reasoning: Low]. Workflow: final step — after poly-buy / poly-sell, or to monitor copy-trade orders after poly-master-follow. Keywords: order fill status, was order signed, pending signed expired, confirm execution after buy sell, copy order history, orders triggered by followed 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'.
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

[Research] PolyMaster logical-implication hedge strategy — `action` selects the operation. action=scan (default): read-only scan for near-risk-free two-leg hedge signals where related markets are mispriced, ranked by coverage tier T1≥0.95 > T2≥0.90 > T3≥0.85 — never places orders, computationally intensive, use sparingly. action=metrics: monitoring dashboard (tier distribution, signal-generation rate, order-cancel rate, coverage). action=dry-run: report whether the engine is in dry-run vs live execution mode (env-controlled). ⚠️ Read-only / advisory — does not place orders. [Read-Only]. [Reasoning: Very High for scan; Low for metrics/dry-run]. Keywords: arbitrage scan, logical implication mispricing, hedge signal T1 T2 T3, strategy coverage stats, signal generation rate, dry run vs live mode

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.

poly-analysis-list

[Research] Discover or search Antalpha's Polymarket prediction events — the entry point before poly-analysis-detail. • No `keyword` → curated HOT feed (top events by heat), each with a one-line AI `take` and a `has_verdict` flag. Optional `board`: recommend / worldcup / sports (always on) / crypto / politics / economics (per deploy). • With `keyword` → resolves a user-named event against LIVE Polymarket (any language, auto-translated to English) — reaches ANY event, not just the curated feed; raw hits are unanalyzed (has_verdict=null) until detail runs. Each item returns `detail_id` — pass it VERBATIM to poly-analysis-detail; never construct an id yourself. Also returns event_id / slug / title, top outcomes with snapshot implied probability, 24h volume, and settlement end_date. Covers every vertical, incl. SPORTS: single-match "who wins X vs Y", title/championship odds (World Cup, Champions League, league winners), player awards, MLB, esports. Does the fuzzy name→event resolution so you never guess an id. Polymarket only. [Read-Only]. [Reasoning: Low]. Workflow: Step 1 of 2 (→ poly-analysis-detail). Keywords: Polymarket, prediction market, hot events, event search, find event by name, who will win, sports odds, World Cup, championship odds, football, player award, MLB, esports, crypto, politics, election

ParameterTypeRequiredDescription
keywordstringoptionalOptional free-text event search (any language — translated to English before hitting gamma). When present, resolves a user-named event against live Polymarket — reaching ANY event, not just the curated feed — so you can read its event_id and call poly-analysis-detail. Prefer 1-2 distinctive proper nouns (team / person / asset). When omitted, returns the curated hot feed instead.
boardstringoptionalOptional feed board filter (only applies to the no-keyword hot feed). recommend (curated hot) / worldcup / sports are always on; crypto / politics / economics are enabled per deployment. Omit for the default feed.
langstringoptionalUser language preference (BCP-47). Resolved to zh-CN (default) / zh-TW / en / ja / ko. Also drives the keyword translation for search, and localizes the report text.

poly-analysis-detail

[Research] Deep-analyze ONE Polymarket or Kalshi event and return Antalpha's full report — one-shot. Give it EITHER a `keyword` (event name / question, any language) when you have no id — it resolves against live Polymarket, no need to call poly-analysis-list first — OR a precise reference: `id` / `event_id` / `slug` / a bare conditionId / a pasted polymarket.com URL (e.g. the `detail_id` from poly-analysis-list), or a Kalshi URL or ticker (e.g. `KXNEXTTEAMNBA-26LJAM`). Do NOT guess or construct ids (0x… values are cryptographic hashes). Returns: the pick, Nina's INDEPENDENT win probability (win_pct 0–100 — NOT the market price), thesis, layered reasons / risks / logic, suggested action, strength comparison, multi-source odds (single-match h2h OR championship de-vig), and notable community voices. Covers crypto, politics, economics and SPORTS (World Cup / league / cup fixtures & titles, player awards, MLB, esports). For a multi-candidate event (championship / multi-candidate election / rate decision) it returns `status:multi` with ALL already-generated candidate reports (≤5); if none exist yet it generates the leading candidate. Cold events generate on demand — the tool waits up to ~48s, else returns `status:generating` (retry shortly). Ended events return `status:settled` with the resolved outcome. [Read-Only]. [Reasoning: Medium]. Keywords: Polymarket analysis, Kalshi analysis, Kalshi link, deep analysis, win probability, prediction, odds comparison, championship odds, match odds, who will win, World Cup, football, MLB, esports, crypto forecast, election forecast, market signals, risk factors

ParameterTypeRequiredDescription
idstringoptionalEvent reference. Accepts a Polymarket gamma event id (= the APP PolyEvent.id), a bare market conditionId (0x + 64 hex), a feed item id (`poly_evt:{eventId}` / `poly_evt:{eventId}#{conditionId}`), a poly-markets `internalEventId` (`poly:{conditionId}`), a pasted polymarket.com event URL, or a Kalshi market URL (kalshi.com) / event ticker (e.g. `KXNEXTTEAMNBA-26LJAM`) / market ticker. One of id / event_id / slug is required. For multi-outcome events (championship / multi-candidate election) pass a specific candidate's conditionId; passing the bare event id returns the candidate list to choose from.
event_idstringoptionalAlias of `id` (same accepted values); for callers that already hold an `event_id`.
slugstringoptionalPolymarket event slug, or a Kalshi URL / event ticker / market ticker (alternative to id / event_id).
keywordstringoptionalFree-text event name / question (any language) when you have no id — the tool resolves it against live Polymarket and analyzes the matched event. Use this as the one-shot entry: no need to call poly-analysis-list first. Prefer 1-2 distinctive proper nouns (team / person / asset / topic).
langstringoptionalUser language preference (BCP-47). Resolved to zh-CN (default) / zh-TW / en / ja / ko. Also drives the keyword translation for search, and localizes the report text.

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/optimism/base/polygon) — pass it when known, e.g. from an explorer URL (arbiscan.io→arbitrum, basescan.org→base). Omit to search all supported EVM chains. Ignored for Bitcoin.

settlement-verify-contract

[Security] Check whether an EVM contract's source is verified on the chain's block explorer (Etherscan V2; Arbitrum/Optimism/Base/Polygon use their own explorers). Returns verified, contract name, compiler, license, and whether it is a proxy. Heuristics only: unverified source, proxy, source text contains "selfdestruct" — not an audit or static analysis. ⚠️ Input: 0x contract address (token/NFT contracts are fine for verification). Default chain=ethereum; BNB Smart Chain is chain=bsc (aliases: bnb, binance). For token honeypot / permission risk → wallet-guard-token-deep-scan; for DeFi rug risk → wallet-guard-token-deep-scan. [Read-Only]. [Reasoning: Low]. Keywords: contract source verified, is source code public, open source contract, etherscan verified, bscscan verified, is this contract a proxy

ParameterTypeRequiredDescription
chainstringoptionalEVM chain (default: ethereum). Supported: ethereum, bsc (BNB Smart Chain; aliases: bnb, binance), arbitrum, optimism, base, polygon, avalanche, linea, blast, gnosis, mantle, opbnb, sonic, unichain, sei, berachain, celo, moonbeam
addressstringrequiredContract address (0x-prefixed)

Machine-readable formats: