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
141

Quick Start

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

Authentication

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

General

antalpha-register

[Trading] Register this agent with Antalpha platform. Returns agent_id required by Polymarket tools. ⚠️ Call ONCE per session BEFORE using any poly-* tool. Without agent_id, all Polymarket calls will fail. [Write]. [Reasoning: Low]. Workflow: Step 1 of 2 — Session Init (after test-ping). Keywords: register agent, get agent ID, antalpha setup, initialize Polymarket session, agent_id

No parameters required.

test-ping

[Account] Connectivity test — confirms MCP server is reachable. Returns server time (UTC+8). [Read-Only]. [Reasoning: Low]. Workflow: Step 0 of 2 — Session Init (test-ping → antalpha-register). Keywords: ping, server check, connectivity test, MCP health check, is server online

No parameters required.

hyperliquid-price

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

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

hyperliquid-account

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

ParameterTypeRequiredDescription
addressstringrequiredWallet address (0x...)

hyperliquid-book

Get L2 order book for a Hyperliquid perp asset.

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

hyperliquid-orders

Get open orders for a Hyperliquid account.

ParameterTypeRequiredDescription
addressstringrequiredWallet address

hyperliquid-positions

Get open perp positions for a Hyperliquid account.

ParameterTypeRequiredDescription
addressstringrequiredWallet address

hyperliquid-funding

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

ParameterTypeRequiredDescription
limitintegeroptionalNumber of results

hyperliquid-balance-check

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

ParameterTypeRequiredDescription
addressstringrequiredWallet address (0x...)
coinstringrequiredAsset to trade (e.g. ETH, BTC)
sizenumberrequiredPlanned order size in asset units
pricenumberrequiredPlanned order price in USD
leverageintegeroptionalLeverage (default: 1, perp only)
order_typestringoptionalspot = Spot balance only; perp = Perp+Spot combined; auto = detect automatically
is_buybooleanoptionaltrue = buy (need USDC for spot); false = sell (need coin for spot)

hyperliquid-limit-order

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

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

hyperliquid-market-order

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

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

hyperliquid-close

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

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

hyperliquid-cancel

Cancel an open order on Hyperliquid.

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

hyperliquid-leverage

Set leverage for a Hyperliquid perp asset.

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

hyperliquid-tp-sl

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

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

hyperliquid-modify-order

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

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

easy-mining-get-workspace

[Mining] Verify API connectivity and get workspace metadata (name, ID). ⚠️ Always call FIRST to confirm API key is valid. [Read-Only]. [Reasoning: Low]. Workflow: Step 0 of 4 — Mining Task Workflow (verify connection before any other call). Keywords: Nonce workspace ID, verify API key mining, workspace name, first mining call

