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
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.02GET /api/x402/v1/scan/token
Quick wallet scan
$0.05GET /api/x402/v1/scan/wallet
Deep scan
$0.07GET /api/x402/v1/scan/dev
Prices and status (no payment)
$0GET /api/x402/v1/info
Money and networks
- Pay in USDC on Base (
eip155:8453) or Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp). Pick whichever rail the 402 quote offers that you hold. - On Base the payer signs one EIP-3009 transfer authorization (no approvals, no ETH needed), and the facilitator pays the gas. On Solana the payer signs a partially signed USDC transfer and the quote’s fee payer covers the fee, so API clients do not need a gas coin. 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. Either way you are only charged if the scan is delivered.
- The exact amount and pay-to address are always in the 402 quote. Read them there, not from this page.
- Spend limits apply per payer and across the whole service. If one is hit you get
429and you are not charged. - Refunds and support: see Refunds & support.
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
- /llms.txt: plain-text summary of the API.
- /openapi.json: OpenAPI 3 description of the four routes.
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.
- A JavaScript client and a local MCP server (it runs on your machine, not on nodetrail.io).
- ElizaOS and Solana Agent Kit plugin drafts. Those drafts are not listed in those ecosystems.
- Packages are not on npm. Do not
npm install @nodetrail/sdkfrom the public registry.
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.
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
- Nodetrail never asks you to connect a wallet, sign a transaction, or enter a seed phrase or private key in these docs.
- Payments are real USDC. Use a small dedicated wallet for bots, and fund it with only what you plan to spend.
- We never DM first. Official links: /security/.
- Facts only. No score that means “safe.” Never a recommendation to buy, sell or hold.
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.
| Item | Price | Status |
|---|---|---|
| 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 |
| Pay in ETH (Base) | 10% off the listed price | Coming soon |
| 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 |