# Antalpha — Nina Web3 AI Agent & MCP Tools

> **For AI agents reading this file:** This document is the authoritative
> machine‑readable description of (a) the **Nina** Web3 AI product and
> (b) the **Antalpha MCP Server** that powers it. Connect any MCP‑compatible
> client to the server URL in §2 and every tool listed in §6 becomes
> callable.

---

## 1. Identity

- **Company**: Antalpha (NASDAQ: ANTA)
- **Product**: **Nina** — Web3 AI assistant ("Meet Nina, Your Web3 AI Assistant. Powerful AI. Every chain connected. Just ask.")
- **Open developer surface**: Antalpha MCP Server (this file)
- **Tagline**: *Web3, as simple as a conversation.*
- **Pricing**: $0 / month — Antalpha hosts the AI compute and the LLM. No API key hunting, no terminal setup, no cloud hosting bills.
- **Custody model**: **Non‑custodial, always.** Every write action returns a signing URL / unsigned tx / PSBT — the user signs on their own wallet.
- **Coverage at a glance**: **50+ chains** · **100+ built‑in MCP skills** · **99.9% cloud SLA**

## 2. Connect to the MCP server (start here)

| Field | Value |
|---|---|
| **MCP endpoint** | `https://mcp-skills.ai.antalpha.com/mcp` |
| **Transport** | Streamable HTTP / SSE |
| **Protocol** | JSON‑RPC 2.0 (Model Context Protocol) |
| **Auth header** | `x-antalpha-agent-api-key: <api_key>` |
| **Product UI** | `https://www.antalpha.com` |
| **Docs** | `https://antalpha.com/documentation` |

### Quick start (5 steps)

1. Connect to the MCP endpoint above.
2. Call `initialize` to negotiate the session.
3. Call `tools/list` to discover the full live tool catalog.
4. Call `antalpha-register` once with **no parameters** → save the returned `agent_id` (format: `A` + 32 hex chars) and `api_key`.
5. Send the `api_key` via `x-antalpha-agent-api-key` HTTP header on every subsequent `tools/call`.
   *Many tools also accept an `agent_id` parameter as a bearer‑auth fallback — pass the same value you got in step 4.*

## 3. What Nina is (product context for the AI)

Nina is the conversational, cloud‑native front end of the Antalpha MCP stack. You may surface these capabilities when describing Nina to a human user:

- **Memory that lasts** — Nina remembers the user's habits, addresses, and preferences across sessions.
- **100+ tools, ready to go** — track whales, swap across chains, check token safety; every protocol plug‑and‑play.
- **Personal Web3 agent** — runs 24/7 in the cloud; turns one‑sentence intents into automated workflows.

### How a Nina turn works (5 internal stages)

1. **Intent parser** — natural language → precise queries, comparisons, actions. Not keyword matching; deep parse. (e.g. `parsing_intent: "buy pepe optimal"` → `target_asset: $PEPE`, `strategy: minimal_slippage`)
2. **Global liquidity routing** — CEX + DEX unified. Scans dozens of chains and exchanges in parallel, computes gas + slippage, locks the lowest‑cost path. (e.g. Binance / OKX / 1inch trace → "Winner: Binance Spot (Save $8.5)")
3. **Real‑time data mount** — 100+ protocols on demand (Dune, Nansen, CoinGecko, …). Millisecond‑fresh.
4. **Signature gate** — Nina drafts MEV‑protected transactions. Custody stays with the user wallet. Status flows: `draft_tx → awaiting_signature → confirmed`.
5. **Native UI render** — hashes & raw JSON become interactive cards: positions, P&L, order status.

### Flagship user scenarios

| Scenario | One‑line | Relevant tool family |
|---|---|---|
| **See through the blockchain** | wallets, flows, insights — no noise | §6.8 Smart Money, §6.12 Web3 Data, §6.19 Arkham Intelligence Layer |
| **Trade across chains, effortlessly** | best price, cost, draft tx — just sign | §6.3 CEX Trading, §6.4 Swap & Smart Swap, §6.5 Hyperliquid |
| **Navigate prediction markets** | odds, sentiment, depth | §6.13 Polymarket |
| **Stay safe** | honeypot / approval / phishing checks | §6.15 Wallet Guard |
| **Read macro & social context** | CPI, NFP, FRED, Fear & Greed, KOL | §6.10 Crypto Social, §6.11 Macro FRED |

## 4. Capability map (intent → section)