ParameterTypeRequiredDescription
api_keystringrequiredNonce API key (from https://app.nonce.app)

easy-mining-list-farms

[Mining] List all mining farms and their IDs. farm_id is required by most other easy-mining tools. ⚠️ Prerequisite for most other mining tools — call this if farm_id is unknown. [Read-Only]. [Reasoning: Low]. Workflow: Step 1 of 4 — Mining Task Workflow (get farm_id before listing miners or creating tasks). Keywords: get farm_id, list all farms, farm names overview, which farms do I have

ParameterTypeRequiredDescription
api_keystringrequiredNonce API key

easy-mining-list-agents

[Mining] List Nonce automation agents: IDs, names, status. [Read-Only]. [Reasoning: Low]. Keywords: automation agents list, Nonce agent names, agent IDs status

ParameterTypeRequiredDescription
api_keystringrequiredNonce API key

easy-mining-list-miners

[Mining] Real-time status of ALL miners in a farm: hashrate, power, temperature, model. Primary health dashboard. Requires farm_id. ⚠️ Farm-level live overview. For single miner history → easy-mining-list-history. [Read-Only]. [Reasoning: Low]. Workflow: Step 2 of 4 — Mining Task Workflow (check status before creating tasks). Keywords: live miner status all, which miners offline, current hashrate all miners, farm health dashboard

ParameterTypeRequiredDescription
api_keystringrequiredNonce API key
farm_idstringrequiredFarm ID from easy-mining-list-farms

easy-mining-list-metrics-history

[Mining] Daily historical metrics for an entire FARM: aggregate hashrate, online count, BTC earnings over time. Requires farm_id. ⚠️ FARM-LEVEL, historical. For single miner history → easy-mining-list-history. For live miner status → easy-mining-list-miners. [Read-Only]. [Reasoning: Low]. Keywords: farm-level daily metrics, aggregate hashrate over time, total BTC earned farm, whole farm trend

ParameterTypeRequiredDescription
api_keystringrequiredNonce API key
farm_idstringrequiredFarm ID
from_datestringoptionalStart date ISO8601 (e.g. 2025-01-01)
to_datestringoptionalEnd date ISO8601

easy-mining-list-pool-diffs

[Mining] Pool configuration change records for a farm: when and what pool settings changed. [Read-Only]. [Reasoning: Low]. Keywords: pool config change log, when pool was switched, mining pool history records

ParameterTypeRequiredDescription
api_keystringrequiredNonce API key
farm_idstringrequiredFarm ID

easy-mining-list-history

[Mining] Historical performance for ONE specific miner: hashrate curve, power, temperature, uptime. For diagnosing hardware issues. Requires miner_id. ⚠️ SINGLE MINER, historical. For all miners live status → easy-mining-list-miners. For farm-level history → easy-mining-list-metrics-history. [Read-Only]. [Reasoning: Low]. Keywords: single miner history, one miner hashrate curve, individual miner uptime, diagnose specific miner

ParameterTypeRequiredDescription
api_keystringrequiredNonce API key
miner_idstringrequiredMiner ID
from_datestringoptionalStart date ISO8601
to_datestringoptionalEnd date ISO8601

easy-mining-list-miner-tasks

[Mining] Task execution history for ONE specific miner: reboots, firmware upgrades, pool changes and their outcomes. Requires miner_id. ⚠️ SINGLE MINER task audit. For farm-level task batches → easy-mining-list-task-batches. [Read-Only]. [Reasoning: Low]. Keywords: one miner task log, past reboots on miner, firmware history single miner, audit miner_id operations

ParameterTypeRequiredDescription
api_keystringrequiredNonce API key
miner_idstringrequiredMiner ID

easy-mining-list-task-batches

[Mining] List all task batches for a farm (paginated). Use to find task_batch_id for status checks. ⚠️ Use to find existing task_batch_id before calling easy-mining-get-task-batch. [Read-Only]. [Reasoning: Low]. Workflow: Step 3b of 4 — Mining Task Workflow (find task_batch_id to then monitor). Keywords: find task_batch_id, all task batches list, paginated task history farm

ParameterTypeRequiredDescription
api_keystringrequiredNonce API key
farm_idstringrequiredFarm ID
pageintegeroptionalPage number
page_sizeintegeroptionalItems per page

easy-mining-create-task-batch

[Mining] Create a batch task across multiple miners: reboot, power mode change, firmware upgrade, pool config update. Requires farm_id. ⚠️ WRITE operation affecting multiple miners simultaneously. ALWAYS confirm exact scope with user before calling. To monitor result → easy-mining-get-task-batch. [Write]. [Reasoning: High]. Workflow: Step 3 of 4 — Mining Task Workflow (after confirming miner status in step 2). Keywords: reboot all miners, bulk firmware upgrade, change mining pool all miners, batch power mode, execute task farm

ParameterTypeRequiredDescription
api_keystringrequiredNonce API key
farm_idstringrequiredFarm ID
task_namestringrequiredTask type to execute
miner_idsarrayrequiredList of miner IDs to apply task to
paramsobjectoptionalTask-specific parameters (e.g. {mode: 'low_power'} for power_mode.update)

easy-mining-get-task-batch

[Mining] Get status and per-miner results for a specific task batch. ⚠️ Input: task_batch_id from easy-mining-create-task-batch or easy-mining-list-task-batches. [Read-Only]. [Reasoning: Low]. Workflow: Step 4 of 4 — Mining Task Workflow (monitor after creating a batch task). Keywords: task batch result, did reboot succeed, batch execution status, check specific task_batch_id

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

wallet-balance-query

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

ParameterTypeRequiredDescription
addressstringrequiredWallet address (chain auto-detected from format)

cex-market-get-ticker

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

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

cex-market-get-kline

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

ParameterTypeRequiredDescription
exchangestringoptionalTarget exchange. Defaults to 'okx' for backward compatibility.
instIdstringrequiredInstrument ID, e.g. BTC-USDT-SWAP
intervalstringoptionalK-line bar interval. Use normalized format (Binance-style): 1m/3m/5m/15m/30m/1h/2h/4h/6h/8h/12h/1d/3d/1w/1M. The skill maps to each exchange's native format internally — do NOT pass OKX-style uppercase (1H, 4H, 1D); Zod will reject those.
limitintegeroptionalNumber of candles (default 100, max 300)

cex-market-get-orderbook

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

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

cex-market-get-instruments

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

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

cex-spot-place-order

[Trading] Place a spot buy or sell order on CEX (no leverage). ⚠️ SPOT only — no leverage, no long/short. For leveraged futures → cex-futures-place-order. NOT for viewing existing orders (→ cex-spot-get-orders). [Write]. [Reasoning: High]. PRIORITY: Default for 'buy / sell' without leverage keywords. If user mentions long/short/perp/leverage → cex-futures-place-order. Keywords: place new spot order, create buy sell, enter spot market, submit spot trade, no leverage buy

ParameterTypeRequiredDescription
exchangestringoptionalTarget exchange. Defaults to 'okx' for backward compatibility.
instIdstringrequiredInstrument ID, e.g. BTC-USDT
sidestringrequiredOrder side
ordTypestringrequiredOrder type
szstringrequiredOrder size in base currency
pxstringoptionalOrder price (required for limit orders)
quoteOrderQtystringoptionalQuote currency amount for market buy (Binance only)

cex-spot-cancel-order

[Trading] Cancel a spot order by order ID. ⚠️ SPOT orders only. For futures orders → cex-futures-cancel-order. [Write]. [Reasoning: Low]. Keywords: cancel pending order, delete unfilled order, remove queued buy sell, abort spot order

ParameterTypeRequiredDescription
exchangestringoptionalTarget exchange. Defaults to 'okx' for backward compatibility.
instIdstringrequiredInstrument ID
orderIdstringrequiredOrder ID to cancel

cex-spot-get-orders

[Account] Get spot order history: open (pending) and historical (filled / cancelled). ⚠️ SPOT ORDERS only. For futures positions → cex-futures-get-positions. NOT for placing orders (→ cex-spot-place-order). [Read-Only]. [Reasoning: Low]. Keywords: spot order history, filled orders, open pending orders, past spot trades, order list

ParameterTypeRequiredDescription
exchangestringoptionalTarget exchange. Defaults to 'okx' for backward compatibility.
instIdstringoptional交易对,如 ETH-USDT。Binance 侧未传 instId 时接口直接返回空数组(非报错)。OKX 可省略以查全市场挂单(仅 pending 接口时慎用)。
statestringoptionalOKX:不传时只查当前挂单 orders-pending;市价单若已瞬间成交则不在挂单里,列表会为空——查成交请传 state=filled(或 cancelled)。Binance:不传 state 时只查该 instId 的未成交挂单。

cex-futures-place-order

[Trading] Place a futures/perpetual order on CEX (leveraged, with long/short). Supports semantic inputs (e.g. 'open long'). ⚠️ FUTURES / PERPETUAL with leverage. For un-leveraged spot buy/sell → cex-spot-place-order. ALWAYS confirm side, size, leverage with user before calling. [Write]. [Reasoning: High]. PRIORITY: Use when user explicitly mentions leverage, perp, futures, long/short. Default to cex-spot-place-order if user just says 'buy/sell'. Keywords: open long, open short, create new position, enter market, go long go short, new futures order, leveraged trade

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

cex-futures-cancel-order

[Trading] Cancel a futures/perpetual order by order ID. ⚠️ FUTURES orders only. For spot orders → cex-spot-cancel-order. For closing an existing position (not an order) → cex-futures-close-position. [Write]. [Reasoning: Low]. Keywords: cancel futures order, remove pending futures, revoke perp order, abort unfilled futures

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

cex-futures-get-positions

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

ParameterTypeRequiredDescription
exchangestringoptionalTarget exchange. Defaults to 'okx' for backward compatibility.
instIdstringoptionalFilter by instrument ID

cex-futures-set-leverage

[Trading] Set leverage multiplier and margin mode (isolated/cross) for a futures instrument. Affects all subsequent orders on that instrument. ⚠️ Setting only — does NOT place an order. Call BEFORE cex-futures-place-order if leverage change is needed. [Write]. [Reasoning: Medium]. Keywords: set leverage multiplier, isolated cross margin mode, change leverage ratio, 10x 20x 50x

ParameterTypeRequiredDescription
exchangestringoptionalTarget exchange. Defaults to 'okx' for backward compatibility.
instIdstringrequiredInstrument ID, e.g. BTC-USDT-SWAP
leverageintegerrequiredLeverage multiplier
mgnModestringrequiredMargin mode

cex-futures-close-position

[Trading] Market-close ALL futures positions for an instrument. Full exit. ⚠️ Closes POSITIONS (not orders). To cancel a pending order → cex-futures-cancel-order. Always confirm scope with user before calling — this is an immediate full exit. [Write]. [Reasoning: High]. Keywords: close existing futures position, exit active trade, flatten all, full exit perp, close out instrument

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

cex-account-get-balance

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

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

cex-account-get-info

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

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

cex-setup-check

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

No parameters required.

cex-setup-save

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

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

cex-setup-verify

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

ParameterTypeRequiredDescription
exchangestringrequiredExchange to verify

airdrop-scan

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

ParameterTypeRequiredDescription
chainstringoptionalFilter by chain name (e.g., 'Ethereum', 'Arbitrum', 'Monad'). Leave empty for all chains. Sentinels 'all' / 'any' / '*' are also accepted as no-filter.
statusstringoptionalFilter by project status. 'active' = currently running, 'upcoming' = announced but not live. Leave empty for both.
limitintegeroptionalMax results to return (default 20)
include_completedbooleanoptionalInclude projects whose token has already launched (airdrop window likely closed). Default false — by definition airdrop-scan returns only claimable opportunities.
include_oldbooleanoptionalInclude projects listed on DeFiLlama more than 24 months ago. Default false — older projects without a token are usually dormant.

airdrop-daily-report

[Research] Get today's pre-curated airdrop digest: top S/A-grade picks, zero-cost options, upcoming deadlines, and active scam alerts. AI-filtered and ROI-ranked — no browsing needed. ⚠️ Curated daily digest. NOT for open-ended market sweep (→ airdrop-scan); NOT for evaluating one specific project (→ airdrop-check-project). [Read-Only]. [Reasoning: High]. Workflow: Step 1 of 3 — Airdrop Workflow (alternative entry to airdrop-scan). PRIORITY: Use when user wants today's picks. For broad discovery → airdrop-scan. Keywords: daily airdrop report, today best airdrops, morning briefing, curated digest, airdrop summary

ParameterTypeRequiredDescription
chainstringoptionalFilter by chain name. Leave empty or pass 'all' / 'any' for no filter.
gradesarrayoptionalGrades to include, as a list. For an "S and A" request pass ["S","A"]. A single grade like ["S"] returns only that grade. Omit to default to the top picks (S and A).

airdrop-check-project

[Research] Deep-dive analysis of ONE specific named airdrop project. Grades it S/A/B/C on VC quality, funding, TVL, token status. Returns scam probability and verdict. Requires a specific project name or ID. ⚠️ Single-project deep dive. NOT for browsing the market (→ airdrop-scan); NOT for the curated daily digest (→ airdrop-daily-report). [Read-Only]. [Reasoning: High]. Workflow: Step 2 of 3 — Airdrop Workflow (after airdrop-scan or airdrop-daily-report surfaces a candidate). Keywords: check specific airdrop, airdrop grade, project rating, is this airdrop legit, S A B C rating, scam probability

ParameterTypeRequiredDescription
project_namestringrequiredProject name or slug (e.g., 'Monad', 'berachain', 'scroll')

airdrop-zero-cost

[Research] Find airdrops that require zero capital: gas-free testnets and free mainnet tasks. Returns time estimate, anti-Sybil tips, faucet links. ⚠️ Filters for $0-cost only. NOT a general airdrop scan (→ airdrop-scan). [Read-Only]. [Reasoning: Low]. Keywords: free airdrop, zero cost, no gas, testnet airdrop, gas-free participation

ParameterTypeRequiredDescription
chainstringoptionalFilter by chain name. Leave empty or pass 'all' / 'any' for no filter.
limitintegeroptionalMax results (default 10)

airdrop-scam-check

[Security] Check whether a specific URL is a phishing site or fake airdrop claim page. Returns SAFE / WARNING / CRITICAL and the verified official URL. Input: URL string. ⚠️ Input is a URL, not a project name. NOT for project evaluation (→ airdrop-check-project); NOT for finding airdrops (→ airdrop-scan). [Read-Only]. [Reasoning: Low]. Workflow: Step 3 of 3 — Airdrop Workflow (always call before connecting wallet to any claim page). Keywords: airdrop link safe, phishing URL check, fake claim page, safe to connect wallet, verify airdrop URL

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

crypto-sentiment-score

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

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

crypto-kol-signals

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

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

crypto-mention-surge

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

ParameterTypeRequiredDescription
limitnumberoptionalMax results

crypto-fear-greed

[DISABLED] Deprecated. Use data-sentiment-fng instead — both return the identical Crypto Fear & Greed Index (0–100). [Read-Only]. [Reasoning: Low]. Keywords: DISABLED, use data-sentiment-fng

ParameterTypeRequiredDescription
daysnumberoptionalHistory days to return (1-30, default 7)

wallet-guard-token-security

[Security] Quick scan of an ERC20 token contract across 20+ risk flags: honeypot, hidden mint, abnormal tax, blacklist, trading restrictions. Fast result, flag-based output. ⚠️ Input: TOKEN CONTRACT ADDRESS. NOT for wallet addresses (→ wallet-guard-address-security); NOT for NFTs (→ wallet-guard-nft-security); NOT for DeFi protocols (→ wallet-guard-rugpull-detection). For a scored deep report → wallet-guard-token-deep-scan. [Read-Only]. [Reasoning: High]. Workflow: Step 1 of 2 — Token Security Workflow (quick check first, deep scan only if ambiguous). PRIORITY: Default token contract scan. Escalate to wallet-guard-token-deep-scan only if results ambiguous or user wants scored report. Keywords: quick token risk flags, honeypot check fast, hidden mint tax blacklist, ERC20 token 20 indicators

ParameterTypeRequiredDescription
chain_idstringrequiredEVM chain ID string. Common values: "1" = Ethereum, "56" = BSC, "137" = Polygon, "8453" = Base, "43114" = Avalanche, "42161" = Arbitrum
contract_addressesstringrequiredOne or more token contract addresses, comma-separated (0x-prefixed)

wallet-guard-address-security

[Security] Check if a wallet address is flagged malicious across 12+ categories: hacker, scammer, sanctions, darknet, phishing. Output: risk categories found. ⚠️ Input: wallet ADDRESS (0x EVM only). Does NOT support Bitcoin (BTC), Solana (SOL), or other non-EVM chain addresses — if user provides a BTC or Solana address, do NOT call this tool, respond: "This tool supports EVM (0x) addresses only. Bitcoin and Solana addresses are not supported." NOT for URLs (→ wallet-guard-phishing-site); NOT for token contracts (→ wallet-guard-token-security); NOT for DeFi protocol contracts (→ wallet-guard-rugpull-detection). [Read-Only]. [Reasoning: Medium]. Keywords: malicious wallet address, hacker scammer address, is 0x address safe, sanctions blacklist check address

ParameterTypeRequiredDescription
addressstringrequiredA wallet/contract address OR a transaction hash to screen. Addresses: EVM (0x-prefixed) get full on-chain risk data; Bitcoin / Solana / Tron and other chains get a sanctions / watch-list check. Transaction hashes (EVM / Bitcoin / Solana) are screened by extracting the involved counterparty addresses and checking each.
chain_idstringoptionalOptional chain ID to narrow an EVM address check. EVM chain ID string. Common values: "1" = Ethereum, "56" = BSC, "137" = Polygon, "8453" = Base, "43114" = Avalanche, "42161" = Arbitrum

wallet-guard-approval-security

[Security] Scan a wallet for dangerous token/NFT approvals: unlimited ERC20 allowances, suspicious spenders, ERC721/1155 risks. Returns revocation recommendations. ⚠️ Input: WALLET ADDRESS to audit its approvals. NOT for checking a token contract itself (→ wallet-guard-token-security). [Read-Only]. [Reasoning: High]. Keywords: token approvals scan, revoke ERC20 allowance, unlimited approval risk, spender contract dangerous

ParameterTypeRequiredDescription
addressstringoptionalWallet address to scan for approvals (0x-prefixed)
wallet_addressstringoptionalAlias for address (0x-prefixed wallet address)
chain_idstringrequiredEVM chain ID string. Common values: "1" = Ethereum, "56" = BSC, "137" = Polygon, "8453" = Base, "43114" = Avalanche, "42161" = Arbitrum
typestringoptionalApproval type to scan: erc20, erc721, erc1155, or all (default)

wallet-guard-nft-security

[Security] Detect NFT collection contract risks: transfer locks, trading pause, blacklist controls, fake floor inflation. ⚠️ Input: NFT CONTRACT ADDRESS. NOT for fungible tokens (→ wallet-guard-token-security); NOT for wallet approvals (→ wallet-guard-approval-security); NOT for DeFi protocols (→ wallet-guard-rugpull-detection). [Read-Only]. [Reasoning: High]. Keywords: NFT collection contract risk, transfer lock NFT, trading pause NFT, fake floor NFT, mint safe collection

ParameterTypeRequiredDescription
chain_idstringrequiredEVM chain ID string. Common values: "1" = Ethereum, "56" = BSC, "137" = Polygon, "8453" = Base, "43114" = Avalanche, "42161" = Arbitrum
contract_addressstringrequiredNFT contract address (0x-prefixed)
token_idstringoptionalOptional specific token ID to check

wallet-guard-phishing-site

[Security] Check if a URL is a phishing or impersonation website. Output: safe/warning/critical verdict. ⚠️ Input: URL (website). NOT for wallet addresses (→ wallet-guard-address-security); NOT for token contracts (→ wallet-guard-token-security). [Read-Only]. [Reasoning: Low]. Keywords: phishing URL, fake website crypto, is this domain safe, URL before wallet connect

ParameterTypeRequiredDescription
urlstringrequiredURL to check for phishing risk (e.g. https://uniswap-airdrop.com)

wallet-guard-token-deep-scan

[Security] Comprehensive token security analysis with 0–100 risk score and scenario classification (Stablecoin / Ecosystem / Meme). Detects honeypot, self-destruct, ownership reclaim, balance manipulation with cross-validation. ⚠️ Slower than wallet-guard-token-security. Use ONLY when: (a) quick scan returned ambiguous results, or (b) user explicitly needs a scored report. [Read-Only]. [Reasoning: Very High]. Workflow: Step 2 of 2 — Token Security Workflow (only after wallet-guard-token-security). PRIORITY: Use only as escalation from wallet-guard-token-security or when user explicitly asks for a scored deep report. Default to wallet-guard-token-security. Keywords: comprehensive token audit, 0-100 risk score, stablecoin ecosystem meme classification, deep honeypot cross-validation

ParameterTypeRequiredDescription
chain_idstringrequiredEVM chain ID string. Common values: "1" = Ethereum, "56" = BSC, "137" = Polygon, "8453" = Base, "43114" = Avalanche, "42161" = Arbitrum
contract_addressstringrequiredToken contract address to deep-scan (0x-prefixed EVM address, 42 chars)

wallet-guard-rugpull-detection

[Security] Detect DeFi protocol rug-pull risk: liquidity lock status, admin mint/pause/blacklist privileges. Beta accuracy. ⚠️ Input: DEFI PROTOCOL CONTRACT. NOT for fungible tokens (→ wallet-guard-token-security); NOT for NFTs (→ wallet-guard-nft-security). [Read-Only]. [Reasoning: High]. Keywords: DeFi rug pull risk, liquidity locked check, owner mint pause blacklist power, can team rug

ParameterTypeRequiredDescription
chain_idstringrequiredEVM chain ID string. Common values: "1" = Ethereum, "56" = BSC, "137" = Polygon, "8453" = Base, "43114" = Avalanche, "42161" = Arbitrum
contract_addressstringrequiredDeFi protocol contract address (0x-prefixed)

meme-analyze

[Research] Analyze a meme token's 'wealth gene' — 4-dimensional assessment (narrative strength, community momentum, liquidity health, risk profile) with star/moon/skull/poop composite rating based on real-time web sentiment and on-chain data. Returns a structured report with actionable verdict. [Read-Only]. [Reasoning: High]. Keywords: meme coin analysis, meme token check, wealth gene, meme rating, pump potential, meme coin risk

ParameterTypeRequiredDescription
token_namestringrequiredA meme or community token name or symbol, e.g. PEPE, DOGE, $SHIB, WIF
agent_idstringoptionalYour agent ID. Accepts BOTH formats: (1) Antalpha format from antalpha-register tool — 'A' followed by 32 hex chars, e.g. 'A1b2c3d4e5f607081920a1b2c3d4e5f6'; (2) Standard UUID v1-5, e.g. '01234567-89ab-1cde-9234-0123456789ab'. Not required when an OAuth Bearer token is provided in the request.

transfer-request

[Trading] Prepare and confirm a Web3 on-chain transfer — sending tokens FROM user's address TO another address. Two steps: (1) prepare generates risk preview; (2) confirm generates signing URL. Supports EVM, Solana, Bitcoin. ⚠️ SENDING TO ANOTHER ADDRESS — not swapping tokens (→ swap-full). Highest-risk tool; requires explicit user approval at BOTH steps. Chain must be specified explicitly by user — do not silently default. [Read+Write]. [Reasoning: Very High]. Workflow: Step 1 of 2 — Transfer Workflow (prepare+confirm here, then transfer-status to track). PRIORITY: Use when user intent involves a recipient address. If intent is token exchange → swap-full instead. Keywords: send crypto, transfer tokens, pay someone, on-chain transfer, send ETH BTC to address

ParameterTypeRequiredDescription
agent_idstringoptionalYour agent ID from antalpha-register (required when no bearer token)
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_idstringoptionalYour agent ID from antalpha-register (required when no bearer token)
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_idstringoptionalYour agent ID from antalpha-register (required when no bearer token)
session_idstringrequired

web-search-query

[Research] Real-time web search via Tavily/Exa. Use when the user asks a general-knowledge question requiring data beyond the model's training cutoff (news, recent events, current prices not covered by dedicated tools). Returns top results with snippets and Markdown rendition. ⚠️ GENERAL WEB SEARCH. NOT for on-chain or DeFi data — those have dedicated tools (data-*, settlement-*, smart-money-*) which are faster and more accurate. For reading a specific known URL → web-search-extract. [Read-Only]. [Reasoning: Medium]. PRIORITY: Use for politics, web3 news, finance, sports, pop culture, tech queries. For on-chain / DeFi data, prefer dedicated tools. Keywords: web search, current news, recent events, latest information, real-time search, what happened

ParameterTypeRequiredDescription
querystringrequiredSearch query (3–200 chars). Plain text, no operators.
limitintegeroptionalMax results to return
backendstringoptionalPreferred backend; 'auto' picks based on query characteristics
includeDomainsarrayoptionalRestrict results to these domains (e.g. ['ethereum.org'])
excludeDomainsarrayoptionalExclude these domains

web-search-extract

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

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

data-macro-cpi

No parameters required.

data-macro-nfp

No parameters required.

data-macro-m2

No parameters required.

data-macro-yield-spread

No parameters required.

data-macro-unemployment

No parameters required.

data-macro-sahm

No parameters required.

data-macro-fed-rate

No parameters required.

data-macro-all

[Market Data] Full US macro snapshot in one call. Returns LATEST values for 12 core indicators: cpi, nfp, m2, yieldSpread, unemployment, sahm, fedRate, sp500, vix, us10y, usd-broad, gold. Optional `series` param selects a subset — use EXACT keys above, e.g. [“cpi”,“sp500",“us10y”]. Omit for all 12. BTC/ETH are NOT included by default: add “btc”/“eth” to series, or call data-price-btc. :warning: Use when user needs 2+ macro indicators. For a single indicator, prefer the sub-tool. [Read-Only]. [Reasoning: Low]. PRIORITY: Default when ≥2 macro indicators are needed. Keywords: macro overview, economic indicators, macro snapshot, fed rate, cpi, sp500, treasury yield, gold

ParameterTypeRequiredDescription
seriesarrayoptionalIndicator keys to return, e.g. ["cpi","sp500","btc"]. Omit for all 12 core indicators.

data-market-pulse

[Market Data] Get a comprehensive crypto market overview in one call: BTC/ETH prices (updated every minute), Fear & Greed Index, BTC dominance, ETH/BTC ratio, and stablecoin market cap. This is the FIRST tool to call when asked about current market conditions. Optional params: include_eth (default true), include_sentiment (default true), include_structure (default true) — set to false to skip sections and reduce response size. [Read-Only]. [Reasoning: Low]. PRIORITY: Default entry for any market overview question. Use before drilling into specifics. Keywords: market overview, BTC ETH price, fear greed index, BTC dominance, ETH/BTC ratio, stablecoin market cap, crypto market snapshot

ParameterTypeRequiredDescription
include_ethbooleanoptionalInclude ETH price
include_sentimentbooleanoptionalInclude Fear & Greed Index
include_structurebooleanoptionalInclude BTC dominance, ETH/BTC ratio, stablecoin market cap

data-btc-technicals

[Market Data] Get ALL BTC technical indicators in one call: RSI (14), MA200, MACD, Bollinger Bands, AHR999, Puell Multiple, plus 52-week range and ATH. Every indicator includes a pre-computed level label (e.g. RSI → oversold/neutral/overbought) so you don't need to apply thresholds yourself. Optional `indicators` param to select a subset (["rsi","ma200","macd","bollinger","ahr999","puell","levels"]) — omit for all. Requires current BTC price from cache internally. [Read-Only]. [Reasoning: Medium]. PRIORITY: Use when user asks about BTC technicals, price levels, or indicator values. For quick single-indicator lookup, use the shortcut tools (data-price-btc for MA200/52w, etc.). Keywords: BTC technical indicators, RSI MA200 MACD, Bollinger bands, AHR999 Puell, 52 week range, ATH, crypto TA

ParameterTypeRequiredDescription
indicatorsarrayoptionalOptional subset: ['rsi','ma200','macd','bollinger','ahr999','puell','levels']. Omit for all.

data-btc-flow

[Market Data] Get BTC smart-money positioning in one call: ETF flows (M USD, inflow/outflow), exchange reserves (M BTC), Coinbase premium (premium/discount/neutral), and taker buy/sell ratio (buy_dominant/sell_dominant/neutral). Use this to understand institutional and whale directional bias. Optional `indicators` param to select a subset. For leverage and derivatives data, use data-btc-derivatives. For a quick ETF-only check, use the shortcut data-whale-* tools (if still registered). [Read-Only]. [Reasoning: Medium]. PRIORITY: Use when analyzing institutional flows and whale positioning. Keywords: ETF flow, institutional flow, exchange reserve, Coinbase premium, taker ratio, whale positioning, BTC smart money

ParameterTypeRequiredDescription
indicatorsarrayoptionalOptional subset: ['etf_flow','exchange_reserve','coinbase_premium','taker_ratio']. Omit for all.

data-btc-derivatives

[Market Data] Get BTC derivatives market structure in one call: funding rate (neutral/high_positive/high_negative), futures premium (contango/backwardation/neutral), CEX & DEX open interest (B USD), 24h liquidations (M USD), and options max pain & OI. Use this to assess market leverage, positioning crowding, and liquidation risk. Optional `indicators` param to select a subset. For smart-money directional flow, use data-btc-flow. For a quick funding rate check only, use the shortcut data-sentiment-funding-btc. [Read-Only]. [Reasoning: Medium]. PRIORITY: Use when assessing leverage risk or derivatives market health. Keywords: funding rate, futures premium, open interest, OI, liquidations, options max pain, derivatives leverage, BTC perp

ParameterTypeRequiredDescription
indicatorsarrayoptionalOptional subset: ['funding_rate','futures_premium','cex_oi','dex_oi','liquidations','options_max_pain','options_oi']. Omit for all.

data-defi

[Market Data] Get DeFi ecosystem overview in one call: total TVL across all chains, Ethereum TVL, DEX 24h trading volume, stETH yield (APY), stablecoin yield (APY), and top DeFi yield opportunities. Optional `categories` param to select a subset (["tvl","volume","yields"]) — omit for all. [Read-Only]. [Reasoning: Low]. PRIORITY: Default for any DeFi overview question. Use before drilling into specific protocols. Keywords: DeFi TVL, total value locked, DEX volume, stETH yield, stablecoin yield, DeFi yields, Ethereum TVL

ParameterTypeRequiredDescription
categoriesarrayoptionalOptional subset: ['tvl','volume','yields']. Omit for all.

data-events

[Market Data] Get upcoming and recent on-chain events in one call: scheduled token unlocks and recent security incidents (hacks, exploits). Optional `types` param to select a subset (["unlocks","security"]) — omit for both. Note: token unlock data is currently a placeholder (P2) and may return empty results. For token unlock events only, use the shortcut data-event-token-unlock. [Read-Only]. [Reasoning: Low]. PRIORITY: Use for risk assessment and calendar-aware trading decisions. Keywords: token unlock, vesting events, crypto hacks, security incidents, exploit losses, on-chain events

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

data-token-info

[Market Data] Query detailed token/project information by name or symbol. Returns price, market cap, 24h/7d/30d/1y changes, ATH/ATL, supply data, project description, categories, and contract addresses. Supports fuzzy name matching with candidate list. Uses Singleflight deduplication and 5-min Redis cache. [Read-Only]. [Reasoning: Medium]. Keywords: token info, coin lookup, project research, CoinGecko data, crypto token details, price market cap

ParameterTypeRequiredDescription
querystringrequiredA token symbol or project name, e.g. HYPE, PEPE, $DOGE, Hyperliquid, Bitcoin

data-price-btc

[Market Data] Get BTC real-time price in USD. Single-value fast lookup. ⚠️ Single-value lookup. For richer context (technical indicators, whale data) use data-btc-technicals or data-btc-flow. For CEX-sourced ticker → cex-market-get-ticker. [Read-Only]. [Reasoning: Low]. Keywords: Bitcoin BTC price, BTC/USD rate, Bitcoin quote, current BTC USD

ParameterTypeRequiredDescription
timezoneintegeroptionalInteger UTC offset hours (-12 to +14) to format the timestamp. Omit for UTC.

data-price-eth

[Market Data] Get ETH real-time price in USD. Single-value fast lookup. ⚠️ Single-value lookup. For richer context use data-market-pulse. For CEX-sourced ticker → cex-market-get-ticker. [Read-Only]. [Reasoning: Low]. Keywords: Ethereum ETH price, ETH/USD rate, Ethereum quote, current ETH USD

ParameterTypeRequiredDescription
timezoneintegeroptionalInteger UTC offset hours (-12 to +14) to format the timestamp. Omit for UTC.

data-sentiment-fng

[Market Data] Get Crypto Fear & Greed Index (0–100). 0 = Extreme Fear, 100 = Extreme Greed. Primary sentiment gauge for the overall crypto market. ⚠️ Single-value lookup. For comprehensive market overview including FNG, use data-market-pulse. [Read-Only]. [Reasoning: Low]. Keywords: fear greed index, FNG, market sentiment, crypto mood, extreme fear greed

No parameters required.

data-sentiment-funding-btc

[Market Data] Get the current BTC perpetual futures funding rate. Positive = longs paying shorts (bullish bias but crowded). Negative = shorts paying longs (bearish bias). Extreme values signal potential mean-reversion. ⚠️ Single-value lookup. For comprehensive derivatives data, use data-btc-derivatives. [Read-Only]. [Reasoning: Low]. Keywords: BTC funding rate, perp funding, longs paying shorts, funding fee, perpetual swap rate

No parameters required.

data-macro-vix

[Market Data] Get the VIX (CBOE Volatility Index) — the fear gauge for US equity markets. Elevated VIX (>20) signals broad market fear that spills into crypto. [Read-Only]. [Reasoning: Low]. Keywords: VIX, volatility index, fear gauge, equity fear, market panic indicator

No parameters required.

data-event-token-unlock

[Market Data] Get upcoming token unlock and vesting schedule events. Returns unlock dates, amounts, and affected tokens. High unlocks can signal near-term sell pressure. [Read-Only]. [Reasoning: Low]. Keywords: token unlock, vesting cliff, token release schedule, upcoming sell pressure, unlock calendar

No parameters required.

event-feed-list

[Research] Browse the curated Antalpha Event Feed: top-N heat-score-ranked prediction events across POLITICS / WEB3_FINANCE / SPORTS / CULTURE / TECH. ⚠️ Top-N CURATED events only — long-tail markets not included. For a specific market by name → poly-master-search-market. For volume-ranked trending → poly-trending. [Read-Only]. [Reasoning: Low]. Workflow: Step 1 of 3 — Event Feed Workflow (event-feed-list → event-feed-detail → event-feed-prompts). PRIORITY: Use for curated heat-ranked discovery. For free-text market lookup → poly-master-search-market. Keywords: hot events, trending prediction events, browse events, curated events, event feed list

ParameterTypeRequiredDescription
categorystringoptionalFilter to one of POLITICS/WEB3_FINANCE/SPORTS/CULTURE/TECH; omit for all
keywordstringoptionalOptional title search. Space-separated tokens are matched case-insensitively against the English / Simplified / Traditional Chinese titles (all tokens first, then automatically any-token if nothing matches all). Prefer 1-2 DISTINCTIVE proper nouns from the user's message — team/person/asset names like 'Portugal' or '葡萄牙' — over generic words; titles mix languages (e.g. '葡萄牙能否夺得 2026 FIFA World Cup 冠军?'), so '世界杯' may not appear literally. Use this FIRST to resolve an event the user names in chat into its eventId, then pass that eventId to event-feed-detail / oracle-* tools — never guess or leave an eventId empty.
includeClosedbooleanoptionalSet true to also match closed/cancelled/expired (non-archived) events — retry with this when the user references a past or settled event and the default active-only search returns 0 hits.
pageintegeroptional1-indexed page number
pageSizeintegeroptionalItems per page (1–100)
sortBystringoptionalSort key: heatScore (default) / updatedAt / yesProb — all DESC
langstringoptionalUser language preference. Resolved to one of: zh-CN, zh-TW, en, ja, ko (default zh-CN). Accepts BCP-47 tags: `zh`, `zh-CN`, `zh-Hans` → zh-CN; `zh-TW`, `zh-HK`, `zh-Hant` → zh-TW; `en`, `en-US` → en. Localizes title / subTag / aiSummary / suggestedPrompts.

event-feed-detail

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

ParameterTypeRequiredDescription
event_idstringrequiredBusiness-stable event id (e.g. 'poly:0x<64hex>' or 'btc-price-event')
langstringoptionalUser language preference. Resolved to one of: zh-CN, zh-TW, en, ja, ko (default zh-CN). Accepts BCP-47 tags: `zh`, `zh-CN`, `zh-Hans` → zh-CN; `zh-TW`, `zh-HK`, `zh-Hant` → zh-TW; `en`, `en-US` → en. Localizes title / subTag / aiSummary / suggestedPrompts.

event-feed-prompts

[Research] Return 2–3 AI-generated follow-up question strings for a known eventId. For UI chip rendering only — returns strings, does NOT answer questions or return market data. ⚠️ UI HELPER ONLY — returns question text for display, not answers. Input: EXACT eventId. [Read-Only]. [Reasoning: Low]. Workflow: Step 3 of 3 — Event Feed Workflow (after event-feed-detail is displayed). Keywords: follow-up questions, event prompt chips, suggested questions, next questions event

ParameterTypeRequiredDescription
event_idstringrequiredBusiness-stable event id (e.g. 'poly:0x<64hex>' or 'btc-price-event')
langstringoptionalUser language preference. Resolved to one of: zh-CN, zh-TW, en, ja, ko (default zh-CN). Accepts BCP-47 tags: `zh`, `zh-CN`, `zh-Hans` → zh-CN; `zh-TW`, `zh-HK`, `zh-Hant` → zh-TW; `en`, `en-US` → en. Localizes title / subTag / aiSummary / suggestedPrompts.

get_trade_quotes

[Trade Route] Aggregate A-class (in-app: 0x swap-full, 1inch smart-swap-create, HL hyperliquid-market-order/hyperliquid-limit-order) and B-class (off-platform: cex-spot-okx/binance, cex-futures-okx/binance) candidates for a normalized trade intent. Each candidate carries execution_engine in {execute_trade, hl, off_platform} so the agent trade-route-node can route to the correct dispatch (PRD v6.4 §2.3 D-1). Persists a quote_snapshot in Redis for subsequent execute_trade. [Read-Only].

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

[Trade Route] Execute a selected route after get_trade_quotes. Enforces whitelist, quote snapshot validity, and Redis idempotency. Only on-chain paths `swap-full` (0x) and `smart-swap-create` (1inch Fusion) are accepted; pass `execution` to build the signing preview (server does not custody private keys). HL paths are not whitelisted here — the agent dispatches them directly to hyperliquid-market-order / hyperliquid-limit-order (PRD v6.4 §2.3 D-1).

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.

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_idstringoptionalYour agent ID from antalpha-register (required when no bearer token)
levelstringoptionalSignal level filter. 'all' excludes silent info events by default.
limitintegeroptionalMax signals to return
sincestringoptionalISO timestamp — only return signals after this time

smart-money-watch

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

ParameterTypeRequiredDescription
agent_idstringoptionalYour agent ID (required when no bearer token)
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_idstringoptionalYour agent ID (required when no bearer token)

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_idstringoptionalYour agent ID (required when no bearer token)
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_idstringoptionalYour agent ID from antalpha-register (required when no bearer token)
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

DeFi Investor

investor_discover

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

ParameterTypeRequiredDescription
agent_idstringoptionalYour agent ID. Accepts BOTH formats: (1) Antalpha format from antalpha-register tool — 'A' followed by 32 hex chars, e.g. 'A1b2c3d4e5f607081920a1b2c3d4e5f6'; (2) Standard UUID v1-5, e.g. '01234567-89ab-1cde-9234-0123456789ab'. Not required when an OAuth Bearer token is provided in the request.
session_idstringoptionalSession ID for stored intent (optional)
natural_languagestringoptionalUser's request in natural language
structured_preferencesobjectoptional
limitnumberoptional

investor_analyze

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

ParameterTypeRequiredDescription
agent_idstringoptionalYour agent ID. Accepts BOTH formats: (1) Antalpha format from antalpha-register tool — 'A' followed by 32 hex chars, e.g. 'A1b2c3d4e5f607081920a1b2c3d4e5f6'; (2) Standard UUID v1-5, e.g. '01234567-89ab-1cde-9234-0123456789ab'. Not required when an OAuth Bearer token is provided in the request.
product_idstringoptionalThe opaque id of a product obtained from a prior investor_discover call (recommendations[].id). Only set this if you actually have such an id — do NOT invent or guess it. If you don't have one, use `query` instead.
querystringoptionalWhat the user wants to analyze, in their own words — a protocol name like 'Aave' or a full request like 'the USDC pool on Arbitrum'. Use this whenever you don't have a product_id from investor_discover.
analysis_depthstringoptional
include_historybooleanoptional

investor_compare

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

ParameterTypeRequiredDescription
agent_idstringoptionalYour agent ID. Accepts BOTH formats: (1) Antalpha format from antalpha-register tool — 'A' followed by 32 hex chars, e.g. 'A1b2c3d4e5f607081920a1b2c3d4e5f6'; (2) Standard UUID v1-5, e.g. '01234567-89ab-1cde-9234-0123456789ab'. Not required when an OAuth Bearer token is provided in the request.
product_idsarrayrequired
dimensionsarrayoptional

Swap & Trading

swap-quote

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

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

swap-create-page

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

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

swap-tokens

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

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

swap-gas

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

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

swap-full

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

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

Smart Swap

smart-swap-create

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

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

smart-swap-list

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

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

smart-swap-status

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

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

smart-swap-cancel

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

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

Polymarket

poly-intel

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

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

poly-master-traders

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

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

poly-master-search-market

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

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

poly-master-follow

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

ParameterTypeRequiredDescription
agent_idstringoptionalYour agent ID
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_idstringoptionalYour agent ID

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

poly-master-pnl

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

ParameterTypeRequiredDescription
agent_idstringoptionalYour agent ID
periodstringoptionalReport period

poly-master-orders

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

ParameterTypeRequiredDescription
agent_idstringoptionalYour agent ID
statusstringoptionalFilter by order status
limitintegeroptionalMax orders to return

poly-new

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

ParameterTypeRequiredDescription
agent_idstringoptionalYour agent ID from antalpha-register
limitintegeroptionalMax markets to return
hoursintegeroptionalLook back hours
categorystringoptionalFilter by category

poly-market-info

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

ParameterTypeRequiredDescription
agent_idstringoptionalYour agent ID from antalpha-register
market_idstringrequiredMarket reference: index (1,2,3...), conditionId (0x...), Gamma ID, slug, or event/question text

poly-positions

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

ParameterTypeRequiredDescription
agent_idstringoptionalYour agent ID from antalpha-register
proxy_walletstringrequiredPolymarket proxy wallet address (GnosisSafe)

poly-history

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

ParameterTypeRequiredDescription
agent_idstringoptionalYour agent ID from antalpha-register
proxy_walletstringrequiredPolymarket proxy wallet address (GnosisSafe)
limitintegeroptionalMax activities to return

poly-buy

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

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

poly-sell

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

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

poly-confirm

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

ParameterTypeRequiredDescription
agent_idstringoptionalYour agent ID from antalpha-register
order_idstringrequiredOrder ID from poly-buy or poly-sell response

poly-order-status

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

ParameterTypeRequiredDescription
agent_idstringoptionalYour agent ID from antalpha-register
order_idstringrequiredOrder ID from poly-buy or poly-sell response

poly-master-strategy-scan

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

ParameterTypeRequiredDescription
agent_idstringoptionalYour agent ID from antalpha-register
limitintegeroptionalMax markets to scan
min_tierstringoptionalMinimum signal tier to return
dry_runbooleanoptionalNo-op alias kept for prompt compatibility; this tool only scans and never places orders.

poly-master-strategy-metrics

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

ParameterTypeRequiredDescription
agent_idstringoptionalYour agent ID from antalpha-register

poly-master-strategy-dry-run

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

ParameterTypeRequiredDescription
agent_idstringoptionalYour agent ID from antalpha-register
enabledbooleanrequiredtrue = dry-run (log only), false = live execution

Settlement & Gas

settlement-gas-prediction

[Market Data] Get EVM gas fee tier recommendations (instant/fast/standard/slow) in Gwei for a specific chain: ethereum, arbitrum, optimism, base, polygon. ⚠️ Returns RECOMMENDED GAS TIERS — does not predict time. To predict time for a chosen Gwei → settlement-predict-time. NOT for BTC fees (→ settlement-btc-fee). NOT for swap-scoped gas estimate (→ swap-gas). [Read-Only]. [Reasoning: Low]. Workflow: Step 1 of 2 — EVM Gas Workflow (get tiers here, then optionally predict time in step 2). Keywords: EVM gas tiers Gwei, Ethereum Arbitrum Optimism Base Polygon gas, fast standard slow Gwei, gas recommendation

ParameterTypeRequiredDescription
chainstringoptionalEVM chain: ethereum, arbitrum, optimism, base, or polygon (default: ethereum)

settlement-predict-time

[Market Data] Predict EVM transaction confirmation time for a GIVEN Gwei price. Input: specific gas price. Output: estimated blocks, ETA seconds, inclusion probability. ⚠️ Requires a Gwei value as input — call settlement-gas-prediction first if unknown. NOT for getting gas recommendations (→ settlement-gas-prediction). [Read-Only]. [Reasoning: Low]. Workflow: Step 2 of 2 — EVM Gas Workflow (only after settlement-gas-prediction provides the price). Keywords: EVM Gwei confirmation time, Ethereum tx eta, how fast Gwei confirms, blocks to confirmation EVM

ParameterTypeRequiredDescription
chainstringoptionalEVM chain: ethereum, arbitrum, optimism, base, or polygon (default: ethereum)
gas_price_gweinumberrequiredGas price in Gwei

settlement-optimal-window

[Market Data] Find the cheapest hour of day (UTC) to send a transaction based on historical gas patterns. Returns optimal_hour_utc and expected savings. ⚠️ Only useful for NON-URGENT transactions with timing flexibility. NOT for current gas price (→ settlement-gas-prediction). [Read-Only]. [Reasoning: Medium]. Keywords: cheapest hour to transact, best time low gas, historical gas pattern, off-peak transaction window

ParameterTypeRequiredDescription
chainstringoptionalEVM chain: ethereum, arbitrum, optimism, base, or polygon (default: ethereum)
urgencystringoptionalTransaction urgency level (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-evm-tx

[Market Data] Track an EVM transaction by hash. Returns: status (confirmed/failed/pending), block number, confirmation count, gas used, effective fee. ⚠️ Input: EVM TX HASH (0x...). NOT for Bitcoin transactions (→ settlement-track-btc-tx). [Read-Only]. [Reasoning: Low]. Keywords: EVM tx hash tracking, 0x transaction hash lookup, Ethereum txhash status, on-chain transaction receipt, block confirmation count, tx confirmed failed pending, gas used fee receipt, EVM transaction finality, transaction hash query 0x-prefixed

ParameterTypeRequiredDescription
chainstringoptionalEVM chain: ethereum, arbitrum, optimism, base, or polygon (default: ethereum)
tx_hashstringrequiredTransaction hash (0x-prefixed, 66 hex chars)

settlement-verify-contract

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

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

settlement-token-info

[Market Data] Get ERC20 token on-chain metadata: name, symbol, decimals, total supply. Reads from chain directly — no API key needed. ⚠️ METADATA ONLY — not a security check. For security risks → wallet-guard-token-security. [Read-Only]. [Reasoning: Low]. Keywords: ERC20 metadata, token name symbol decimals, total supply contract, what token is this address

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

settlement-btc-fee

[Market Data] Get current Bitcoin mempool fee tier recommendations in sat/vB: instant / fast / standard / slow / economy. ⚠️ Returns RECOMMENDED FEE RATES — does not predict time. To predict confirmation time for a chosen rate → settlement-btc-settlement. NOT for EVM gas (→ settlement-gas-prediction). [Read-Only]. [Reasoning: Low]. Workflow: Step 1 of 2 — Bitcoin Fee Workflow (get rates here, then optionally predict time in step 2). Keywords: Bitcoin fee tiers, sat per vbyte, mempool congestion, BTC fee recommendation, fast slow economy sat/vB

ParameterTypeRequiredDescription
urgencystringoptionalFee urgency level

settlement-btc-settlement

[Market Data] Predict Bitcoin confirmation time for a GIVEN sat/vB fee rate. Input: a specific fee rate. Output: estimated confirmation window + confidence. ⚠️ Requires a fee rate as input — call settlement-btc-fee first if unknown. NOT for getting fee recommendations (→ settlement-btc-fee). [Read-Only]. [Reasoning: Low]. Workflow: Step 2 of 2 — Bitcoin Fee Workflow (only after settlement-btc-fee provides the rate). Keywords: Bitcoin confirmation time, sat/vB speed, BTC mempool time, how fast BTC fee confirms

ParameterTypeRequiredDescription
sat_per_vbnumberrequiredFee rate in satoshis per virtual byte
urgencystringoptionalUrgency level

settlement-track-btc-tx

[Market Data] Track a Bitcoin transaction by txid. Returns: confirmation count, fee paid, input/output totals. ⚠️ Input: BITCOIN TXID (not 0x). NOT for EVM transactions (→ settlement-track-evm-tx). [Read-Only]. [Reasoning: Low]. Keywords: Bitcoin txid tracking, BTC transaction hash lookup, Bitcoin block confirmation count, UTXO transaction status, BTC txid confirmed pending, Bitcoin on-chain finality, BTC fee paid satoshi, Bitcoin transfer confirmation depth

ParameterTypeRequiredDescription
tx_hashstringrequiredBitcoin transaction hash (64 hex chars)

Machine-readable formats: