SOL… ETH… BTC… NEAR… XRP… LINK… AVAX… ONDO…
COIN… MSTR… HOOD… NVDA… QQQ… SPY… BLK… JPM… ICE…

Prices by CoinGecko. Stock quotes delayed, from Nasdaq public data. Not a Nasdaq partner.

Developers

Developer API

Bots, scripts, and AI agents can pay per scan with x402. Send a request, get a price, pay in USDC from your own wallet, and get the read back. Quick token scans are $0.02, wallet scans are $0.05 and deep scans are $0.07. You are only charged if the scan is delivered.

Open @nodetrailbot on this phone

Live, pay per scan. The scan routes below run on nodetrail.io and take real USDC on Base and Solana mainnet. Payments are checked and settled through the Coinbase CDP facilitator. We read the chain first and settle only after the read succeeds, so a failed read is never charged. Results are facts and a Low, Elevated or High risk signal, never a verdict. There is no official x402 token.

What you can call

All scan routes use GET. A request with no payment returns HTTP 402 and a PAYMENT-REQUIRED header (x402 v2, exact scheme) that lists the exact USDC price, network and pay-to address. Pay, then retry the same request with a PAYMENT-SIGNATURE header. Any x402 v2 client library does this for you.

Quick token scan

$0.02

GET /api/x402/v1/scan/token

Quick wallet scan

$0.05

GET /api/x402/v1/scan/wallet

Deep scan

$0.07

GET /api/x402/v1/scan/dev

Prices and status (no payment)

$0

GET /api/x402/v1/info

Money and networks

Chains

Set chain to one of solana, ethereum, base, bnb, robinhood, arbitrum, tron, polygon, avalanche, sui, near, xrpl, ton, optimism, monad, unichain, mantle, berachain, sei, ink, xlayer, arc, cronos, worldchain, sonic, linea, zksync, plasma, stable, celo, beam, scroll, taiko, katana, ronin, kaia, soneium, flare, megaeth, story, hedera, apechain, flowevm, fuse, kava, manta, metis, telos, merlin, elysium, cardano, aptos, movement, injective, stacks, starknet, multiversx, algorand, icp, polkadot or stellar. Token scans work on all 61. Wallet scans work on Solana, Base, Tron, Sui, NEAR, XRP Ledger, TON, Hedera, Cardano, Aptos, Movement, Injective, Stacks, Starknet, MultiversX, Algorand, ICP, Polkadot Asset Hub and Stellar only. Nodetrail scanning for Hyperliquid is coming soon. A wallet scan on any other chain returns an error and no charge. If chain is left out, a 40-character 0x address is read as Base, an address containing :: as Sui, and anything else as Solana. Sui tokens are coin types like 0x2::sui::SUI. XRP Ledger tokens can be written RLUSD.r… (currency, dot, issuer).

Copy-paste examples

Prices and status, no payment:

curl -sS "https://nodetrail.io/api/x402/v1/info"

Ask for a quick token scan price. With no payment this returns 402, and the quote is in the PAYMENT-REQUIRED header (base64 JSON):

curl -sS -D - \
  "https://nodetrail.io/api/x402/v1/scan/token?chain=base&address=0xYOUR_TOKEN_ADDRESS"

Query fields: address (required; mint or wallet also work), optional chain, plus currency for XRP Ledger tokens. Then pay with an x402 v2 client and repeat the request with the PAYMENT-SIGNATURE header it builds. The scan page does the same thing in the browser with your own wallet.

What a paid result looks like

A paid scan returns 200 with JSON. Trimmed example:

{
  "ok": true,
  "kind": "token",
  "chain": "base",
  "chainName": "Base",
  "address": "0x…",
  "type": "token",
  "level": "Low",
  "findings": [],
  "headline": { "level": "low", "reasons": [] },
  "rows": [],
  "coverage": { "sources": [], "not_checked": [] },
  "live_read": true,
  "paid": true,
  "bucket": "quick",
  "settlement": { "network": "eip155:8453", "transaction": "0x…", "payer": "0x…" },
  "disclaimer": "Facts read from public chain data. A risk signal, not a verdict. Anything under coverage.not_checked was not read."
}

level is Low, Elevated, High or Unknown. It sums up the facts that were flagged and is never a buy or sell verdict. Anything under coverage.not_checked was not read and is not implied either way.

Errors and “no charge”

