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

Settlement audit trail — Ed25519-signed PDF (tx_hash, facilitator, endpoint, amount, signature). POST /v1/_audit/:txHash

/v1/_audit

Validation · pdf-lib + @noble/curves/ed25519

Request → Response

Examples from schemas.json.

Requestapplication/json

POST /v1/_audit
Content-Type: application/json

{}

Responseapplication/json

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

// Endpoint-specific body after 402 settlement

Overview

Settlement audit trail — Ed25519-signed PDF (tx_hash, facilitator, endpoint, amount, signature). POST /v1/_audit/:txHash.

Request schema

Empty JSON body

IMPLEMENTATION

import requests

# Step 1: POST → 402 quote, pay USDC, retry with X-Payment
r = requests.post(
    "https://api.tools402.dev/v1/_audit",
    json={}
)
print(r.status_code, r.text[:500])

402 payment flow omitted — see Integrations for settlement.