# h402

> Equip your agent with any capability. Pick a route's current default provider once,
> keep that provider pinned until you choose another one, and pay per call from one wallet.
> No keys, no plans, no subscriptions.

h402 is a curated catalog of 147 production-tested APIs an AI agent can pay for by
the call over x402 from a single wallet. Read a task route's `defaultProvider`, store it locally,
and call `/routes/{provider}/{category}/{action}`; change the provider only when you want to.

## Start here
- [Agent skill (SKILL.md)](https://raw.githubusercontent.com/Steemhunt/h402-cli/refs/heads/main/SKILL.md): point your agent at this to onboard end-to-end — it creates a wallet, funds it with Base USDC, and starts calling tools on its own.
- [h402 CLI on GitHub](https://github.com/Steemhunt/h402-cli): install with `npm i -g @h402/cli`.
- [Docs](https://h402-test.hunt.town/docs): human quickstart.

## Catalog (machine-readable)
- [OpenAPI 3.1 spec](https://h402-test.hunt.town/openapi.json): every enabled capability with parameters, price, and x402 payment info.
- [Catalog JSON API](https://h402-test.hunt.town/api/catalog): live capability list with usage stats.
- [Catalog search](https://h402-test.hunt.town/api/catalog/search): find a task by keyword (`?q=`).
- [Agent capability registry](https://h402-test.hunt.town/.well-known/ai-catalog.json): the catalog as an Agentic Resource Discovery (ARD) manifest.

## How a call works
1. Find the task and its current `defaultProvider` in the catalog or OpenAPI spec.
2. Persist that provider and call its pinned route (GET or POST). Free routes respond directly; paid routes first return HTTP 402.
3. For paid routes, pay and retry the same pinned path with the payment header. The response is `{ data, meta?, h402 }`: `data` is provider-native, `meta` is reserved optional envelope metadata, and `h402` carries payment/job metadata. Async routes include `h402.followUp`. Reuse an `idempotency-key` on retries — h402 never double-charges.

## Capabilities
- [Crypto](https://h402-test.hunt.town/catalog?category=crypto): 42 capabilities
- [Web](https://h402-test.hunt.town/catalog?category=web): 10 capabilities
- [Maps](https://h402-test.hunt.town/catalog?category=maps): 9 capabilities
- [People](https://h402-test.hunt.town/catalog?category=people): 3 capabilities
- [Business](https://h402-test.hunt.town/catalog?category=business): 1 capabilities
- [Social](https://h402-test.hunt.town/catalog?category=social): 14 capabilities
- [Weather](https://h402-test.hunt.town/catalog?category=weather): 4 capabilities
- [Finance](https://h402-test.hunt.town/catalog?category=finance): 13 capabilities
- [Domains](https://h402-test.hunt.town/catalog?category=domains): 7 capabilities
- [Security](https://h402-test.hunt.town/catalog?category=security): 5 capabilities
- [Utilities](https://h402-test.hunt.town/catalog?category=utilities): 3 capabilities
- [Research](https://h402-test.hunt.town/catalog?category=research): 4 capabilities
- [AI](https://h402-test.hunt.town/catalog?category=ai): 14 capabilities
- [Travel](https://h402-test.hunt.town/catalog?category=travel): 8 capabilities
- [Predictions](https://h402-test.hunt.town/catalog?category=predictions): 4 capabilities
- [Real Estate](https://h402-test.hunt.town/catalog?category=real-estate): 6 capabilities

## Optional
- [Full machine-readable catalog](https://h402-test.hunt.town/openapi.json): all 147 capabilities with input schemas, prices, and payment networks — skip if a task category above is enough.