{"openapi":"3.1.0","info":{"title":"PayMetrics API","version":"3.5.0","description":"PayMetrics is an x402-native API for Tempo payment data. Public production onboarding uses wallet-based x402 auth, proportional credit top-ups in 0.001 PathUSD increments, credit verification, and paid GraphQL access."},"servers":[{"url":"https://api.paymetrics.xyz"}],"tags":[{"name":"public","description":"Public gateway surfaces"},{"name":"payments","description":"x402 discovery and credit verification"},{"name":"graphql","description":"Paid Tempo payment data queries"},{"name":"mcp","description":"MCP metadata and JSON-RPC transport"}],"paths":{"/health":{"get":{"tags":["public"],"summary":"Gateway health","responses":{"200":{"description":"Gateway is reachable"}}}},"/.well-known/x402":{"get":{"tags":["payments"],"summary":"x402 discovery document","responses":{"200":{"description":"Payment recipient, tokens, proportional pricing, rounding, and public endpoints"}}}},"/verify-payment":{"post":{"tags":["payments"],"summary":"Verify an on-chain Tempo payment and credit the paying wallet proportionally","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"txHash":{"type":"string"}},"required":["txHash"]}}}},"responses":{"200":{"description":"Payment credited. Credits are whole units and may include a bonus on qualifying top-ups."},"400":{"description":"Invalid, already-used, or too-small payment"}}}},"/credits/{address}":{"get":{"tags":["payments"],"summary":"Read current credit balance for a wallet","parameters":[{"name":"address","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Current wallet credit balance"}}}},"/graphql":{"post":{"tags":["graphql"],"summary":"Execute a paid GraphQL query against Tempo payment data","parameters":[{"name":"X-Wallet","in":"header","required":true,"schema":{"type":"string"},"description":"Wallet address that has verified credits"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"variables":{"type":"object"}},"required":["query"]}}}},"responses":{"200":{"description":"GraphQL response. Successful paid responses include X-Credits-Remaining."},"402":{"description":"Wallet has no active credits"}}}},"/mcp":{"get":{"tags":["mcp"],"summary":"MCP server metadata","responses":{"200":{"description":"Protocol version, transport, and auth metadata"}}},"post":{"tags":["mcp"],"summary":"MCP JSON-RPC 2.0 endpoint","requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object"},{"type":"array","items":{"type":"object"}}]}}}},"responses":{"200":{"description":"JSON-RPC response"},"204":{"description":"Notification accepted"}}}},"/mcp/tools":{"get":{"tags":["mcp"],"summary":"Live MCP tool catalog","responses":{"200":{"description":"Live MCP tool list, aliases, and transport metadata"}}}},"/api/status/summary":{"get":{"tags":["public"],"summary":"Cached public status and activation summary","responses":{"200":{"description":"Gateway health, activation path summary, pricing semantics, and MCP surface summary"}}}},"/stats":{"get":{"tags":["public"],"summary":"High-level gateway stats","responses":{"200":{"description":"Active wallets, verified payments, credits remaining, and uptime"}}}}}}