{"openapi":"3.1.0","info":{"title":"Paid Research Verification Agent Network","version":"1.1.0-mainnet","description":"Ten paid research-verification APIs settled in USDC through x402 on Base Mainnet."},"servers":[{"url":"https://red-breeze-8b8c.keenanbooker83.workers.dev","description":"Production Cloudflare Worker"}],"tags":[{"name":"Paid research agents","description":"Per-request x402 research and verification services."}],"paths":{"/verify-citation":{"post":{"operationId":"citationVerification","summary":"Citation Verification Agent","description":"Tests whether a cited public source supports an exact factual claim.","tags":["Paid research agents"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"claim":{"type":"string","minLength":1,"maxLength":4000,"description":"Exact factual claim to test."},"sourceUrl":{"type":"string","minLength":1,"maxLength":2048,"description":"Public URL of the source that allegedly supports the claim."}},"required":["claim","sourceUrl"]},"example":{"claim":"The United States declared war on Japan on December 8, 1941.","sourceUrl":"https://www.archives.gov/milestone-documents/joint-address-to-congress-declaration-of-war-against-japan"}}}},"responses":{"200":{"description":"Paid agent result.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request body.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}},"402":{"description":"Payment required. Inspect the PAYMENT-REQUIRED response header, complete the x402 payment, and repeat the request with PAYMENT-SIGNATURE.","headers":{"PAYMENT-REQUIRED":{"description":"Base64url-encoded x402 payment requirements.","schema":{"type":"string"}}}},"415":{"description":"Unsupported source content type.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}},"422":{"description":"Source retrieval or processing failure.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}},"500":{"description":"Internal processing or configuration failure.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}}},"x-x402":{"scheme":"exact","network":"eip155:8453","asset":"USDC","priceUsd":"0.01","amountBaseUnits":"10000","payTo":"0xFbC4f75278c9F3C901EFaDa9fEB3DE76089Fcb99"}}},"/extract-evidence":{"post":{"operationId":"evidenceExtraction","summary":"Evidence Extraction Agent","description":"Extracts quotations, dates, people, organizations, numbers, and factual evidence from a public source.","tags":["Paid research agents"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"sourceUrl":{"type":"string","minLength":1,"maxLength":2048,"description":"Public URL from which evidence should be extracted."},"focus":{"type":"string","minLength":1,"maxLength":2000,"description":"Optional subject or evidence type to prioritize."}},"required":["sourceUrl"]},"example":{"sourceUrl":"https://www.archives.gov/milestone-documents/joint-address-to-congress-declaration-of-war-against-japan","focus":"Extract direct quotations, dates, people, organizations, and numerical evidence."}}}},"responses":{"200":{"description":"Paid agent result.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request body.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}},"402":{"description":"Payment required. Inspect the PAYMENT-REQUIRED response header, complete the x402 payment, and repeat the request with PAYMENT-SIGNATURE.","headers":{"PAYMENT-REQUIRED":{"description":"Base64url-encoded x402 payment requirements.","schema":{"type":"string"}}}},"415":{"description":"Unsupported source content type.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}},"422":{"description":"Source retrieval or processing failure.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}},"500":{"description":"Internal processing or configuration failure.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}}},"x-x402":{"scheme":"exact","network":"eip155:8453","asset":"USDC","priceUsd":"0.02","amountBaseUnits":"20000","payTo":"0xFbC4f75278c9F3C901EFaDa9fEB3DE76089Fcb99"}}},"/compare-claims":{"post":{"operationId":"claimComparison","summary":"Claim Comparison Agent","description":"Compares two factual claims and their sources for agreement, contradiction, and missing context.","tags":["Paid research agents"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"claimA":{"type":"string","minLength":1,"maxLength":4000,"description":"First factual claim."},"sourceUrlA":{"type":"string","minLength":1,"maxLength":2048,"description":"Public source URL for the first claim."},"claimB":{"type":"string","minLength":1,"maxLength":4000,"description":"Second factual claim."},"sourceUrlB":{"type":"string","minLength":1,"maxLength":2048,"description":"Public source URL for the second claim."}},"required":["claimA","sourceUrlA","claimB","sourceUrlB"]},"example":{"claimA":"Japan attacked Pearl Harbor on December 7, 1941.","sourceUrlA":"https://www.archives.gov/milestone-documents/joint-address-to-congress-declaration-of-war-against-japan","claimB":"Congress approved a declaration of war against Japan on December 8, 1941.","sourceUrlB":"https://www.senate.gov/about/images/documents/sjres116-wwii-japan.htm"}}}},"responses":{"200":{"description":"Paid agent result.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request body.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}},"402":{"description":"Payment required. Inspect the PAYMENT-REQUIRED response header, complete the x402 payment, and repeat the request with PAYMENT-SIGNATURE.","headers":{"PAYMENT-REQUIRED":{"description":"Base64url-encoded x402 payment requirements.","schema":{"type":"string"}}}},"415":{"description":"Unsupported source content type.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}},"422":{"description":"Source retrieval or processing failure.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}},"500":{"description":"Internal processing or configuration failure.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}}},"x-x402":{"scheme":"exact","network":"eip155:8453","asset":"USDC","priceUsd":"0.03","amountBaseUnits":"30000","payTo":"0xFbC4f75278c9F3C901EFaDa9fEB3DE76089Fcb99"}}},"/score-source":{"post":{"operationId":"sourceCredibility","summary":"Source Credibility Agent","description":"Evaluates observable source credibility, transparency, evidence quality, bias signals, and limitations.","tags":["Paid research agents"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"sourceUrl":{"type":"string","minLength":1,"maxLength":2048,"description":"Public source URL to evaluate."},"context":{"type":"string","minLength":1,"maxLength":2000,"description":"Optional intended use or factual context."}},"required":["sourceUrl"]},"example":{"sourceUrl":"https://www.archives.gov/milestone-documents/joint-address-to-congress-declaration-of-war-against-japan","context":"Evaluate whether this source is suitable for a high-stakes historical factual claim."}}}},"responses":{"200":{"description":"Paid agent result.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request body.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}},"402":{"description":"Payment required. Inspect the PAYMENT-REQUIRED response header, complete the x402 payment, and repeat the request with PAYMENT-SIGNATURE.","headers":{"PAYMENT-REQUIRED":{"description":"Base64url-encoded x402 payment requirements.","schema":{"type":"string"}}}},"415":{"description":"Unsupported source content type.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}},"422":{"description":"Source retrieval or processing failure.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}},"500":{"description":"Internal processing or configuration failure.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}}},"x-x402":{"scheme":"exact","network":"eip155:8453","asset":"USDC","priceUsd":"0.03","amountBaseUnits":"30000","payTo":"0xFbC4f75278c9F3C901EFaDa9fEB3DE76089Fcb99"}}},"/research-brief":{"post":{"operationId":"researchBrief","summary":"Research Brief Agent","description":"Builds a structured research brief from one to three supplied public sources.","tags":["Paid research agents"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"topic":{"type":"string","minLength":1,"maxLength":2000,"description":"Research topic or subject."},"sourceUrls":{"type":"array","minItems":1,"maxItems":3,"items":{"type":"string","minLength":1,"maxLength":2048,"description":"Public source URL."},"description":"One to three public source URLs."},"question":{"type":"string","minLength":1,"maxLength":3000,"description":"Optional research question."}},"required":["topic","sourceUrls"]},"example":{"topic":"The Pearl Harbor attack and the United States declaration of war against Japan","sourceUrls":["https://www.archives.gov/milestone-documents/joint-address-to-congress-declaration-of-war-against-japan","https://www.senate.gov/about/images/documents/sjres116-wwii-japan.htm"],"question":"What events occurred, what evidence supports them, and how did Congress respond?"}}}},"responses":{"200":{"description":"Paid agent result.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request body.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}},"402":{"description":"Payment required. Inspect the PAYMENT-REQUIRED response header, complete the x402 payment, and repeat the request with PAYMENT-SIGNATURE.","headers":{"PAYMENT-REQUIRED":{"description":"Base64url-encoded x402 payment requirements.","schema":{"type":"string"}}}},"415":{"description":"Unsupported source content type.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}},"422":{"description":"Source retrieval or processing failure.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}},"500":{"description":"Internal processing or configuration failure.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}}},"x-x402":{"scheme":"exact","network":"eip155:8453","asset":"USDC","priceUsd":"0.10","amountBaseUnits":"100000","payTo":"0xFbC4f75278c9F3C901EFaDa9fEB3DE76089Fcb99"}}},"/fact-check":{"post":{"operationId":"factCheck","summary":"Fact-Checking Agent","description":"Checks a factual claim against one to three supplied public sources.","tags":["Paid research agents"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"claim":{"type":"string","minLength":1,"maxLength":4000,"description":"Factual claim to check."},"sourceUrls":{"type":"array","minItems":1,"maxItems":3,"items":{"type":"string","minLength":1,"maxLength":2048,"description":"Public source URL."},"description":"One to three public source URLs."}},"required":["claim","sourceUrls"]},"example":{"claim":"Congress declared war against Japan on December 8, 1941.","sourceUrls":["https://www.archives.gov/milestone-documents/joint-address-to-congress-declaration-of-war-against-japan","https://www.senate.gov/about/images/documents/sjres116-wwii-japan.htm"]}}}},"responses":{"200":{"description":"Paid agent result.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request body.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}},"402":{"description":"Payment required. Inspect the PAYMENT-REQUIRED response header, complete the x402 payment, and repeat the request with PAYMENT-SIGNATURE.","headers":{"PAYMENT-REQUIRED":{"description":"Base64url-encoded x402 payment requirements.","schema":{"type":"string"}}}},"415":{"description":"Unsupported source content type.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}},"422":{"description":"Source retrieval or processing failure.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}},"500":{"description":"Internal processing or configuration failure.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}}},"x-x402":{"scheme":"exact","network":"eip155:8453","asset":"USDC","priceUsd":"0.04","amountBaseUnits":"40000","payTo":"0xFbC4f75278c9F3C901EFaDa9fEB3DE76089Fcb99"}}},"/extract-timeline":{"post":{"operationId":"timelineExtraction","summary":"Timeline Extraction Agent","description":"Extracts and organizes dated events from one to three public sources.","tags":["Paid research agents"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"topic":{"type":"string","minLength":1,"maxLength":2000,"description":"Topic whose events should be organized chronologically."},"sourceUrls":{"type":"array","minItems":1,"maxItems":3,"items":{"type":"string","minLength":1,"maxLength":2048,"description":"Public source URL."},"description":"One to three public source URLs."}},"required":["topic","sourceUrls"]},"example":{"topic":"The Pearl Harbor attack and the United States declaration of war against Japan","sourceUrls":["https://www.archives.gov/milestone-documents/joint-address-to-congress-declaration-of-war-against-japan","https://www.senate.gov/about/images/documents/sjres116-wwii-japan.htm"]}}}},"responses":{"200":{"description":"Paid agent result.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request body.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}},"402":{"description":"Payment required. Inspect the PAYMENT-REQUIRED response header, complete the x402 payment, and repeat the request with PAYMENT-SIGNATURE.","headers":{"PAYMENT-REQUIRED":{"description":"Base64url-encoded x402 payment requirements.","schema":{"type":"string"}}}},"415":{"description":"Unsupported source content type.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}},"422":{"description":"Source retrieval or processing failure.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}},"500":{"description":"Internal processing or configuration failure.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}}},"x-x402":{"scheme":"exact","network":"eip155:8453","asset":"USDC","priceUsd":"0.04","amountBaseUnits":"40000","payTo":"0xFbC4f75278c9F3C901EFaDa9fEB3DE76089Fcb99"}}},"/detect-conflicts":{"post":{"operationId":"conflictDetection","summary":"Source Conflict Detection Agent","description":"Finds contradictions, scope differences, shared ground, and unresolved tensions across sources.","tags":["Paid research agents"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"topic":{"type":"string","minLength":1,"maxLength":2000,"description":"Topic for conflict detection."},"sourceUrls":{"type":"array","minItems":2,"maxItems":3,"items":{"type":"string","minLength":1,"maxLength":2048,"description":"Public source URL."},"description":"Two or three public source URLs."}},"required":["topic","sourceUrls"]},"example":{"topic":"The Pearl Harbor attack and the United States declaration of war against Japan","sourceUrls":["https://www.archives.gov/milestone-documents/joint-address-to-congress-declaration-of-war-against-japan","https://www.senate.gov/about/images/documents/sjres116-wwii-japan.htm"]}}}},"responses":{"200":{"description":"Paid agent result.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request body.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}},"402":{"description":"Payment required. Inspect the PAYMENT-REQUIRED response header, complete the x402 payment, and repeat the request with PAYMENT-SIGNATURE.","headers":{"PAYMENT-REQUIRED":{"description":"Base64url-encoded x402 payment requirements.","schema":{"type":"string"}}}},"415":{"description":"Unsupported source content type.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}},"422":{"description":"Source retrieval or processing failure.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}},"500":{"description":"Internal processing or configuration failure.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}}},"x-x402":{"scheme":"exact","network":"eip155:8453","asset":"USDC","priceUsd":"0.05","amountBaseUnits":"50000","payTo":"0xFbC4f75278c9F3C901EFaDa9fEB3DE76089Fcb99"}}},"/check-statistics":{"post":{"operationId":"statisticalClaimCheck","summary":"Statistical Claim Checking Agent","description":"Tests whether a numerical or statistical claim is supported and properly framed by its source.","tags":["Paid research agents"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"claim":{"type":"string","minLength":1,"maxLength":4000,"description":"Numerical or statistical claim to evaluate."},"sourceUrl":{"type":"string","minLength":1,"maxLength":2048,"description":"Public URL containing the relevant numerical evidence."}},"required":["claim","sourceUrl"]},"example":{"claim":"The Senate approved the declaration of war against Japan by a vote of 82 to 0.","sourceUrl":"https://www.senate.gov/about/images/documents/sjres116-wwii-japan.htm"}}}},"responses":{"200":{"description":"Paid agent result.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request body.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}},"402":{"description":"Payment required. Inspect the PAYMENT-REQUIRED response header, complete the x402 payment, and repeat the request with PAYMENT-SIGNATURE.","headers":{"PAYMENT-REQUIRED":{"description":"Base64url-encoded x402 payment requirements.","schema":{"type":"string"}}}},"415":{"description":"Unsupported source content type.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}},"422":{"description":"Source retrieval or processing failure.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}},"500":{"description":"Internal processing or configuration failure.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}}},"x-x402":{"scheme":"exact","network":"eip155:8453","asset":"USDC","priceUsd":"0.05","amountBaseUnits":"50000","payTo":"0xFbC4f75278c9F3C901EFaDa9fEB3DE76089Fcb99"}}},"/generate-research-questions":{"post":{"operationId":"researchQuestionGeneration","summary":"Research Question Generation Agent","description":"Generates prioritized research questions and evidence needs from a topic and optional source.","tags":["Paid research agents"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"topic":{"type":"string","minLength":1,"maxLength":2000,"description":"Topic for prioritized research-question generation."},"sourceUrl":{"type":"string","minLength":1,"maxLength":2048,"description":"Optional public source URL supplying initial context."},"goal":{"type":"string","minLength":1,"maxLength":3000,"description":"Optional research objective."}},"required":["topic"]},"example":{"topic":"The Pearl Harbor attack and the United States declaration of war against Japan","sourceUrl":"https://www.archives.gov/milestone-documents/joint-address-to-congress-declaration-of-war-against-japan","goal":"Build a rigorous, source-grounded account of the attack and the congressional response."}}}},"responses":{"200":{"description":"Paid agent result.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Invalid request body.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}},"402":{"description":"Payment required. Inspect the PAYMENT-REQUIRED response header, complete the x402 payment, and repeat the request with PAYMENT-SIGNATURE.","headers":{"PAYMENT-REQUIRED":{"description":"Base64url-encoded x402 payment requirements.","schema":{"type":"string"}}}},"415":{"description":"Unsupported source content type.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}},"422":{"description":"Source retrieval or processing failure.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}},"500":{"description":"Internal processing or configuration failure.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"properties":{"error":{"type":"string"},"message":{"type":"string"}}}}}}},"x-x402":{"scheme":"exact","network":"eip155:8453","asset":"USDC","priceUsd":"0.03","amountBaseUnits":"30000","payTo":"0xFbC4f75278c9F3C901EFaDa9fEB3DE76089Fcb99"}}}}}