{"openapi":"3.1.0","info":{"title":"Nova Tools API","version":"1.0.0","description":"AI-powered blockchain analytics tools — Bitcoin, Stacks, Ordinals, 60+ EVM networks, and Solana — plus community-ecosystem tools (e.g. ZADAO). Paid tools settle via the x402 payment protocol on Stacks mainnet. Generated from the Nova tool manifest — do not hand-edit."},"servers":[{"url":"https://nova.zeroauthoritydao.com"}],"tags":[{"name":"analytics"},{"name":"bitcoin"},{"name":"developer"},{"name":"ecosystem"},{"name":"network"},{"name":"security"},{"name":"trading"}],"paths":{"/api/tools/aptos-address-activity/run":{"post":{"operationId":"run_aptos_address_activity","summary":"Aptos Address Activity","description":"Recent transaction history for an Aptos address. Returns the newest transactions affecting the address (one row per transaction) with version, timestamp, status, entry function, the address's net APT change, and the other assets that moved. Use the Aptos Transaction Decoder on a tx hash for the full event breakdown, or Aptos Wallet Lookup for a current holdings snapshot. Capped to the most recent transactions (not exhaustive). Read-only, keyless (Aptos Indexer; APTOS_API_KEY raises the rate limit).","tags":["analytics"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"address":{"description":"Aptos Address","type":"string","examples":["0x… (up to 64 hex)"]},"limit":{"description":"Number of Transactions","type":"number","examples":["20"]}},"required":["address"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/aptos-news/run":{"post":{"operationId":"run_aptos_news","summary":"Aptos News","description":"Latest Aptos (Move-based L1) ecosystem news headlines (Cointelegraph Aptos, The Block, Decrypt). Returns a list of articles with title, link, published date, summary, and source, newest first. Keyless RSS aggregation, read-only.","tags":["analytics"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"limit":{"description":"Number of Headlines","type":"number","examples":["12"]}},"required":[],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/aptos-token-price/run":{"post":{"operationId":"run_aptos_token_price","summary":"Aptos Token Price","description":"Live USD spot price for APT (Aptos, the Move-based L1) or any Aptos coin / Fungible Asset, by symbol (USDt, THL, CELL, …), fully-qualified Move coin type (0x…::module::TYPE, e.g. 0x1::aptos_coin::AptosCoin), or Fungible-Asset object address (0x…). Returns price plus FDV, market cap, 24h volume, and decimals. Keyless (GeckoTerminal), read-only. Low-liquidity Aptos coins can be manipulated — not financial advice.","tags":["analytics"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"token":{"description":"Token (APT, symbol, coin type, or FA address)","type":"string","examples":["APT / USDt or 0x1::aptos_coin::AptosCoin"]}},"required":["token"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/aptos-tx-decoder/run":{"post":{"operationId":"run_aptos_tx_decoder","summary":"Aptos Transaction Decoder","description":"Decode an Aptos transaction by hash and explain what it did — the cross-chain analogue of the Solana / Sui / EVM / TON Transaction Decoder. Uses the Aptos Fullnode REST API: returns overall status (success/failure), vm_status, the entry function called, sender, gas fee in APT, the coin/FA asset movements (deposit/withdraw amounts), and the emitted event types. Read-only, keyless.","tags":["developer"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"hash":{"description":"Transaction Hash","type":"string","examples":["0x… (64 hex)"]}},"required":["hash"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/aptos-wallet-lookup/run":{"post":{"operationId":"run_aptos_wallet_lookup","summary":"Aptos Wallet Lookup","description":"Aggregate Aptos wallet / portfolio overview for any Aptos address — the cross-chain analogue of Solana / Sui / EVM / TON Wallet Lookup. Returns native APT balance + USD value, an asset table (asset type, token standard, symbol, amount, USD price/value) covering BOTH the legacy coin standard and the newer Fungible Asset (FA) standard, token count, and total portfolio USD. Prices native APT + every asset with an Aptos DEX market in USD. Accepts 0x… (up to 64 hex) addresses. Keyless (Aptos Indexer + GeckoTerminal; APTOS_API_KEY raises the Indexer rate limit), read-only. Assets without a market are excluded from the USD total; NFTs / Digital Assets are not enumerated. Not financial advice.","tags":["analytics"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"address":{"description":"Aptos Address","type":"string","examples":["0x… (up to 64 hex)"]}},"required":["address"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/bitcoin-address/run":{"post":{"operationId":"run_bitcoin_address","summary":"Bitcoin Address","description":"Look up any Bitcoin address — BTC balance, transaction count, Ordinals inscriptions held, BRC-20 token balances, Runes balances, and Sats Names owned. Supports legacy, SegWit, and Taproot addresses.","tags":["bitcoin"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"address":{"description":"Bitcoin Address","type":"string","examples":["1..., 3..., or bc1... Bitcoin address"]}},"required":["address"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/bitcoin-brc20-info/run":{"post":{"operationId":"run_bitcoin_brc20_info","summary":"Bitcoin BRC-20 Info","description":"Look up a BRC-20 token on Bitcoin by ticker (e.g. ordi, sats) — returns deploy info (max and minted supply, deployer, deploy timestamp, holder count) plus the top holders with balances and percentage of supply. For the BRC-20 Ordinals-based fungible-token standard on Bitcoin L1. Bitcoin only — not for EVM, Solana, or Stacks tokens. Read-only, powered by Best-In-Slot.","tags":["analytics"],"x-price-sats":500,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"ticker":{"description":"BRC-20 Ticker","type":"string","examples":["ordi"]}},"required":["ticker"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"402":{"description":"Payment required (x402). Retry with a `payment-signature` header. Price: 500 sats.","headers":{"payment-required":{"schema":{"type":"string"},"description":"base64 x402 PaymentRequiredV2"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Unknown tool slug."}}}},"/api/tools/bitcoin-fees/run":{"post":{"operationId":"run_bitcoin_fees","summary":"Bitcoin Fee Estimator","description":"Current Bitcoin mempool fee rates with cost estimates for typical transaction sizes and real-time congestion assessment.","tags":["bitcoin"],"x-price-sats":0,"x-aliases":["btc-fees"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{},"required":[],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/bitcoin-inscription-info/run":{"post":{"operationId":"run_bitcoin_inscription_info","summary":"Bitcoin Inscription Info","description":"Look up a single Bitcoin Ordinals inscription by its full inscription id — returns the inscription number, content type and size, the sat it is inscribed on (with sat rarity), genesis block and timestamp, current owner, and collection slug (if any). For Ordinals / digital artifacts / inscriptions / NFTs on Bitcoin L1. Bitcoin only — not for Stacks, EVM, or Solana NFTs (use stacks-nft-holdings / evm-wallet-lookup / solana-wallet-lookup for those). Read-only, powered by Best-In-Slot.","tags":["analytics"],"x-price-sats":500,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"inscription_id":{"description":"Inscription ID","type":"string","examples":["6fb976ab49dcec017f1e201e84395983204ae1a7c2abf7ced0a85d692e442799i0"]}},"required":["inscription_id"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"402":{"description":"Payment required (x402). Retry with a `payment-signature` header. Price: 500 sats.","headers":{"payment-required":{"schema":{"type":"string"},"description":"base64 x402 PaymentRequiredV2"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Unknown tool slug."}}}},"/api/tools/bitcoin-lightning-stats/run":{"post":{"operationId":"run_bitcoin_lightning_stats","summary":"Bitcoin Lightning Stats","description":"Bitcoin Lightning Network overview: total public capacity (BTC), number of channels, number of nodes, average channel size, and recent growth. Keyless data from mempool.space and lightningnetwork.plus, read-only. Use for a snapshot of Lightning Layer-2 adoption and liquidity.","tags":["network"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{},"required":[],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/bitcoin-mempool-inspector/run":{"post":{"operationId":"run_bitcoin_mempool_inspector","summary":"Bitcoin Mempool Inspector","description":"Inspect the Bitcoin mempool. With no inputs: a live congestion snapshot — pending tx count, total vMB backlog, projected blocks to clear, congestion level, the current recommended fee rates in sat/vB (next-block / 30-min / 1-hour / economy), and the fee histogram. By address: list the address's pending (unconfirmed) txs with fee, vsize, and sat/vB rate. By tx id: the transaction's fee and sat/vB rate plus a \"stuck\" diagnosis — its effective rate (including any CPFP child) compared against current recommended tiers, and whether RBF is signaled. Powered by mempool.space.","tags":["network"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"address":{"description":"Bitcoin Address (optional)","type":"string","examples":["bc1... / 1... / 3..."]},"tx_id":{"description":"Transaction ID (optional)","type":"string","examples":["64-hex txid (no 0x prefix)"]}},"required":[],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/bitcoin-mining-stats/run":{"post":{"operationId":"run_bitcoin_mining_stats","summary":"Bitcoin Mining Stats","description":"Bitcoin mining-pool distribution and hashrate over a chosen window: total blocks mined, average network hashrate, current difficulty, and the top 10 mining pools with their block counts and share percentage. Keyless mempool.space data, read-only. Use to gauge mining centralization and hashrate trends.","tags":["network"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"timeframe":{"description":"Timeframe","type":"string","enum":["24h","3d","1w","1m","3m","1y"],"examples":["1w"]}},"required":[],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/bitcoin-network-stats/run":{"post":{"operationId":"run_bitcoin_network_stats","summary":"Bitcoin Network Stats","description":"Live Bitcoin base-layer network health: latest block height, current difficulty and the next retarget estimate, total/estimated hashrate, mempool backlog size, and unconfirmed transaction count. Keyless mempool.space data, read-only. Use for a quick pulse on chain congestion and security — not for fee rates (see bitcoin-fees) or mining-pool breakdown (see bitcoin-mining-stats).","tags":["network"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{},"required":[],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/bitcoin-news/run":{"post":{"operationId":"run_bitcoin_news","summary":"Bitcoin News","description":"Latest Bitcoin ecosystem news headlines aggregated from both market and protocol-development sources. Returns a list of articles with title, link, published date, summary, and source, newest first. Keyless RSS aggregation, read-only.","tags":["analytics"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"limit":{"description":"Number of Headlines","type":"number","examples":["5"]}},"required":[],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/bitcoin-ordinals-collection/run":{"post":{"operationId":"run_bitcoin_ordinals_collection","summary":"Bitcoin Ordinals Collection","description":"Look up a Bitcoin Ordinals collection by its Best-In-Slot slug — returns collection metadata and headline supply/market stats (name, total supply, inscription ranges, and summary figures). For exploring Ordinals NFT collections on Bitcoin L1 (e.g. bitcoin-frogs, nodemonkes, runestone). Bitcoin only — not for Stacks, EVM, or Solana NFT collections. Read-only, powered by Best-In-Slot.","tags":["analytics"],"x-price-sats":500,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"collection_slug":{"description":"Collection Slug","type":"string","examples":["bitcoin-frogs"]}},"required":["collection_slug"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"402":{"description":"Payment required (x402). Retry with a `payment-signature` header. Price: 500 sats.","headers":{"payment-required":{"schema":{"type":"string"},"description":"base64 x402 PaymentRequiredV2"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Unknown tool slug."}}}},"/api/tools/bitcoin-runes-info/run":{"post":{"operationId":"run_bitcoin_runes_info","summary":"Bitcoin Runes Info","description":"Look up a Bitcoin Runes token by rune name (e.g. DOG•GO•TO•THE•MOON / DOGGOTOTHEMOON / UNCOMMON•GOODS) — returns the rune's id, symbol, divisibility, supply, mint terms and progress, plus the top holders with balances and percentage of supply. For the Runes fungible-token protocol on Bitcoin L1. Bitcoin only — not for EVM, Solana, or Stacks tokens (use evm-token-price / solana-token-price / stacks-token-price for those). Read-only, powered by Best-In-Slot.","tags":["analytics"],"x-price-sats":500,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"rune_name":{"description":"Rune Name","type":"string","examples":["DOGGOTOTHEMOON or UNCOMMON•GOODS"]}},"required":["rune_name"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"402":{"description":"Payment required (x402). Retry with a `payment-signature` header. Price: 500 sats.","headers":{"payment-required":{"schema":{"type":"string"},"description":"base64 x402 PaymentRequiredV2"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Unknown tool slug."}}}},"/api/tools/bitcoin-token-price/run":{"post":{"operationId":"run_bitcoin_token_price","summary":"Bitcoin Price","description":"Live Bitcoin (BTC) USD spot price plus sats valuation. Returns price, 24h change, market cap, 24h volume, and derived USD-per-sat / sats-per-USD. Keyless (CoinGecko), takes no inputs. This is the native BTC price — for Ordinals / Runes / BRC-20 asset prices use the dedicated Bitcoin asset tools. Not financial advice.","tags":["analytics"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{},"required":[],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/emblem-collections/run":{"post":{"operationId":"run_emblem_collections","summary":"Emblem Collections","description":"Browse or search the curated Emblem Vault collections — the official catalog of what Emblem can wrap into tradable Ethereum NFTs (Bitcoin Ordinals, BRC-20s, Bitcoin Stamps, rare sats, Counterparty/XCP assets, Dogecoin, BEL, and other L1/L2 assets). Returns a normalized list — for each collection: name, the native asset(s) it wraps, the chain, whether it is currently mintable, the mint/unvault price (in COVAL, not USD), the Ethereum contract, a short description, and an image. Supports filtering by a name/asset substring and a mintable-only flag. Read-only, keyless, non-custodial. Nova is an ecosystem assistant as well as a blockchain assistant; this surfaces the Emblem collection catalog to external agents.","tags":["ecosystem"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"query":{"description":"Search (name or asset)","type":"string","examples":["ordinals, doge, BRC-20…"]},"mintable_only":{"description":"Mintable only","type":"boolean"},"limit":{"description":"Max results","type":"number","examples":["40"]}},"required":[],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/emblem-vault-create-guide/run":{"post":{"operationId":"run_emblem_vault_create_guide","summary":"Emblem Vault Create Guide","description":"Get the official, non-custodial guide to creating/minting an Emblem Vault — wrapping a Bitcoin Ordinal, BRC-20, Bitcoin Stamp, rare sat, Counterparty/XCP asset, Dogecoin, or other L1/L2 asset into a tradable Ethereum NFT. Returns a plain explanation of what a vault is, the custody model, the official create URL, a step-by-step outline (connect your own wallet, pick the asset, fund the vault's deposit address, approve and pay gas/fees, mint and sign in your own wallet, claim to redeem), the supported asset types, and the safety caveats. The creator mints and signs in their OWN wallet; Emblem/Nova never hold the keys. Optionally tailor the guidance to a specific asset.","tags":["ecosystem"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"asset":{"description":"Asset to vault (optional)","type":"string","examples":["a Bitcoin Ordinal, a BRC-20 token, rare sats…"]}},"required":[],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/emblem-vault-lookup/run":{"post":{"operationId":"run_emblem_vault_lookup","summary":"Emblem Vault Lookup","description":"Look up an Emblem Vault and report what assets are wrapped inside it. Emblem Vaults wrap non-EVM assets (Bitcoin Ordinals, BRC-20, Bitcoin Stamps, rare sats, Counterparty/XCP, Dogecoin, BEL, and other L1/L2 coins/NFTs) into tradable ERC-721/1155 NFTs on Ethereum. Given a vault tokenId, a 0xcontract/tokenId pair, or a marketplace link, returns the vault name, image, wrapped contents (each coin's balance, USD price, USD value, and inner on-chain address), the total USD value, and whether the vault has been claimed. Read-only, keyless, non-custodial — it never exposes private keys. Nova is an ecosystem assistant as well as a blockchain assistant; this surfaces Emblem Vault data to external agents.","tags":["ecosystem"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"vault":{"description":"Vault tokenId or link","type":"string","examples":["30243073570574861 or 0xabc…/1234 or a marketplace link"]}},"required":["vault"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/emblem-wallet-vaults/run":{"post":{"operationId":"run_emblem_wallet_vaults","summary":"Emblem Wallet Vaults","description":"Find which curated Emblem Vaults an EVM wallet owns. Given an Ethereum (0x…) address, enumerates the wallet's NFTs and filters them to the curated Emblem contract set, returning the matched vaults — each with the collection name, contract, tokenId, and a marketplace link. Optionally also looks up what is inside the first few vaults (wrapped coin balances, USD value, and claim status), capped to avoid fan-out. Read-only, non-custodial — never exposes vault keys; Ethereum only. Nova is an ecosystem assistant as well as a blockchain assistant; this surfaces Emblem Vault ownership to external agents.","tags":["ecosystem"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"address":{"description":"EVM wallet address","type":"string","examples":["0x…"]},"include_contents":{"description":"Include vault contents","type":"boolean"},"contents_limit":{"description":"Max vaults to enrich","type":"number","examples":["3"]}},"required":["address"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/evm-address-activity/run":{"post":{"operationId":"run_evm_address_activity","summary":"EVM Address Activity","description":"Recent transfer activity / transaction history for an EVM address (Ethereum, Base, Arbitrum, Optimism, Polygon, BSC, Avalanche). Returns the newest native + ERC-20 / ERC-721 / ERC-1155 transfers in BOTH directions (in and out) with direction, hash, block, timestamp, category, asset, amount, token id, and counterparty. Capped to the most recent transfers (not exhaustive) — use the EVM Transaction Decoder on any hash for full detail, or EVM Wallet Lookup for a current holdings snapshot. Read-only, keyless.","tags":["analytics"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"address":{"description":"EVM Address","type":"string","examples":["0x… 40-hex EVM address"]},"chain":{"description":"Chain","type":"string","examples":["ethereum (default), base, arbitrum, optimism, polygon, bsc, avalanche"],"default":"ethereum"},"limit":{"description":"Number of Transfers","type":"number","examples":["20"]}},"required":["address"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/evm-contract-reader/run":{"post":{"operationId":"run_evm_contract_reader","summary":"EVM Contract Reader","description":"Read any verified EVM / Solidity smart contract (Ethereum, Base, Arbitrum, Optimism, Polygon, BSC, Avalanche) — the cross-chain analogue of the Stacks Contract Reader. Fetches the verified ABI (proxy-aware — follows a proxy to its implementation) and lists the contract's read functions (view/pure), write functions (state-changing), and events, each with a Solidity-style signature and typed inputs/outputs. Optionally executes one view/pure call live (e.g. totalSupply, balanceOf, name, owner) and returns the decoded result. Read-only — never sends a transaction. Not a security audit (use the EVM Contract Scanner for that).","tags":["developer"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"address":{"description":"Contract Address","type":"string","examples":["0x… 40-hex contract address"]},"chain":{"description":"Chain","type":"string","examples":["ethereum (default), base, arbitrum, optimism, polygon, bsc, avalanche"],"default":"ethereum"},"call_function":{"description":"View Function (optional)","type":"string","examples":["totalSupply"]},"call_args":{"description":"Function Arguments (optional, JSON array)","type":"string","examples":["[\"0xabc…\"]"]}},"required":["address"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/evm-contract-scanner/run":{"post":{"operationId":"run_evm_contract_scanner","summary":"EVM Contract Scanner","description":"Comprehensive AI-powered security audit for a verified EVM / Solidity smart contract (Ethereum, Base, Arbitrum, Optimism, Polygon, BSC, Avalanche). Fetches the verified source (and follows proxies to the implementation) from the block explorer, then analyzes access control, privileged roles, asset flows, upgradeability, and vulnerability patterns — reentrancy, unprotected mint/withdraw/upgrade, honeypot/rug patterns, oracle/flash-loan vectors — and returns a detailed report with severity ratings and recommendations. Requires the contract source to be verified on the explorer. Heuristic audit — not a guarantee of safety and not financial advice.","tags":["security"],"x-price-sats":500,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"contract":{"description":"Contract Address","type":"string","examples":["0x… verified contract address"]},"chain":{"description":"Chain","type":"string","examples":["ethereum (default), base, arbitrum, optimism, polygon, bsc, avalanche"],"default":"ethereum"}},"required":["contract"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"402":{"description":"Payment required (x402). Retry with a `payment-signature` header. Price: 500 sats.","headers":{"payment-required":{"schema":{"type":"string"},"description":"base64 x402 PaymentRequiredV2"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Unknown tool slug."}}}},"/api/tools/evm-dex-trade-history/run":{"post":{"operationId":"run_evm_dex_trade_history","summary":"EVM DEX Trade History","description":"Per-wallet DEX trade history for an EVM address (Ethereum, Base, Arbitrum, Optimism, Polygon, BSC, Avalanche). Returns recent swaps — each with the token sold and bought (symbol + amount), tx hash, timestamp, and USD/gas values. A trade is detected DEX-agnostically as any tx where the wallet both sent one token and received a different one (works across Uniswap / Sushi / 1inch / aggregators). Best for normal user wallets; scans the most recent ~100 txs (not exhaustive). Uses Covalent GoldRush. Read-only. Not financial advice.","tags":["analytics"],"x-price-sats":500,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"address":{"description":"Wallet Address","type":"string","examples":["0x… EVM wallet address"]},"chain":{"description":"Chain","type":"string","examples":["ethereum (default), base, arbitrum, optimism, polygon, bsc, avalanche"],"default":"ethereum"},"limit":{"description":"Number of Trades","type":"number","examples":["20"]}},"required":["address"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"402":{"description":"Payment required (x402). Retry with a `payment-signature` header. Price: 500 sats.","headers":{"payment-required":{"schema":{"type":"string"},"description":"base64 x402 PaymentRequiredV2"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Unknown tool slug."}}}},"/api/tools/evm-encode-calldata/run":{"post":{"operationId":"run_evm_encode_calldata","summary":"EVM Calldata Encoder","description":"Encode ready-to-sign EVM / Solidity calldata (the 0x… hex for a transaction's data field) for a contract function call across Ethereum, Base, Arbitrum, Optimism, Polygon, BSC, and Avalanche — the inverse of the EVM Transaction Decoder. Fetches the verified ABI from the explorer (proxy-aware — encodes against the implementation ABI while the call still targets the proxy), or accepts a caller-supplied ABI fragment for an unverified contract. Pass the contract address, function name, and arguments in ABI order; viem handles arg coercion (uint/int/address/bool/bytes/tuple/array) and overload resolution. Returns the call target, function signature, 4-byte selector, and the full calldata. Read-only — it only returns the bytes; it never signs or broadcasts a transaction. Pair with a simulator before signing.","tags":["developer"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"address":{"description":"Contract Address","type":"string","examples":["0x… 40-hex contract address"]},"chain":{"description":"Chain","type":"string","examples":["ethereum (default), base, arbitrum, optimism, polygon, bsc, avalanche"],"default":"ethereum"},"function_name":{"description":"Function Name","type":"string","examples":["transfer"]},"function_args":{"description":"Function Arguments (JSON array, ABI order)","type":"string","examples":["[\"0xRecipient…\", \"1000000\"]"]},"value":{"description":"Native Value in wei (optional)","type":"string","examples":["0"],"default":"0"},"abi_fragment":{"description":"ABI Fragment (optional JSON, for unverified contracts)","type":"string","examples":["[{\"name\":\"transfer\",\"type\":\"function\",\"inputs\":[…]}]"]}},"required":["address","function_name"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/evm-market-overview/run":{"post":{"operationId":"run_evm_market_overview","summary":"EVM Market Overview","description":"DeFi + market overview for an EVM chain (Ethereum, Base, Arbitrum, Optimism, Polygon, BSC, Avalanche). Returns total TVL with 7d/30d change, DEX 24h/7d volume, top protocols by TVL, global crypto context (total market cap, BTC/ETH dominance), and trending coins. One chain per call (default ethereum). Keyless (DefiLlama + CoinGecko), read-only. Not financial advice.","tags":["analytics"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"chain":{"description":"Chain","type":"string","examples":["ethereum (default), base, arbitrum, optimism, polygon, bsc, avalanche"],"default":"ethereum"}},"required":[],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/evm-mempool-inspector/run":{"post":{"operationId":"run_evm_mempool_inspector","summary":"EVM Mempool Inspector","description":"Inspect the EVM mempool / pending transactions on Ethereum, Base, Arbitrum, Optimism, Polygon, BSC, or Avalanche. With no address or tx id: a gas/fee snapshot — current and next-block base fee, priority-fee percentiles (p10/p50/p90), suggested low/medium/high all-in gas prices in gwei, and the pending block's tx count. By address: the count of pending txs plus a nonce-gap read (confirmed vs pending nonce); public RPCs do not expose the individual pending txs, so this is a count, not a listing. By tx id: whether the tx is still pending plus a \"stuck\" diagnosis — its max/effective gas price vs the current base fee and median priority, and a sender nonce-gap check.","tags":["network"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"chain":{"description":"Chain","type":"string","examples":["ethereum (default), base, arbitrum, optimism, polygon, bsc, avalanche"],"default":"ethereum"},"address":{"description":"EVM Address (optional)","type":"string","examples":["0x… 40-hex address"]},"tx_id":{"description":"Transaction Hash (optional)","type":"string","examples":["0x… 64-hex tx hash"]}},"required":[],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/evm-news/run":{"post":{"operationId":"run_evm_news","summary":"EVM News","description":"Latest Ethereum / EVM ecosystem news headlines (Ethereum Foundation blog, Cointelegraph Ethereum, The Block). Returns a list of articles with title, link, published date, summary, and source, newest first. Keyless RSS aggregation, read-only.","tags":["analytics"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"limit":{"description":"Number of Headlines","type":"number","examples":["12"]}},"required":[],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/evm-token-analytics/run":{"post":{"operationId":"run_evm_token_analytics","summary":"EVM Token Analytics","description":"AI-generated deep-dive report on an EVM / Ethereum token (Ethereum, Base, Arbitrum, Optimism, Polygon, BSC, Avalanche). Composes price & market data, holder distribution & concentration, a conservative risk/rug assessment, recent DEX trading activity, and ecosystem context into a professional markdown report. Accepts a 0x contract address or a symbol. Read-only analysis — not financial advice and not a guarantee.","tags":["analytics"],"x-price-sats":500,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"token":{"description":"Token (contract or symbol)","type":"string","examples":["0x… ERC-20 address or ETH / PEPE"]},"chain":{"description":"Chain","type":"string","examples":["ethereum (default), base, arbitrum, optimism, polygon, bsc, avalanche"],"default":"ethereum"}},"required":["token"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"402":{"description":"Payment required (x402). Retry with a `payment-signature` header. Price: 500 sats.","headers":{"payment-required":{"schema":{"type":"string"},"description":"base64 x402 PaymentRequiredV2"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Unknown tool slug."}}}},"/api/tools/evm-token-holders/run":{"post":{"operationId":"run_evm_token_holders","summary":"EVM Token Holders","description":"Holder distribution for an EVM ERC-20 token (Ethereum, Base, Arbitrum, Optimism, Polygon, BSC, Avalanche). Returns total supply, top-holder and top-10 concentration percentages, and a ranked list of top holders with balances and % of supply. Note: contract / DEX-pool / bridge addresses count as holders, so a high top-holder % may be a liquidity pool, not one owner. Uses Covalent GoldRush. Read-only. Not financial advice.","tags":["analytics"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"token":{"description":"Token Contract","type":"string","examples":["0x… ERC-20 contract address"]},"chain":{"description":"Chain","type":"string","examples":["ethereum (default), base, arbitrum, optimism, polygon, bsc, avalanche"],"default":"ethereum"},"limit":{"description":"Top Holders","type":"number","examples":["20"]}},"required":["token"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/evm-token-price/run":{"post":{"operationId":"run_evm_token_price","summary":"EVM Token Price","description":"Live USD spot price for any EVM / Ethereum token across 60+ chains (Ethereum, Base, Arbitrum, Optimism, Polygon, BSC, Avalanche, and more). Accepts an ERC-20 contract address (0x…, priced via DexScreener across its deepest-liquidity trading pair, optionally constrained to a chain) or a symbol / native-coin name like ETH, USDC, PEPE (priced via CoinGecko). Returns price, 24h change, liquidity, 24h volume, market cap, DEX, and pair link. Keyless, read-only. Low-liquidity DEX prices can be manipulated — not financial advice.","tags":["analytics"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"token":{"description":"Token (contract or symbol)","type":"string","examples":["0x… ERC-20 address or ETH / USDC / PEPE"]},"chain":{"description":"Chain (optional)","type":"string","examples":["ethereum, base, arbitrum, optimism, polygon, bsc, avalanche"]}},"required":["token"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/evm-token-risk-check/run":{"post":{"operationId":"run_evm_token_risk_check","summary":"EVM Token Risk Check","description":"Conservative rug-check / safety risk score (0–100, higher = riskier) for an EVM ERC-20 token (Ethereum, Base, Arbitrum, Optimism, Polygon, BSC, Avalanche, and more). Composed from the GoPlus Security API: honeypot / cannot-sell detection, owner-can-change-balance, hidden owner, reclaimable ownership, self-destruct, mintable supply, pausable transfers, blacklist, trading cooldown, buy/sell tax, source-verified status, proxy/upgradeable, holder count, and creator concentration. Returns a low/med/high level with plain-English flags. Conservative by design — a critical signal (honeypot, owner-change-balance, hidden owner, mintable, pausable, extreme tax) caps the verdict at high and it never asserts a token is \"safe\". Read-only, keyless. Not a guarantee and not financial advice.","tags":["security"],"x-price-sats":500,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"token":{"description":"Token Contract","type":"string","examples":["0x… ERC-20 contract address"]},"chain":{"description":"Chain","type":"string","examples":["ethereum (default), base, arbitrum, optimism, polygon, bsc, avalanche"],"default":"ethereum"}},"required":["token"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"402":{"description":"Payment required (x402). Retry with a `payment-signature` header. Price: 500 sats.","headers":{"payment-required":{"schema":{"type":"string"},"description":"base64 x402 PaymentRequiredV2"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Unknown tool slug."}}}},"/api/tools/evm-tx-decoder/run":{"post":{"operationId":"run_evm_tx_decoder","summary":"EVM Transaction Decoder","description":"Decode an EVM / Ethereum transaction (Ethereum, Base, Arbitrum, Optimism, Polygon, BSC, Avalanche) and explain what it did — the cross-chain analogue of the Stacks Transaction Decoder. Goes beyond the raw RPC: returns status (success/failed/pending), from, to, native value, the function called (resolved via 4byte signatures), the ERC-20 / ERC-721 / ERC-1155 token transfers that occurred (with symbol + amount where resolvable), gas used, and fee. Read-only, keyless.","tags":["developer"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"tx_hash":{"description":"Transaction Hash","type":"string","examples":["0x… 64-hex tx hash"]},"chain":{"description":"Chain","type":"string","examples":["ethereum (default), base, arbitrum, optimism, polygon, bsc, avalanche"],"default":"ethereum"}},"required":["tx_hash"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/evm-tx-simulate/run":{"post":{"operationId":"run_evm_tx_simulate","summary":"EVM Transaction Simulation","description":"Pre-flight / dry-run a PROPOSED EVM transaction (Ethereum, Base, Arbitrum, Optimism, Polygon, BSC, Avalanche) against live on-chain state WITHOUT broadcasting. Returns predicted success or revert (+ the decoded revert reason), the intended asset changes, and the gas cost — via eth_call + eth_estimateGas. Modes: action=transfer (native or ERC-20 — from, to, amount, optional token), action=contract_call (from, to=contract, data=calldata hex, optional value), action=sellability (HONEYPOT check — eth_call-executes a transfer of the holder's full balance and reports if the sell reverts or returns false: blacklist / pause / trading-disabled). Read-only: never signs, never broadcasts, never moves funds, and the from address need not be yours. Reflects current chain state — not a guarantee, and fee-on-transfer tax is not measured. Not financial advice.","tags":["developer"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"chain":{"description":"Chain","type":"string","examples":["ethereum (default), base, arbitrum, optimism, polygon, bsc, avalanche"],"default":"ethereum"},"action":{"description":"Action","type":"string","examples":["transfer | contract_call | sellability"]},"from":{"description":"From (0x)","type":"string","examples":["sender address"]},"to":{"description":"To (0x)","type":"string","examples":["recipient or contract address"]},"amount":{"description":"Amount","type":"number","examples":["native units, or token units if token set"]},"token":{"description":"ERC-20 Token (0x)","type":"string","examples":["for a token transfer or sellability check"]},"holder":{"description":"Holder (0x)","type":"string","examples":["owner of the token — for sellability"]},"data":{"description":"Calldata (0x)","type":"string","examples":["for action=contract_call"]},"value":{"description":"Native Value in wei (optional)","type":"string","examples":["0 — native value to attach to action=contract_call"]}},"required":[],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/evm-wallet-lookup/run":{"post":{"operationId":"run_evm_wallet_lookup","summary":"EVM Wallet Lookup","description":"Aggregate EVM wallet / portfolio overview for any Ethereum or EVM-L2 address — the cross-chain analogue of Stacks Wallet Lookup. Auto-discovers the address's ERC-20 holdings, values the native coin + every token in USD (DexScreener / CoinGecko), and enumerates NFTs by owner with collection counts. Returns native balance + value, a token table (symbol, amount, USD price/value, liquidity), token count, NFT collections, and total portfolio USD. Runs on ONE chain per call (default ethereum) — call once per chain to cover several. Read-only, keyless. Spam/airdrop dust with no liquidity is excluded from the USD total. Not financial advice.","tags":["analytics"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"address":{"description":"EVM Address","type":"string","examples":["0x… 40-hex EVM address"]},"chain":{"description":"Chain","type":"string","examples":["ethereum (default), base, arbitrum, optimism, polygon, bsc, avalanche"],"default":"ethereum"},"include_nfts":{"description":"Include NFTs","type":"string","enum":["true","false"],"examples":["true"],"default":"true"}},"required":["address"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/hyperliquid-funding/run":{"post":{"operationId":"run_hyperliquid_funding","summary":"Hyperliquid Funding Rates","description":"Perpetual funding rates on Hyperliquid (the on-chain perps + spot DEX L1, native token HYPE) — the signature perp-DEX signal with no analogue on any other chain. Omit the coin for an all-coins ranking by funding magnitude (hourly + annualized rate, premium, mark price per coin). Pass a coin (e.g. BTC, HYPE) for detail: current funding, predicted next funding across venues (Hyperliquid vs Binance vs Bybit — a cross-exchange funding-arb signal), and ~24h funding history. Positive funding = longs pay shorts. Keyless, read-only (Hyperliquid Info API). Not financial advice.","tags":["analytics"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"coin":{"description":"Coin (optional)","type":"string","examples":["BTC, ETH, HYPE — leave blank for all coins"]},"limit":{"description":"Max coins when listing all (1–100)","type":"number","examples":["30"]}},"required":[],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/hyperliquid-market-overview/run":{"post":{"operationId":"run_hyperliquid_market_overview","summary":"Hyperliquid Market Overview","description":"Market-wide perpetuals overview for Hyperliquid (the on-chain perps + spot DEX L1, native token HYPE) — every listed perp ranked in a single call. Returns total open interest and 24h volume across the venue plus, per market: mark / oracle / mid price, 24h change, hourly + annualized funding rate, premium, open interest (in coins and USD), 24h notional volume, and max leverage. Rank by open interest (default), volume, funding, or 24h change. This is perp-DEX derivatives data with no analogue on Stacks, Bitcoin, EVM, or Solana. Keyless, read-only (Hyperliquid Info API). Not financial advice.","tags":["analytics"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"sort":{"description":"Rank by","type":"string","enum":["oi","volume","funding","change"],"default":"oi"},"limit":{"description":"Max markets (1–100)","type":"number","examples":["30"]}},"required":[],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/hyperliquid-orderbook/run":{"post":{"operationId":"run_hyperliquid_orderbook","summary":"Hyperliquid Order Book","description":"Live L2 order book depth and bid/ask spread for a coin on Hyperliquid (the on-chain perps + spot DEX L1, native token HYPE) — central-limit-order-book microstructure that no other chain Nova supports exposes (Stacks, Bitcoin, EVM, and Solana are AMM/UTXO, not an order book). Returns best bid / best ask, mid price, absolute and basis-point spread, aggregated resting liquidity within 1% of mid on each side, and the top N price levels (price, size, order count, notional) for bids and asks. Keyless, read-only (Hyperliquid Info API). Snapshot only — depth changes continuously. Not financial advice.","tags":["analytics"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"coin":{"description":"Coin","type":"string","examples":["BTC, ETH, HYPE, SOL"]},"depth":{"description":"Levels per side (1–50)","type":"number","examples":["10"]}},"required":["coin"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/hyperliquid-token-ohlc/run":{"post":{"operationId":"run_hyperliquid_token_ohlc","summary":"Hyperliquid Token OHLC","description":"OHLCV candles for a coin on Hyperliquid (the on-chain perps + spot DEX L1, native token HYPE). Returns open / high / low / close + volume per candle over a chosen interval, plus a summary (first open, last close, period high/low, change %). Intervals: 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 8h, 12h, 1d, 3d, 1w, 1M (default 1h). Reflects the perp market when the coin is a listed perp, the canonical spot market otherwise. Keyless, read-only (Hyperliquid Info API). Not financial advice.","tags":["analytics"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"coin":{"description":"Coin","type":"string","examples":["BTC, ETH, HYPE, SOL"]},"interval":{"description":"Candle interval","type":"string","enum":["5m","15m","1h","4h","1d","1w"],"default":"1h"},"limit":{"description":"Number of candles (1–500)","type":"number","examples":["48"]}},"required":["coin"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/hyperliquid-token-price/run":{"post":{"operationId":"run_hyperliquid_token_price","summary":"Hyperliquid Token Price","description":"Live Hyperliquid market price for the HYPE token or any coin listed on Hyperliquid — the high-performance on-chain perpetuals + spot DEX L1. Resolves the perp market first (mark price, oracle price, mid price, hourly funding rate, open interest, 24h volume, max leverage) and falls back to the canonical spot token (price, 24h change, volume, circulating supply, market cap). Accepts a coin symbol like HYPE, BTC, ETH, SOL, or PURR. Keyless, read-only (Hyperliquid Info API). Hyperliquid only — not for EVM, Solana, Stacks, or native BTC prices. Not financial advice; perp mark price can diverge from spot/oracle.","tags":["analytics"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"token":{"description":"Coin / token symbol","type":"string","examples":["HYPE, BTC, ETH, SOL, PURR"]}},"required":["token"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/hyperliquid-wallet-lookup/run":{"post":{"operationId":"run_hyperliquid_wallet_lookup","summary":"Hyperliquid Wallet Lookup","description":"Aggregate Hyperliquid account overview for a 0x address — the cross-chain analogue of EVM / Solana / Stacks Wallet Lookup, for Hyperliquid (the on-chain perps + spot DEX L1, native token HYPE). On Hyperliquid a wallet is a trading account: returns the perp clearinghouse (account value, total notional position, margin used, withdrawable), open positions (coin, long/short side, size, entry price, position value, unrealized PnL, return on equity, leverage, liquidation price, margin used), and spot balances valued in USD via live mids (USDC 1:1). Keyless, read-only (Hyperliquid Info API). Hyperliquid uses EVM-style 0x addresses but balances live on the Hyperliquid L1, not Ethereum. Not financial advice; perp positions carry liquidation risk.","tags":["analytics"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"address":{"description":"Hyperliquid Address","type":"string","examples":["0x… 40-hex address"]}},"required":["address"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/solana-address-activity/run":{"post":{"operationId":"run_solana_address_activity","summary":"Solana Address Activity","description":"Recent transaction history for a Solana address. Returns the newest transaction signatures with signature, slot, block time, status, error, and memo. Use the Solana Transaction Decoder on a signature for the full decoded breakdown of any one tx, or Solana Wallet Lookup for a current holdings snapshot. Capped to the most recent signatures (not exhaustive). Read-only, keyless.","tags":["analytics"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"address":{"description":"Solana Address","type":"string","examples":["base58 Solana address"]},"limit":{"description":"Number of Signatures","type":"number","examples":["20"]}},"required":["address"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/solana-dex-trade-history/run":{"post":{"operationId":"run_solana_dex_trade_history","summary":"Solana DEX Trade History","description":"Per-wallet DEX trade history for a Solana address. Returns recent swaps — each with the token sold and bought (mint + amount), the DEX source (Jupiter / Raydium / Orca / Pump / …), signature, timestamp, and fee — using the Helius enhanced-transaction classifier (type=SWAP) over the wallet's ~100 most recent txs (not exhaustive). Token symbols are not always resolved by the parser. Uses Helius. Read-only. Not financial advice.","tags":["analytics"],"x-price-sats":500,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"address":{"description":"Wallet Address","type":"string","examples":["base58 Solana wallet address"]},"limit":{"description":"Number of Trades","type":"number","examples":["20"]}},"required":["address"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"402":{"description":"Payment required (x402). Retry with a `payment-signature` header. Price: 500 sats.","headers":{"payment-required":{"schema":{"type":"string"},"description":"base64 x402 PaymentRequiredV2"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Unknown tool slug."}}}},"/api/tools/solana-market-overview/run":{"post":{"operationId":"run_solana_market_overview","summary":"Solana Market Overview","description":"DeFi + market overview for Solana. Returns total TVL with 7d/30d change, DEX 24h/7d volume, top Solana protocols by TVL, global crypto context (total market cap, BTC dominance), and trending coins. Takes no inputs. Keyless (DefiLlama + CoinGecko), read-only. Not financial advice.","tags":["analytics"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{},"required":[],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/solana-news/run":{"post":{"operationId":"run_solana_news","summary":"Solana News","description":"Latest Solana ecosystem news headlines (Solana News, Cointelegraph Solana, The Block). Returns a list of articles with title, link, published date, summary, and source, newest first. Keyless RSS aggregation, read-only.","tags":["analytics"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"limit":{"description":"Number of Headlines","type":"number","examples":["12"]}},"required":[],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/solana-program-read/run":{"post":{"operationId":"run_solana_program_read","summary":"Solana Program Read","description":"Read a Solana account or program's on-chain state — the analogue of an EVM contract read. Uses RPC getAccountInfo (jsonParsed): returns whether the account exists, its owning program, whether it is executable (i.e. it IS a program), lamports / SOL balance, data size, and decoded state for known program accounts (SPL token mints/accounts, system, stake). Arbitrary accounts return owner + raw data info. Read-only, keyless.","tags":["developer"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"address":{"description":"Account / Program Address","type":"string","examples":["base58 account or program address"]}},"required":["address"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/solana-token-analytics/run":{"post":{"operationId":"run_solana_token_analytics","summary":"Solana Token Analytics","description":"AI-generated deep-dive report on a Solana SPL token. Composes price & market data, holder distribution & concentration, a conservative risk/rug assessment (GoPlus + RugCheck), recent DEX trading activity, and Solana ecosystem context into a professional markdown report. Accepts an SPL mint address or a symbol. Read-only analysis — not financial advice and not a guarantee.","tags":["analytics"],"x-price-sats":500,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"token":{"description":"Token (mint or symbol)","type":"string","examples":["base58 mint or SOL / BONK / JUP"]}},"required":["token"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"402":{"description":"Payment required (x402). Retry with a `payment-signature` header. Price: 500 sats.","headers":{"payment-required":{"schema":{"type":"string"},"description":"base64 x402 PaymentRequiredV2"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Unknown tool slug."}}}},"/api/tools/solana-token-holders/run":{"post":{"operationId":"run_solana_token_holders","summary":"Solana Token Holders","description":"Holder distribution for a Solana SPL token. Returns total supply, top-holder / top-10 / top-20 concentration percentages, and a ranked list of the top holder wallets with balances and % of supply. Note: the largest accounts often include DEX pools, CEX hot wallets, and the treasury, so a high top-holder % may not be one private owner; for very large tokens (millions of accounts) the breakdown can be temporarily unavailable. Uses Helius / Alchemy RPC. Read-only. Not financial advice.","tags":["analytics"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"token":{"description":"Token Mint","type":"string","examples":["base58 SPL mint address"]},"limit":{"description":"Top Holders","type":"number","examples":["20"]}},"required":["token"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/solana-token-price/run":{"post":{"operationId":"run_solana_token_price","summary":"Solana Token Price","description":"Live USD spot price for any Solana SPL token, by mint address or symbol (SOL, BONK, JUP, WIF, …). Returns price, 24h change, liquidity, 24h volume, market cap, FDV, holder count, and a verified flag. Keyless (Jupiter), read-only. Low-liquidity prices can be manipulated and a verified flag is not a safety guarantee — not financial advice.","tags":["analytics"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"token":{"description":"Token (mint or symbol)","type":"string","examples":["base58 mint or SOL / BONK / JUP"]}},"required":["token"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/solana-token-risk-check/run":{"post":{"operationId":"run_solana_token_risk_check","summary":"Solana Token Risk Check","description":"Conservative rug-check / safety risk score (0–100, higher = riskier) for a Solana SPL token, composed from TWO sources: GoPlus Solana (active mint authority, active freeze authority, balance-mutable authority, transfer hook, transfer fee, non-transferable, closable, mutable metadata, holder count) and RugCheck.xyz (aggregated risks + LP-locked %). Returns a low/med/high level with plain-English flags. Conservative by design — a critical signal (live mint/freeze authority, balance-mutable, transfer hook, non-transferable, RugCheck danger) caps the verdict at high and it never asserts a token is \"safe\". Read-only, keyless. Not a guarantee and not financial advice.","tags":["security"],"x-price-sats":500,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"token":{"description":"Token Mint","type":"string","examples":["base58 SPL mint address"]}},"required":["token"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"402":{"description":"Payment required (x402). Retry with a `payment-signature` header. Price: 500 sats.","headers":{"payment-required":{"schema":{"type":"string"},"description":"base64 x402 PaymentRequiredV2"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Unknown tool slug."}}}},"/api/tools/solana-tx-decoder/run":{"post":{"operationId":"run_solana_tx_decoder","summary":"Solana Transaction Decoder","description":"Decode a Solana transaction by signature and explain what it did — the cross-chain analogue of the Stacks Transaction Decoder. Uses Solana RPC jsonParsed decoding: returns status (success/failed) + error, fee, slot, block time, fee payer, the programs involved, a per-instruction summary (program + parsed type/info for known programs like System and SPL Token), the SPL token balance changes (mint, owner, delta), and SOL balance changes per account. Read-only, keyless.","tags":["developer"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"signature":{"description":"Transaction Signature","type":"string","examples":["base58 tx signature (~88 chars)"]}},"required":["signature"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/solana-tx-simulate/run":{"post":{"operationId":"run_solana_tx_simulate","summary":"Solana Transaction Simulation","description":"Pre-flight / dry-run a PROPOSED Solana transaction against live on-chain state WITHOUT broadcasting. Returns predicted success or revert (+ the program error), SOL/SPL asset changes (who gains/loses what), compute-unit cost, and program logs. Modes: action=transfer (native SOL or SPL token transfer — from, to, amount, optional token_mint), action=program_call (arbitrary instruction — program_id, accounts, instruction data), action=sellability (HONEYPOT check — simulate moving an SPL token out of a holder and report if it is frozen / non-transferable), or pass a fully-serialized transaction (transaction_base64) to simulate it as-is. Read-only: never signs, never broadcasts, never moves funds. Not a guarantee the real transaction will behave identically — reflects current chain state. Not financial advice.","tags":["developer"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"action":{"description":"Action","type":"string","examples":["transfer | program_call | sellability (omit if passing transaction_base64)"]},"from":{"description":"From / Holder (base58)","type":"string","examples":["sender / fee-payer / holder address"]},"to":{"description":"To (base58)","type":"string","examples":["recipient — for action=transfer"]},"amount":{"description":"Amount","type":"number","examples":["SOL, or token units if token_mint set"]},"token_mint":{"description":"SPL Token Mint (base58)","type":"string","examples":["for SPL transfer or sellability check"]},"transaction_base64":{"description":"Serialized Transaction (base64)","type":"string","examples":["a fully-built tx to simulate as-is (e.g. a Jupiter swap)"]},"program_id":{"description":"Program ID (base58)","type":"string","examples":["for action=program_call"]},"accounts":{"description":"Accounts (JSON array)","type":"string","examples":["[{\"pubkey\":\"…\",\"is_signer\":false,\"is_writable\":true}] — for action=program_call"]},"data_base64":{"description":"Instruction Data (base64)","type":"string","examples":["instruction data, base64 — for action=program_call"]},"data_hex":{"description":"Instruction Data (hex)","type":"string","examples":["instruction data, hex (alternative to data_base64)"]},"fee_payer":{"description":"Fee Payer (base58)","type":"string","examples":["optional — defaults to `from`"]}},"required":[],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/solana-wallet-lookup/run":{"post":{"operationId":"run_solana_wallet_lookup","summary":"Solana Wallet Lookup","description":"Aggregate Solana wallet / portfolio overview for any SOL address — the cross-chain analogue of Stacks Wallet Lookup. Auto-discovers SPL + Token-2022 token accounts, prices SOL + every token in USD via Jupiter, resolves symbols for the top holdings, and (when a Helius key is configured) enumerates NFTs by owner with collection counts. Returns native SOL balance + value, a token table (mint, symbol, amount, USD price/value), token count, NFT collections, and total portfolio USD. If NFT enumeration is unavailable (no Helius key) it is reported as unavailable rather than empty. Read-only. Unpriced tokens are excluded from the USD total. Not financial advice.","tags":["analytics"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"address":{"description":"Solana Address","type":"string","examples":["base58 Solana address"]},"include_nfts":{"description":"Include NFTs","type":"string","enum":["true","false"],"examples":["true"],"default":"true"}},"required":["address"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/stacks-address-activity/run":{"post":{"operationId":"run_stacks_address_activity","summary":"Address Activity","description":"View decoded transaction history for any Stacks address — transfers, contract calls, deployments, and stacking operations with human-readable descriptions, timestamps, and status indicators.","tags":["analytics"],"x-price-sats":0,"x-aliases":["address-activity"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"address":{"description":"Stacks Address","type":"string","examples":["SP... Stacks address"]},"limit":{"description":"Number of Transactions","type":"number","examples":["20"]}},"required":["address"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/stacks-bns-bulk-resolve/run":{"post":{"operationId":"run_stacks_bns_bulk_resolve","summary":"BNS Bulk Reverse Lookup","description":"Resolve many Stacks addresses to their primary .btc / BNS name in a single call (up to 25, resolved in parallel). Returns an { address: name|null } map — built for labelling leaderboards, token holder lists, member rosters, whale lists, and airdrop lists all at once. For a deep single-address identity profile (all names, namespaces, renewal, zonefile) use the BNS Resolver tool instead.","tags":["analytics"],"x-price-sats":0,"x-aliases":["bns-bulk-resolve"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"addresses":{"description":"Stacks Addresses","type":"string","examples":["SP2ZNGJ...,SP3FBR2...,SP1G... (comma or newline separated, max 25)"]}},"required":["addresses"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/stacks-bns-resolver/run":{"post":{"operationId":"run_stacks_bns_resolver","summary":"BNS Resolver","description":"Resolve any Stacks wallet address into its full on-chain BNS identity — primary name, all owned names, namespace details, renewal status, and zonefile profile data. A standard identity endpoint for apps and agents.","tags":["analytics"],"x-price-sats":0,"x-aliases":["bns-resolver"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"address":{"description":"Stacks Address","type":"string","examples":["SP2ZNGJ85ENDY6QRHQ5P2D4FXKGZWCKTB2T0Z55KS"]}},"required":["address"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/stacks-contract-diff/run":{"post":{"operationId":"run_stacks_contract_diff","summary":"Contract Diff","description":"Compare two deployed Stacks Clarity smart contracts and see exactly what changed between them. Fetches each contract's live ABI from Hiro and diffs the public/read-only functions (added, removed, or signature-changed — when arguments, outputs, or access level differ), plus maps, data-variables, and fungible / non-fungible token definitions. Newly-added admin or sensitive functions — mint authority, freeze/blacklist, transfer-pause, functions that can move other holders' balances, upgradeable/admin-transfer, drain/withdraw, fee/tax change, and mutable metadata — are highlighted separately. Set Include Source to \"true\" to also fetch both contracts' Clarity source and get a bounded line-level source diff (added/removed line counts plus a capped +/- preview) and publish heights. On-demand A-vs-B comparison only (not a version tracker — Clarity contracts are immutable and redeploys are not linked on-chain). Read-only. The name-based security highlights are heuristics, not a guarantee.","tags":["analytics"],"x-price-sats":0,"x-aliases":["contract-diff"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"contract_id_a":{"description":"Contract A","type":"string","examples":["SP2C2YFP12AJZB4MABJBAJ55XECVS7E4PMMZ89YZR.contract-name"]},"contract_id_b":{"description":"Contract B","type":"string","examples":["SP3D...address.contract-name"]},"include_source":{"description":"Include Source Diff","type":"string","enum":["false","true"],"examples":["false"],"default":"false"}},"required":["contract_id_a","contract_id_b"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/stacks-contract-reader/run":{"post":{"operationId":"run_stacks_contract_reader","summary":"Contract Reader","description":"Explore any Clarity smart contract — view public and read-only functions with typed signatures, variables, token definitions, and execute read-only calls.","tags":["developer"],"x-price-sats":0,"x-aliases":["contract-reader"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"contract_id":{"description":"Contract ID","type":"string","examples":["SP2ZNGJ85ENDY6QRHQ5P2D4FXKGZWCKTB2T0Z55KS.charisma-token"]},"call_function":{"description":"Read-Only Function (optional)","type":"string","examples":["get-balance"]},"call_args":{"description":"Function Arguments (optional, JSON array)","type":"string","examples":["[\"0x0516...\"]"]}},"required":["contract_id"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/stacks-contract-scanner/run":{"post":{"operationId":"run_stacks_contract_scanner","summary":"Smart Contract Scanner","description":"Comprehensive AI-powered security audit for Clarity smart contracts. Analyzes source code, access control, asset flows, and vulnerability patterns. Get a detailed report with function reference, risk ratings, and actionable recommendations.","tags":["security"],"x-price-sats":500,"x-aliases":["contract-scanner"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"contract":{"description":"Contract ID","type":"string","examples":["SP2ZNGJ85ENDY6QRHQ5P2D4FXKGZWCKTB2T0Z55KS.charisma-token"]}},"required":["contract"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"402":{"description":"Payment required (x402). Retry with a `payment-signature` header. Price: 500 sats.","headers":{"payment-required":{"schema":{"type":"string"},"description":"base64 x402 PaymentRequiredV2"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Unknown tool slug."}}}},"/api/tools/stacks-defi-lp-positions/run":{"post":{"operationId":"run_stacks_defi_lp_positions","summary":"DeFi LP Positions","description":"View a Stacks address's liquidity-provider positions across Velar and Bitflow — pool pair, underlying token amounts, USD value, and pool share. Optionally filter to a single platform.","tags":["analytics"],"x-price-sats":0,"x-aliases":["defi-lp-positions"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"address":{"description":"Stacks Address","type":"string","examples":["SP2ZNGJ85ENDY6QRHQ5P2D4FXKGZWCKTB2T0Z55KS"]},"platform":{"description":"Platform (optional)","type":"string","examples":["velar, bitflow, or leave empty for all"]}},"required":["address"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/stacks-defi-pools/run":{"post":{"operationId":"run_stacks_defi_pools","summary":"DeFi Pools","description":"Explore DeFi liquidity pools across Stacks DEXes — filter by token, sort by TVL/volume/APY, and compare pool metrics including reserves, fees, and yield across Velar, Alex, and other platforms.","tags":["analytics"],"x-price-sats":0,"x-aliases":["defi-pools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"token":{"description":"Token Filter","type":"string","examples":["STX, sBTC, or contract address (optional)"]},"sort_by":{"description":"Sort By","type":"string","enum":["tvl","volume","apy"],"examples":["tvl"]}},"required":[],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/stacks-dex-trade-history/run":{"post":{"operationId":"run_stacks_dex_trade_history","summary":"DEX Trade History","description":"Paginated DEX trade history for any wallet across Velar, ALEX, and Bitflow (Stacks) plus the other supported chains. Each trade includes its type (buy/sell/swap/add/remove), token, token amount, USD value, price, and timestamp, with a cursor to fetch the next page. The raw trade-by-trade feed behind wallet P&L.","tags":["analytics"],"x-price-sats":500,"x-aliases":["dex-trade-history"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"address":{"description":"Wallet Address","type":"string","examples":["SP2ZNGJ85ENDY6QRHQ5P2D4FXKGZWCKTB2T0Z55KS"]},"chain":{"description":"Chain (optional)","type":"string","examples":["stacks"]},"event_type":{"description":"Trade Type (optional)","type":"string","examples":["buy, sell, swap, add, remove"]},"limit":{"description":"Limit (1-100, optional)","type":"number","examples":["50"]},"cursor":{"description":"Pagination Cursor (optional)","type":"string","examples":["next_cursor from a previous call"]}},"required":["address"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"402":{"description":"Payment required (x402). Retry with a `payment-signature` header. Price: 500 sats.","headers":{"payment-required":{"schema":{"type":"string"},"description":"base64 x402 PaymentRequiredV2"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Unknown tool slug."}}}},"/api/tools/stacks-digest/run":{"post":{"operationId":"run_stacks_digest","summary":"Stacks Daily Digest","description":"Get the daily Stacks ecosystem digest — a curated summary of development updates, DeFi activity, community highlights, and key metrics, generated automatically every day at 9:00 UTC from aggregated news, tweets, and web sources. Call with NO arguments to get today's digest (the latest one) — that is the default and the common case. Set 'mode' only to change that: 'date' returns the digest for a specific past day (also provide 'date' as YYYY-MM-DD), and 'history' returns a list of recent digests (optionally set 'limit', 1-14). Free, read-only, no authentication.","tags":["analytics"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"mode":{"description":"What to fetch","type":"string","enum":["latest","date","history"],"default":"latest"},"date":{"description":"Date — only for \"Specific date\"","type":"string","examples":["2026-03-18"]},"limit":{"description":"History Limit — only for \"Recent digests\"","type":"number","examples":["7"]}},"required":[],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/stacks-encode-calldata/run":{"post":{"operationId":"run_stacks_encode_calldata","summary":"Stacks Calldata Encoder","description":"Encode the function arguments for a Stacks Clarity contract-call into serialized Clarity values plus a ready-to-sign contract-call spec — the Stacks analogue of the EVM Calldata Encoder (Stacks has no flat calldata blob; a contract-call's payload is a function name + a list of serialized Clarity values). Fetches the contract ABI from Hiro, coerces each argument to a ClarityValue against its declared type (recursively for optional, tuple, and list types), and returns the serialized hex per argument together with a contract-call spec (contract address, contract name, function name, and function_args as {type, value} objects) that mirrors the wallet contract-call pipeline. Pass plain values in ABI order: numbers for uint/int, strings for principal and string types, 0x-hex or text for buffers, null for an optional none, an object for a tuple, an array for a list. Read-only — it only serializes the args; it never signs or broadcasts. Pair with a simulator before signing.","tags":["developer"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"contract_id":{"description":"Contract ID","type":"string","examples":["SP….contract-name"]},"function_name":{"description":"Function Name","type":"string","examples":["transfer"]},"function_args":{"description":"Function Arguments (JSON array, ABI order)","type":"string","examples":["[1000, \"SP…sender\", \"SP…recipient\", null]"]}},"required":["contract_id","function_name"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/stacks-market-overview/run":{"post":{"operationId":"run_stacks_market_overview","summary":"Market Overview","description":"Get a complete Stacks DeFi market dashboard — total TVL, 24h volume, active traders, top gainers and losers, trending liquidity pools, and net token inflows/outflows. No input required.","tags":["analytics"],"x-price-sats":0,"x-aliases":["market-overview"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{},"required":[],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/stacks-mempool-inspector/run":{"post":{"operationId":"run_stacks_mempool_inspector","summary":"Stacks Mempool Inspector","description":"Inspect pending (unconfirmed) Stacks transactions. By address: list a wallet's outgoing and incoming mempool txs with fee, nonce, type, and age. By tx id: get the transaction's fee, nonce, and age plus a \"stuck\" diagnosis — its fee compared against live mempool fee percentiles for its tx type, and a sender nonce-gap check (the most common reason a tx won't confirm regardless of fee).","tags":["network"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"address":{"description":"Stacks Address (optional)","type":"string","examples":["SP2ZNGJ85ENDY6QRHQ5P2D4FXKGZWCKTB2T0Z55KS"]},"tx_id":{"description":"Transaction ID (optional)","type":"string","examples":["0xabc123..."]}},"required":[],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/stacks-network/run":{"post":{"operationId":"run_stacks_network","summary":"Stacks Network Status","description":"Live Stacks network dashboard — block height, PoX stacking cycle, mempool stats, and server version in one view.","tags":["network"],"x-price-sats":0,"x-aliases":["stx-network"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{},"required":[],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/stacks-news/run":{"post":{"operationId":"run_stacks_news","summary":"Stacks News","description":"Latest Stacks ecosystem news headlines combining market coverage, protocol development, and SIP governance updates. Returns a list of articles with title, link, published date, summary, and source, newest first. Keyless RSS aggregation, read-only.","tags":["analytics"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"limit":{"description":"Number of Headlines","type":"number","examples":["10"]}},"required":[],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/stacks-nft-holdings/run":{"post":{"operationId":"run_stacks_nft_holdings","summary":"NFT Holdings","description":"View all Stacks (SIP-009) NFTs held by an address — grouped by collection with collection names, artwork, and counts. Resolves the wallet's BNS name(s) too. Optionally filter to a single collection contract.","tags":["analytics"],"x-price-sats":0,"x-aliases":["nft-holdings"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"address":{"description":"Stacks Address","type":"string","examples":["SP2ZNGJ85ENDY6QRHQ5P2D4FXKGZWCKTB2T0Z55KS"]},"collection":{"description":"Collection Contract (optional)","type":"string","examples":["SP...contract-name (leave empty for all)"]}},"required":["address"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/stacks-sip/run":{"post":{"operationId":"run_stacks_sip","summary":"Stacks SIP Updates","description":"Recent Stacks Improvement Proposal (SIP) governance updates: proposal title, status, link, and published date, newest first. Keyless RSS/GitHub aggregation, read-only. Use to track Stacks protocol governance and upcoming network changes.","tags":["network"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"limit":{"description":"Number of SIPs","type":"number","examples":["5"]}},"required":[],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/stacks-stacking-info/run":{"post":{"operationId":"run_stacks_stacking_info","summary":"Stacking Info","description":"View the current Stacks PoX stacking cycle — total STX stacked, percentage of supply locked, minimum threshold, top signers with weight, and next cycle countdown. Pass an address for its stacking detail: locked STX, unlock cycle, solo vs pool, and liquid stSTX/liSTX positions.","tags":["network"],"x-price-sats":0,"x-aliases":["stacking-info"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"address":{"description":"Stacks Address (optional)","type":"string","examples":["SP... (leave empty for global overview)"]}},"required":[],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/stacks-stealth-buy/run":{"post":{"operationId":"run_stacks_stealth_buy","summary":"Stealth Buy","description":"Buy a token without it being tied to your main wallet in charts and trade feeds — routed through a fresh wallet and split into smaller buys.","tags":["trading"],"x-price-sats":0,"x-aliases":["stealth-buy"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"preset_id":{"description":"Target Token","type":"string","enum":["welsh","leo","not","sbtc"]},"amount_usd":{"description":"Amount (USD)","type":"string"},"splits":{"description":"Number of Buys","type":"string"},"interval":{"description":"Interval (seconds)","type":"string"},"slippage":{"description":"Slippage %","type":"string"}},"required":["preset_id","amount_usd","splits","interval"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/stacks-token-analytics/run":{"post":{"operationId":"run_stacks_token_analytics","summary":"Deep Token Analytics","description":"Comprehensive token analysis: real-time price, market data, holder distribution, trading volume, and on-chain metrics for any Stacks token.","tags":["analytics"],"x-price-sats":500,"x-aliases":["token-analytics"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"token":{"description":"Token Name or Contract","type":"string","examples":["WELSH or SP2..."]}},"required":["token"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"402":{"description":"Payment required (x402). Retry with a `payment-signature` header. Price: 500 sats.","headers":{"payment-required":{"schema":{"type":"string"},"description":"base64 x402 PaymentRequiredV2"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Unknown tool slug."}}}},"/api/tools/stacks-token-holders/run":{"post":{"operationId":"run_stacks_token_holders","summary":"Token Holders","description":"Analyze token holder distribution for any Stacks token — top holder wallets, percentage of supply held by top 10/50 addresses, concentration assessment, and per-holder USD values. Supports token name or contract address.","tags":["analytics"],"x-price-sats":0,"x-aliases":["token-holders"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"token":{"description":"Token","type":"string","examples":["WELSH, CHA, or SP...contract-address"]}},"required":["token"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/stacks-token-ohlc/run":{"post":{"operationId":"run_stacks_token_ohlc","summary":"Stacks Token OHLC","description":"Historical OHLC price candles (open, high, low, close, volume) for a Stacks token over a chosen interval. Read-only Tenero market data, no auth. Pass a token contract id; returns up to 50 candles for charting and technical analysis.","tags":["analytics"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"token_address":{"description":"Token Contract ID","type":"string","examples":["SP2...::token"]},"interval":{"description":"Candle Interval","type":"string","examples":["1h"]},"limit":{"description":"Number of Candles (max 50)","type":"number","examples":["50"]}},"required":["token_address"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/stacks-token-price/run":{"post":{"operationId":"run_stacks_token_price","summary":"Token Price","description":"Get real-time price, market cap, 24h volume, liquidity, and holder count for any Stacks token — blended from DEX and market data.","tags":["analytics"],"x-price-sats":0,"x-aliases":["token-price"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"token":{"description":"Token","type":"string","examples":["WELSH, CHA, or SP2...contract-address"]}},"required":["token"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/stacks-token-risk-check/run":{"post":{"operationId":"run_stacks_token_risk_check","summary":"Token Risk Check","description":"Conservative rug-check / safety risk score for any Stacks SIP-010 token. Returns a 0-100 risk score (higher = riskier) and a low/med/high level with plain-English flags, composed from: verified-token registry status, liquidity depth (USD), holder concentration (top-10 / single-holder / deployer percentages, excluding DEX-pool and contract holders), token age, recent DEX trade flow, and a Clarity contract audit — open/unguarded mint authority, freeze/blacklist powers, transfer-pause, admin functions that can move other holders' balances, upgradeable/proxy targets, modifiable transfer fee/tax, mutable metadata, and admin drain/withdraw functions. Conservative by design: anything it cannot verify is marked uncertain, and it never asserts a token is \"safe\" — only whether high-risk signals were found. LP-lock detection is best-effort. Not financial advice and not a guarantee.","tags":["security"],"x-price-sats":500,"x-aliases":["token-risk-check"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"contract_id":{"description":"Token Contract ID","type":"string","examples":["SP2C2YFP12AJZB4MABJBAJ55XECVS7E4PMMZ89YZR.token-name"]}},"required":["contract_id"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"402":{"description":"Payment required (x402). Retry with a `payment-signature` header. Price: 500 sats.","headers":{"payment-required":{"schema":{"type":"string"},"description":"base64 x402 PaymentRequiredV2"}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Unknown tool slug."}}}},"/api/tools/stacks-trader-stats/run":{"post":{"operationId":"run_stacks_trader_stats","summary":"Stacks Trader Stats","description":"Aggregate Stacks market trading statistics over a timeframe: active traders, trade counts, volume, and other market-wide activity metrics. Read-only Tenero analytics, no auth. Use for a market-level pulse on Stacks DEX trading activity (not for a single wallet — see stacks-wallet-pnl).","tags":["analytics"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"timeframe":{"description":"Timeframe","type":"string","examples":["24h"]}},"required":[],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/stacks-tx-decoder/run":{"post":{"operationId":"run_stacks_tx_decoder","summary":"Transaction Decoder","description":"Decode any Stacks transaction into a human-readable breakdown — amounts in STX, function arguments, events, and status.","tags":["analytics"],"x-price-sats":0,"x-aliases":["tx-decoder"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"tx_id":{"description":"Transaction ID","type":"string","examples":["0xabc123... or abc123..."]}},"required":["tx_id"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/stacks-tx-simulate/run":{"post":{"operationId":"run_stacks_tx_simulate","summary":"Stacks Transaction Simulation","description":"Pre-flight / dry-run a PROPOSED Stacks transaction WITHOUT broadcasting. Keyless and read-only — never signs, never broadcasts, never moves funds. Modes: action=transfer (from, to, amount in STX → estimates the fee and checks the sender's balance covers amount + fee), action=contract_call (contract_id, function_name, function_args, from → for READ-ONLY functions truly evaluates them against live state and returns the (ok …)/(err …) result; for STATE-CHANGING functions Stacks cannot read-only-execute them, so it validates the args against the live ABI, estimates the fee, and statically lists the asset-movement primitives the function uses — success/revert is not predicted), action=sellability (token_contract → a honeypot check that statically scans the SIP-010 transfer source for pause / blacklist / owner-only guards). Reflects current chain state — not a safety guarantee. Not financial advice.","tags":["developer"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"action":{"description":"Action","type":"string","examples":["transfer | contract_call | sellability"]},"from":{"description":"From (S…)","type":"string","examples":["sender address"]},"to":{"description":"To (S…)","type":"string","examples":["recipient — for action=transfer"]},"amount":{"description":"Amount (STX)","type":"number","examples":["for action=transfer"]},"contract_id":{"description":"Contract ID","type":"string","examples":["SP….contract-name — for contract_call"]},"function_name":{"description":"Function Name","type":"string","examples":["for action=contract_call"]},"function_args":{"description":"Function Arguments (JSON array, ABI order)","type":"string","examples":["[1000, \"SP…sender\", \"SP…recipient\", null] — for action=contract_call"]},"token_contract":{"description":"SIP-010 Token","type":"string","examples":["SP….token — for sellability"]}},"required":[],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/stacks-wallet-lookup/run":{"post":{"operationId":"run_stacks_wallet_lookup","summary":"Wallet Lookup","description":"Look up any Stacks address — STX balance, token holdings, NFT collections, BNS name, staking (PoX + stSTX/liSTX), DeFi positions (Zest + LP), and trading P&L in one profile.","tags":["analytics"],"x-price-sats":0,"x-aliases":["wallet-lookup"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"address":{"description":"Stacks Address","type":"string","examples":["SP2ZNGJ85ENDY6QRHQ5P2D4FXKGZWCKTB2T0Z55KS"]}},"required":["address"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/stacks-wallet-pnl/run":{"post":{"operationId":"run_stacks_wallet_pnl","summary":"Stacks Wallet P&L","description":"Realized profit-and-loss distribution for a Stacks wallet: per-token and aggregate P&L breakdown showing winning vs losing positions across the wallet's trading history. Read-only Tenero analytics, no auth. Pass a Stacks address; returns the P&L distribution plus a Tenero dashboard link.","tags":["analytics"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"wallet_address":{"description":"Stacks Address","type":"string","examples":["SP2ZNGJ85ENDY6QRHQ5P2D4FXKGZWCKTB2T0Z55KS"]}},"required":["wallet_address"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/stacks-whale-watch/run":{"post":{"operationId":"run_stacks_whale_watch","summary":"Whale Watch","description":"Monitor large whale trades on Stacks DEXes — track big buys and sells, net token inflows/outflows, and overall whale sentiment across configurable timeframes and value thresholds.","tags":["analytics"],"x-price-sats":0,"x-aliases":["whale-watch"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"timeframe":{"description":"Timeframe","type":"string","enum":["1h","6h","24h"],"examples":["24h"]},"min_value_usd":{"description":"Min Trade Value (USD)","type":"number","examples":["10000"]}},"required":["timeframe"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/stacks-zest-markets/run":{"post":{"operationId":"run_stacks_zest_markets","summary":"Zest Markets","description":"Zest Protocol market overview — every reserve's supply and borrow APY, TVL, utilization, loan-to-value and liquidation threshold, and active/frozen status. Compare lending yields across sBTC, STX, stSTX, stablecoins and more.","tags":["analytics"],"x-price-sats":0,"x-aliases":["zest-markets"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{},"required":[],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/stacks-zest-position/run":{"post":{"operationId":"run_stacks_zest_position","summary":"Zest Position","description":"View a Stacks address's Zest Protocol lending position — supplied and borrowed assets, accrued interest, collateral flags, supply/borrow APYs, USD values, and a derived health factor (below 1.0 = liquidatable).","tags":["analytics"],"x-price-sats":0,"x-aliases":["zest-position"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"address":{"description":"Stacks Address","type":"string","examples":["SP2ZNGJ85ENDY6QRHQ5P2D4FXKGZWCKTB2T0Z55KS"]}},"required":["address"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/sui-address-activity/run":{"post":{"operationId":"run_sui_address_activity","summary":"Sui Address Activity","description":"Recent transaction history for a Sui address. Returns the newest transactions affecting the address with digest, timestamp, transaction kind, status, sender, and the address's net SUI balance change. Use the Sui Transaction Decoder on a digest for the full balance-change / event breakdown, or Sui Wallet Lookup for a current holdings snapshot. Capped to the most recent transactions (not exhaustive). Read-only, keyless (Sui GraphQL RPC).","tags":["analytics"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"address":{"description":"Sui Address","type":"string","examples":["0x… (up to 64 hex)"]},"limit":{"description":"Number of Transactions","type":"number","examples":["20"]}},"required":["address"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/sui-news/run":{"post":{"operationId":"run_sui_news","summary":"Sui News","description":"Latest Sui (Mysten Labs Move-based L1) ecosystem news headlines (Cointelegraph Sui, The Block, Decrypt). Returns a list of articles with title, link, published date, summary, and source, newest first. Keyless RSS aggregation, read-only.","tags":["analytics"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"limit":{"description":"Number of Headlines","type":"number","examples":["12"]}},"required":[],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/sui-token-price/run":{"post":{"operationId":"run_sui_token_price","summary":"Sui Token Price","description":"Live USD spot price for SUI (Sui, the Mysten Labs Move-based L1) or any Sui coin, by symbol (CETUS, USDC, …) or fully-qualified Move coin type (0x…::module::TYPE, e.g. 0x2::sui::SUI). Returns price plus FDV, market cap, 24h volume, and decimals. Keyless (GeckoTerminal), read-only. Low-liquidity Sui coins can be manipulated — not financial advice.","tags":["analytics"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"token":{"description":"Token (SUI, symbol, or coin type)","type":"string","examples":["SUI / CETUS or 0x2::sui::SUI"]}},"required":["token"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/sui-tx-decoder/run":{"post":{"operationId":"run_sui_tx_decoder","summary":"Sui Transaction Decoder","description":"Decode a Sui transaction by digest and explain what it did — the cross-chain analogue of the Solana / EVM / TON Transaction Decoder. Uses Sui GraphQL RPC: returns overall status (success/failure), transaction kind, sender, gas fee in SUI, the per-owner balance changes (who gained/lost which coin), and the emitted Move event types. Read-only, keyless.","tags":["developer"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"hash":{"description":"Transaction Digest","type":"string","examples":["base58 digest (~44 chars)"]}},"required":["hash"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/sui-wallet-lookup/run":{"post":{"operationId":"run_sui_wallet_lookup","summary":"Sui Wallet Lookup","description":"Aggregate Sui wallet / portfolio overview for any Sui address — the cross-chain analogue of Solana / EVM / TON Wallet Lookup. Returns native SUI balance + USD value, a coin table (coin type, symbol, amount, USD price/value), token count, and total portfolio USD. Prices native SUI + every coin with a Sui DEX market in USD. Accepts 0x… (up to 64 hex) addresses. Keyless (Sui GraphQL RPC + GeckoTerminal), read-only. Coins without a market are excluded from the USD total; NFTs / arbitrary Move objects are not enumerated. Not financial advice.","tags":["analytics"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"address":{"description":"Sui Address","type":"string","examples":["0x… (up to 64 hex)"]}},"required":["address"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/ton-address-activity/run":{"post":{"operationId":"run_ton_address_activity","summary":"TON Address Activity","description":"Recent transaction / event history for a TON (The Open Network) address. Returns the newest decoded events with event id, timestamp, primary action (TonTransfer / JettonTransfer / NftItemTransfer / JettonSwap), status, a human-readable description, and action count. Use the TON Transaction Decoder on an event id for the full breakdown, or TON Wallet Lookup for a current holdings snapshot. Capped to the most recent events (not exhaustive). Read-only, keyless.","tags":["analytics"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"address":{"description":"TON Address","type":"string","examples":["EQ…/UQ… or raw 0:… address"]},"limit":{"description":"Number of Events","type":"number","examples":["20"]}},"required":["address"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/ton-news/run":{"post":{"operationId":"run_ton_news","summary":"TON News","description":"Latest TON (The Open Network) ecosystem news headlines (Cointelegraph TON, The Block, Decrypt). Returns a list of articles with title, link, published date, summary, and source, newest first. Keyless RSS aggregation, read-only.","tags":["analytics"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"limit":{"description":"Number of Headlines","type":"number","examples":["12"]}},"required":[],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/ton-token-price/run":{"post":{"operationId":"run_ton_token_price","summary":"TON Token Price","description":"Live USD spot price for TON (Toncoin) or any jetton on The Open Network, by symbol (NOT, USDT, …) or jetton contract address. Returns price plus 24h / 7d / 30d change, decimals, and a verification flag. Keyless (TON API / tonapi.io), read-only. Low-liquidity jettons can be manipulated and a whitelisted flag is not a safety guarantee — not financial advice.","tags":["analytics"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"token":{"description":"Token (TON, jetton symbol, or contract)","type":"string","examples":["TON / NOT / USDT or jetton address"]}},"required":["token"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/ton-tx-decoder/run":{"post":{"operationId":"run_ton_tx_decoder","summary":"TON Transaction Decoder","description":"Decode a TON (The Open Network) transaction by hash and explain what it did — the cross-chain analogue of the Solana / EVM Transaction Decoder. Uses TON API decoded event actions: returns overall status (success/failed) plus a per-action breakdown (type, status, human-readable description, sender, recipient, amount) for TonTransfer / JettonTransfer / NftItemTransfer / JettonSwap and more. Read-only, keyless.","tags":["developer"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"hash":{"description":"Transaction Hash","type":"string","examples":["64-char hex tx hash"]}},"required":["hash"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/ton-wallet-lookup/run":{"post":{"operationId":"run_ton_wallet_lookup","summary":"TON Wallet Lookup","description":"Aggregate TON (The Open Network) wallet / portfolio overview for any TON address — the cross-chain analogue of Solana / EVM Wallet Lookup. Returns native TON balance + USD value, a jetton table (symbol, amount, USD price/value, verification), token count, NFT items held by the owner, and total portfolio USD. Prices native TON + every jetton in USD via TON API. Accepts user-friendly (EQ…/UQ…) or raw (0:…) addresses. Keyless (tonapi.io), read-only. Unpriced jettons are excluded from the USD total. Not financial advice.","tags":["analytics"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"address":{"description":"TON Address","type":"string","examples":["EQ…/UQ… or raw 0:… address"]},"include_nfts":{"description":"Include NFTs","type":"string","enum":["true","false"],"examples":["true"],"default":"true"}},"required":["address"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/zadao-bounties/run":{"post":{"operationId":"run_zadao_bounties","summary":"ZADAO Bounties","description":"Search open bounties on the ZADAO community platform. Filter by free-text query, status (Open/closed), category, or organization. Returns each bounty's id, title, and reward. Read-only ZADAO data, no auth. Nova is a community assistant as well as a blockchain assistant; this surfaces the ZADAO ecosystem's earning opportunities to external agents.","tags":["ecosystem"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"query":{"description":"Search Query","type":"string","examples":["design, dev, content..."]},"status":{"description":"Status","type":"string","examples":["Open"]},"category":{"description":"Category","type":"string"}},"required":[],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/zadao-docs/run":{"post":{"operationId":"run_zadao_docs","summary":"ZADAO Docs Search","description":"Search the ZADAO documentation for an answer or relevant pages. Pass a natural-language query; returns the most relevant documentation snippets. Read-only ZADAO data, no auth.","tags":["ecosystem"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"query":{"description":"Search Query","type":"string","examples":["How do I create a bounty?"]},"limit":{"description":"Number of Results","type":"number","examples":["5"]}},"required":["query"],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/zadao-gigs/run":{"post":{"operationId":"run_zadao_gigs","summary":"ZADAO Gigs","description":"Search service gigs offered on the ZADAO community platform. Filter by free-text query, status, or service type. Returns matching gigs with their core details. Read-only ZADAO data, no auth.","tags":["ecosystem"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"query":{"description":"Search Query","type":"string"},"service":{"description":"Service Type","type":"string"}},"required":[],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/zadao-grants/run":{"post":{"operationId":"run_zadao_grants","summary":"ZADAO Grants","description":"Search grants available on the ZADAO community platform. Filter by free-text query, category, or status. Returns matching grants with their core details. Read-only ZADAO data, no auth.","tags":["ecosystem"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"query":{"description":"Search Query","type":"string"},"category":{"description":"Category","type":"string"},"status":{"description":"Status","type":"string"}},"required":[],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}},"/api/tools/zadao-quests/run":{"post":{"operationId":"run_zadao_quests","summary":"ZADAO Quests","description":"Search quests on the ZADAO community platform. Filter by free-text query, status (active/etc.), and sort order. Returns matching quests with their core details. Read-only ZADAO data, no auth.","tags":["ecosystem"],"x-price-sats":0,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"input":{"type":"object","properties":{"query":{"description":"Search Query","type":"string"},"status":{"description":"Status","type":"string","examples":["active"]}},"required":[],"additionalProperties":false}},"required":["input"]}}}},"responses":{"200":{"description":"Tool executed. `output` holds the per-executor result map.","content":{"application/json":{"schema":{"type":"object","properties":{"runId":{"type":"string"},"status":{"type":"string","enum":["completed","running","failed"]},"output":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid input (failed schema validation)."},"404":{"description":"Unknown tool slug."}}}}}}