> For the complete documentation index, see [llms.txt](https://docs.zeroauthority.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.zeroauthority.xyz/nova-bot/tools.md). # Tools Nova Tools is your AI-powered, multi-chain blockchain toolkit — with the deepest coverage of the Bitcoin and Stacks ecosystems, plus 60+ EVM networks, Solana, TON, Sui, and Hyperliquid — and a growing set of **community-ecosystem** tools (Nova is both a blockchain assistant and a community assistant). Run analytics directly from the dashboard, or connect your AI agent via MCP or REST API. {% hint style="info" %} Tools are available to both humans (via the dashboard) and AI agents (via MCP / REST API with x402 payment). Nova Premium subscribers get unlimited access to all tools. {% endhint %} *** ### How to read this catalog Nova ships **one tool per chain** for each capability. To keep this page readable as more chains land, the catalog is grouped by **capability** — each row is a capability, and the **Chains** column shows which chains it covers. The live [Nova Tools dashboard](https://nova.zeroauthoritydao.com/tools) is the searchable, filterable source of truth; this page is the human-readable overview. {% hint style="info" %} **Slugs are chain-prefixed** (`stacks-…`, `bitcoin-…`, `evm-…`, `solana-…`, `ton-…`, `sui-…`, `hyperliquid-…`) so the target chain is legible from the name alone, and you can filter a chain's whole toolset by its prefix. For each capability below, the canonical slug is `-` — e.g. the Token Price capability is `stacks-token-price`, `bitcoin-token-price`, `evm-token-price`, `solana-token-price`, `hyperliquid-token-price`. Renamed Stacks/Bitcoin tools keep their **old slug as an alias** — the previous `POST /api/tools//run` URL and the `nova_` MCP id still resolve, so existing integrations keep working. {% endhint %} A full capability × chain coverage matrix lives on its own page: *** ### Token Intelligence | Capability | Slug pattern | Chains | Price | Description | | -------------------- | -------------------------- | --------------------------------------------------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Token Price** | `-token-price` | Stacks · Bitcoin · EVM · Solana · TON · Sui · Hyperliquid | Free | Live USD price, 24h change, market cap, volume, liquidity, holder count (Hyperliquid adds perp mark/oracle price, funding rate, open interest) | | **Token Analytics** | `-token-analytics` | Stacks · EVM · Solana | 💰 500 sats | AI deep-dive report: price, market data, holder distribution, trading volume, on-chain metrics, ecosystem context | | **Token Risk Check** | `-token-risk-check` | Stacks · EVM · Solana | 💰 500 sats | Conservative rug-check / risk score (0–100): verified status, liquidity, holder concentration, mint/freeze authority, honeypot, owner powers, taxes (GoPlus / RugCheck + contract audit) | | **Token Holders** | `-token-holders` | Stacks · EVM · Solana | Free | Holder distribution: top wallets, top-10/top-20 concentration %, supply breakdown, per-holder USD values | | **Token OHLC** | `-token-ohlc` | Stacks · Hyperliquid | Free | Historical OHLC price candles (open / high / low / close / volume) over a chosen interval for charting & technical analysis (Hyperliquid covers its perp market, or canonical spot) | ### Wallet & Portfolio | Capability | Slug pattern | Chains | Price | Description | | --------------------- | --------------------------- | ----------------------------------------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Wallet Lookup** | `-wallet-lookup` | Stacks · EVM · Solana · TON · Sui · Hyperliquid | Free | Aggregate portfolio: native + token holdings with USD values, NFTs, and total value. Stacks adds BNS, staking (PoX + stSTX/liSTX), DeFi positions, and P\&L; Hyperliquid returns the perp trading account (open positions, PnL, margin, account value) + spot balances | | **NFT Holdings** | `stacks-nft-holdings` | Stacks | Free | All Stacks (SIP-009) NFTs held by an address: collections, artwork, counts, and BNS name | | **Address Activity** | `-address-activity` | Stacks · EVM · Solana · TON · Sui | Free | Recent transaction history with direction, asset, amount, and counterparty (decoded transfers, contract calls, deployments) | | **DEX Trade History** | `-dex-trade-history` | Stacks · EVM · Solana | 💰 500 sats | A wallet's recent swaps (DEX-agnostic): token sold/bought, amounts, USD/gas, DEX source, tx hash | | **Wallet P\&L** | `stacks-wallet-pnl` | Stacks | Free | Realized profit-and-loss distribution: per-token & aggregate winners vs losers across a wallet's trading history | ### DeFi & Markets | Capability | Slug pattern | Chains | Price | Description | | --------------------- | -------------------------- | ----------------------------------- | ----- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Market Overview** | `-market-overview` | Stacks · EVM · Solana · Hyperliquid | Free | Chain DeFi dashboard: total TVL + change, DEX volume, top protocols, top gainers/losers, trending pools, global context. Hyperliquid instead returns a market-wide **perps** overview (every perp ranked by open interest, volume, funding, or 24h change) | | **Zest Position** | `stacks-zest-position` | Stacks | Free | Zest lending position: supplied/borrowed assets, accrued interest, APYs, USD values, health factor | | **Zest Markets** | `stacks-zest-markets` | Stacks | Free | Zest lending market overview: supply/borrow APY, TVL, utilization, LTV & liquidation threshold per asset | | **DeFi LP Positions** | `stacks-defi-lp-positions` | Stacks | Free | Velar + Bitflow LP positions: pool pair, underlying token amounts, USD value, and pool share | | **DeFi Pools** | `stacks-defi-pools` | Stacks | Free | Liquidity pools across DEXes: filter by token, sort by TVL/volume/APY, compare reserves and yield | | **Whale Watch** | `stacks-whale-watch` | Stacks | Free | Large trades on Stacks DEXes: big buys/sells, net flows, whale sentiment by timeframe | | **Trader Stats** | `stacks-trader-stats` | Stacks | Free | Market-wide trading statistics over a timeframe: active traders, trade counts, volume, activity metrics | ### Derivatives & Perps Perpetual-DEX-native data with no analogue on other chains. **Hyperliquid** is the on-chain perps + spot DEX L1 (native token HYPE). | Capability | Slug pattern | Chains | Price | Description | | ----------------- | ----------------------- | ----------- | ----- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Funding Rates** | `hyperliquid-funding` | Hyperliquid | Free | Perp funding rates: all coins ranked by funding magnitude, or one coin's current rate + **predicted next funding across venues** (Hyperliquid vs Binance vs Bybit) + \~24h history. Positive funding = longs pay shorts | | **Order Book** | `hyperliquid-orderbook` | Hyperliquid | Free | Live L2 order book for a coin: best bid/ask, mid, spread (absolute + bps), resting liquidity within 1% of mid per side, and the top price levels (price, size, order count, notional) | ### Contract Inspection | Capability | Slug pattern | Chains | Price | Description | | -------------------- | -------------------------- | ------------ | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Contract Scanner** | `-contract-scanner` | Stacks · EVM | 💰 500 sats | AI security audit of verified source (proxy-aware): access control, asset flows, upgradeability, reentrancy/rug patterns, risk ratings | | **Contract Reader** | `-contract-reader` | Stacks · EVM | Free | Smart-contract explorer: read/write functions, variables, token definitions, events, and inline read-only/view calls. EVM is proxy-aware (follows a proxy to its implementation ABI) | | **Contract Diff** | `stacks-contract-diff` | Stacks | Free | Compare TWO Stacks contracts: functions added/removed/signature-changed, maps, data-vars, FT/NFT defs, newly-added admin/sensitive fns highlighted. Optional line-level source diff | | **Program Read** | `solana-program-read` | Solana | Free | Read a Solana account/program state (getAccountInfo): owner, executable, balance, decoded SPL/system/stake | | **Calldata Encoder** | `-encode-calldata` | EVM · Stacks | Free | Build ready-to-sign call data from plain args (inverse of the tx decoder): EVM returns the 0x… calldata via viem (proxy-aware ABI fetch); Stacks returns serialized Clarity-value args + a contract-call spec. Read-only — never signs or broadcasts; pair with simulation before signing | ### Transactions & Network | Capability | Slug pattern | Chains | Price | Description | | --------------------------- | --------------------------- | --------------------------------- | ----- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Transaction Decoder** | `-tx-decoder` | Stacks · EVM · Solana · TON · Sui | Free | Decode any tx: status, function/instruction summary, token + native balance changes, events, gas/fee, error diagnosis | | **Transaction Simulation** | `-tx-simulate` | Stacks · EVM · Solana | Free | Pre-flight / dry-run a proposed transfer / swap / contract or program call WITHOUT broadcasting: success-or-revert + reason, asset changes, real fee/gas/compute, and a honeypot/sellability check (guide) | | **Stacks Network** | `stacks-network` | Stacks | Free | Block height, PoX stacking cycle, mempool stats, and server version in one view | | **Mempool Inspector** | `-mempool-inspector` | Stacks · Bitcoin · EVM | Free | Mempool congestion snapshot with no args (pending count, fee/gas percentiles), per-address pending txs, or a per-tx "stuck" diagnosis (fee vs current rates, nonce gaps / CPFP) (guide) | | **Stacking Info** | `stacks-stacking-info` | Stacks | Free | PoX cycle details + per-address stacking: locked STX, unlock cycle, solo/pool, liquid stSTX/liSTX | | **Bitcoin Fees** | `bitcoin-fees` | Bitcoin | Free | Mempool fee rates with cost estimates for typical tx sizes and congestion assessment | | **Bitcoin Network Stats** | `bitcoin-network-stats` | Bitcoin | Free | Block height, difficulty & next retarget, hashrate, mempool backlog and unconfirmed tx count | | **Bitcoin Mining Stats** | `bitcoin-mining-stats` | Bitcoin | Free | Mining-pool distribution & hashrate over a window: total blocks, avg hashrate, difficulty, top 10 pools | | **Bitcoin Lightning Stats** | `bitcoin-lightning-stats` | Bitcoin | Free | Lightning Network overview: total capacity, channels, nodes, avg channel size, growth | | **Stacks SIP Updates** | `stacks-sip` | Stacks | Free | Recent Stacks Improvement Proposal governance updates: title, status, link, published date | ### Identity & Addresses | Capability | Slug pattern | Chains | Price | Description | | -------------------- | ------------------------- | ------- | ----- | --------------------------------------------------------------------------------------------------------------------- | | **BNS Resolver** | `stacks-bns-resolver` | Stacks | Free | Resolve a Stacks address to its BNS identity: primary name, all names, namespace, zonefile profile | | **BNS Bulk Resolve** | `stacks-bns-bulk-resolve` | Stacks | Free | Resolve up to 25 addresses to their primary BNS names at once → `{ address: name }` map for leaderboards/holder lists | | **Bitcoin Address** | `bitcoin-address` | Bitcoin | Free | BTC balance, tx count, Ordinals, BRC-20, Runes, Sats Names. Legacy / SegWit / Taproot | ### Bitcoin Meta-Protocol | Capability | Slug pattern | Chains | Price | Description | | ----------------------- | ----------------------------- | ------- | ----------- | ------------------------------------------------------------------------------------------------------------ | | **Inscription Info** | `bitcoin-inscription-info` | Bitcoin | 💰 500 sats | Single Ordinals inscription by id: number, content type/size, sat + rarity, genesis block, owner, collection | | **Ordinals Collection** | `bitcoin-ordinals-collection` | Bitcoin | 💰 500 sats | Ordinals collection by Best-In-Slot slug: metadata + headline supply/market stats | | **Runes Info** | `bitcoin-runes-info` | Bitcoin | 💰 500 sats | Runes token by name: id, symbol, divisibility, supply, mint terms/progress, and top holders | | **BRC-20 Info** | `bitcoin-brc20-info` | Bitcoin | 💰 500 sats | BRC-20 token by ticker: max/minted supply, deployer, deploy time, holder count, and top holders | ### News & Digest | Capability | Slug pattern | Chains | Price | Description | | ----------------------- | --------------- | ------- | ----- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Bitcoin News** | `bitcoin-news` | Bitcoin | Free | Latest Bitcoin headlines combining market coverage and protocol-development sources | | **Stacks News** | `stacks-news` | Stacks | Free | Latest Stacks headlines combining market, development, and SIP governance updates | | **EVM News** | `evm-news` | EVM | Free | Latest Ethereum / EVM ecosystem headlines (Ethereum Foundation, Cointelegraph, The Block) | | **Solana News** | `solana-news` | Solana | Free | Latest Solana ecosystem headlines (Solana News, Cointelegraph, The Block) | | **TON News** | `ton-news` | TON | Free | Latest TON (The Open Network) ecosystem headlines (Cointelegraph TON, The Block, Decrypt) | | **Sui News** | `sui-news` | Sui | Free | Latest Sui (Mysten Labs Move-based L1) ecosystem headlines (Cointelegraph Sui, The Block, Decrypt) | | **Stacks Daily Digest** | `stacks-digest` | Stacks | Free | Daily ecosystem digest: dev updates, DeFi activity, community highlights. Generated at 9 AM UTC. Call with **no arguments** for today's digest; set `mode` to `date` (with `date`) for a past day or `history` (with `limit`) for a list | ### Trading | Capability | Slug | Chains | Price | Description | | ---------------------- | -------------------- | ------ | ------- | ----------------------------------------------------------------------------------------------------------------------------------- | | **Stealth Buy** `BETA` | `stacks-stealth-buy` | Stacks | 💰 x402 | Buy a token without it being tied to your main wallet in charts/feeds — fresh temp wallet + split orders (not anonymous; see guide) | {% hint style="warning" %} **Stealth Buy is in beta** and moves real funds through temporary wallets. Start with small amounts. See the full guide before using it: {% endhint %} *** ### Community & Ecosystem Nova is **both a blockchain assistant and a community assistant.** Alongside the chain tools above, the platform exposes community-ecosystem tools that surface off-chain data. These are **not tied to a chain**, so their slug is `-` instead of `-`. **ZADAO** is the first ecosystem. | Capability | Slug | Ecosystem | Price | Description | | --------------- | ---------------- | --------- | ----- | --------------------------------------------------------------------------------------------------- | | **Bounties** | `zadao-bounties` | ZADAO | Free | Search open bounties: filter by query, status, category, or organization. Returns id, title, reward | | **Gigs** | `zadao-gigs` | ZADAO | Free | Search service gigs offered on the platform: filter by query, status, or service type | | **Grants** | `zadao-grants` | ZADAO | Free | Search available grants: filter by query, category, or status | | **Quests** | `zadao-quests` | ZADAO | Free | Search community quests: filter by query and status, sorted by recency | | **Docs Search** | `zadao-docs` | ZADAO | Free | Natural-language search over the ZADAO documentation; returns the most relevant snippets | *** ### For Humans 1. Go to [Nova Tools](https://nova.zeroauthoritydao.com/tools) 2. Select a tool and fill in the input form 3. **Premium users**: Click "Run Tool" — results appear immediately 4. **Non-premium users**: Click "Run Tool" — select a payment method (STX, sBTC, or USDCx), approve in your wallet, and results appear after payment {% hint style="success" %} Payment uses the x402 protocol with a two-phase flow. If tool execution fails after payment verification, your wallet is **never charged**. {% endhint %} *** ### For AI Agents Nova tools are accessible to AI agents via: 1. **MCP Server** — `npx @nova/mcp-server` or connect to `https://nova.zeroauthoritydao.com/mcp` 2. **REST API** — `POST /api/tools/:slug/run` with x402 inline payment 3. **Discovery** — `GET /.well-known/agent.json` (agent manifest), `GET /api/tools/openapi.json` (OpenAPI spec), and `GET /llms.txt` (llms.txt index) for machine-readable tool catalogs Every tool is auto-discovered by MCP clients with full input schemas and pricing. See the dedicated guides: *** ### Trending & Usage Stats See which tools the community uses most, with week/month/all-time trends and a REST-vs-MCP breakdown. *** ### Pricing | Access Level | Paid Tools | Free Tools | | -------------------------------- | -------------------- | ------------------ | | **Nova Premium** | Free, unlimited | Free, unlimited | | **Dashboard user** (non-premium) | x402 payment per use | Free, rate-limited | | **AI agent** (Stacks address) | x402 payment per use | Free, rate-limited | **Rate limits for free tools:** 5 calls/min, 30 calls/hour per IP. **Accepted payment tokens**: STX, sBTC, USDCx — all on Stacks mainnet. {% hint style="info" %} Get [Nova Premium](https://nova.zeroauthoritydao.com/premium) for unlimited access to all current and future tools. {% endhint %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.zeroauthority.xyz/nova-bot/tools.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.