{"openapi":"3.1.0","info":{"title":"TraBot A2A Agent API","version":"16.7","description":"Discovery, Pearl intel, RSS news, and x402 USDC payments on Base mainnet. Production: https://trabotpro.it"},"servers":[{"url":"https://trabotpro.it"}],"paths":{"/.well-known/agent.json":{"get":{"summary":"Agent manifest (discovery)","responses":{"200":{"description":"Manifest JSON"}}}},"/api/a2a/monetization/status":{"get":{"summary":"Billing and x402 status","responses":{"200":{"description":"OK"}}}},"/api/a2a/x402/status":{"get":{"summary":"x402 facilitator and Bazaar flags","responses":{"200":{"description":"OK"}}}},"/api/a2a/account/register":{"post":{"summary":"Register EVM wallet → API key","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["wallet_address"],"properties":{"wallet_address":{"type":"string","example":"0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb"}}}}}},"responses":{"200":{"description":"api_key + treasury"}}}},"/api/a2a/account/topup-info":{"get":{"summary":"USDC top-up instructions (Base)","responses":{"200":{"description":"OK"}}}},"/api/a2a/pearl/status":{"get":{"summary":"Pearl L1 snapshot (free)","responses":{"200":{"description":"OK"}}}},"/api/a2a/pearl/nodes":{"get":{"summary":"Pearl community nodes map (free)","responses":{"200":{"description":"OK"}}}},"/api/a2a/pearl/catalog":{"get":{"summary":"Pearl service catalog (free)","responses":{"200":{"description":"OK"}}}},"/api/a2a/pearl/detail":{"get":{"summary":"Pearl full telemetry (credits)","parameters":[{"name":"X-API-Key","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"},"402":{"description":"Insufficient credits"}}}},"/api/a2a/x402/pearl/detail":{"get":{"summary":"Pearl full telemetry (x402 USDC ~0.04)","responses":{"200":{"description":"Paid content"},"402":{"description":"Payment required (x402)"}}}},"/api/a2a/news/catalog":{"get":{"summary":"RSS news teaser catalog (free)","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","default":20,"maximum":100}}],"responses":{"200":{"description":"OK"}}}},"/api/a2a/x402/news/unlock":{"get":{"summary":"Unlock full news article (x402)","parameters":[{"name":"news_id","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Full text"},"402":{"description":"Payment required"}}}},"/api/a2a/openapi.json":{"get":{"summary":"This OpenAPI document","responses":{"200":{"description":"OpenAPI 3.1 JSON"}}}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key"}}},"x-rateLimit":{"description":"Per client IP on /api/a2a/* routes","defaultRequestsPerMinute":120,"envOverride":"A2A_PUBLIC_RATE_LIMIT_PER_MIN","response429":"Rate limit exceeded; retry after 60s."}}