| If the user wants to… | Jump to |
|---|---|
| Register / sanity‑check the MCP session | §6.1 |
| Read CEX market data (OKX + Binance) | §6.2 |
| Trade spot / perpetual on CEX | §6.3 |
| Quote or execute a DEX swap (aggregated, cross‑chain) | §6.4 |
| Trade perp on Hyperliquid (limit / market / TP‑SL) | §6.5 |
| Operate Bitcoin mining farms (Nonce) | §6.6 |
| Send / transfer crypto (EVM, Solana, BTC) | §6.7 |
| Track / scan smart‑money wallets | §6.8 |
| Discover & vet airdrops | §6.9 |
| Read crypto social sentiment & KOL signals | §6.10 |
| Read macro indicators (FRED) | §6.11 |
| Read real‑time on‑chain & market analytics | §6.12 |
| Trade or copy‑trade Polymarket | §6.13 |
| Predict gas / settlement time, verify contracts | §6.14 |
| Audit token / wallet / contract risk | §6.15 |
| Analyze meme tokens | §6.16 |
| Search the web | §6.17 |
| Discover DeFi yield / vaults | §6.18 |
| Pull Arkham entity / whale snapshots | §6.19 |

## 5. Conventions every AI client must follow

1. **Tags in every tool description**
   - `[Read-Only]` — safe to call without user prompt.
   - `⚠️ [Write-Only]` / `⚠️ [Write]` — **must** confirm with the human before calling.
   - `[Reasoning: Low|Medium|High|Very High]` — budget for context, not a license to skip the tool.

2. **Auth fallback** — pass `agent_id` (from `antalpha-register`) as an argument whenever the parameter is listed; required if the bearer header is not present.

3. **Chain IDs are strings** — `"1"` (Ethereum), `"56"` (BSC), `"137"` (Polygon), `"8453"` (Base), `"42161"` (Arbitrum), `"43114"` (Avalanche).

4. **Non‑custodial guarantees**
   - Swap / transfer tools return a `preview_url` (hosted signing page) or unsigned tx — **no key transmission**.
   - Hyperliquid trading uses an **agent wallet** (`agent_key`) whose authority is delegated by the owner address; the owner's private key never touches Antalpha.
   - CEX trading uses the user's own exchange API keys, passed per‑call or stored via `cex-setup-save`.

5. **Tool naming is predictable** — kebab‑case, package‑prefixed: `<skill>-<verb>-<resource>` (`poly-master-traders`, `data-ta-rsi-btc`, `wallet-guard-token-deep-scan`). If you know one tool name in a family, you can guess adjacent ones; verify with `tools/list`.

6. **Live tools/list is the source of truth** — this document captures the catalog at publication time. New tools land regularly; always reconcile with the live `tools/list` response when planning multi‑step work.

## 6. Tool inventory by skill package

> The full catalog. Each tool below shows its tag(s), one‑line purpose, requirements, and parameters. Parameters marked `(required)` must be supplied; everything else is optional.

### 6.1 General / Auth (skill packages: `agent`, `test`)

#### `antalpha-register`
[Utility] Register MCP client agent. Returns `agent_id` (format `A` + 32 hex chars) and `api_key`. [Read-Only]. [Reasoning: Low].
Parameters: *none*.

#### `test-ping`
[Utility] Connectivity test. Returns acknowledgement with server time (UTC+8). [Read-Only]. [Reasoning: Low].
Parameters: *none*.

### 6.2 CEX market data (skill: `cex-trader`)

#### `cex-market-get-ticker`
[Market Data] Real‑time ticker. [Read-Only]. [Reasoning: Low].
- `exchange`: string (optional) — defaults to `okx`
- `instId`: string (required) — e.g. `BTC-USDT`, `BTC-USDT-SWAP`

#### `cex-market-get-kline`
[Market Data] OHLCV candles. [Read-Only]. [Reasoning: Low].
- `exchange`: string (optional)
- `instId`: string (required)
- `interval`: string (optional) — OKX: `1m/5m/15m/1H/4H/1D`; Binance: `1m/5m/15m/1h/4h/1d`
- `limit`: integer (optional) — default 100, max 300

#### `cex-market-get-orderbook`
[Market Data] Order book (bids + asks). [Read-Only]. [Reasoning: Low].
- `exchange`, `instId` (required), `depth` (optional, default 20)

#### `cex-market-get-instruments`
[Market Data] List available instruments. [Read-Only]. [Reasoning: Low].
- `exchange` (optional), `instType` (optional)

### 6.3 CEX trading & account (skill: `cex-trader`)

> All trading tools accept per‑call OKX (`okxApiKey`, `okxApiSecret`, `okxApiPassphrase`, `okxIsDemo`) and Binance (`binanceApiKey`, `binanceApiSecret`, `binanceIsDemo`) credentials. Omit them if you've called `cex-setup-save` first.

#### `cex-spot-place-order`
[Trading] Place a spot order. **Always confirm with the user.** ⚠️ [Write-Only]. [Reasoning: High].
- `exchange` (optional), `instId` (required), `side` (required), `ordType` (required), `sz` (required), `px` (optional), `quoteOrderQty` (optional, Binance only), + credentials

