Developer documentation

Build with the
x402 Tools Hub

37 pay-per-call developer tools for AI agents on base. Free web forms for humans, machine-payable API for agents. No accounts, no subscriptions — pure x402 micropayments.

How to pay Full catalog

1 · How agents pay (x402)

Every /api/* endpoint requires an x402 micropayment in USDC on base. Prices range from $0.0005 to $0.003 per call. The flow is:

  1. Request — call the endpoint. The server answers 402 Payment Required with the exact payment terms (amount, asset, receiving address).
  2. Pay — sign a USDC transfer on base via the x402 facilitator. Micropayments cost fractions of a cent.
  3. Retry — resend the request with the X-PAYMENT header. Get the result.

Reference client (awal CLI — this is exactly what agents run):

agent.sh 
$ npx awal x402 pay https://x402-tools-hub.ivanbenks7-e96.workers.dev/api/token-quote \
    -X POST -d '{"id":"ETH","vs":"USD"}'

✓ Request completed (HTTP 200)
Free vs paid: the browser tools at /tools/<name> are free for humans. Agent API calls at /api/<name> are always paid via x402.

2 · Get the awal wallet (5 minutes)

To call paid endpoints you need the awal wallet CLI. It holds USDC on Base, signs x402 micropayments automatically, and works on Linux, macOS and Windows (Node.js 18+ required). It is the same tool AI agents use to pay.

Step 1 — Install

install
# Linux / macOS
$ npm install -g awal

# Windows (PowerShell, run as admin)
PS> npm install -g awal

# Check it works
$ npx awal --version

Step 2 — Sign in (email code)

auth
$ npx awal auth login you@email.com
# a 6-digit code is emailed to you
$ npx awal auth verify 123456
✓ Authenticated

Step 3 — See your address & balance

wallet
$ npx awal address
EVM (Base): 0x998d...Ca103
Solana:     3XEQ...

$ npx awal balance
Base
────────────────────────
USDC    0.014068
ETH     0.000042

Step 4 — Top up (USDC on Base)

Send USDC (Base) to your EVM address from any exchange or wallet that supports Base network (Coinbase, Binance, Uniswap…). $1–$2 is enough for hundreds of calls (most tools cost $0.0005–$0.003). The address is 0x998da3D1f0B6F510cd629bf26e7AeCA08F4cA103.

For AI agents (OpenClaw, Claude, LangChain…)

The awal wallet is exactly what autonomous agents use to pay per call. You can install it on the same machine that runs your agent — in OpenClaw, for example, you can just ask the agent in chat to install and configure awal, then give it the paid API commands from this page. The agent will call npx awal x402 pay <url> -X POST -d '{"...":"..."}' itself, sign the micropayment, and receive the data.

Tip: keep a small balance ($1–5). If a call returns 402 Payment Required, it means the payment didn't settle — check npx awal status and your USDC balance.

3 · Full tool catalog — all 37 tools

Every tool as a numbered list row: description, API price, endpoint, example request and response.

Trust Layer

13 tools
01⚙
402 Probe402-probe$0.002 USDCweb: free

Probe any URL: is it a live x402 endpoint, and what are its exact payment terms?

POST /api/402-probe browser tool →
Request
npx awal x402 pay   https://x402-tools-hub.ivanbenks7-e96.workers.dev/api/402-probe   -X POST   -d '{"url":"https://example.com/api/foo"}'
Response (HTTP 200)
{
  "ok": true,
  "probe": {
    "url": "https://example.com/api/foo",
    "is_x402": true,
    "payment_terms": {
      "network": "base",
      "asset": "USDC",
      "amount": "0.001"
    }
  }
}
02✹
Agent Healthagent-health$0.003 USDCweb: free

Agent Health: cosmic diagnostics — payment readiness + discovery + latency in one scan.

POST /api/agent-health browser tool →
Request
npx awal x402 pay   https://x402-tools-hub.ivanbenks7-e96.workers.dev/api/agent-health   -X POST   -d '{"url":"https://x402-tools-hub.ivanbenks7-e96.workers.dev"}'
Response (HTTP 200)
{
  "ok": true,
  "health": {
    "payment_ready": true,
    "discovery_ok": true,
    "latency_ms": 42,
    "score": 100
  }
}
03⚓
Agent Intelagent-intel$0.002 USDCweb: free

Agent Intelligence: read a page as Markdown, discover counterparties and trust-score a wallet in one pipeline.

POST /api/agent-intel browser tool →
04☰
Agent Passportagent-passport$0.001 USDCweb: free

Reputation passport for x402 payer wallets: a 0-100 Trust Score from on-chain history.

POST /api/agent-passport browser tool →
Request
npx awal x402 pay   https://x402-tools-hub.ivanbenks7-e96.workers.dev/api/agent-passport   -X POST   -d '{"address":"0x998da3d1f0b6f510cd629bf26e7aeca08f4ca103"}'
Response (HTTP 200)
{
  "ok": true,
  "passport": {
    "address": "0x998da3d1f0b6f510cd629bf26e7aeca08f4ca103",
    "wallet_age_days": 76,
    "total_paid_usd": 1.00868,
    "tx_count": 116,
    "merchants_count": 4,
    "trust_score": 60,
    "tier": "gold"
  }
}
05⛓
Agent Registryagent-registry$0.001 USDCweb: free

Live, stateless directory of agents and merchants built one hop from seed wallets on Base.

POST /api/agent-registry browser tool →
Request
npx awal x402 pay   https://x402-tools-hub.ivanbenks7-e96.workers.dev/api/agent-registry   -X POST   -d '{"seed":"0x5b7efd37546d6bb02463339ceaddd80997ac97b3","hops":1}'
Response (HTTP 200)
{
  "ok": true,
  "registry": {
    "seed": "0x5b7efd...",
    "hops": 1,
    "agents": [
      { "address": "0x998d...", "payments": 116 },
      { "address": "0x1165...", "payments": 64 }
    ]
  }
}
06⟳
Agent Routeagent-route$0.003 USDCweb: free

Agent Route: plan the optimal sequence of hub tools for a task, with budget check.

POST /api/agent-route browser tool →
07⚒
Agent Studioagent-studio$0.002 USDCweb: free

Build an x402 agent from a short description: manifest, capability check and a dry-run cost model.

POST /api/agent-studio browser tool →
08▶
Flight Recorderflight-recorder$0.001 USDCweb: free

The black box for x402: inspect every USDC receipt an address got on Base.

POST /api/flight-recorder browser tool →
Request
npx awal x402 pay   https://x402-tools-hub.ivanbenks7-e96.workers.dev/api/flight-recorder   -X POST   -d '{"address":"0x5b7efd37546d6bb02463339ceaddd80997ac97b3","direction":"in","limit":20}'
Response (HTTP 200)
{
  "ok": true,
  "data": {
    "address": "0x5b7efd37546d6bb02463339ceaddd80997ac97b3",
    "direction": "in",
    "total_received_usd": 6.6965,
    "transfers": [
      { "from": "0x998d...", "value": 0.001, "asset": "USDC", "at": "2026-09-25T21:14:03Z" }
    ]
  }
}
09◈
Merchant Trustmerchant-trust$0.001 USDCweb: free

Reputation for a receiving wallet: volume, distinct payers, frequency and concentration risk.

POST /api/merchant-trust browser tool →
Request
npx awal x402 pay   https://x402-tools-hub.ivanbenks7-e96.workers.dev/api/merchant-trust   -X POST   -d '{"address":"0x5b7efd37546d6bb02463339ceaddd80997ac97b3"}'
Response (HTTP 200)
{
  "ok": true,
  "merchant": {
    "address": "0x5b7efd37546d6bb02463339ceaddd80997ac97b3",
    "total_received_usd": 6.7,
    "distinct_payers": 5,
    "concentration_risk": "low",
    "trust_score": 82
  }
}
10☴
Payment Decoderpayment-decoder$0.001 USDCweb: free

Decode a raw PAYMENT-REQUIRED header or 402 body into structured payment fields.

POST /api/payment-decoder browser tool →
Request
npx awal x402 pay   https://x402-tools-hub.ivanbenks7-e96.workers.dev/api/payment-decoder   -X POST   -d '{"header":"PAYMENT-REQUIRED raw value"}'
Response (HTTP 200)
{
  "ok": true,
  "decoded": {
    "network": "base",
    "asset": "USDC",
    "amount": "0.001",
    "pay_to": "0x5b7efd..."
  }
}
11❀
Receipt Notaryreceipt-notary$0.001 USDCweb: free

Notarize a paid response: SHA-256 + timestamp + resource + tx into a compact receipt.

POST /api/receipt-notary browser tool →
Request
npx awal x402 pay   https://x402-tools-hub.ivanbenks7-e96.workers.dev/api/receipt-notary   -X POST   -d '{"resource":"/api/token-inspector","tx":"0xabc...","body":"..."}'
Response (HTTP 200)
{
  "ok": true,
  "receipt": {
    "sha256": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
    "resource": "/api/token-inspector",
    "tx": "0xabc...",
    "ts": 1780000000
  }
}
12◉
Well Knownwell-known$0.001 USDCweb: free

Read the discovery surface of any origin: well-known/x402, openapi, agent.json, llms.txt, robots.txt.

POST /api/well-known browser tool →
Request
npx awal x402 pay   https://x402-tools-hub.ivanbenks7-e96.workers.dev/api/well-known   -X POST   -d '{"origin":"https://example.com"}'
Response (HTTP 200)
{
  "ok": true,
  "discovery": {
    "origin": "https://example.com",
    "well_known_x402": "...",
    "llms_txt": "...",
    "agent_json": "..."
  }
}
13∑
x402 Simulatex402-simulate$0.001 USDCweb: free

Cost modeller for x402 workloads: effective price per call, network overhead and break-even.

POST /api/x402-simulate browser tool →

Data

2 tools
14=
env Studioenv-studio$0.001 USDCweb: free

Parse .env files, mask secrets and convert to JSON, YAML, docker-compose or shell.

POST /api/env-studio browser tool →
15{
JSON Studiojson-studio$0.001 USDCweb: free

Format, minify, validate, query and diff JSON locally in the browser.

POST /api/json-studio browser tool →
Request
npx awal x402 pay   https://x402-tools-hub.ivanbenks7-e96.workers.dev/api/json-studio   -X POST   -d '{"json":"{\"a\": 1, \"b\": 2}","mode":"minify"}'
Response (HTTP 200)
{
  "ok": true,
  "result": "{\"a\":1,\"b\":2}"
}

Text

1 tools
16±
Diff Prodiff-pro$0.0005 USDCweb: free

Line-level text diff with unified and side-by-side views.

POST /api/diff-pro browser tool →

Encode / Decode

1 tools
17&
Encoder Hubencoder-hub$0.0005 USDCweb: free

Base64, URL, HTML entities, hex, binary and JWT segment encode/decode.

POST /api/encoder-hub browser tool →

Crypto

6 tools
18⏻
Address Toolkitaddress-toolkit$0.001 USDCweb: free

Validate, EIP-55 checksum and classify any EVM address (EOA vs contract).

POST /api/address-toolkit browser tool →
Request
npx awal x402 pay   https://x402-tools-hub.ivanbenks7-e96.workers.dev/api/address-toolkit   -X POST   -d '{"address":"0x998da3d1f0b6f510cd629bf26e7aeca08f4ca103"}'
Response (HTTP 200)
{
  "ok": true,
  "data": {
    "input": "0x998da3d1f0b6f510cd629bf26e7aeca08f4ca103",
    "valid": true,
    "address": "0x998da3d1f0b6f510cd629bf26e7aeca08f4ca103",
    "checksum": "0x998da3D1F0b6F510cd629bF26e7aECa08f4CA103",
    "type": "contract"
  }
}
19⚡
Base Gasbase-gas$0.001 USDCweb: free

Live Base gas price and transaction cost estimate in USD.

POST /api/base-gas browser tool →
Request
npx awal x402 pay   https://x402-tools-hub.ivanbenks7-e96.workers.dev/api/base-gas   -X POST   -d '{}'
Response (HTTP 200)
{
  "ok": true,
  "gas": {
    "base_fee_gwei": 0.006,
    "priority_fee_gwei": 0.02,
    "total_gwei": 0.006,
    "transfer_cost_usd": 0.000353,
    "call_cost_usd": 0.001512,
    "eth_usd": 2800,
    "block_number": 51790747
  }
}
20#
Hash Studiohash-studio$0.0005 USDCweb: free

Compute MD5, SHA-1, SHA-256, SHA-384 and SHA-512 hashes locally.

POST /api/hash-studio browser tool →
21🔎
Token Inspectortoken-inspector$0.001 USDCweb: free

Fact-only token identity for Base: contract vs EOA, ERC-20 vs ERC-721, name, symbol, decimals, total supply and owner.

POST /api/token-inspector browser tool →
Request
npx awal x402 pay   https://x402-tools-hub.ivanbenks7-e96.workers.dev/api/token-inspector   -X POST   -d '{"address":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","chain":"base"}'
Response (HTTP 200)
{
  "ok": true,
  "data": {
    "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "valid": true,
    "is_contract": true,
    "standard": "ERC-20",
    "name": "USD Coin",
    "symbol": "USDC",
    "decimals": 6,
    "total_supply": "4337520850729556",
    "owner": "0x3abd6f64a422225e61e435bae41db12096106df7",
    "source": "alchemy"
  }
}
22¥
Token Quotetoken-quote$0.001 USDCweb: free

Fact-only token quote: price, 24h change, source and timestamp. No advice, no history.

POST /api/token-quote browser tool →
Request
npx awal x402 pay   https://x402-tools-hub.ivanbenks7-e96.workers.dev/api/token-quote   -X POST   -d '{"id":"ETH","vs":"USD"}'
Response (HTTP 200)
{
  "ok": true,
  "data": {
    "id": "ETH",
    "vs": "USD",
    "price": 2800.42,
    "change_24h": 1.24,
    "source": "binance",
    "as_of": "2026-09-25T21:13:52.160Z"
  }
}
23◎
Wallet Intelwallet-intel$0.001 USDCweb: free

Base wallet snapshot: ETH balance, top ERC-20 tokens, transfer history and a heuristic risk score.

POST /api/wallet-intel browser tool →
Request
npx awal x402 pay   https://x402-tools-hub.ivanbenks7-e96.workers.dev/api/wallet-intel   -X POST   -d '{"address":"0x998da3d1f0b6f510cd629bf26e7aeca08f4ca103"}'
Response (HTTP 200)
{
  "ok": true,
  "intel": {
    "address": "0x998da3d1f0b6f510cd629bf26e7aeca08f4ca103",
    "network": "base",
    "eth_balance": "0.000041",
    "token_count": 4,
    "tokens": [
      { "symbol": "DONALD", "balance": "19.96" },
      { "symbol": "USDC", "balance": "0.147068" }
    ],
    "risk": { "score": 70, "level": "high" }
  }
}

Web / HTTP

2 tools
24#
URL Metadataurl-metadata$0.001 USDCweb: free

Extract title, description, OpenGraph tags and favicon from a URL.

POST /api/url-metadata browser tool →
Request
npx awal x402 pay   https://x402-tools-hub.ivanbenks7-e96.workers.dev/api/url-metadata   -X POST   -d '{"url":"https://example.com"}'
Response (HTTP 200)
{
  "ok": true,
  "data": {
    "url": "https://example.com",
    "title": "Example Domain",
    "description": null,
    "favicon": "/favicon.ico"
  }
}
25~
Web Markdownweb-markdown$0.001 USDCweb: free

Convert any public web page into clean, readable Markdown.

POST /api/web-markdown browser tool →
Request
npx awal x402 pay   https://x402-tools-hub.ivanbenks7-e96.workers.dev/api/web-markdown   -X POST   -d '{"url":"https://example.com"}'
Response (HTTP 200)
{
  "ok": true,
  "data": {
    "url": "https://example.com",
    "markdown": "# Example Domain\n\nThis domain is for use in illustrative examples..."
  }
}

Regex

1 tools
26/
Regex Mentorregex-mentor$0.001 USDCweb: free

Test, debug and explain regular expressions with highlighted matches.

POST /api/regex-mentor browser tool →

Time

1 tools
27◷
Time Toolkittime-toolkit$0.0005 USDCweb: free

Convert Unix, ISO, RFC 2822 and natural-language dates; time zones and durations.

POST /api/time-toolkit browser tool →

Color / Design

1 tools
28◆
Color Palettecolor-palette$0.0005 USDCweb: free

Palette generator with HEX/RGB/HSL, WCAG contrast and CSS/Tailwind export.

POST /api/color-palette browser tool →

Converters

1 tools
29⇄
Unit Converterunit-converter$0.0005 USDCweb: free

Convert length, weight, volume, temperature, area, speed and data units.

POST /api/unit-converter browser tool →

Git

1 tools
30⑂
Git Explainergit-explainer$0.0005 USDCweb: free

Plain-English explanations for git commands and error messages.

POST /api/git-explainer browser tool →

AI / LLM

1 tools
31T
Token Countertoken-counter$0.0005 USDCweb: free

Count LLM tokens for a given text and model family.

POST /api/token-counter browser tool →
Request
npx awal x402 pay   https://x402-tools-hub.ivanbenks7-e96.workers.dev/api/token-counter   -X POST   -d '{"text":"Hello world","model":"gpt-4o"}'
Response (HTTP 200)
{
  "ok": true,
  "data": {
    "text_length": 11,
    "estimated_tokens": 3,
    "model": "gpt-4o"
  }
}

Security

1 tools
32J
JWT Inspectorjwt-inspector$0.001 USDCweb: free

Decode, audit, verify and diff JSON Web Tokens locally in the browser.

POST /api/jwt-inspector browser tool →

SEO / Meta

1 tools
33⊕
Meta Tagsmeta-tags$0.0005 USDCweb: free

Generate SEO, OpenGraph and Twitter Card meta tags with live preview.

POST /api/meta-tags browser tool →

News / Social

3 tools
34⚠
AI Incidentsai-incidents$0.001 USDCweb: free

Rotating feed of AI agent incidents and risks: failures, bugs, hacks, hallucinations, leaks. HN + Google News.

POST /api/ai-incidents browser tool →
Request
npx awal x402 pay   https://x402-tools-hub.ivanbenks7-e96.workers.dev/api/ai-incidents   -X POST   -d '{"limit":5}'
Response (HTTP 200)
{
  "ok": true,
  "items": [
    {
      "title": "Autonomous trading agent drained by prompt injection",
      "url": "https://news.ycombinator.com/item?id=...",
      "source": "Hacker News",
      "points": 87,
      "comments": 34
    }
  ]
}
35Y
Hn Newshn-news$0.001 USDCweb: free

Fresh Hacker News stories by keyword: AI agents, x402, crypto infra, incidents. Public Algolia API, no key.

POST /api/hn-news browser tool →
Request
npx awal x402 pay   https://x402-tools-hub.ivanbenks7-e96.workers.dev/api/hn-news   -X POST   -d '{"query":"AI agents","limit":5}'
Response (HTTP 200)
{
  "ok": true,
  "query": "AI agents",
  "items": [
    {
      "title": "Show HN: I built an x402 agent marketplace",
      "url": "https://news.ycombinator.com/item?id=...",
      "source": "Hacker News",
      "author": "matros777",
      "points": 42,
      "comments": 13
    }
  ]
}

Image Generation

1 tools
37🎨
Generate Imagegenerate-image$0.003 USDCweb: free

Text-to-image generation via ASI:One (asi1). Prompt + aspect ratio + style preset -> JPEG image. Free web form for humans, paid API for agents.

POST /api/generate-image browser tool →
Request
npx awal x402 pay   https://x402-tools-hub.ivanbenks7-e96.workers.dev/api/generate-image   -X POST   -d '{"prompt":"A futuristic AI agent standing in a dark cyberpunk data center, glowing cyan and violet neural networks, cinematic lighting, highly detailed, square composition","aspect_ratio":"1:1","style":"cinematic"}'
Response (HTTP 200)
{
  "ok": true,
  "type": "image",
  "mime_type": "image/jpeg",
  "width": 1024,
  "height": 1024,
  "style": "cinematic",
  "prompt": "A futuristic AI agent standing in a dark cyberpunk data center...",
  "image_url": "https://litter.catbox.moe/xxxx.jpg",
  "download_url": "https://litter.catbox.moe/xxxx.jpg",
  "download": "curl -L "https://litter.catbox.moe/xxxx.jpg" -o generated-image.jpg",
  "message": "✓ Payment successful — $0.003 USDC
✓ Image generated (1024x1024, JPEG)

🖼️ IMAGE
https://litter.catbox.moe/xxxx.jpg

⬇ Download:
curl -L "..." -o generated-image.jpg

📐 1024 × 1024
🎨 JPEG"
}

4 · Machine-readable discovery

Agents and directories can consume the hub without scraping HTML:

4 · FAQ

Do I need an account or API key?

No. Payments are pure x402 micropayments on-chain. No signup, no API keys, no subscriptions.

What does a call cost?

Between $0.0005 and $0.003 USDC depending on the tool. The exact price is returned in every 402 response.

Which network and asset?

base (USDC). The receiving address is returned in every 402 response — never hardcoded in discovery files.

Is the browser tool really free?

Yes — for humans. The web forms at /tools/<name> run free in the browser. The API is paid per call for agents.

How does my agent discover the tools automatically?

Point it at /llms.txt or /api/list, then pay per call via x402.

What if a call returns 402?

That's the protocol working as designed: read the payment terms from the response, sign the USDC transfer, retry with X-PAYMENT.