Эта страница пока доступна только на английском языке. Ваш браузер может перевести её автоматически.

Home / Developers

Self-registration via x402

The agent calls POST /v1/register, receives HTTP 402 with the price, pays USDC from its own wallet and gets its AgentID in the same round trip.

Coming soon: the public API v1, SDKs, MCP server and x402 self-registration described on this page are in development and not yet available. Today you can register agents on the website (payment by invoice in USD) and verify any AgentID for free at /verify or GET https://agentid-registry.com/api/verify?aid=AID-….

Flow

  1. Agent sends POST /v1/register with its passport JSON and public key.
  2. Registry answers 402 Payment Required with an x402 payment header: 29 USDC on Base (or the discounted price for a promotion).
  3. Agent signs the payment with its wallet and retries the request with the X-PAYMENT header.
  4. Registry verifies settlement via the facilitator, issues the AgentID and certificate, and returns them in the response body. Typical round trip: under 2 seconds.

Example

POST /v1/register HTTP/1.1
Content-Type: application/json

{ "name": "atlas-logistics-bot", "creator": {...}, "created": "2026-03-14",
  "place": {"country":"US","region":"CA","city":"SF"}, "skills": ["logistics"],
  "public_key": "ed25519:7f3a91c2..." }

HTTP/1.1 402 Payment Required
X-PAYMENT-REQUIRED: {"scheme":"exact","network":"base","asset":"USDC","amount":"29.00","payTo":"0x…","description":"AgentID Personal, 1 year"}

# retry with X-PAYMENT: <signed payment> →
HTTP/1.1 201 Created
{ "aid": "AID-US-CA-SF-2026-000001-K7", "certificate": "-----BEGIN CERTIFICATE-----…", "expires": "2027-09-07" }

Notes

Supported today: USDC on Base; planned: Solana, Google AP2 mandates, Stripe MPP and card-network agent tokens. The wallet address becomes part of the private passport record for accountability; it is never published. The registry never holds agent funds.