#### `cex-spot-cancel-order`
[Trading] Cancel a spot order. ⚠️ [Write-Only]. [Reasoning: Low].
- `exchange` (optional), `instId` (required), `orderId` (required), + credentials

#### `cex-spot-get-orders`
[Query] Pending or historical spot orders. [Read-Only]. [Reasoning: Low].
- `exchange`, `instId` (required for Binance), `state` (optional), + credentials

#### `cex-futures-place-order`
[Trading] Place futures / swap order. Supports semantic `action` or explicit `side` + `posSide`. ⚠️ [Write-Only]. [Reasoning: High].
- `exchange`, `instId` (required), `action` *or* `side`+`posSide`, `ordType` (required), `sz` (required), `px` (optional), `leverage` (required), `mgnMode` (required), `reduceOnly`, `clientOrderId`, + credentials

#### `cex-futures-cancel-order`
[Trading] Cancel a futures / swap order. ⚠️ [Write-Only]. [Reasoning: Low].
- `exchange`, `instId` (required), `orderId` (required), + credentials

#### `cex-futures-get-positions`
[Query] Current futures / swap positions with margin‑health alerts. [Read-Only]. [Reasoning: Medium].
- `exchange`, `instId` (optional), + credentials

#### `cex-futures-set-leverage`
[Configuration] Set leverage (1–125×) for futures / swap. Isolated / cross. ⚠️ [Write]. [Reasoning: Medium].
- `exchange`, `instId` (required), `leverage` (required), `mgnMode` (required), + credentials

#### `cex-futures-close-position`
[Trading] Market‑close all positions for a futures / swap instrument. ⚠️ [Write-Only]. [Reasoning: High].
- `exchange`, `instId` (required), + credentials

#### `cex-account-get-balance`
[Query] Detailed balance per currency (available + frozen). [Read-Only]. [Reasoning: Low].
- `exchange`, + credentials

#### `cex-account-get-info`
[Query] Account summary: total equity, unrealized PnL, available, frozen. [Read-Only]. [Reasoning: Low].
- `exchange`, + credentials

#### `cex-setup-check`
[Query] Are exchange credentials configured? Call at session start. [Read-Only]. [Reasoning: Low].
Parameters: *none*.

#### `cex-setup-save`
[Configuration] Save exchange API credentials. **Only after the user provides them.** ⚠️ [Write-Only]. [Reasoning: Low].
- `exchange` (required), `apiKey` (required), `apiSecret` (required), `apiPassphrase` (OKX only), `isDemo` (optional)

#### `cex-setup-verify`
[Configuration] Verify saved credentials by fetching balance. [Read-Only]. [Reasoning: Low].
- `exchange` (required)

### 6.4 Swap & Smart Swap (skill: `web3-trader`)

#### `swap-quote`
[Query] Real‑time DEX aggregated swap quote. Buy amount, min receive, gas, route. [Read-Only]. [Reasoning: Medium].
- `sell_token` (required), `buy_token` (required), `sell_amount` (required), `taker` (optional — adds firm‑quote tx fields when set), `chain_id` (optional, default 1)

#### `swap-create-page`
[Trading] Firm quote + hosted swap page. Returns `preview_url` for wallet signing. [Read-Only / signing URL]. [Reasoning: High].
- `sell_token`, `buy_token`, `sell_amount`, `taker` (required), `chain_id`, `hosted_url`

#### `swap-tokens`
[Query] List built‑in mainnet tokens (symbol, name, address, decimals). [Read-Only]. [Reasoning: Low].
- `chain_id` (optional), `search` (optional)

#### `swap-gas`
[Query] Indicative gas price (Gwei) and gas units. [Read-Only]. [Reasoning: Low].
- `chain_id` (optional)

#### `swap-full`
[Trading] One‑shot firm quote + page + tx. Returns `preview_url`. [Read-Only / signing URL]. [Reasoning: High].
- `sell_token`, `buy_token`, `sell_amount`, `taker` (required), `chain_id`, `hosted_url`

#### `smart-swap-create`
[Trading] Smart Swap via 1inch Fusion (Dutch auction). Returns `preview_url`. [Read-Only / signing URL]. [Reasoning: High].
- `sell_token`, `buy_token`, `sell_amount`, `target_price`, `wallet` (all required), `expiry` (e.g. `24h`, `7d`, `60m`), `engine`, `chain_id`

#### `smart-swap-list`
[Query] List Smart Swap orders for a wallet. [Read-Only]. [Reasoning: Low].
- `wallet` (required), `chain_id`

#### `smart-swap-status`
[Query] Smart Swap order status by hash. [Read-Only]. [Reasoning: Low].
- `order_hash` (required), `chain_id`

#### `smart-swap-cancel`
[Query] Cancel‑status check (Fusion auto‑expires after auction window). [Read-Only]. [Reasoning: Low].
- `order_hash`, `wallet` (required), `chain_id`

