# Nodetrail > Nodetrail is a read-only security layer for traders and AI agents. It reads public chain data for a token or wallet and returns facts plus a Low, Elevated or High risk signal, and a list of what it could not check. Agents pay per scan with the x402 protocol, in USDC, from their own wallet. Site: https://nodetrail.io ## Paid scan API (x402 v2, live) Base URL: https://nodetrail.io - GET /api/x402/v1/scan/token quick token scan, $0.02 (20000 atomic USDC) - GET /api/x402/v1/scan/wallet quick wallet scan, $0.05 (50000 atomic USDC) - GET /api/x402/v1/scan/dev deep scan, $0.07 (70000 atomic USDC) - GET /api/x402/v1/info prices, networks and status. No payment needed. Query: `address` (required; `mint` or `wallet` also accepted), `chain` (optional), `currency` (optional, XRP Ledger tokens). How to pay: call a scan route with no payment. It answers HTTP 402 with a PAYMENT-REQUIRED header (base64 JSON, x402 v2, scheme "exact") giving the exact price, asset, network and payTo. Sign a payment for one of the offered rails and repeat the same request with a PAYMENT-SIGNATURE header. An x402 v2 client library does this for you. Read the amount and payTo from the quote, not from this file. Payment rails (USDC, mainnet): - Base: eip155:8453 - Solana: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp Payments are verified and settled through the Coinbase CDP x402 facilitator. Base: the payer signs one EIP-3009 transfer authorization (no approvals, no ETH needed; the facilitator pays the gas). Solana (API clients): the payer signs a partially signed USDC transfer and the quote's fee payer covers the fee, so no gas coin is needed. On the nodetrail.io scan page, a Solana payer is the only signer and fee payer and pays the tiny network fee from their own wallet. You are only charged if the scan is delivered: the read happens before settlement. A bad address, an unsupported chain or scan type, a failed read or a spend limit returns JSON {"ok": false, "charged": false, "error": {"code", "message"}} and nothing is settled. ## Chains Token scans: solana, ethereum, base, bnb (BNB Chain), robinhood (Robinhood Chain), arbitrum, tron, polygon, avalanche, sui, near, xrpl (XRP Ledger), ton, optimism, monad, unichain, mantle, berachain, sei, ink, xlayer (X Layer), arc, cronos, worldchain (World Chain), sonic, linea, zksync (zkSync Era), plasma, stable, celo, beam, scroll, taiko, katana, ronin, kaia, soneium, flare, megaeth, story, hedera, apechain, flowevm (Flow EVM), fuse, kava (Kava EVM), manta (Manta Pacific), metis, telos (Telos EVM), merlin (Merlin Chain), elysium, cardano, aptos, movement, injective, stacks, starknet, multiversx, algorand, icp, polkadot (Polkadot Asset Hub), stellar. That is 61 chains. Wallet scans: solana, base, tron, sui, near, xrpl, ton, hedera, cardano, aptos, movement, injective, stacks, starknet, multiversx, algorand, icp, polkadot and stellar only. A wallet scan on any other chain returns an error with no charge. Hyperliquid: Nodetrail scanning for Hyperliquid is coming soon. It is listed but cannot be scanned yet. If `chain` is omitted: a 40-character 0x address is read as base, an address containing "::" as sui, anything else as solana. Sui tokens are coin types such as 0x2::sui::SUI. XRP Ledger tokens can be written CURRENCY.rISSUER. ## Result HTTP 200 JSON with: ok, kind, chain, chainName, address, type, level (Low, Elevated, High or Unknown), findings, headline, rows, facts, coverage (including coverage.not_checked), source, read_ms, cached, data_age_s, live_read, paid, bucket ("quick" or "deep"), settlement {network, transaction, payer}, disclaimer. A chain read may be reused for up to 8 minutes (token and deep) or 2 minutes (wallet); data_age_s says how old it is (0 = just read). If a data source is too slow the call returns read_timeout (HTTP 504) and nothing is charged. Anything listed under coverage.not_checked was not read and is not implied either way. A risk signal is a summary of flagged facts, not a verdict. ## Machine-readable docs - https://nodetrail.io/openapi.json OpenAPI 3.1 description of the four routes - https://nodetrail.io/developers/ human docs - https://nodetrail.io/llms.txt this file ## Human scan page https://nodetrail.io/scan/ lets a person pay the same routes from their own browser wallet (Base USDC or Solana USDC). Deep links: https://nodetrail.io/scan/?chain=. ## Honest status and limits - Real USDC moves on these routes. Use a small dedicated wallet. - Spend limits apply per payer and across the whole service. When one is reached the route returns HTTP 429 and nothing is charged. - A Nodetrail token is in the works, but no token exists yet and there is no contract address. Anyone selling one today is not us. It will only be announced on nodetrail.io and our official accounts. Nodetrail never asks for a seed phrase or private key. - Scanning on the nodetrail.io site is paid per scan today. Bots and agents are never free. A free daily scan with sign-up is coming soon and is not live. - Plans (card, via Stripe): Free $0 (coming soon), Trail $24.99, Pro $59.99 and Team $109.99 a month. 12-month plans (Trail $249.90, Pro $599.90, Team $1,099.90) and bundles (Ape Pack, Bot Fuel, Call Group Pass) are coming soon and cannot be bought yet. - Monthly API plans with a key have been built but are switched off. No keys are issued yet. Planned: API Starter $49 a month for 250 unique scans per UTC day, API Pro $199 a month for 2,500, Enterprise by contact. Every scan type counts as one. - Nodetrail has not submitted itself to any agent directory or registry yet. - Nodetrail is not affiliated with Robinhood, Base, Solana, Sui, NEAR, Ripple, BNB Chain, Avalanche, Arbitrum or Ethereum. Chain names and logos belong to their owners. ## Information only Scan output is a tool result: facts read from public chain data. See https://nodetrail.io/disclaimer/ for the full notice. Official links: https://nodetrail.io/security/ (X x.com/nodetrailio, Telegram t.me/nodetrailio and t.me/nodetrailbot, Discord discord.gg/aPYz2NN7gC, GitHub github.com/nodetrailio, YouTube youtube.com/@nodetrailio, TikTok tiktok.com/@nodetraillabsllc, Linktree linktr.ee/nodetraillabs). Contact: support@nodetrail.io . Terms: https://nodetrail.io/terms/ . Refunds and support: https://nodetrail.io/refunds/ . ## All prices Pay per scan (USDC, x402): - Quick token scan: 2¢ (Live) - Wallet scan: 5¢ (Live) - Deep token check: 7¢ (Live) Monthly plans (card, via Stripe): - Trail: $24.99 / month (Live) - Pro: $59.99 / month (Live) - Team: $109.99 / month (Live) Pay in crypto: - Pay in SOL (Solana): 10% off the listed price (Coming soon; shows Live on the scan page where it is switched on) - Pay in ETH (Base): 10% off the listed price (Coming soon; shows Live on the scan page where it is switched on) - Pay in another non-stablecoin: 10% off the listed price (Coming soon) Same plans in @nodetrailbot with Telegram Stars: - Trail (Telegram Stars): 1,923⭐ / month (Coming soon) - Pro (Telegram Stars): 4,615⭐ / month (Coming soon) - Team (Telegram Stars): 8,461⭐ / month (Coming soon) Yearly plans (12 months for the price of 10): - Trail, yearly: $249.90 / year (Coming soon) - Pro, yearly: $599.90 / year (Coming soon) - Team, yearly: $1,099.90 / year (Coming soon) Bundles (pay once and save): - Ape Pack, 150 scans: $9.99 (Coming soon) - Ape Pack, 500 scans: $24.99 (Coming soon) - Bot Fuel, 1,000 scans (this month's deal): $49 (Coming soon) - Call Group Pass: $99 / month (Coming soon) Add-ons and deals: - Pro add-on: $4.99 / month (Coming soon) - Afterguard alerts: $38.99 / month (Coming soon) - API entry plan: $53.99 / month (Coming soon) - Telegram group plan: $133.99 / month per group (Coming soon) - Blockchain Buddy Plus: $4.99 / month (Coming soon) - Scan trio: 13¢ total (Coming soon) - Blockchain Buddy Welcome Pack: +100 checks, first month (Planned) - Buddy Bonus: 25 checks each (Planned) For bots and agents: - API Starter: $49 / month (Coming soon) - API Pro: $199 / month (Coming soon) - API Starter, yearly: $490 / year (Coming soon) - API Pro, yearly: $1,990 / year (Coming soon) - Agent bundle: $59 / month (Coming soon) Live means you can buy or use it today. Coming soon and Planned items cannot be bought yet. Telegram Stars price = the USD price divided by 1.3¢ per Star, rounded up. USDC scan prices do not change with plans. Stablecoins (USDC, USDT) pay the listed price with no discount. The 10% crypto discount is for non-stablecoins only. SOL (Solana) and ETH (Base) show Live on the scan page where that option is switched on, and Coming soon everywhere else; other non-stablecoins are coming soon.