{ "openapi": "3.0.3", "info": { "title": "Waltsoft AgentAudit API", "version": "2.0.0", "description": "x402 commerce intelligence: on-chain x402 settlements on Base, by seller, buyer and service. Generated Oct 15 2026 from the live API responses (LISTING-FIX-RUNBOOK step 4)." }, "servers": [ { "url": "https://agentaudit.waltsoft.net/v1" } ], "security": [ { "ApiKeyAuth": [] } ], "paths": { "/stats": { "get": { "operationId": "getStats", "summary": "Totals for indexed x402 settlements", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "OK (billed)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Stats" } } } }, "400": { "description": "Invalid parameter (not billed)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Invalid or inactive API key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "No API key sent: x402 payment challenge", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Index or key store temporarily unavailable (not billed)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/trending": { "get": { "operationId": "getTrending", "summary": "x402 services ranked by settlement volume", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "OK (billed)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Trending" } } } }, "400": { "description": "Invalid parameter (not billed)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Invalid or inactive API key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "No API key sent: x402 payment challenge", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Index or key store temporarily unavailable (not billed)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "parameters": [ { "name": "period", "in": "query", "required": false, "description": "24h, 7d, 30d (default), 90d or all", "schema": { "type": "string", "example": "7d" }, "example": "7d" } ] } }, "/flow": { "get": { "operationId": "getFlow", "summary": "Most recent x402 settlements, newest first", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "OK (billed)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Flow" } } } }, "400": { "description": "Invalid parameter (not billed)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Invalid or inactive API key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "No API key sent: x402 payment challenge", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Index or key store temporarily unavailable (not billed)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "parameters": [ { "name": "limit", "in": "query", "required": false, "description": "1-50 (default 20)", "schema": { "type": "integer", "minimum": 1, "maximum": 50, "example": 5 }, "example": 5 } ] } }, "/discover": { "get": { "operationId": "discoverServices", "summary": "Recommended x402 services by category", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "OK (billed)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Discover" } } } }, "400": { "description": "Invalid parameter (not billed)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Invalid or inactive API key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "No API key sent: x402 payment challenge", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Index or key store temporarily unavailable (not billed)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "parameters": [ { "name": "category", "in": "query", "required": false, "description": "Category key or all (default)", "schema": { "type": "string", "example": "all" }, "example": "all" } ] } }, "/seller/{address}": { "get": { "operationId": "getSeller", "summary": "Settlement history for one x402 seller", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "OK (billed)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Seller" } } } }, "400": { "description": "Invalid parameter (not billed)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Invalid or inactive API key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "No API key sent: x402 payment challenge", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found / untracked address (not billed)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Index or key store temporarily unavailable (not billed)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "parameters": [ { "name": "address", "in": "path", "required": true, "description": "Seller address on Base", "schema": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$", "example": "0x589a2314a2e05f45e40c4823da3ba58d421db3d8" }, "example": "0x589a2314a2e05f45e40c4823da3ba58d421db3d8" } ] } }, "/buyer/{address}": { "get": { "operationId": "getBuyer", "summary": "What one buyer paid x402 sellers", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "OK (billed)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Buyer" } } } }, "400": { "description": "Invalid parameter (not billed)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Invalid or inactive API key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "No API key sent: x402 payment challenge", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found / untracked address (not billed)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Index or key store temporarily unavailable (not billed)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "parameters": [ { "name": "address", "in": "path", "required": true, "description": "Buyer address on Base", "schema": { "type": "string", "pattern": "^0x[0-9a-fA-F]{40}$", "example": "0x9c89686aa0d039a56374960ccbcdfbb2062120fc" }, "example": "0x9c89686aa0d039a56374960ccbcdfbb2062120fc" } ] } }, "/receipt": { "post": { "operationId": "verifyReceipts", "summary": "Verify Base transactions as x402 settlements", "security": [ { "ApiKeyAuth": [] } ], "responses": { "200": { "description": "OK (billed)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Receipt" } } } }, "400": { "description": "Invalid parameter (not billed)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Invalid or inactive API key", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "402": { "description": "No API key sent: x402 payment challenge", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "503": { "description": "Index or key store temporarily unavailable (not billed)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "tx_hashes" ], "properties": { "tx_hashes": { "type": "array", "minItems": 1, "maxItems": 20, "items": { "type": "string", "pattern": "^0x[0-9a-fA-F]{64}$" } } } }, "example": { "tx_hashes": [ "0xbe1e15b44ccc2b382e88e67de5132ffb042a11ef9ff363c253c777711be31fb1" ] } } } } } } }, "components": { "securitySchemes": { "ApiKeyAuth": { "type": "apiKey", "in": "header", "name": "X-API-Key" } }, "schemas": { "Stats": { "type": "object", "required": [ "chain", "chains_indexed", "total_settlements", "total_volume_usd", "avg_price_usd", "unique_buyers", "active_sellers", "tracked_sellers", "catalog_base_resources", "catalog_refreshed_at", "first_settlement", "last_settlement", "indexed_from", "indexed_through", "self_payments", "excluded_plain_transfers", "index_frequency", "leaderboards_refresh", "coverage", "timestamp" ], "properties": { "chain": { "type": "string" }, "chains_indexed": { "type": "array", "items": { "type": "string" } }, "total_settlements": { "type": "integer" }, "total_volume_usd": { "type": "number" }, "avg_price_usd": { "type": "number" }, "unique_buyers": { "type": "integer" }, "active_sellers": { "type": "integer" }, "tracked_sellers": { "type": "integer" }, "catalog_base_resources": { "type": "integer" }, "catalog_refreshed_at": { "type": "string" }, "first_settlement": { "type": "string" }, "last_settlement": { "type": "string" }, "indexed_from": { "type": "string" }, "indexed_through": { "type": "string" }, "self_payments": { "type": "object", "required": [ "settlements", "volume_usd", "note" ], "properties": { "settlements": { "type": "integer" }, "volume_usd": { "type": "number" }, "note": { "type": "string" } } }, "excluded_plain_transfers": { "type": "object", "required": [ "count", "volume_usd", "note" ], "properties": { "count": { "type": "integer" }, "volume_usd": { "type": "number" }, "note": { "type": "string" } } }, "index_frequency": { "type": "string" }, "leaderboards_refresh": { "type": "string" }, "coverage": { "type": "string" }, "timestamp": { "type": "string" } } }, "Trending": { "type": "object", "required": [ "period", "chain", "window_start", "indexed_through", "board_generated_at", "total_settlements", "total_volume_usd", "active_sellers", "tracked_sellers", "trending_services", "ranked_by", "note", "coverage", "timestamp" ], "properties": { "period": { "type": "string" }, "chain": { "type": "string" }, "window_start": { "type": "string" }, "indexed_through": { "type": "string" }, "board_generated_at": { "type": "string" }, "total_settlements": { "type": "integer" }, "total_volume_usd": { "type": "number" }, "active_sellers": { "type": "integer" }, "tracked_sellers": { "type": "integer" }, "trending_services": { "type": "array", "items": { "type": "object", "required": [ "seller", "service_name", "domain", "categories", "listed", "settlements", "volume_usd", "avg_price_usd", "unique_buyers" ], "properties": { "seller": { "type": "string" }, "service_name": { "type": "string" }, "domain": { "type": "string" }, "categories": { "type": "array", "items": { "type": "string" } }, "listed": { "type": "boolean" }, "settlements": { "type": "integer" }, "volume_usd": { "type": "number" }, "avg_price_usd": { "type": "number" }, "unique_buyers": { "type": "integer" } } } }, "ranked_by": { "type": "string" }, "note": { "type": "string" }, "coverage": { "type": "string" }, "timestamp": { "type": "string" } } }, "Flow": { "type": "object", "required": [ "count", "chain", "order", "updated_at", "indexed_through", "settlements", "timestamp" ], "properties": { "count": { "type": "integer" }, "chain": { "type": "string" }, "order": { "type": "string" }, "updated_at": { "type": "string" }, "indexed_through": { "type": "string" }, "settlements": { "type": "array", "items": { "type": "object", "required": [ "tx_hash", "log_index", "seller", "service_name", "buyer", "amount_usd", "block", "timestamp" ], "properties": { "tx_hash": { "type": "string" }, "log_index": { "type": "integer" }, "seller": { "type": "string" }, "service_name": { "type": "string" }, "buyer": { "type": "string" }, "amount_usd": { "type": "number" }, "block": { "type": "integer" }, "timestamp": { "type": "string" } } } }, "timestamp": { "type": "string" } } }, "Discover": { "type": "object", "required": [ "category", "chain", "ranked_by", "window_start", "indexed_through", "board_generated_at", "sellers_in_category", "recommendations", "categories", "note", "timestamp" ], "properties": { "category": { "type": "string" }, "chain": { "type": "string" }, "ranked_by": { "type": "string" }, "window_start": { "type": "string" }, "indexed_through": { "type": "string" }, "board_generated_at": { "type": "string" }, "sellers_in_category": { "type": "integer" }, "recommendations": { "type": "array", "items": { "type": "object", "required": [ "seller", "service", "domain", "categories", "listed", "settlements_30d", "volume_usd_30d", "avg_price_usd", "unique_buyers_30d", "catalog_calls_30d" ], "properties": { "seller": { "type": "string" }, "service": { "type": "string" }, "domain": { "type": "string" }, "categories": { "type": "array", "items": { "type": "string" } }, "listed": { "type": "boolean" }, "settlements_30d": { "type": "integer" }, "volume_usd_30d": { "type": "number" }, "avg_price_usd": { "type": "number" }, "unique_buyers_30d": { "type": "integer" }, "catalog_calls_30d": { "type": "integer" } } } }, "categories": { "type": "array", "items": { "type": "string" } }, "note": { "type": "string" }, "timestamp": { "type": "string" } } }, "Seller": { "type": "object", "required": [ "address", "chain", "label", "domain", "domains", "categories", "listed_in_bazaar", "catalog", "tracked_since", "total_settlements", "total_volume_usd", "avg_price_usd", "unique_buyers", "first_settlement", "last_settlement", "top_buyer_share", "top_buyers", "top_buyers_complete", "revenue_trend", "indexed_from", "indexed_through", "note", "timestamp" ], "properties": { "address": { "type": "string" }, "chain": { "type": "string" }, "label": { "type": "string" }, "domain": { "type": "string" }, "domains": { "type": "array", "items": { "type": "string" } }, "categories": { "type": "array", "items": { "type": "string" } }, "listed_in_bazaar": { "type": "boolean" }, "catalog": { "type": "object", "required": [ "resources", "calls_30d", "payers_30d", "last_called", "first_seen" ], "properties": { "resources": { "type": "integer" }, "calls_30d": { "type": "integer" }, "payers_30d": { "type": "integer" }, "last_called": { "type": "string" }, "first_seen": { "type": "string" } } }, "tracked_since": { "type": "string" }, "total_settlements": { "type": "integer" }, "total_volume_usd": { "type": "number" }, "avg_price_usd": { "type": "number" }, "unique_buyers": { "type": "integer" }, "first_settlement": { "type": "string" }, "last_settlement": { "type": "string" }, "top_buyer_share": { "type": "number" }, "top_buyers": { "type": "array", "items": { "type": "object", "required": [ "buyer", "settlements", "volume_usd", "first", "last" ], "properties": { "buyer": { "type": "string" }, "settlements": { "type": "integer" }, "volume_usd": { "type": "number" }, "first": { "type": "string" }, "last": { "type": "string" } } } }, "top_buyers_complete": { "type": "boolean" }, "revenue_trend": { "type": "array", "items": { "type": "object", "required": [ "date", "settlements", "volume_usd" ], "properties": { "date": { "type": "string" }, "settlements": { "type": "integer" }, "volume_usd": { "type": "number" } } } }, "indexed_from": { "type": "string" }, "indexed_through": { "type": "string" }, "note": { "type": "string" }, "timestamp": { "type": "string" } } }, "Buyer": { "type": "object", "required": [ "address", "chain", "operator_wallet", "total_transactions", "total_spend_usd", "unique_sellers", "first_tx", "last_tx", "sellers", "sellers_complete", "indexed_from", "indexed_through", "timestamp" ], "properties": { "address": { "type": "string" }, "chain": { "type": "string" }, "operator_wallet": { "type": "boolean" }, "total_transactions": { "type": "integer" }, "total_spend_usd": { "type": "number" }, "unique_sellers": { "type": "integer" }, "first_tx": { "type": "string" }, "last_tx": { "type": "string" }, "sellers": { "type": "array", "items": { "type": "object", "required": [ "seller", "service_name", "domain", "settlements", "volume_usd", "first", "last" ], "properties": { "seller": { "type": "string" }, "service_name": { "type": "string" }, "domain": { "type": "string" }, "settlements": { "type": "integer" }, "volume_usd": { "type": "number" }, "first": { "type": "string" }, "last": { "type": "string" } } } }, "sellers_complete": { "type": "boolean" }, "indexed_from": { "type": "string" }, "indexed_through": { "type": "string" }, "timestamp": { "type": "string" } } }, "Receipt": { "type": "object", "required": [ "total_spend_usd", "settled_count", "transactions", "by_service", "chain", "verification", "timestamp" ], "properties": { "total_spend_usd": { "type": "number" }, "settled_count": { "type": "integer" }, "transactions": { "type": "array", "items": { "type": "object", "required": [ "tx", "status", "block", "timestamp", "transfers" ], "properties": { "tx": { "type": "string" }, "status": { "type": "string" }, "block": { "type": "integer" }, "timestamp": { "type": "string" }, "transfers": { "type": "array", "items": { "type": "object", "required": [ "kind", "payee", "service", "payer", "amount_usd" ], "properties": { "kind": { "type": "string" }, "payee": { "type": "string" }, "service": { "type": "string" }, "payer": { "type": "string" }, "amount_usd": { "type": "number" } } } } } } }, "by_service": { "type": "object", "additionalProperties": { "type": "number" }, "description": "USD spend per seller domain", "example": { "api-xpay.com": 0.005 } }, "chain": { "type": "string" }, "verification": { "type": "string" }, "timestamp": { "type": "string" } } }, "Error": { "type": "object", "properties": { "error": { "oneOf": [ { "type": "string" }, { "type": "object", "properties": { "code": { "type": "integer" }, "message": { "type": "string" } } } ] } } } } } }