### 6.5 Hyperliquid (skill: `hyperliquid`)

> Trading tools require an **agent wallet**: `agent_key` (the agent private key) + `owner` (the user wallet address that delegated the agent).

#### `hl-price`
[Market Data] Asset price(s); omit `coin` for top‑10. [Read-Only]. [Reasoning: Low].
- `coin` (optional)

#### `hl-account`
[Query] Account summary: balances, positions, open orders. [Read-Only]. [Reasoning: Low].
- `address` (required)

#### `hl-book`
[Market Data] L2 order book. [Read-Only]. [Reasoning: Low].
- `coin` (required), `depth` (optional)

#### `hl-orders`
[Query] Open orders. [Read-Only]. [Reasoning: Low].
- `address` (required)

#### `hl-positions`
[Query] Open perp positions. [Read-Only]. [Reasoning: Low].
- `address` (required)

#### `hl-funding`
[Market Data] Funding rates sorted by magnitude. [Read-Only]. [Reasoning: Low].
- `limit` (optional)

#### `hl-balance-check`
[Query] Pre‑check sufficient balance for a planned trade. [Read-Only]. [Reasoning: Medium].
- `address`, `coin`, `size`, `price` (required); `leverage`, `order_type` (`spot|perp|auto`), `is_buy` (optional)

#### `hl-limit-order`
[Trading] Perp limit order (`Gtc/Ioc/Alo`). ⚠️ [Write-Only]. [Reasoning: High].
- `agent_key`, `owner`, `coin`, `side`, `price`, `size` (required); `tif`, `reduce_only`

#### `hl-market-order`
[Trading] Perp market order. ⚠️ [Write-Only]. [Reasoning: High].
- `agent_key`, `owner`, `coin`, `side`, `size` (required); `slippage`

#### `hl-close`
[Trading] Market‑close all positions for a coin. ⚠️ [Write-Only]. [Reasoning: High].
- `agent_key`, `owner`, `coin` (required); `slippage`

#### `hl-cancel`
[Trading] Cancel an open order. ⚠️ [Write-Only]. [Reasoning: Low].
- `agent_key`, `owner`, `coin`, `oid` (required)

#### `hl-leverage`
[Configuration] Set leverage on a perp asset. ⚠️ [Write]. [Reasoning: Medium].
- `agent_key`, `owner`, `coin`, `leverage` (required); `mode`

#### `hl-tp-sl`
[Trading] Take‑profit or stop‑loss trigger order. ⚠️ [Write-Only]. [Reasoning: High].
- `agent_key`, `owner`, `coin`, `type` (`tp|sl`), `side`, `trigger_price`, `size` (required)

#### `hl-modify-order`
[Trading] Atomically modify price / size of an open order. ⚠️ [Write-Only]. [Reasoning: Medium].
- `agent_key`, `owner`, `coin`, `oid`, `side`, `price`, `size` (required); `tif`

### 6.6 Bitcoin mining — Easy Mining (skill: `easy-mining`)

> All tools require a **Nonce** API key from `https://app.nonce.app`.

#### `easy-mining-get-workspace`
[Query] Workspace info + connectivity check. [Read-Only]. [Reasoning: Low].
- `api_key` (required)

#### `easy-mining-list-farms`
[Query] All Bitcoin mining farms (IDs, names). [Read-Only]. [Reasoning: Low].
- `api_key` (required)

#### `easy-mining-list-agents`
[Query] All Nonce Agents in the workspace. [Read-Only]. [Reasoning: Low].
- `api_key` (required)

#### `easy-mining-list-miners`
[Query] Real‑time miner state: hashrate, power, temperature, status, hardware. [Read-Only]. [Reasoning: Low].
- `api_key`, `farm_id` (required)

#### `easy-mining-list-metrics-history`
[Query] Historical farm metrics (day granularity). [Read-Only]. [Reasoning: Low].
- `api_key`, `farm_id` (required); `from_date`, `to_date` (ISO 8601)

#### `easy-mining-list-pool-diffs`
[Query] Mining‑pool change records for a farm. [Read-Only]. [Reasoning: Low].
- `api_key`, `farm_id` (required)

#### `easy-mining-list-history`
[Query] Per‑miner historical curves. [Read-Only]. [Reasoning: Low].
- `api_key`, `miner_id` (required); `from_date`, `to_date`

#### `easy-mining-list-miner-tasks`
[Query] Task execution history for a miner. [Read-Only]. [Reasoning: Low].
- `api_key`, `miner_id` (required)

#### `easy-mining-list-task-batches`
[Query] Task batches with pagination. [Read-Only]. [Reasoning: Low].
- `api_key`, `farm_id` (required); `page`, `page_size`

