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

Retrieve the top-k most similar items from agent memory for a query, with optional namespace and metadata filter. Backed by Pinecone serverless

/v1/agent/memory/query

Request → Response

Examples from schemas.json.

Requestapplication/json

POST /v1/agent/memory/query
Content-Type: application/json

{
  "query": "latest AI agent payments",
  "top_k": 5
}

Responseapplication/json

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

// Endpoint-specific body after 402 settlement

Overview

Retrieve the top-k most similar items from agent memory for a query, with optional namespace and metadata filter. Backed by Pinecone serverless.

Managed vector database for similarity search and AI memory.

Request schema

Body: JSON · application/json

Field	Type		Description
query	string	required	—
namespace	string	optional	pattern: ^[\w:.-]+$
top_k	integer	required	min: 1
filter	object	optional	—

IMPLEMENTATION

curl -X POST https://api.tools402.dev/v1/agent/memory/query \
  -H "Content-Type: application/json" \
  -d '{
  "query": "latest AI agent payments",
  "top_k": 5
}'

402 payment flow omitted — see Integrations for settlement.