If the address is bad, the chain or scan type is not offered, or the read does not finish, the response is JSON like {"ok": false, "charged": false, "error": {"code": "…", "message": "…"}} and nothing is settled. A read is cut off after about 7 seconds so a slow data source cannot hang your call. Codes you may see: bad_address, unsupported_chain, wallet_chain_unsupported, read_failed (502, try again), read_timeout (504, a data source was too slow, try again in a few seconds), busy and budget_exhausted (503, try later), chain_not_enabled (503), a spend-limit code (429) and replay (409, that payment was already used).

How fresh is a result? Each paid call returns a fresh paid answer, but the chain read behind it may be reused for a few minutes to protect the public data sources: up to 8 minutes for a token or deep scan and 2 minutes for a wallet. data_age_s in the result says how old the read is (0 means just read) and cached says whether it was reused.

For agents and crawlers

Monthly API plans (built, off)

Monthly API plans with a key are built but not switched on, and no keys are issued yet. When they open, you send X-API-Key: nt_<id>_<secret> or Authorization: Bearer nt_<id>_<secret> to the same scan routes instead of paying per call. The plans are API Starter at $49 a month for 250 unique scans per UTC day, API Pro at $199 a month for 2,500, and Enterprise by contact at support@nodetrail.io. Every scan type (quick token, wallet or deep) counts as one scan; a read that fails and a repeat of the same scan that day are not counted. Responses carry X-Quota-* and X-RateLimit-* headers, and 429 means a limit was reached. Plans, keys and usage live on the API dashboard; see the draft API Terms. A request without a key keeps the x402 flow above, unchanged.

SDK, MCP and plugins

A public bot kit lives at github.com/nodetrailio/botkit. It was written for the earlier testnet preview, so its payment helper only works on test networks and its docs and prices are out of date. Use the routes and prices on this page. For mainnet today, call the API with any x402 v2 client.

Powered by Nodetrail badge

If you use Nodetrail in your app, you can show this badge and link it to nodetrail.io. Use the dark badge on dark backgrounds and the light badge on light backgrounds.

Powered by Nodetrail Powered by Nodetrail

Dark background:

<a href="https://nodetrail.io/">
  <img src="https://nodetrail.io/developers/badges/powered-by-nodetrail-dark.svg"
       alt="Powered by Nodetrail" width="240" height="48">
</a>

Light background:

<a href="https://nodetrail.io/">
  <img src="https://nodetrail.io/developers/badges/powered-by-nodetrail.svg"
       alt="Powered by Nodetrail" width="240" height="48">
</a>

Directories

The paid routes publish x402 discovery metadata (input fields and an example output). Nodetrail has not submitted itself to any agent directory or registry yet, and we do not claim a listing anywhere.

Rules for anyone using these docs

Questions: Contact. Corrections: /corrections/.

All prices in one place

These are the same names and prices on every page, in llms.txt, the API docs, the developer kit and @nodetrailbot. 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.

ItemPriceStatus
Pay per scan (USDC, x402)
Quick token scan2¢Live
Wallet scan5¢Live
Deep token check7¢Live
Monthly plans (card, via Stripe)
Trail$24.99 / monthLive
Pro$59.99 / monthLive
Team$109.99 / monthLive
Pay in crypto
Pay in SOL (Solana)10% off the listed priceComing soon
Pay in ETH (Base)10% off the listed priceComing soon
Pay in another non-stablecoin10% off the listed priceComing soon
Same plans in @nodetrailbot with Telegram Stars
Trail (Telegram Stars)1,923⭐ / monthComing soon
Pro (Telegram Stars)4,615⭐ / monthComing soon
Team (Telegram Stars)8,461⭐ / monthComing soon
Yearly plans (12 months for the price of 10)
Trail, yearly$249.90 / yearComing soon
Pro, yearly$599.90 / yearComing soon
Team, yearly$1,099.90 / yearComing soon
Bundles (pay once and save)
Ape Pack, 150 scans$9.99Coming soon
Ape Pack, 500 scans$24.99Coming soon
Bot Fuel, 1,000 scans (this month's deal)$49Coming soon
Call Group Pass$99 / monthComing soon
Add-ons and deals
Pro add-on$4.99 / monthComing soon
Afterguard alerts$38.99 / monthComing soon
API entry plan$53.99 / monthComing soon
Telegram group plan$133.99 / month per groupComing soon
Blockchain Buddy Plus$4.99 / monthComing soon
Scan trio13¢ totalComing soon
Blockchain Buddy Welcome Pack+100 checks, first monthPlanned
Buddy Bonus25 checks eachPlanned
For bots and agents
API Starter$49 / monthComing soon
API Pro$199 / monthComing soon
API Starter, yearly$490 / yearComing soon
API Pro, yearly$1,990 / yearComing soon
Agent bundle$59 / monthComing soon