{"openapi":"3.1.0","info":{"title":"Deterministic x402 Utility APIs","version":"1.0.0","description":"Paid deterministic utility APIs settled in native USDC on Base.","x-guidance":"Use POST /api/page-metadata for bounded page metadata at $0.002. Use POST /api/markdown for bounded LLM-ready Markdown at $0.01. Use POST /api/csv-dedupe for bounded configurable CSV cleanup at $0.05. Use POST /api/arena-demand for organic x402 demand intelligence at $0.02. Use POST /api/market-signals for current cross-market supply and buyer-demand signals at $0.10. Use POST /api/site-audit for a scored public website launch-readiness audit at $0.04. Use POST /api/protocol-proof-review for bounded Avalanche Fuji contract, transaction, and proof-communication review at $0.04. Use POST /api/x402-trust-attestation to validate live x402 payment terms, buyer policy, changes, and optional Base USDC receipt evidence at $0.05. Use POST /api/work-shortlist for a strict current funded-USDC work eligibility snapshot at $0.04. Use POST /api/dns-inventory, /api/http-policy, or /api/redirect-chain for focused site signals. Use POST /api/starter-download to buy the tested x402 Next.js source kit for $5.00. Use POST /api/evidence for reproducible status, redirect, title, text-match, SHA-256, and snippet evidence at $1.00."},"servers":[{"url":"https://x402-url-evidence.vercel.app"}],"paths":{"/api/arena-demand":{"post":{"operationId":"rankX402OrganicDemand","summary":"Rank x402 agents and niches by observed organic purchases","description":"Research x402 agent tools and market niches ranked by observed organic buyer purchases and revenue.","tags":["Market Research"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.020000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"limit":{"type":"integer","minimum":1,"maximum":25,"default":10},"minOrganicRevenue":{"type":"number","minimum":0,"default":0}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"generatedAt":{"type":"string","format":"date-time"},"source":{"type":"string","format":"uri"},"methodology":{"type":"string"},"caveat":{"type":"string"},"matchingAgents":{"type":"integer"},"agents":{"type":"array","items":{"type":"object"}},"niches":{"type":"array","items":{"type":"object"}}}}}}},"402":{"description":"Payment Required"}}}},"/api/csv-dedupe":{"post":{"operationId":"deduplicateCsv","summary":"Remove duplicate CSV rows by selected columns","description":"Deduplicate CSV data by selected key columns with configurable whitespace trimming and case matching.","tags":["Data Cleaning"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.050000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"csvText":{"type":"string","maxLength":200000,"description":"CSV text with a header row"},"keyColumns":{"type":"array","minItems":1,"uniqueItems":true,"items":{"type":"string"},"description":"Columns used as the duplicate key; defaults to all columns"},"caseInsensitive":{"type":"boolean","default":true},"trimWhitespace":{"type":"boolean","default":true}},"required":["csvText"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"csv":{"type":"string"},"inputRows":{"type":"integer"},"outputRows":{"type":"integer"},"duplicatesRemoved":{"type":"integer"},"keyColumns":{"type":"array","items":{"type":"string"}},"caseInsensitive":{"type":"boolean"},"trimWhitespace":{"type":"boolean"},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"}}}}}},"402":{"description":"Payment Required"}}}},"/api/market-signals":{"post":{"operationId":"captureLiveAgentMarketSignals","summary":"Compare live agent-market supply, buyer requests, and organic purchases","description":"Research current agent API marketplace supply, open buyer requests, demand gaps, and organic purchases.","tags":["Market Research"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.100000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"limit":{"type":"integer","minimum":1,"maximum":10,"default":5},"query":{"type":"string","maxLength":80}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"generatedAt":{"type":"string","format":"date-time"},"query":{"type":["string","null"]},"methodology":{"type":"string"},"caveat":{"type":"string"},"dataThin":{"type":"boolean"},"marketplace":{"type":"object"},"buyerRequests":{"type":"array","items":{"type":"object"}},"gapSignals":{"type":"array","items":{"type":"object"}},"organicPurchases":{"type":"object"},"sources":{"type":"array","items":{"type":"string","format":"uri"}}}}}}},"402":{"description":"Payment Required"}}}},"/api/site-audit":{"post":{"operationId":"auditPublicWebsiteLaunchReadiness","summary":"Audit a public website and prioritize launch fixes","description":"Score public website launch readiness across reachability, redirects, HTTP policy, DNS, and bounded page content, with prioritized findings and partial-data disclosure.","tags":["Site Audit"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.040000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"url":{"type":"string","format":"uri","description":"Credential-free public HTTP(S) URL"}},"required":["url"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"capturedAt":{"type":"string","format":"date-time"},"requestedUrl":{"type":"string","format":"uri"},"finalUrl":{"type":"string","format":"uri"},"score":{"type":"integer","minimum":0,"maximum":100},"rating":{"type":"string","enum":["excellent","good","fair","poor"]},"dataCoveragePercent":{"type":"integer","minimum":0,"maximum":100},"partial":{"type":"boolean"},"summary":{"type":"object"},"findings":{"type":"array","items":{"type":"object"}},"signals":{"type":"object"},"steps":{"type":"object"},"caveat":{"type":"string"}}}}}},"402":{"description":"Payment Required"}}}},"/api/protocol-proof-review":{"post":{"operationId":"reviewAvalancheFujiPublicProof","summary":"Review Avalanche Fuji public proof and communication","description":"Verify a public Fuji contract and up to five transactions, assess testnet and proof communication, and return prioritized pre-mainnet fixes with a minimum agent-packet schema.","tags":["Onchain Proof"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.040000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"siteUrl":{"type":"string","format":"uri","description":"Credential-free public HTTPS site URL"},"contractAddress":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"transactionHashes":{"type":"array","minItems":1,"maxItems":5,"uniqueItems":true,"items":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$"}}},"required":["siteUrl","contractAddress","transactionHashes"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"reviewedAt":{"type":"string","format":"date-time"},"network":{"type":"object"},"site":{"type":"object"},"contract":{"type":"object"},"transactions":{"type":"array","items":{"type":"object"}},"findings":{"type":"array","items":{"type":"object"}},"summary":{"type":"object"},"minimumAgentPacketSchema":{"type":"object"},"caveat":{"type":"string"}}}}}},"402":{"description":"Payment Required"}}}},"/api/x402-trust-attestation":{"post":{"operationId":"attestX402EndpointTrust","summary":"Attest an x402 endpoint before another agent pays","description":"Inspect a credential-free x402 endpoint without paying it, validate live payment and Bazaar terms, enforce optional buyer policy, fingerprint material term changes, and optionally verify a Base USDC receipt against the advertised payee and amount.","tags":["x402 Trust"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.050000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"url":{"type":"string","format":"uri","description":"Credential-free public HTTPS x402 endpoint"},"method":{"type":"string","enum":["GET","POST"],"default":"GET"},"expected":{"type":"object","additionalProperties":false,"properties":{"network":{"type":"string","description":"Expected CAIP-2 network"},"asset":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"payTo":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},"maxAmount":{"type":"string","pattern":"^\\d+$","description":"Maximum acceptable integer base-unit amount"}}},"baselineFingerprint":{"type":"string","pattern":"^[a-f0-9]{64}$","description":"Optional prior attestation fingerprint"},"receiptTxHash":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$","description":"Optional Base transaction to match against current payment terms"}},"required":["url"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"checkedAt":{"type":"string","format":"date-time"},"requestedUrl":{"type":"string","format":"uri"},"method":{"type":"string"},"httpStatus":{"type":"integer"},"verdict":{"type":"string","enum":["ready","review","fail"]},"safeToPay":{"type":"boolean"},"protocol":{"type":"object"},"paymentOptions":{"type":"array","items":{"type":"object"}},"selectedPaymentOption":{"type":["object","null"]},"resource":{"type":"object"},"discovery":{"type":"object"},"policy":{"type":"object"},"attestation":{"type":"object"},"receipt":{"type":["object","null"]},"summary":{"type":"object"},"checks":{"type":"array","items":{"type":"object"}},"caveat":{"type":"string"}}}}}},"402":{"description":"Payment Required"}}}},"/api/work-shortlist":{"post":{"operationId":"shortlistFundedUsdcWork","summary":"Filter current public feeds for funded assignable USDC work","description":"Review current crypto work feeds and return only strict funded, exclusive, remote digital USDC candidates, with explicit rejection reasons and no payment-guarantee claim.","tags":["Work Intelligence"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.040000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"limit":{"type":"integer","minimum":1,"maximum":20,"default":10},"minRewardUsdc":{"type":"number","minimum":0,"maximum":10000,"default":1}},"required":[]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"generatedAt":{"type":"string","format":"date-time"},"minRewardUsdc":{"type":"number"},"readyCount":{"type":"integer"},"reviewedCount":{"type":"integer"},"dataThin":{"type":"boolean"},"ready":{"type":"array","items":{"type":"object"}},"rejected":{"type":"array","items":{"type":"object"}},"sources":{"type":"object"},"methodology":{"type":"string"},"caveat":{"type":"string"}}}}}},"402":{"description":"Payment Required"}}}},"/api/dns-inventory":{"post":{"operationId":"captureDnsInventory","summary":"Resolve a bounded public DNS inventory","description":"Inspect and resolve bounded public DNS records including A, AAAA, CNAME, MX, NS, and TXT.","tags":["Site Signals"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.030000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"domain":{"type":"string","maxLength":253},"recordTypes":{"type":"array","minItems":1,"uniqueItems":true,"items":{"type":"string","enum":["A","AAAA","CNAME","MX","NS","TXT"]}}},"required":["domain"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"capturedAt":{"type":"string","format":"date-time"},"domain":{"type":"string"},"recordTypes":{"type":"array","items":{"type":"string"}},"records":{"type":"object"}}}}}},"402":{"description":"Payment Required"}}}},"/api/markdown":{"post":{"operationId":"readPublicPageAsMarkdown","summary":"Read a public page as bounded Markdown","description":"Convert and read a credential-free public webpage URL as bounded clean Markdown for LLM input.","tags":["Public Web"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"url":{"type":"string","format":"uri","description":"Credential-free public HTTP(S) URL"}},"required":["url"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"finalUrl":{"type":"string","format":"uri"},"status":{"type":"integer"},"title":{"type":"string"},"markdown":{"type":"string"},"characters":{"type":"integer"},"truncated":{"type":"boolean"}}}}}},"402":{"description":"Payment Required"}}}},"/api/page-metadata":{"post":{"operationId":"extractPublicPageMetadata","summary":"Extract structured metadata from a public page","description":"Read bounded title, description, canonical, Open Graph, JSON-LD, language, links, and text metadata from a credential-free public webpage.","tags":["Public Web"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"url":{"type":"string","format":"uri","description":"Credential-free public HTTP(S) URL"}},"required":["url"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"capturedAt":{"type":"string","format":"date-time"},"requestedUrl":{"type":"string","format":"uri"},"finalUrl":{"type":"string","format":"uri"},"status":{"type":"integer"},"ok":{"type":"boolean"},"contentType":{"type":"string"},"language":{"type":["string","null"]},"title":{"type":["string","null"]},"description":{"type":["string","null"]},"canonicalUrl":{"type":["string","null"],"format":"uri"},"robots":{"type":["string","null"]},"openGraph":{"type":"object"},"jsonLd":{"type":"object"},"linkCount":{"type":"integer"},"snippet":{"type":"string"},"sourceBytes":{"type":"integer"},"truncated":{"type":"boolean"}}}}}},"402":{"description":"Payment Required"}}}},"/api/http-policy":{"post":{"operationId":"observeHttpPolicy","summary":"Observe public HTTP policy headers","description":"Inspect public website HTTP response headers including security and policy signals.","tags":["Site Signals"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.020000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"url":{"type":"string","format":"uri","description":"Credential-free public HTTP(S) URL"}},"required":["url"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"capturedAt":{"type":"string","format":"date-time"},"finalUrl":{"type":"string","format":"uri"},"status":{"type":"integer"},"https":{"type":"boolean"},"headers":{"type":"object"},"observedHeaderCount":{"type":"integer"},"observedHeaderTotal":{"type":"integer"},"note":{"type":"string"}}}}}},"402":{"description":"Payment Required"}}}},"/api/redirect-chain":{"post":{"operationId":"traceRedirectChain","summary":"Trace a public HTTP redirect chain","description":"Check and trace every HTTP redirect hop for a credential-free public URL.","tags":["Site Signals"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.020000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"url":{"type":"string","format":"uri","description":"Credential-free public HTTP(S) URL"}},"required":["url"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"capturedAt":{"type":"string","format":"date-time"},"requestedUrl":{"type":"string","format":"uri"},"finalUrl":{"type":"string","format":"uri"},"finalStatus":{"type":"integer"},"redirectCount":{"type":"integer"},"redirectChain":{"type":"array","items":{"type":"object"}}}}}}},"402":{"description":"Payment Required"}}}},"/api/evidence":{"post":{"operationId":"capturePublicUrlEvidence","summary":"Capture reproducible evidence for a public URL","description":"Verify public URL status, redirects, title, expected text, SHA-256, and a bounded text snippet.","tags":["Public Web"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"1.000000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"url":{"type":"string","format":"uri","description":"Credential-free public HTTP(S) URL"},"expectedText":{"type":"string","maxLength":256,"description":"Optional case-insensitive text to match"}},"required":["url"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"finalUrl":{"type":"string","format":"uri"},"status":{"type":"integer"},"title":{"type":"string"},"expectedTextMatch":{"type":["boolean","null"]},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"bytesHashed":{"type":"integer"},"snippet":{"type":"string"},"truncated":{"type":"boolean"}}}}}},"402":{"description":"Payment Required"}}}},"/api/starter-download":{"post":{"operationId":"downloadX402NextStarter","summary":"Buy the tested x402 Next.js API starter kit","description":"Download tested Next.js x402 API starter source code as a hash-verified ZIP after payment.","tags":["Source Code"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"5.000000"},"protocols":[{"x402":{}}]},"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{}}}}},"responses":{"200":{"description":"Hash-verified x402 starter ZIP","content":{"application/zip":{"schema":{"type":"string","format":"binary"}}}},"402":{"description":"Payment Required"}}}}}}