{"openapi":"3.1.0","info":{"title":"Groundcheck Engine","contact":{"name":"Groundcheck","url":"https://github.com/beepboop2025/groundcheck","email":"mrinallovesbhature@gmail.com"},"version":"0.6.0","x-guidance":"POST /verify with {claim} to ground one factual claim (free, rate limited). POST /check with {text} to extract and verify every claim in a document (x402 paid, small free daily quota). Both return verdicts (supported/refuted/unverified), confidence scores, and cited sources. POST /resolve with {query} to map a ticker/ISIN/CUSIP/FIGI/name to canonical instrument identity with provenance (x402 paid, same free quota). POST /extract with {text} for claim extraction alone (x402 paid, cheapest step of the loop). POST /attest-delivery with {service, response_text, payment_receipt?, advertised_schema?} to verify what a PAID third-party service delivered and receive a signed, offline-verifiable delivery receipt binding payment to delivery to grounded content (x402 paid)."},"paths":{"/":{"get":{"summary":"Landing","operationId":"landing__get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}},"security":[]}},"/health":{"get":{"summary":"Health","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Health Health Get"}}}}},"security":[]}},"/attest/pubkey":{"get":{"summary":"Attest Pubkey","description":"Public half of response attestation: the Ed25519 key receipts are\nsigned with, the message format, and how to verify a receipt offline.","operationId":"attest_pubkey_attest_pubkey_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/.well-known/x402.json":{"get":{"summary":"X402 Manifest","description":"Machine-readable payment manifest, for agents and discovery indexes.","operationId":"x402_manifest__well_known_x402_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/.well-known/x402":{"get":{"summary":"X402 Manifest","description":"Machine-readable payment manifest, for agents and discovery indexes.","operationId":"x402_manifest__well_known_x402_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[]}},"/search":{"get":{"summary":"Search","operationId":"search_search_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","title":"Q"}},{"name":"n","in":"query","required":false,"schema":{"type":"integer","default":5,"title":"N"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Search Search Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"properties":{"detail":{"items":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"}}}}},"security":[]}},"/verify":{"post":{"summary":"Verify","operationId":"verify_verify_post","requestBody":{"content":{"application/json":{"schema":{"properties":{"claim":{"type":"string","title":"Claim"},"max_sources":{"type":"integer","maximum":10.0,"minimum":1.0,"title":"Max Sources","default":5}},"type":"object","required":["claim"],"title":"VerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"properties":{"claim":{"type":"string","title":"Claim"},"verdict":{"type":"string","enum":["supported","refuted","unverified"],"title":"Verdict"},"confidence":{"type":"number","title":"Confidence"},"rationale":{"type":"string","title":"Rationale"},"backend":{"type":"string","title":"Backend"},"classifier":{"type":"string","title":"Classifier"},"sources":{"items":{"properties":{"title":{"type":"string","title":"Title"},"url":{"type":"string","title":"Url"},"snippet":{"type":"string","title":"Snippet"},"stance":{"anyOf":[{"type":"string","enum":["supports","refutes","neutral"]},{"type":"null"}],"title":"Stance"},"stub":{"type":"boolean","title":"Stub","default":false}},"type":"object","required":["title","url","snippet"],"title":"Source"},"type":"array","title":"Sources"},"instruments":{"items":{"properties":{"reference":{"type":"string","title":"Reference"},"id_type":{"type":"string","title":"Id Type"},"resolved":{"type":"boolean","title":"Resolved"},"instrument":{"anyOf":[{"$ref":"#/components/schemas/Instrument"},{"type":"null"}]}},"type":"object","required":["reference","id_type","resolved"],"title":"ClaimInstrument","description":"An explicit security reference found in a claim, resolved (or not)."},"type":"array","title":"Instruments","default":[]},"sufficiency":{"anyOf":[{"type":"string","enum":["sufficient","insufficient","no_sources","no_stance","conflict"]},{"type":"null"}],"title":"Sufficiency"},"atoms":{"anyOf":[{"items":{"$ref":"#/components/schemas/AtomReport"},"type":"array"},{"type":"null"}],"title":"Atoms"},"ensemble_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Ensemble Score"},"guarantee":{"anyOf":[{"properties":{"certified":{"type":"boolean","title":"Certified"},"alpha":{"type":"number","title":"Alpha"},"group":{"type":"string","title":"Group"},"score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Score"},"threshold":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Threshold"},"n_calibration":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"N Calibration"},"calibrated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Calibrated At"}},"type":"object","required":["certified","alpha","group"],"title":"Guarantee","description":"Conformal certification of a verdict (conformal.py). Present only when a\ncalibration artifact is deployed; certified=True means the ensemble score\ncleared a finite-sample threshold giving error probability <= alpha."},{"type":"null"}]},"provenance":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Provenance"},"attestation":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Attestation"}},"type":"object","required":["claim","verdict","confidence","rationale","backend","classifier","sources"],"title":"VerifyResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"properties":{"detail":{"items":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"}}}}},"security":[]}},"/resolve":{"post":{"summary":"Resolve","description":"Attested instrument-identity enrichment: canonical FIGI records (with\nprovenance) for a ticker / ISIN / CUSIP / SEDOL / FIGI / name.","operationId":"resolve_resolve_post","requestBody":{"content":{"application/json":{"schema":{"properties":{"query":{"type":"string","maxLength":200,"minLength":1,"title":"Query"},"id_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id Type","description":"TICKER | ID_ISIN | ID_CUSIP | ID_SEDOL | ID_BB_GLOBAL; auto-detected from the value's shape when omitted"},"max_results":{"type":"integer","maximum":10.0,"minimum":1.0,"title":"Max Results","default":5}},"type":"object","required":["query"],"title":"ResolveRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"properties":{"query":{"type":"string","title":"Query"},"id_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id Type"},"matched":{"type":"boolean","title":"Matched"},"instruments":{"items":{"properties":{"figi":{"type":"string","title":"Figi"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"ticker":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ticker"},"exch_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Exch Code"},"security_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Security Type"},"market_sector":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Market Sector"},"composite_figi":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Composite Figi"},"share_class_figi":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Share Class Figi"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"}},"type":"object","required":["figi"],"title":"Instrument","description":"One canonical security record from open symbology (OpenFIGI)."},"type":"array","title":"Instruments"},"provenance":{"properties":{"source":{"type":"string","title":"Source"},"url":{"type":"string","title":"Url"},"retrieved_at":{"type":"string","title":"Retrieved At"},"authenticated":{"type":"boolean","title":"Authenticated","default":false}},"type":"object","required":["source","url","retrieved_at"],"title":"InstrumentProvenance"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note"}},"type":"object","required":["query","matched","instruments","provenance"],"title":"ResolveResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"properties":{"detail":{"items":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"}}}},"402":{"description":"Payment Required"}},"security":[{"x402":[]}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005000"},"protocols":[{"x402":{}}]}}},"/check":{"post":{"summary":"Check","operationId":"check_check_post","requestBody":{"content":{"application/json":{"schema":{"properties":{"text":{"type":"string","title":"Text"},"max_claims":{"type":"integer","maximum":20.0,"minimum":1.0,"title":"Max Claims","default":8}},"type":"object","required":["text"],"title":"CheckRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"properties":{"checked":{"type":"integer","title":"Checked"},"backend":{"type":"string","title":"Backend"},"classifier":{"type":"string","title":"Classifier"},"report":{"items":{"properties":{"claim":{"type":"string","title":"Claim"},"verdict":{"type":"string","enum":["supported","refuted","unverified"],"title":"Verdict"},"confidence":{"type":"number","title":"Confidence"},"rationale":{"type":"string","title":"Rationale"},"sufficiency":{"anyOf":[{"type":"string","enum":["sufficient","insufficient","no_sources","no_stance","conflict"]},{"type":"null"}],"title":"Sufficiency"},"guarantee":{"anyOf":[{"$ref":"#/components/schemas/Guarantee"},{"type":"null"}]}},"type":"object","required":["claim","verdict","confidence","rationale"],"title":"ClaimReport"},"type":"array","title":"Report"},"attestation":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Attestation"}},"type":"object","required":["checked","backend","classifier","report"],"title":"CheckResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"properties":{"detail":{"items":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"}}}},"402":{"description":"Payment Required"}},"security":[{"x402":[]}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.020000"},"protocols":[{"x402":{}}]}}},"/extract":{"post":{"summary":"Extract","description":"Claim extraction only — the $0.005 step of the verification loop\n(extract -> ground -> attest). Rule-based and auditable; no LLM.","operationId":"extract_extract_post","requestBody":{"content":{"application/json":{"schema":{"properties":{"text":{"type":"string","maxLength":100000,"minLength":1,"title":"Text"},"max_claims":{"type":"integer","maximum":50.0,"minimum":1.0,"title":"Max Claims","default":20}},"type":"object","required":["text"],"title":"ExtractRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"properties":{"count":{"type":"integer","title":"Count"},"claims":{"items":{"type":"string"},"type":"array","title":"Claims"},"method":{"type":"string","title":"Method"},"input_sha256":{"type":"string","title":"Input Sha256"},"attestation":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Attestation"}},"type":"object","required":["count","claims","method","input_sha256"],"title":"ExtractResult","description":"POST /extract: checkable atomic claims pulled from text — the cheap\nfirst step of a verification loop (extract -> ground -> attest)."}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"properties":{"detail":{"items":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"}}}},"402":{"description":"Payment Required"}},"security":[{"x402":[]}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005000"},"protocols":[{"x402":{}}]}}},"/attest-delivery":{"post":{"summary":"Attest Delivery","description":"Neutral delivery verification for agentic commerce: a signed,\noffline-verifiable receipt binding an x402 payment to what the paid\nservice actually delivered (delivery.py has the judgment rules).","operationId":"attest_delivery_attest_delivery_post","requestBody":{"content":{"application/json":{"schema":{"properties":{"service":{"type":"string","maxLength":500,"minLength":1,"title":"Service","description":"URL (or name) of the paid service whose delivery is being verified"},"response_text":{"type":"string","maxLength":100000,"minLength":1,"title":"Response Text","description":"The delivered payload, verbatim (JSON or prose)"},"request_text":{"anyOf":[{"type":"string","maxLength":10000},{"type":"null"}],"title":"Request Text","description":"What was asked of the service (bound by hash when given)"},"payment_receipt":{"anyOf":[{"type":"string","maxLength":16384},{"type":"null"}],"title":"Payment Receipt","description":"The x402 settlement receipt from the paid call (X-PAYMENT-RESPONSE / PAYMENT-RESPONSE value, base64 or raw JSON); bound by hash into the attestation"},"advertised_schema":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Advertised Schema","description":"JSON schema the service advertised for its output (from its 402 offer or Bazaar listing)"},"max_claims":{"type":"integer","maximum":20.0,"minimum":1.0,"title":"Max Claims","default":8}},"type":"object","required":["service","response_text"],"title":"AttestDeliveryRequest","description":"A third-party paid exchange to verify and attest (delivery.py)."}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"properties":{"service":{"type":"string","title":"Service"},"delivery_verdict":{"type":"string","enum":["consistent","degraded","inconsistent","unverifiable"],"title":"Delivery Verdict"},"rationale":{"type":"string","title":"Rationale"},"response_sha256":{"type":"string","title":"Response Sha256"},"request_sha256":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Request Sha256"},"grounding":{"properties":{"checked":{"type":"integer","title":"Checked"},"supported":{"type":"integer","title":"Supported"},"refuted":{"type":"integer","title":"Refuted"},"unverified":{"type":"integer","title":"Unverified"},"mean_confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Mean Confidence"},"report":{"items":{"$ref":"#/components/schemas/ClaimReport"},"type":"array","title":"Report"}},"type":"object","required":["checked","supported","refuted","unverified","report"],"title":"DeliveryGrounding","description":"Grounding tally over the factual claims in a delivered response."},"conformance":{"properties":{"checked":{"type":"boolean","title":"Checked"},"valid":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Valid"},"problems":{"items":{"type":"string"},"type":"array","title":"Problems","default":[]}},"type":"object","required":["checked"],"title":"DeliveryConformance","description":"Structural check of the delivered payload against the schema the\nservice advertised (402 offer / Bazaar listing). checked=False when the\nbuyer supplied no schema."},"payment":{"properties":{"bound":{"type":"boolean","title":"Bound"},"receipt_sha256":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Receipt Sha256"},"network":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Network"},"transaction":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Transaction"},"payer":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Payer"},"success":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Success"},"problems":{"items":{"type":"string"},"type":"array","title":"Problems","default":[]}},"type":"object","required":["bound"],"title":"DeliveryPayment","description":"The x402 settlement receipt the buyer presented, bound by hash into\nthe attestation. Binding records WHAT was presented; confirming the\ntransaction on-chain is the verifier's own step."},"backend":{"type":"string","title":"Backend"},"classifier":{"type":"string","title":"Classifier"},"attestation":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Attestation"}},"type":"object","required":["service","delivery_verdict","rationale","response_sha256","grounding","conformance","payment","backend","classifier"],"title":"DeliveryResult","description":"POST /attest-delivery: a signed, offline-verifiable receipt binding an\nagent's payment to what the paid service actually delivered."}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"properties":{"detail":{"items":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"}}}},"402":{"description":"Payment Required"}},"security":[{"x402":[]}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.050000"},"protocols":[{"x402":{}}]}}}},"components":{"schemas":{"AtomReport":{"properties":{"claim":{"type":"string","title":"Claim"},"verdict":{"type":"string","enum":["supported","refuted","unverified"],"title":"Verdict"},"confidence":{"type":"number","title":"Confidence"},"sufficiency":{"anyOf":[{"type":"string","enum":["sufficient","insufficient","no_sources","no_stance","conflict"]},{"type":"null"}],"title":"Sufficiency"}},"type":"object","required":["claim","verdict","confidence"],"title":"AtomReport","description":"One atomic sub-claim of a compound claim, verified on its own evidence."},"AttestDeliveryRequest":{"properties":{"service":{"type":"string","maxLength":500,"minLength":1,"title":"Service","description":"URL (or name) of the paid service whose delivery is being verified"},"response_text":{"type":"string","maxLength":100000,"minLength":1,"title":"Response Text","description":"The delivered payload, verbatim (JSON or prose)"},"request_text":{"anyOf":[{"type":"string","maxLength":10000},{"type":"null"}],"title":"Request Text","description":"What was asked of the service (bound by hash when given)"},"payment_receipt":{"anyOf":[{"type":"string","maxLength":16384},{"type":"null"}],"title":"Payment Receipt","description":"The x402 settlement receipt from the paid call (X-PAYMENT-RESPONSE / PAYMENT-RESPONSE value, base64 or raw JSON); bound by hash into the attestation"},"advertised_schema":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Advertised Schema","description":"JSON schema the service advertised for its output (from its 402 offer or Bazaar listing)"},"max_claims":{"type":"integer","maximum":20.0,"minimum":1.0,"title":"Max Claims","default":8}},"type":"object","required":["service","response_text"],"title":"AttestDeliveryRequest","description":"A third-party paid exchange to verify and attest (delivery.py)."},"CheckRequest":{"properties":{"text":{"type":"string","title":"Text"},"max_claims":{"type":"integer","maximum":20.0,"minimum":1.0,"title":"Max Claims","default":8}},"type":"object","required":["text"],"title":"CheckRequest"},"CheckResult":{"properties":{"checked":{"type":"integer","title":"Checked"},"backend":{"type":"string","title":"Backend"},"classifier":{"type":"string","title":"Classifier"},"report":{"items":{"$ref":"#/components/schemas/ClaimReport"},"type":"array","title":"Report"},"attestation":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Attestation"}},"type":"object","required":["checked","backend","classifier","report"],"title":"CheckResult"},"ClaimInstrument":{"properties":{"reference":{"type":"string","title":"Reference"},"id_type":{"type":"string","title":"Id Type"},"resolved":{"type":"boolean","title":"Resolved"},"instrument":{"anyOf":[{"$ref":"#/components/schemas/Instrument"},{"type":"null"}]}},"type":"object","required":["reference","id_type","resolved"],"title":"ClaimInstrument","description":"An explicit security reference found in a claim, resolved (or not)."},"ClaimReport":{"properties":{"claim":{"type":"string","title":"Claim"},"verdict":{"type":"string","enum":["supported","refuted","unverified"],"title":"Verdict"},"confidence":{"type":"number","title":"Confidence"},"rationale":{"type":"string","title":"Rationale"},"sufficiency":{"anyOf":[{"type":"string","enum":["sufficient","insufficient","no_sources","no_stance","conflict"]},{"type":"null"}],"title":"Sufficiency"},"guarantee":{"anyOf":[{"$ref":"#/components/schemas/Guarantee"},{"type":"null"}]}},"type":"object","required":["claim","verdict","confidence","rationale"],"title":"ClaimReport"},"DeliveryConformance":{"properties":{"checked":{"type":"boolean","title":"Checked"},"valid":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Valid"},"problems":{"items":{"type":"string"},"type":"array","title":"Problems","default":[]}},"type":"object","required":["checked"],"title":"DeliveryConformance","description":"Structural check of the delivered payload against the schema the\nservice advertised (402 offer / Bazaar listing). checked=False when the\nbuyer supplied no schema."},"DeliveryGrounding":{"properties":{"checked":{"type":"integer","title":"Checked"},"supported":{"type":"integer","title":"Supported"},"refuted":{"type":"integer","title":"Refuted"},"unverified":{"type":"integer","title":"Unverified"},"mean_confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Mean Confidence"},"report":{"items":{"$ref":"#/components/schemas/ClaimReport"},"type":"array","title":"Report"}},"type":"object","required":["checked","supported","refuted","unverified","report"],"title":"DeliveryGrounding","description":"Grounding tally over the factual claims in a delivered response."},"DeliveryPayment":{"properties":{"bound":{"type":"boolean","title":"Bound"},"receipt_sha256":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Receipt Sha256"},"network":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Network"},"transaction":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Transaction"},"payer":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Payer"},"success":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Success"},"problems":{"items":{"type":"string"},"type":"array","title":"Problems","default":[]}},"type":"object","required":["bound"],"title":"DeliveryPayment","description":"The x402 settlement receipt the buyer presented, bound by hash into\nthe attestation. Binding records WHAT was presented; confirming the\ntransaction on-chain is the verifier's own step."},"DeliveryResult":{"properties":{"service":{"type":"string","title":"Service"},"delivery_verdict":{"type":"string","enum":["consistent","degraded","inconsistent","unverifiable"],"title":"Delivery Verdict"},"rationale":{"type":"string","title":"Rationale"},"response_sha256":{"type":"string","title":"Response Sha256"},"request_sha256":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Request Sha256"},"grounding":{"$ref":"#/components/schemas/DeliveryGrounding"},"conformance":{"$ref":"#/components/schemas/DeliveryConformance"},"payment":{"$ref":"#/components/schemas/DeliveryPayment"},"backend":{"type":"string","title":"Backend"},"classifier":{"type":"string","title":"Classifier"},"attestation":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Attestation"}},"type":"object","required":["service","delivery_verdict","rationale","response_sha256","grounding","conformance","payment","backend","classifier"],"title":"DeliveryResult","description":"POST /attest-delivery: a signed, offline-verifiable receipt binding an\nagent's payment to what the paid service actually delivered."},"ExtractRequest":{"properties":{"text":{"type":"string","maxLength":100000,"minLength":1,"title":"Text"},"max_claims":{"type":"integer","maximum":50.0,"minimum":1.0,"title":"Max Claims","default":20}},"type":"object","required":["text"],"title":"ExtractRequest"},"ExtractResult":{"properties":{"count":{"type":"integer","title":"Count"},"claims":{"items":{"type":"string"},"type":"array","title":"Claims"},"method":{"type":"string","title":"Method"},"input_sha256":{"type":"string","title":"Input Sha256"},"attestation":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Attestation"}},"type":"object","required":["count","claims","method","input_sha256"],"title":"ExtractResult","description":"POST /extract: checkable atomic claims pulled from text — the cheap\nfirst step of a verification loop (extract -> ground -> attest)."},"Guarantee":{"properties":{"certified":{"type":"boolean","title":"Certified"},"alpha":{"type":"number","title":"Alpha"},"group":{"type":"string","title":"Group"},"score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Score"},"threshold":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Threshold"},"n_calibration":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"N Calibration"},"calibrated_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Calibrated At"}},"type":"object","required":["certified","alpha","group"],"title":"Guarantee","description":"Conformal certification of a verdict (conformal.py). Present only when a\ncalibration artifact is deployed; certified=True means the ensemble score\ncleared a finite-sample threshold giving error probability <= alpha."},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"Instrument":{"properties":{"figi":{"type":"string","title":"Figi"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"ticker":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ticker"},"exch_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Exch Code"},"security_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Security Type"},"market_sector":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Market Sector"},"composite_figi":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Composite Figi"},"share_class_figi":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Share Class Figi"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"}},"type":"object","required":["figi"],"title":"Instrument","description":"One canonical security record from open symbology (OpenFIGI)."},"InstrumentProvenance":{"properties":{"source":{"type":"string","title":"Source"},"url":{"type":"string","title":"Url"},"retrieved_at":{"type":"string","title":"Retrieved At"},"authenticated":{"type":"boolean","title":"Authenticated","default":false}},"type":"object","required":["source","url","retrieved_at"],"title":"InstrumentProvenance"},"ResolveRequest":{"properties":{"query":{"type":"string","maxLength":200,"minLength":1,"title":"Query"},"id_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id Type","description":"TICKER | ID_ISIN | ID_CUSIP | ID_SEDOL | ID_BB_GLOBAL; auto-detected from the value's shape when omitted"},"max_results":{"type":"integer","maximum":10.0,"minimum":1.0,"title":"Max Results","default":5}},"type":"object","required":["query"],"title":"ResolveRequest"},"ResolveResult":{"properties":{"query":{"type":"string","title":"Query"},"id_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id Type"},"matched":{"type":"boolean","title":"Matched"},"instruments":{"items":{"$ref":"#/components/schemas/Instrument"},"type":"array","title":"Instruments"},"provenance":{"$ref":"#/components/schemas/InstrumentProvenance"},"note":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Note"}},"type":"object","required":["query","matched","instruments","provenance"],"title":"ResolveResult"},"Source":{"properties":{"title":{"type":"string","title":"Title"},"url":{"type":"string","title":"Url"},"snippet":{"type":"string","title":"Snippet"},"stance":{"anyOf":[{"type":"string","enum":["supports","refutes","neutral"]},{"type":"null"}],"title":"Stance"},"stub":{"type":"boolean","title":"Stub","default":false}},"type":"object","required":["title","url","snippet"],"title":"Source"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"VerifyRequest":{"properties":{"claim":{"type":"string","title":"Claim"},"max_sources":{"type":"integer","maximum":10.0,"minimum":1.0,"title":"Max Sources","default":5}},"type":"object","required":["claim"],"title":"VerifyRequest"},"VerifyResult":{"properties":{"claim":{"type":"string","title":"Claim"},"verdict":{"type":"string","enum":["supported","refuted","unverified"],"title":"Verdict"},"confidence":{"type":"number","title":"Confidence"},"rationale":{"type":"string","title":"Rationale"},"backend":{"type":"string","title":"Backend"},"classifier":{"type":"string","title":"Classifier"},"sources":{"items":{"$ref":"#/components/schemas/Source"},"type":"array","title":"Sources"},"instruments":{"items":{"$ref":"#/components/schemas/ClaimInstrument"},"type":"array","title":"Instruments","default":[]},"sufficiency":{"anyOf":[{"type":"string","enum":["sufficient","insufficient","no_sources","no_stance","conflict"]},{"type":"null"}],"title":"Sufficiency"},"atoms":{"anyOf":[{"items":{"$ref":"#/components/schemas/AtomReport"},"type":"array"},{"type":"null"}],"title":"Atoms"},"ensemble_score":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Ensemble Score"},"guarantee":{"anyOf":[{"$ref":"#/components/schemas/Guarantee"},{"type":"null"}]},"provenance":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Provenance"},"attestation":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Attestation"}},"type":"object","required":["claim","verdict","confidence","rationale","backend","classifier","sources"],"title":"VerifyResult"}},"securitySchemes":{"x402":{"type":"apiKey","in":"header","name":"X-PAYMENT","description":"x402 payment payload (v1 X-PAYMENT or v2 PAYMENT-SIGNATURE). Unpaid calls receive HTTP 402 with an accepts[] offer."}}}}