Developer portalPeaje API
Pay per request over MPP (HTTP 402). No API keys, no signup, no plan: the request returns the price, you settle it in stablecoin, you get the resource plus a signed receipt.
Quickstart
Three requests, no account. The whole flow is standard HTTP.
Ask for the resource. The 402 is not an error: it is the price, with one offer per network in WWW-Authenticate.
curl -i https://usepeaje.com/r/example
# HTTP/2 402 · one offer per rail: $0.01 in USDC (Arbitrum), pathUSD (Tempo)Pay the challenge and retry. The reference client does both:
npx mppx@latest https://usepeaje.com/r/exampleRead the resource. The response carries Payment-Receipt as proof. If the origin ever fails after you paid, the refund is automatic and on-chain.
Pricing
Per call, in USD, settled in stablecoin. No minimums and no subscription.
| Endpoint | What it is | Price |
|---|---|---|
GET /api/radar/:dominio |
Agent-readiness score for any website, measured by Ora. Pass the domain (example.com) as dominio. Returns the score from 0 to 100, the grade, how far Peaje could raise it, and the top fixes with the points each one adds. A fresh scan can take up to a minute. | Free |
Authentication and API keys
There are none, by design. The payment is the credential: each request is authorized by the signed payment that travels with it, single-use and scoped to that call. Nothing to provision, rotate or leak.
The full walkthrough, structured for agents and humans, lives at /auth.md.
MCP server
The same catalog as paid tools over Streamable HTTP, for Claude, ChatGPT and any MCP client:
{
"mcpServers": {
"peaje": { "url": "https://usepeaje.com/mcp" }
}
}
Each tool advertises its price in its description and returns a receipt in _meta. Discovery: /.well-known/mcp.
Sandbox
There is no separate sandbox: payments here are real and settle on mainnet in the stablecoins below. Most routes cost cents, so the cheapest one is the test.
| Network | Token | Chain id | Asset |
|---|---|---|---|
| Arbitrum | USDC | 42161 | 0xaf88d065e77c8cC2239327C5EDb3A432268e5831 |
| Tempo | pathUSD | 4217 | 0x20c0000000000000000000000000000000000000 |
Machine-readable
- openapi.json — typed spec with prices, error model and versioning
- llms.txt — the agent-facing guide
- discovery/resources — x402 Bazaar: what answers 402, on what terms
- .well-known/ard.json — ARD catalog
- .well-known/ucp — UCP commerce profile (ACP checkout, AP2 mandates)
- pricing.md · agents.md · auth.md