Skip to content

x402node/x402node-site

Repository files navigation

x402node

Developer & Data Tools for AI Agents — built for autonomous payments

Pay-per-call APIs designed for AI agents: precise, deterministic tools an LLM can't guess — on-chain data, crypto, parsing, conversion, text, generation and more. Built on the x402 protocol — settled in USDC on Base, no accounts, no API keys, no subscriptions.

🌐 Live: x402node.dev 📂 Full catalog (live manifest): api.x402node.dev/.well-known/x402-manifest.json

What's inside

150+ endpoints across 30+ categories. A sample:

Group Examples
Chain data /chain/tx-decode, /chain/base-gas
Crypto /crypto/random-bytes, hashing, encoding
Dev utilities /dev/uuid, /generate/password, /generate/color-palette
Parsing & convert /url/*, /convert/*, /text/lorem
Validation & math /validate/*, /math/*
Time /time/timezone-convert
Supply-chain / security /supply/ioc-list, /supply/ioc-scan
Search /search/news

The live manifest above is the authoritative, always-current list with prices.

Quick Start (JS / TypeScript)

npm i x402-fetch viem
import { wrapFetchWithPayment } from "x402-fetch";
import { createWalletClient, http } from "viem";
import { privateKeyToAccount } from "viem/accounts";
import { base } from "viem/chains";

const account = privateKeyToAccount("0xYOUR_KEY");
const wallet  = createWalletClient({ account, chain: base, transport: http() });
const pay     = wrapFetchWithPayment(fetch, wallet);

const r = await pay("https://api.x402node.dev/chain/tx-decode?tx=0x...");
console.log(await r.json());   // 402 -> auto-sign EIP-3009 -> 200 + data

Any x402-capable client or agent works — the protocol is plain HTTP.

How payment works

The server returns 402 Payment Required with the payment terms; your client signs an EIP-3009 authorization; the Coinbase CDP facilitator settles on Base; the request is fulfilled — end to end in about a second. The agent simply pays per call.

These endpoints are paid programmatically. Opening one in a browser and trying to pay by hand won't complete — use an x402 client or an x402-capable agent.

Links

Sister project

cn402 — Chinese metaphysics & almanac data for AI agents, same x402 rails.

About

Developer & data tools for AI agents — pay-per-call over x402, settled in USDC on Base. No accounts, no API keys.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors