Skip to content

x402 pay-per-call APIs

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. You don’t need an account, a sign-up or an API key.

  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 transfer and sends the same request again with the signed payment attached.
  4. The API answers with the result and the payment’s transaction id.

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

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.

API Route Price
Web search POST / GET /v1/search 0.01 USDC per query
Page scrape POST / GET /v1/scrape 0.01 USDC per page

A search that returns nothing isn’t charged. A scrape that fails or hits an HTTP error page isn’t charged either. More APIs are coming, starting with historical Algorand asset prices.

Route What it returns
/v1/search/pricing, /v1/scrape/pricing Price, asset, networks and receiving address
/v1/search/health, /health Service health
/docs/ Live, interactive API reference
/openapi.json OpenAPI 3.1 description
/.well-known/x402, /llms.txt Machine-readable discovery, see Discovery

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"}'