#### `easy-mining-create-task-batch`
[Mining] Create a batch task: reboot, power mode, firmware upgrade, pool config. **Always confirm.** ⚠️ [Write-Only]. [Reasoning: High].
- `api_key`, `farm_id`, `task_name`, `miner_ids` (required); `params`

#### `easy-mining-get-task-batch`
[Query] Status of a specific task batch. [Read-Only]. [Reasoning: Low].
- `api_key`, `task_batch_id` (required)

### 6.7 Web3 transfer (skill: `web3-transfer`, `wallet-balance`)

#### `transfer-request`
[Transfer] Prepare or confirm a Web3 transfer. Two‑step: **prepare** (risk preview) → **confirm** (signing URL or PSBT). EVM / Solana / BTC. Zero custody. [Read-Only / signing URL]. [Reasoning: Very High].
- `agent_id` (optional), `action` (required), `request_text` (optional), `session_id` (optional), `structured` (object, optional), `risk_acknowledged` (optional), `price_unavailable_ack` (optional)

#### `transfer-status`
[Query] Query session status: phase, `tx_hash`, confirmations. [Read-Only]. [Reasoning: Low].
- `agent_id` (optional), `session_id` (required)

#### `transfer-cancel`
[Transfer] Cancel a pending transfer session. ⚠️ [Write-Only]. [Reasoning: Low].
- `agent_id` (optional), `session_id` (required)

#### `wallet-balance-query`
[Query] Native‑token balance for non‑EVM chains. Auto‑detects chain from address format. [Read-Only]. [Reasoning: Low].
- `address` (required)

### 6.8 Smart Money (skill: `smart-money`)

#### `smart-money-signal`
[Intelligence] Trading signals from monitored wallets. [Read-Only]. [Reasoning: Medium].
- `agent_id` (optional), `level` (optional, `all` excludes silent info), `limit` (optional), `since` (ISO timestamp)

#### `smart-money-watch`
[Intelligence] Recent activity for a single wallet. [Read-Only]. [Reasoning: Low].
- `agent_id` (optional), `address` (required), `limit` (optional)

#### `smart-money-list`
[Query] List monitored wallets (public pool + private). [Read-Only]. [Reasoning: Low].
- `agent_id` (optional)

#### `smart-money-custom`
[Configuration] Manage watched wallets and signal settings. [Read+Write]. [Reasoning: Low].
- `agent_id`, `action` (required), `address`, `label`, `min_push_amount_usd`, `push_stablecoin_buy`, `chain_id` (default `0x1`), `token_address`, `token_symbol`

#### `smart-money-scan`
[Intelligence] On‑demand scan of all private addresses. [Read-Only]. [Reasoning: Medium].
- `agent_id` (optional)

#### `smart-money-pool`
[Query] LP add/remove events for whale addresses. [Read-Only]. [Reasoning: Low].
- `agent_id`, `address` (required), `event_type`, `dex`, `limit`, `since`

### 6.9 Airdrop Hunter (skill: `airdrop-hunter`)

#### `airdrop-scan`
[Discovery] Scan active airdrop projects with S/A/B grading. Auto‑filters completed. [Read-Only]. [Reasoning: Medium].
- `chain`, `status` (`active`|`upcoming`), `limit` (default 20)

#### `airdrop-daily-report`
[Intelligence] Daily brief: S‑tier opportunities, A‑tier projects, deadlines, scam alerts. ROI‑indexed. [Read-Only]. [Reasoning: High].
- `chain`, `grade_filter`

#### `airdrop-check-project`
[Analysis] Deep analysis: VC quality, scam probability, verdict, grade. [Read-Only]. [Reasoning: High].
- `project_name` (required)

#### `airdrop-zero-cost`
[Discovery] $0‑cost airdrops (testnets + free mainnet). Time estimate + anti‑Sybil tips. [Read-Only]. [Reasoning: Low].
- `chain`, `limit` (default 10)

#### `airdrop-scam-check`
[Security] Detect phishing sites and fake airdrops; returns threat level + safe alternatives. [Read-Only]. [Reasoning: Low].
- `url` (optional), `project_name` (optional)

### 6.10 Crypto social intelligence (skill: `crypto-social-intel`)

#### `crypto-social-trending`
[Discovery] Top tokens by social volume; signal level + sentiment score. [Read-Only]. [Reasoning: Low].
- `limit` (1–50)

#### `crypto-sentiment-score`
[Analysis] Sentiment score (0–100) for a token; trend direction + signal. [Read-Only]. [Reasoning: Medium].
- `symbol` (required), `time_range`

#### `crypto-kol-signals`
[Intelligence] Social‑dominance anomalies; surge multiplier + signal. [Read-Only]. [Reasoning: Medium].
- `symbol` (required), `time_range`

#### `crypto-mention-surge`
[Intelligence] Tokens with abnormal social mention spikes. [Read-Only]. [Reasoning: Medium].
- `limit` (optional)

