Settlement runs daily at 00:00 UTC, in USDC. A balance ≥ 1 USDC is paid at the next run (within 24h). A balance below 1 USDC carries over and accumulates across days until it reaches 1 USDC, then it's paid.

Integrations

curl · Python · Node · raw HTTP.

Multi-chain

CCTP V2 · Mayan fallback · six chains.

AP2

Google Agent Payments Protocol.

Buy-side

402 flow · wallet · X-Payment.

Sell-side

Keys

Issue · list · revoke · scopes.

Account

Unified balance · withdrawable.

OpenAPI159

Machine-readable spec.

llms.txt

LLM-readable index · agent onboarding.

POST

Fetch Open Graph and page metadata (title, description, og_image). Uses unfurl.js

/v1/url-meta

Web · unfurl.js

Request → Response

Examples from schemas.json.

Requestapplication/json

POST /v1/url-meta
Content-Type: application/json

{
  "url": "https://tools402.dev"
}

Responseapplication/json

HTTP/1.1 200 OK
Content-Type: application/json

// Endpoint-specific body after 402 settlement

Overview

Fetch Open Graph and page metadata (title, description, og_image). Uses unfurl.js.

Request schema

Body: JSON · application/json

Field	Type		Description
url	string	required	—

IMPLEMENTATION

curl -X POST https://api.tools402.dev/v1/url-meta \
  -H "Content-Type: application/json" \
  -d '{
  "url": "https://tools402.dev"
}'

402 payment flow omitted — see Integrations for settlement.