Developer documentation

Build with the
x402 Tools Hub

36 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:

Request — call the endpoint. The server answers 402 Payment Required with the exact payment terms (amount, asset, receiving address).
Pay — sign a USDC transfer on base via the x402 facilitator. Micropayments cost fractions of a cent.
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 · Full tool catalog — all 36 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

curl -X POST https://x402-tools-hub.ivanbenks7-e96.workers.dev/api/402-probe \
  -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

curl -X POST https://x402-tools-hub.ivanbenks7-e96.workers.dev/api/agent-health \
  -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

curl -X POST https://x402-tools-hub.ivanbenks7-e96.workers.dev/api/agent-passport \
  -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

curl -X POST https://x402-tools-hub.ivanbenks7-e96.workers.dev/api/agent-registry \
  -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

curl -X POST https://x402-tools-hub.ivanbenks7-e96.workers.dev/api/flight-recorder \
  -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

curl -X POST https://x402-tools-hub.ivanbenks7-e96.workers.dev/api/merchant-trust \
  -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

curl -X POST https://x402-tools-hub.ivanbenks7-e96.workers.dev/api/payment-decoder \
  -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

curl -X POST https://x402-tools-hub.ivanbenks7-e96.workers.dev/api/receipt-notary \
  -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

curl -X POST https://x402-tools-hub.ivanbenks7-e96.workers.dev/api/well-known \
  -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

curl -X POST https://x402-tools-hub.ivanbenks7-e96.workers.dev/api/json-studio \
  -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

curl -X POST https://x402-tools-hub.ivanbenks7-e96.workers.dev/api/address-toolkit \
  -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

curl -X POST https://x402-tools-hub.ivanbenks7-e96.workers.dev/api/base-gas -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

curl -X POST https://x402-tools-hub.ivanbenks7-e96.workers.dev/api/token-inspector \
  -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

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

Response (HTTP 200)

{
  "ok": true,
  "data": {
    "id": "ETH",
    "vs": "USD",
    "price": 2800.42,
    "change_24h": 1.24,
    "source": "coingecko",
    "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

curl -X POST https://x402-tools-hub.ivanbenks7-e96.workers.dev/api/wallet-intel \
  -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

curl -X POST https://x402-tools-hub.ivanbenks7-e96.workers.dev/api/url-metadata \
  -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

curl -X POST https://x402-tools-hub.ivanbenks7-e96.workers.dev/api/web-markdown \
  -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

curl -X POST https://x402-tools-hub.ivanbenks7-e96.workers.dev/api/token-counter \
  -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

curl -X POST https://x402-tools-hub.ivanbenks7-e96.workers.dev/api/ai-incidents   -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

curl -X POST https://x402-tools-hub.ivanbenks7-e96.workers.dev/api/hn-news   -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
    }
  ]
}

36✕

X Searchx-search$0.001 USDCweb: free

Recent X/Twitter mentions and news by keyword — agent launches, token drama, AI agent incidents.

POST /api/x-search browser tool →

Request

curl -X POST https://x402-tools-hub.ivanbenks7-e96.workers.dev/api/x-search   -d '{"query":"x402 micropayments","limit":5}'

Response (HTTP 200)

{
  "ok": true,
  "query": "x402 micropayments (twitter OR x)",
  "items": [
    {
      "title": "AI agents now pay per API call on Base via x402",
      "url": "https://news.google.com/rss/articles/...",
      "source": "CoinDesk",
      "published": "Fri, 25 Sep 2026 12:00:00 GMT"
    }
  ]
}

3 · Machine-readable discovery

Agents and directories can consume the hub without scraping HTML:

/api/list — full tool catalog (name, path, price, description, free_for_humans).
/openapi.json — OpenAPI 3.1 spec of every endpoint.
/llms.txt — LLM-friendly text catalog (Markdown).
/.well-known/agent.json — agent manifest (schema_version, payment protocol, tools).
/.well-known/x402 — x402 discovery resource.
/api/stats — live on-chain payment telemetry (public, free).

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.

Build with thex402 Tools Hub

1 · How agents pay (x402)

2 · Full tool catalog — all 36 tools

Trust Layer

Data

Text

Encode / Decode

Crypto

Web / HTTP

Regex

Time

Color / Design

Converters

Git

AI / LLM

Security

SEO / Meta

News / Social

3 · Machine-readable discovery

4 · FAQ

Do I need an account or API key?

What does a call cost?

Which network and asset?

Is the browser tool really free?

How does my agent discover the tools automatically?

What if a call returns 402?

Build with the
x402 Tools Hub