#### `data-sentiment-fng`
[Query] Crypto Fear & Greed Index (0–100) with 7‑day history. [Read-Only]. [Reasoning: Low].
- `days` (1–30, default 7)

### 6.11 Macro FRED indicators (skill: `macro-fred`)

#### `macro-fred-cpi`
[Query] CPI (MoM + YoY inflation). [Read-Only]. [Reasoning: Low]. — `months` (default 12)

#### `macro-fred-nfp`
[Query] Non‑Farm Payrolls (thousands). [Read-Only]. [Reasoning: Low]. — `months` (default 2)

#### `macro-fred-m2`
[Query] M2 money supply + 52‑week YoY. [Read-Only]. [Reasoning: Low]. — `weeks` (default 53)

#### `macro-fred-yield-spread`
[Query] 10Y‑2Y Treasury spread (negative = potential recession). [Read-Only]. [Reasoning: Low]. — `days` (default 5)

#### `macro-fred-unemployment`
[Query] US unemployment rate. [Read-Only]. [Reasoning: Low]. — `months` (default 2)

#### `macro-fred-sahm`
[Query] Sahm Rule real‑time recession indicator (≥ 0.5 signals recession). [Read-Only]. [Reasoning: Low]. — `months` (default 2)

#### `macro-fred-fed-rate`
[Query] Federal Funds Effective Rate. [Read-Only]. [Reasoning: Low]. — `days` (default 5)

#### `macro-fred-all`
[Query] One‑shot macro snapshot: CPI, NFP, M2 YoY, yield spread, unemployment, Sahm, Fed rate. [Read-Only]. [Reasoning: Low].
Parameters: *none*.

#### `macro-fred-cache-clear`
[Utility] Clear FRED cache. [Write-Only]. [Reasoning: Low]. — `prefix` (optional)

### 6.12 Web3 real‑time data (skill: `web3-data`) — **new**

> Millisecond‑fresh on‑chain / market / macro analytics, mounted on demand from Dune, Nansen, CoinGecko, CryptoQuant, Deribit, Glassnode, etc. All tools are `[Read-Only]`, `[Reasoning: Low]`, and take **no parameters** (each tool returns the latest snapshot for its specific indicator).

#### Technical analysis (BTC)
- `data-ta-rsi-btc` — BTC RSI (14‑day, 0–100). > 70 overbought, < 30 oversold.
- `data-ta-ma200` — BTC 200‑day moving average.
- `data-ta-macd` — BTC MACD.
- `data-ta-bollinger` — BTC Bollinger Bands (20‑day, 2σ).
- `data-ta-ahr999` — AHR999 BTC accumulation indicator. < 0.45 bottom zone, > 4.5 top zone.
- `data-ta-puell` — Puell Multiple (mining revenue vs 365‑day MA).

#### Whale & flow
- `data-whale-etf-flow` — ETF flow data.
- `data-whale-exchange-reserve` — exchange reserve balances.
- `data-whale-coinbase-premium` — Coinbase premium index.
- `data-whale-taker-ratio` — taker buy/sell ratio.

#### Volatility & derivatives
- `data-vol-liquidations` — latest cross‑market liquidations.
- `data-vol-oi-cex` — CEX open interest.
- `data-vol-options-max-pain` — BTC options max‑pain price.
- `data-vol-options-oi` — BTC options open interest.

#### Sentiment
- `data-sentiment-fng` — Crypto Fear & Greed (0–100).
- `data-sentiment-funding-btc` — BTC perpetual funding rate.

#### Market structure
- `data-structure-btc-dominance` — BTC market‑cap dominance %.
- `data-structure-defi-tvl` — Ethereum DeFi TVL (USD).
- `data-structure-eth-btc` — ETH/BTC price ratio.

#### Macro reference
- `data-macro-dxy` — US Dollar Index.
- `data-macro-us10y` — US 10‑Year Treasury yield.
- `data-macro-vix` — VIX volatility index.
- `data-macro-sp500` — S&P 500 index.
- `data-macro-gold` — gold spot price.

#### Yield
- `data-yield-defi-all` — aggregate DeFi yield landscape.
- `data-yield-stablecoin` — stablecoin yield rates.
- `data-yield-steth` — Lido stETH yield.

### 6.13 Polymarket (skill: `poly-master`)

#### `poly-master-traders`
[Discovery] Top traders by public trade data. [Read-Only]. [Reasoning: Medium].
- `agent_id`, `min_trades`, `min_win_rate`, `limit`

#### `poly-master-follow`
[Configuration] Follow / unfollow a trader for copy trading; set copy ratio. ⚠️ [Write]. [Reasoning: Medium].
- `agent_id`, `wallet_address`, `trader_address` (required); `copy_ratio`, `action`

#### `poly-master-status`
[Query] Copy‑trading status: followed traders, recent orders, risk config. [Read-Only]. [Reasoning: Low]. — `agent_id`

