Skip to content
Nodely

x402 pay-per-call APIs

View Markdown · Agent resources

Nodely sells pay-per-call APIs for AI agents at https://x402.api.nodely.io. You pay per request with x402 in USDC on Algorand mainnet; web search and page scrape also take USDC on Base and Arc. You don’t need an account, a sign-up or an API key.

How it works

Section titled “How it works”
  1. Call a paid route.
  2. The API answers HTTP 402 Payment Required with the price and where to pay.
  3. Your client signs one USDC payment and sends the same request again with the signed payment attached. Nodely pays the network fee, so you spend only USDC: no ALGO on Algorand, no ETH on Base.
  4. The API answers with the result and a payment receipt.

The official x402 clients handle all of this. Pricing & payment covers the details and has a client example.

The x402 payment flow on Algorand, using the web search API as an example: request, 402 offer, signing, retry, result, and who pays what

Why no API keys

Section titled “Why no API keys”

An agent can find the API, read the price from the 402 response and pay, all without a human. You don’t need a sign-up, a key to rotate or a monthly plan. You pay only for requests that deliver a result.

APIs and prices

Section titled “APIs and prices”
API Route Price Pay on
Web search POST / GET /v1/search 0.0085 USDC per query on Algorand, 0.009 on Base and Arc Algorand, Base, Arc
Page scrape POST / GET /v1/scrape 0.011 USDC per page on Algorand, 0.012 on Base and Arc Algorand, Base, Arc
Algorand DEX prices GET /v1/prices/{price,history,pairs,pools,candles} 0.001 USDC per call Algorand
Account value GET /v1/prices/account 0.002 USDC per call Algorand
NFT image search GET / POST /v1/images/search, GET /v1/images/similar/{cid} 0.005 USDC per call Algorand

A search that returns nothing isn’t charged. A scrape that fails or hits an HTTP error page isn’t charged either, and neither is a price query that finds no data, an account that was never on chain, or an image search that fails or names an unknown CID.

Free routes

Section titled “Free routes”
Route What it returns
/v1/search/pricing, /v1/scrape/pricing, /v1/prices/pricing, /v1/images/pricing Price, asset, networks and receiving address
/v1/search/health, /v1/prices/health, /v1/images/health, /health Service health
/v1/prices/status How far the price dataset is built
/docs/ Live, interactive API reference
/openapi.json OpenAPI 3.1 description
/.well-known/x402, /llms.txt Machine-readable discovery, see Discovery

Try it

Section titled “Try it”

This request shows the 402 payment offer without paying anything:

Terminal window
curl -si -X POST https://x402.api.nodely.io/v1/search \
  -H 'Content-Type: application/json' \
  -d '{"query":"x402"}'