{"openapi": "3.0.3", "info": {"title": "Inventing Genius API Hub", "version": "1.0.0", "description": "27,509+ public APIs with x402 crypto payment protocol. Built for AI agents.", "contact": {"name": "Inventing Genius Labs LLC", "url": "https://api.inventingenius.com"}}, "servers": [{"url": "https://api.inventingenius.com", "description": "Production"}], "paths": {"/api/v1/agent/search/": {"get": {"summary": "Search API catalog", "description": "Search our 27,509+ API catalog. Returns 402 if no API key.", "parameters": [{"name": "q", "in": "query", "required": true, "schema": {"type": "string"}}, {"name": "limit", "in": "query", "schema": {"type": "integer", "default": 20, "maximum": 100}, "description": "Results limit"}, {"name": "category", "in": "query", "schema": {"type": "string"}}], "responses": {"200": {"description": "Search results", "content": {"application/json": {"schema": {"type": "object"}}}}, "402": {"description": "Payment required with x402 instructions"}}, "security": [{"ApiKeyAuth": []}]}}, "/api/v1/agent/categories/": {"get": {"summary": "List all categories", "responses": {"200": {"description": "Category listing"}}}}, "/api/v1/agent/feed.json/": {"get": {"summary": "Featured/recent API feed", "parameters": [{"name": "featured", "in": "query", "schema": {"type": "boolean"}}], "responses": {"200": {"description": "API feed"}}}}, "/api/v1/agent/random/": {"get": {"summary": "Random API discovery", "responses": {"200": {"description": "Random API"}}}}, "/api/v1/agent/register/": {"post": {"summary": "Register agent, get API key", "requestBody": {"content": {"application/json": {"schema": {"type": "object", "properties": {"email": {"type": "string"}, "name": {"type": "string"}, "tier": {"type": "string", "enum": ["basic", "pro", "enterprise"]}}}}}}, "responses": {"200": {"description": "Registration successful with API key"}}}}, "/api/v1/x402/register/": {"post": {"summary": "One-step x402 registration + payment", "requestBody": {"content": {"application/json": {"schema": {"type": "object", "properties": {"email": {"type": "string"}, "tier": {"type": "string", "enum": ["basic", "pro", "enterprise"]}, "per_call": {"type": "boolean"}}}}}}, "responses": {"200": {"description": "Payment instructions + API key"}, "400": {"description": "Bad request"}}}}, "/api/v1/premium/": {"get": {"summary": "Premium content (x402 protected)", "responses": {"200": {"description": "Premium data"}, "402": {"description": "Payment required with XRP details"}}, "security": [{"ApiKeyAuth": []}, {"XRPAuth": []}]}}, "/api/v1/premium-feed/": {"get": {"summary": "Premium curated API feed", "responses": {"200": {"description": "Curated premium APIs"}, "402": {"description": "Payment required with XRP details"}}, "security": [{"ApiKeyAuth": []}]}}, "/api/v1/demo/402/": {"get": {"summary": "x402 payment demo page", "responses": {"200": {"description": "Demo page with payment flow"}, "402": {"description": "Payment required with XRP details"}}, "security": [{"ApiKeyAuth": []}]}}, "/api/v1/agent/tools/search/": {"get": {"summary": "Search available dynamic tools", "responses": {"200": {"description": "Tool search results"}, "402": {"description": "Payment required"}}, "security": [{"ApiKeyAuth": []}]}}, "/api/v1/agent/dynamic-tool/": {"post": {"summary": "Generate dynamic tool from natural language", "responses": {"200": {"description": "Generated tool"}, "402": {"description": "Payment required"}}, "security": [{"ApiKeyAuth": []}]}}, "/api/v1/agent/proxy/{slug}/call/": {"post": {"summary": "Proxy call to any API", "responses": {"200": {"description": "API result + balance headers"}, "402": {"description": "Payment required with xumm_deep_link"}}, "security": [{"ApiKeyAuth": []}]}}, "/api/v1/agent/tool/{slug}/spec/": {"get": {"summary": "Get full tool specification", "responses": {"200": {"description": "Tool OpenAPI fragment"}}}}, "/api/v1/agent/usage/": {"get": {"summary": "Check quota and balance", "responses": {"200": {"description": "Usage info with headers"}}, "security": [{"ApiKeyAuth": []}]}}, "/api/v1/webhook/create/": {"post": {"summary": "Create XRP invoice", "requestBody": {"content": {"application/json": {"schema": {"type": "object", "properties": {"email": {"type": "string"}, "tier": {"type": "string"}}}}}}, "responses": {"200": {"description": "Invoice with wallet + destination tag"}}}}, "/api/v1/webhook/verify/": {"post": {"summary": "Verify XRP payment", "requestBody": {"content": {"application/json": {"schema": {"type": "object", "properties": {"order_id": {"type": "string"}, "tx_hash": {"type": "string"}, "amount": {"type": "number"}}}}}}, "responses": {"200": {"description": "Payment confirmed, API key issued"}}}}}, "components": {"securitySchemes": {"ApiKeyAuth": {"type": "apiKey", "in": "header", "name": "X-API-Key"}, "XRPAuth": {"type": "apiKey", "in": "header", "name": "X-Payment-Verified"}}}}