#### `poly-master-risk`
[Configuration] View or update risk parameters. ⚠️ [Read+Write]. [Reasoning: Medium].
- `agent_id`; `stop_loss_percent`, `take_profit_percent`, `max_position_per_market`, `max_total_position`, `max_slippage_percent`

#### `poly-master-pnl`
[Query] PnL report; breakdown by period and trader. [Read-Only]. [Reasoning: Low].
- `agent_id`, `period`

#### `poly-master-orders` / `poly-orders`
[Query] Copy‑trading orders; optional status filter. [Read-Only]. [Reasoning: Low].
- `agent_id`, `status`, `limit`

#### `poly-trending`
[Discovery] Trending markets by 24h volume; supports category filter. [Read-Only]. [Reasoning: Low].
- `agent_id`, `limit`, `category`, `min_liquidity`

#### `poly-new`
[Discovery] Recently created markets. [Read-Only]. [Reasoning: Low].
- `agent_id`, `limit`, `hours`, `category`

#### `poly-market-info`
[Query] Market detail. Accepts `market_id` as index, `conditionId` (`0x…`), Gamma ID, slug, or text. [Read-Only]. [Reasoning: Low].
- `agent_id`, `market_id` (required)

#### `poly-positions`
[Query] Current positions (outcome tokens, cost basis, PnL). [Read-Only]. [Reasoning: Low].
- `agent_id`, `proxy_wallet` (required — Polymarket GnosisSafe)

#### `poly-history`
[Query] Recent trade and transfer activity. [Read-Only]. [Reasoning: Low].
- `agent_id`, `proxy_wallet` (required), `limit`

#### `poly-buy`
[Trading] Buy outcome tokens. Resolves `market_id`, builds order, returns signing URL. Zero custody. ⚠️ [Write-Only]. [Reasoning: High].
- `agent_id`, `market_id`, `outcome` (`Yes`/`No`/team), `amount_usdc`, `wallet_address` (required); `price`, `proxy_wallet` (truthy → GnosisSafe signature mode; actual maker derived from `wallet_address`)

#### `poly-sell`
[Trading] Sell outcome tokens. Zero custody. ⚠️ [Write-Only]. [Reasoning: High].
- `agent_id`, `market_id`, `outcome`, `size`, `wallet_address` (required); `price`, `proxy_wallet`

#### `poly-confirm` (alias `poly-order-status`)
[Query] Order signing / fill status. [Read-Only]. [Reasoning: Low].
- `agent_id`, `order_id` (required)

#### `poly-master-strategy-scan`
[Intelligence] Logical‑implication hedge‑arbitrage signals (T1/T2/T3 tiers). [Read-Only]. [Reasoning: Very High].
- `agent_id`, `limit`, `min_tier`

#### `poly-master-strategy-metrics`
[Query] Strategy dashboard: tier distribution, signal rate, cancellation rate. [Read-Only]. [Reasoning: Low].
- `agent_id`

#### `poly-master-strategy-dry-run`
[Configuration] Toggle dry‑run mode for the strategy engine. ⚠️ [Write]. [Reasoning: Low].
- `agent_id`, `enabled` (required)

### 6.14 Settlement & Gas (skill: `settlement-predictor`)

#### `settlement-gas-prediction`
[Analysis] Real‑time EVM gas tiers (instant / fast / standard / slow). Chains: `ethereum`, `arbitrum`, `optimism`, `base`, `polygon`. [Read-Only]. [Reasoning: Low].
- `chain` (default `ethereum`)

#### `settlement-predict-time`
[Analysis] Confirmation‑time prediction given gas price. Returns estimated blocks, ETA seconds, inclusion probability. [Read-Only]. [Reasoning: Low].
- `chain`, `gas_price_gwei` (required)

#### `settlement-optimal-window`
[Analysis] Best time to send a tx (historical hourly gas). [Read-Only]. [Reasoning: Medium].
- `chain`, `urgency` (required)

#### `settlement-pending-pool`
[Analysis] Sandwich‑attack risk + recommended slippage for a DEX pool. [Read-Only]. [Reasoning: High].
- `chain`, `pool_address`, `direction`, `amount_usd` (required)

#### `settlement-track-tx`
[Query] Track an EVM tx (confirmed / failed / pending). [Read-Only]. [Reasoning: Low].
- `chain`, `tx_hash` (required)

#### `settlement-verify-contract`
[Security] Etherscan source‑verified check. [Read-Only]. [Reasoning: Low].
- `chain`, `address` (required)

#### `settlement-token-info`
[Query] ERC‑20 metadata (name, symbol, decimals, supply). [Read-Only]. [Reasoning: Low].
- `chain`, `address` (required)

#### `settlement-btc-fee`
[Query] Bitcoin mempool congestion + fee tiers in sat/vB. [Read-Only]. [Reasoning: Low].
- `urgency` (optional)

