{"openapi":"3.1.0","info":{"title":"X402 Data API","version":"1.0.0","description":"Pay-per-request data APIs for AI agents using x402 payments.","contact":{"email":"admin@x402dataapi.com"},"x-guidance":"X402 Data API exposes paid JSON endpoints for autonomous agents that need domain intelligence, TLS reports, mail security, HTTP security header audits, agent accessibility checks and full domain reports.\nUse GET /openapi.json as the canonical discovery contract. Paid POST operations include requestBody schemas, response schemas, HTTP 402 responses and x-payment-info metadata for x402scan.\nCall a paid endpoint without PAYMENT-SIGNATURE first to receive HTTP 402 Payment Required and the PAYMENT-REQUIRED header. Build the x402 payment from that runtime challenge, then retry with PAYMENT-SIGNATURE.\nStatic x-payment-info.price.amount is decimal USD for discovery. Runtime x402 accepts[].amount is encoded in token atomic units for USDC on Base."},"servers":[{"url":"https://api.x402dataapi.com"}],"x-agentcash-guidance":{"llmsTxtUrl":"https://api.x402dataapi.com/llms.txt","catalogUrl":"https://api.x402dataapi.com/.well-known/x402-catalog.json","unauthenticatedProbeExpectedStatus":402},"paths":{"/health":{"get":{"operationId":"health","summary":"Health","description":"Returns current API availability, version, x402 status and timestamp.","tags":["status","monitoring"],"security":[],"responses":{"200":{"description":"Successful JSON response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string"},"name":{"type":"string"},"version":{"type":"string"},"x402":{"type":"object","properties":{"enabled":{"type":"boolean"},"network":{"type":"string"},"currency":{"type":"string"}}},"time":{"type":"string"}}},"examples":{"default":{"value":{"status":"ok","name":"X402 Data API","version":"1.0.0","x402":{"enabled":true,"network":"eip155:8453","currency":"USDC"},"time":"2026-06-29T12:00:00.000Z"}}}}}},"400":{"description":"Validation or target safety error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"5XX":{"description":"Server or scanner error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/pricing":{"get":{"operationId":"pricing","summary":"Pricing","description":"Returns live feature prices, currency, network, TTL and timeout metadata.","tags":["pricing","x402"],"security":[],"responses":{"200":{"description":"Successful JSON response","content":{"application/json":{"schema":{"type":"object","properties":{"currency":{"type":"string"},"network":{"type":"string"},"features":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"price":{"type":"string"},"currency":{"type":"string"}}}}}},"examples":{"default":{"value":{"currency":"USDC","network":"eip155:8453","features":[{"key":"domain_intel","price":"0.005","currency":"USDC"}]}}}}}},"400":{"description":"Validation or target safety error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"5XX":{"description":"Server or scanner error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/capabilities":{"get":{"operationId":"capabilities","summary":"Capabilities","description":"Returns the machine-readable service catalog used by agents and documentation pages.","tags":["catalog","agents"],"security":[],"responses":{"200":{"description":"Successful JSON response","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"x402":{"type":"boolean"},"services":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"endpoint":{"type":"string"},"input_schema":{"type":"object","properties":{"type":{"type":"string"}}}}}}}},"examples":{"default":{"value":{"name":"X402 Data API","x402":true,"services":[{"key":"domain_intel","endpoint":"/v1/domain-intel","input_schema":{"type":"object"}}]}}}}}},"400":{"description":"Validation or target safety error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"5XX":{"description":"Server or scanner error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/domain-intel":{"post":{"operationId":"domain_intel","summary":"Paid x402 Domain Intelligence API","description":"Paid x402 API for AI agents that returns domain intelligence, DNS lookup data, domain risk signals, security posture, WHOIS-like technical data, mail security, TLS, HTTP headers, fingerprinting and AI agent domain analysis for a public domain.","tags":["x402","ai-agents","domain-intelligence","cybersecurity","dns"],"security":[{"paymentSignature":[]}],"parameters":[{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string"},"description":"x402 payment payload. Omit it to receive HTTP 402 Payment Required metadata first."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string","description":"Public domain name to inspect"}},"required":["domain"]},"examples":{"default":{"value":{"domain":"example.com"}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002000"},"protocols":[{"x402":{"version":2,"scheme":"exact","network":"eip155:8453","asset":"USDC","resource":"https://api.x402dataapi.com/v1/domain-intel"}}]},"x-x402":{"required":true,"price":"0.002 USDC","amount":"0.002","asset":"USDC","currency":"USDC","network":"eip155:8453","payment":"HTTP 402 Payment Required","discovery":"CDP Bazaar and x402scan","accepts":[{"scheme":"exact","network":"eip155:8453","amount":"2000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0xE3e597A4698e0Ed0e06F9d9fE513157728FBc28B","maxTimeoutSeconds":300,"extra":{"currency":"USDC","displayAmount":"0.002","resource":"/v1/domain-intel","name":"USD Coin","version":"2"}}],"resource":{"url":"https://api.x402dataapi.com/v1/domain-intel","description":"Paid x402 API for AI agents that returns domain intelligence, DNS lookup data, domain risk signals, security posture, WHOIS-like technical data, mail security, TLS, HTTP headers, fingerprinting and AI agent domain analysis for a public domain.","mimeType":"application/json","serviceName":"X402 Data API","tags":["x402","ai-agents","domain-intelligence","cybersecurity","dns"]}},"responses":{"200":{"description":"Successful JSON response","content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"},"dns":{"type":"object","properties":{}},"mail_security":{"type":"object","properties":{}},"tls":{"type":"object","properties":{}},"http":{"type":"object","properties":{}},"fingerprint":{"type":"object","properties":{}},"risk_score":{"type":"integer"},"summary":{"type":"array","items":{}}}},"examples":{"default":{"value":{"domain":"example.com","dns":{},"mail_security":{},"tls":{},"http":{},"fingerprint":{},"risk_score":0,"summary":[]}}}}}},"400":{"description":"Validation or target safety error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required via x402. Inspect PAYMENT-REQUIRED response header, pay, then retry with PAYMENT-SIGNATURE.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 payment requirements payload.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"5XX":{"description":"Server or scanner error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/tls-report":{"post":{"operationId":"tls_report","summary":"Paid x402 TLS Report API","description":"Paid x402 API for AI agents that checks TLS certificate health, SSL report data, HTTPS certificate expiration, issuer, validity, SAN coverage, chain health, HTTPS readiness and certificate risk for a public hostname.","tags":["x402","ai-agents","tls","ssl","https"],"security":[{"paymentSignature":[]}],"parameters":[{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string"},"description":"x402 payment payload. Omit it to receive HTTP 402 Payment Required metadata first."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"host":{"type":"string","description":"Public hostname to inspect"},"port":{"type":"number","description":"TLS port, usually 443"}},"required":["host"]},"examples":{"default":{"value":{"host":"example.com","port":443}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001000"},"protocols":[{"x402":{"version":2,"scheme":"exact","network":"eip155:8453","asset":"USDC","resource":"https://api.x402dataapi.com/v1/tls-report"}}]},"x-x402":{"required":true,"price":"0.001 USDC","amount":"0.001","asset":"USDC","currency":"USDC","network":"eip155:8453","payment":"HTTP 402 Payment Required","discovery":"CDP Bazaar and x402scan","accepts":[{"scheme":"exact","network":"eip155:8453","amount":"1000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0xE3e597A4698e0Ed0e06F9d9fE513157728FBc28B","maxTimeoutSeconds":300,"extra":{"currency":"USDC","displayAmount":"0.001","resource":"/v1/tls-report","name":"USD Coin","version":"2"}}],"resource":{"url":"https://api.x402dataapi.com/v1/tls-report","description":"Paid x402 API for AI agents that checks TLS certificate health, SSL report data, HTTPS certificate expiration, issuer, validity, SAN coverage, chain health, HTTPS readiness and certificate risk for a public hostname.","mimeType":"application/json","serviceName":"X402 Data API","tags":["x402","ai-agents","tls","ssl","https"]}},"responses":{"200":{"description":"Successful JSON response","content":{"application/json":{"schema":{"type":"object","properties":{"host":{"type":"string"},"port":{"type":"integer"},"tls_enabled":{"type":"boolean"},"issuer":{"type":"string"},"days_remaining":{"type":"integer"},"errors":{"type":"array","items":{}}}},"examples":{"default":{"value":{"host":"example.com","port":443,"tls_enabled":true,"issuer":"Example CA","days_remaining":60,"errors":[]}}}}}},"400":{"description":"Validation or target safety error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required via x402. Inspect PAYMENT-REQUIRED response header, pay, then retry with PAYMENT-SIGNATURE.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 payment requirements payload.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"5XX":{"description":"Server or scanner error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/mail-security":{"post":{"operationId":"mail_security","summary":"Paid x402 Mail Security API","description":"Paid x402 API for AI agents that checks MX records, SPF, DMARC, email security, phishing risk, domain mail configuration and anti-spoofing posture for a public domain.","tags":["x402","ai-agents","mail-security","email-security","mx"],"security":[{"paymentSignature":[]}],"parameters":[{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string"},"description":"x402 payment payload. Omit it to receive HTTP 402 Payment Required metadata first."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string","description":"Public domain name to inspect"}},"required":["domain"]},"examples":{"default":{"value":{"domain":"example.com"}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001000"},"protocols":[{"x402":{"version":2,"scheme":"exact","network":"eip155:8453","asset":"USDC","resource":"https://api.x402dataapi.com/v1/mail-security"}}]},"x-x402":{"required":true,"price":"0.001 USDC","amount":"0.001","asset":"USDC","currency":"USDC","network":"eip155:8453","payment":"HTTP 402 Payment Required","discovery":"CDP Bazaar and x402scan","accepts":[{"scheme":"exact","network":"eip155:8453","amount":"1000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0xE3e597A4698e0Ed0e06F9d9fE513157728FBc28B","maxTimeoutSeconds":300,"extra":{"currency":"USDC","displayAmount":"0.001","resource":"/v1/mail-security","name":"USD Coin","version":"2"}}],"resource":{"url":"https://api.x402dataapi.com/v1/mail-security","description":"Paid x402 API for AI agents that checks MX records, SPF, DMARC, email security, phishing risk, domain mail configuration and anti-spoofing posture for a public domain.","mimeType":"application/json","serviceName":"X402 Data API","tags":["x402","ai-agents","mail-security","email-security","mx"]}},"responses":{"200":{"description":"Successful JSON response","content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"},"spf":{"type":"object","properties":{"present":{"type":"boolean"}}},"dmarc":{"type":"object","properties":{"present":{"type":"boolean"}}},"mx":{"type":"array","items":{}}}},"examples":{"default":{"value":{"domain":"example.com","spf":{"present":true},"dmarc":{"present":true},"mx":[]}}}}}},"400":{"description":"Validation or target safety error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required via x402. Inspect PAYMENT-REQUIRED response header, pay, then retry with PAYMENT-SIGNATURE.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 payment requirements payload.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"5XX":{"description":"Server or scanner error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/http-security":{"post":{"operationId":"http_security","summary":"Paid x402 HTTP Security Headers API","description":"Paid x402 API for AI agents that audits HTTP security headers, HSTS, Content-Security-Policy, X-Frame-Options, Referrer-Policy, Permissions-Policy and web security scan findings for a public URL.","tags":["x402","ai-agents","http-security","security-headers","hsts"],"security":[{"paymentSignature":[]}],"parameters":[{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string"},"description":"x402 payment payload. Omit it to receive HTTP 402 Payment Required metadata first."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"Public http or https URL to inspect"}},"required":["url"]},"examples":{"default":{"value":{"url":"https://example.com"}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002000"},"protocols":[{"x402":{"version":2,"scheme":"exact","network":"eip155:8453","asset":"USDC","resource":"https://api.x402dataapi.com/v1/http-security"}}]},"x-x402":{"required":true,"price":"0.002 USDC","amount":"0.002","asset":"USDC","currency":"USDC","network":"eip155:8453","payment":"HTTP 402 Payment Required","discovery":"CDP Bazaar and x402scan","accepts":[{"scheme":"exact","network":"eip155:8453","amount":"2000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0xE3e597A4698e0Ed0e06F9d9fE513157728FBc28B","maxTimeoutSeconds":300,"extra":{"currency":"USDC","displayAmount":"0.002","resource":"/v1/http-security","name":"USD Coin","version":"2"}}],"resource":{"url":"https://api.x402dataapi.com/v1/http-security","description":"Paid x402 API for AI agents that audits HTTP security headers, HSTS, Content-Security-Policy, X-Frame-Options, Referrer-Policy, Permissions-Policy and web security scan findings for a public URL.","mimeType":"application/json","serviceName":"X402 Data API","tags":["x402","ai-agents","http-security","security-headers","hsts"]}},"responses":{"200":{"description":"Successful JSON response","content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"status":{"type":"integer"},"score":{"type":"integer"},"missing":{"type":"array","items":{}}}},"examples":{"default":{"value":{"url":"https://example.com","status":200,"score":80,"missing":[]}}}}}},"400":{"description":"Validation or target safety error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required via x402. Inspect PAYMENT-REQUIRED response header, pay, then retry with PAYMENT-SIGNATURE.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 payment requirements payload.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"5XX":{"description":"Server or scanner error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/agent-accessibility":{"post":{"operationId":"agent_accessibility","summary":"Paid x402 Agent Accessibility Check API","description":"Paid x402 API for AI agents that checks robots.txt, sitemap availability, llms.txt discovery, AI crawler readiness, agent accessibility and AI scraping compatibility for a public URL.","tags":["x402","ai-agents","agent-accessibility","robots.txt","sitemap"],"security":[{"paymentSignature":[]}],"parameters":[{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string"},"description":"x402 payment payload. Omit it to receive HTTP 402 Payment Required metadata first."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"Public http or https URL to inspect"}},"required":["url"]},"examples":{"default":{"value":{"url":"https://example.com"}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.001000"},"protocols":[{"x402":{"version":2,"scheme":"exact","network":"eip155:8453","asset":"USDC","resource":"https://api.x402dataapi.com/v1/agent-accessibility"}}]},"x-x402":{"required":true,"price":"0.001 USDC","amount":"0.001","asset":"USDC","currency":"USDC","network":"eip155:8453","payment":"HTTP 402 Payment Required","discovery":"CDP Bazaar and x402scan","accepts":[{"scheme":"exact","network":"eip155:8453","amount":"1000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0xE3e597A4698e0Ed0e06F9d9fE513157728FBc28B","maxTimeoutSeconds":300,"extra":{"currency":"USDC","displayAmount":"0.001","resource":"/v1/agent-accessibility","name":"USD Coin","version":"2"}}],"resource":{"url":"https://api.x402dataapi.com/v1/agent-accessibility","description":"Paid x402 API for AI agents that checks robots.txt, sitemap availability, llms.txt discovery, AI crawler readiness, agent accessibility and AI scraping compatibility for a public URL.","mimeType":"application/json","serviceName":"X402 Data API","tags":["x402","ai-agents","agent-accessibility","robots.txt","sitemap"]}},"responses":{"200":{"description":"Successful JSON response","content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string"},"robots":{"type":"object","properties":{}},"sitemap":{"type":"object","properties":{}},"ai_ready":{"type":"boolean"}}},"examples":{"default":{"value":{"url":"https://example.com","robots":{},"sitemap":{},"ai_ready":true}}}}}},"400":{"description":"Validation or target safety error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required via x402. Inspect PAYMENT-REQUIRED response header, pay, then retry with PAYMENT-SIGNATURE.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 payment requirements payload.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"5XX":{"description":"Server or scanner error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/full-domain-report":{"post":{"operationId":"full_domain_report","summary":"Paid x402 Full Domain Report API","description":"Paid x402 API for AI agents that returns a complete domain security report with DNS, TLS, mail security, HTTP headers, AI accessibility, website risk score and consolidated remediation issues for a public domain.","tags":["x402","ai-agents","full-domain-report","domain-security-report","dns"],"security":[{"paymentSignature":[]}],"parameters":[{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string"},"description":"x402 payment payload. Omit it to receive HTTP 402 Payment Required metadata first."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string","description":"Public domain name to inspect"}},"required":["domain"]},"examples":{"default":{"value":{"domain":"example.com"}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.000100"},"protocols":[{"x402":{"version":2,"scheme":"exact","network":"eip155:8453","asset":"USDC","resource":"https://api.x402dataapi.com/v1/full-domain-report"}}]},"x-x402":{"required":true,"price":"0.0001 USDC","amount":"0.0001","asset":"USDC","currency":"USDC","network":"eip155:8453","payment":"HTTP 402 Payment Required","discovery":"CDP Bazaar and x402scan","accepts":[{"scheme":"exact","network":"eip155:8453","amount":"100","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0xE3e597A4698e0Ed0e06F9d9fE513157728FBc28B","maxTimeoutSeconds":300,"extra":{"currency":"USDC","displayAmount":"0.0001","resource":"/v1/full-domain-report","name":"USD Coin","version":"2"}}],"resource":{"url":"https://api.x402dataapi.com/v1/full-domain-report","description":"Paid x402 API for AI agents that returns a complete domain security report with DNS, TLS, mail security, HTTP headers, AI accessibility, website risk score and consolidated remediation issues for a public domain.","mimeType":"application/json","serviceName":"X402 Data API","tags":["x402","ai-agents","full-domain-report","domain-security-report","dns"]}},"responses":{"200":{"description":"Successful JSON response","content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"},"dns":{"type":"object","properties":{}},"tls":{"type":"object","properties":{}},"http":{"type":"object","properties":{}},"mail_security":{"type":"object","properties":{}},"agent_accessibility":{"type":"object","properties":{}}}},"examples":{"default":{"value":{"domain":"example.com","dns":{},"tls":{},"http":{},"mail_security":{},"agent_accessibility":{}}}}}}},"400":{"description":"Validation or target safety error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required via x402. Inspect PAYMENT-REQUIRED response header, pay, then retry with PAYMENT-SIGNATURE.","headers":{"PAYMENT-REQUIRED":{"description":"Base64-encoded x402 payment requirements payload.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"5XX":{"description":"Server or scanner error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/openapi.json":{"get":{"operationId":"openapi","summary":"OpenAPI Contract","description":"Returns the OpenAPI 3.1 discovery contract. This endpoint is public and does not require x402 payment.","tags":["openapi","discovery","agents"],"security":[],"responses":{"200":{"description":"Successful JSON response","content":{"application/json":{"schema":{"type":"object","properties":{"openapi":{"type":"string"},"info":{"type":"object","properties":{"title":{"type":"string"},"version":{"type":"string"}}},"paths":{"type":"object","properties":{}}}},"examples":{"default":{"value":{"openapi":"3.1.0","info":{"title":"X402 Data API","version":"1.0.0"},"paths":{}}}}}}},"400":{"description":"Validation or target safety error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"5XX":{"description":"Server or scanner error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"securitySchemes":{"paymentSignature":{"type":"apiKey","in":"header","name":"PAYMENT-SIGNATURE","description":"x402 payment payload returned by an x402-capable client after reading the HTTP 402 payment challenge."}},"schemas":{"Error":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"},"issues":{"type":"array","items":{"type":"object"}}}},"PaymentRequired":{"type":"object","required":["error","x402Version","accepts"],"properties":{"error":{"type":"string","const":"PAYMENT_REQUIRED"},"message":{"type":"string"},"x402Version":{"type":"integer"},"resource":{"type":"object"},"accepts":{"type":"array","items":{"type":"object"}},"extensions":{"type":"object"}}}}}}