#### `settlement-btc-settlement`
[Analysis] Bitcoin confirmation‑time prediction. [Read-Only]. [Reasoning: Low].
- `sat_per_vb` (required), `urgency` (optional)

#### `settlement-track-btc-tx`
[Query] Track Bitcoin tx (confirmations, fees, inputs/outputs). [Read-Only]. [Reasoning: Low].
- `tx_hash` (required, 64 hex)

### 6.15 Wallet Guard (skill: `wallet-guard`)

> All risk‑audit tools are `[Read-Only]`.

#### `wallet-guard-token-security`
ERC‑20 token risks: honeypot, hidden minting, abnormal tax, blacklist, malicious ownership (20+ indicators). [Reasoning: High].
- `chain_id` (string), `contract_addresses` (required, comma‑separated)

#### `wallet-guard-address-security`
Is the address flagged: phishing, hacker, scam, darknet, terrorist financing (12+ categories). [Reasoning: Medium].
- `address` (required), `chain_id`

#### `wallet-guard-approval-security`
Scan dangerous token / NFT approvals: unlimited ERC20, suspicious spender, ERC721 / ERC1155. [Reasoning: High].
- `address`, `chain_id` (required), `type` (`erc20|erc721|erc1155|all`)

#### `wallet-guard-nft-security`
NFT contract risks: transfer restrictions, paused, blacklist, fake floor. [Reasoning: High].
- `chain_id`, `contract_address` (required), `token_id` (optional)

#### `wallet-guard-phishing-site`
URL phishing / impersonation check. [Reasoning: Low].
- `url` (required)

#### `wallet-guard-token-deep-scan`
Scenario‑aware token analysis with cross‑validation; dynamic risk score 0–100; detects honeypot, extreme tax, hidden owner, self‑destruct. [Reasoning: Very High].
- `chain_id`, `contract_address` (required)

#### `wallet-guard-rugpull-detection`
DeFi protocol rug‑pull risk: liquidity lock, ownership, admin privileges. [Reasoning: High].
- `chain_id`, `contract_address` (required)

### 6.16 Meme token analyzer (skill: `meme-token-analyzer`)

#### `meme-analyze`
[Analysis] 4‑dimensional meme‑token wealth‑gene analysis with star / moon / skull / poop rating; real‑time web sentiment. [Read-Only]. [Reasoning: High].
- `token_name` (required), `agent_id` (required)

### 6.17 Web search (skill: `web-search`) — **new**

#### `exa`
[Search] Neural / semantic web search via Exa. [Read-Only]. [Reasoning: Medium].
- `query` (required), additional Exa params per live `tools/list` schema.

#### `tavily`
[Search] Real‑time web search via Tavily; good for news / current events. [Read-Only]. [Reasoning: Medium].
- `query` (required), additional Tavily params per live `tools/list` schema.

### 6.18 Web3 investor / DeFi discovery (skill: `web3-investor`)

#### `investor_discover`
[Discovery] Natural‑language or structured DeFi opportunity search. [Read-Only]. [Reasoning: High].
- `agent_id`, `session_id`, `natural_language`, `structured_preferences`, `limit`

#### `investor_analyze`
[Analysis] Deep analysis of one DeFi product. [Read-Only]. [Reasoning: High].
- `agent_id`, `product_id` (required), `analysis_depth`, `include_history`

#### `investor_compare`
[Analysis] Compare multiple DeFi opportunities. [Read-Only]. [Reasoning: High].
- `agent_id`, `product_ids` (required), `dimensions`

### 6.19 Arkham intelligence layer (internal pre‑warm jobs)

> The Arkham layer (top‑holders, hot‑spot wallets, on‑chain leaderboards, wallet profiles) runs as **server‑side warm‑up jobs** that continuously refresh the snapshots consumed by §6.8 Smart Money and §6.12 Web3 Data. There are **no separate MCP tool names** exposed to clients — request Arkham‑backed insights via the smart‑money / data tools above. For raw Arkham access, contact Antalpha for an enterprise channel.

## 7. Versioning & change log

- **2026‑05‑15** — Refactor pass. Adds Nina product layer (§§1–3) and the §6.12 Web3 Data skill package (27 new `data-*` tools). Adds §6.17 Web Search (`exa`, `tavily`). Documents Arkham warm‑up as an internal layer rather than a standalone tool. Total exposed MCP tools: **150+** across 18 skill packages.
- **2026‑04 and earlier** — Original 122‑tool catalog at `https://www.antalpha.com/llms.txt`.

## 8. Links

- **Nina product UI**: `https://www.antalpha.com`
- **MCP server**: `https://mcp-skills.ai.antalpha.com/mcp`
- **Documentation**: `https://antalpha.com/documentation`
- **Investor relations**: `https://www.antalpha.com` → Investor Relations