Field notes
Agents need predictable, bounded tools with clear prices and useful outputs.
Agents need predictable, bounded tools with clear prices and useful outputs.
| Item |
|---|
| Cup |
![\"Blue](\"/cup.png\")
","baseUrl":"https://example.com/"}}}},"responses":{"200":{"description":"Result and service-credit debit or Gateway acceptance receipt; not final on-chain confirmation.","content":{"application/json":{"schema":{"type":"object","required":["result","receipt","settlementStatus","finalOnchainSettlementVerified","recoveryExpiresAt"],"properties":{"result":{"type":"object","properties":{"images":{"type":"array","items":{"type":"object","properties":{"url":{"type":["string","null"]},"alt":{"type":["string","null"]},"width":{"type":"string"},"height":{"type":"string"},"srcset":{"type":"string"},"loading":{"type":"string"}},"required":["url","alt","width","height","srcset","loading"],"additionalProperties":false}},"total":{"type":"number"},"truncated":{"type":"boolean"},"scope":{"type":"string"}},"required":["images","total","truncated","scope"],"additionalProperties":false},"receipt":{"type":"object"},"settlementStatus":{"enum":["gateway-accepted","service-credits-debited"]},"finalOnchainSettlementVerified":{"const":false},"recoveryExpiresAt":{"type":"string"}}}}}},"400":{"description":"Invalid input or payment."},"401":{"description":"Invalid credit API key."},"402":{"description":"Insufficient service credits, or x402 v2 requirements with mandatory request binding."},"403":{"description":"Credit account frozen after refund or dispute."},"409":{"description":"Replay or request mismatch."},"410":{"description":"Quote or result recovery expired."},"412":{"description":"Current tool price exceeds the supplied credit ceiling. No new reservation or debit."},"413":{"description":"Input too large."},"422":{"description":"Tool cannot process this input."},"429":{"description":"Capacity limit."},"503":{"description":"Payments disabled, provider unavailable or settlement unknown."}}}},"/v1/tools/html.feeds":{"post":{"operationId":"html_feeds","description":"Discover up to 50 RSS, Atom and JSON Feed links declared in supplied HTML.","x-price-micro-usdc":300,"parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}},{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Quote","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Quote-Signature","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Max-Credit-Micro-Usd","in":"header","required":false,"description":"Prepaid credits only. Reject a new reservation above this ceiling without debit (412). A matching existing retry makes no new reservation; zero allows recovery only. Does not cancel a prior reservation.","schema":{"type":"string","pattern":"^(0|[1-9][0-9]{0,11})$"},"example":"300"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"html":{"type":"string","maxLength":100000},"baseUrl":{"type":"string","minLength":1,"maxLength":2048}},"required":["html"],"additionalProperties":false},"example":{"html":"","baseUrl":"https://example.com/"}}}},"responses":{"200":{"description":"Result and service-credit debit or Gateway acceptance receipt; not final on-chain confirmation.","content":{"application/json":{"schema":{"type":"object","required":["result","receipt","settlementStatus","finalOnchainSettlementVerified","recoveryExpiresAt"],"properties":{"result":{"type":"object","properties":{"feeds":{"type":"array","items":{"type":"object","properties":{"url":{"type":["string","null"]},"type":{"type":"string"},"title":{"type":"string"}},"required":["url","type","title"],"additionalProperties":false}},"truncated":{"type":"boolean"}},"required":["feeds","truncated"],"additionalProperties":false},"receipt":{"type":"object"},"settlementStatus":{"enum":["gateway-accepted","service-credits-debited"]},"finalOnchainSettlementVerified":{"const":false},"recoveryExpiresAt":{"type":"string"}}}}}},"400":{"description":"Invalid input or payment."},"401":{"description":"Invalid credit API key."},"402":{"description":"Insufficient service credits, or x402 v2 requirements with mandatory request binding."},"403":{"description":"Credit account frozen after refund or dispute."},"409":{"description":"Replay or request mismatch."},"410":{"description":"Quote or result recovery expired."},"412":{"description":"Current tool price exceeds the supplied credit ceiling. No new reservation or debit."},"413":{"description":"Input too large."},"422":{"description":"Tool cannot process this input."},"429":{"description":"Capacity limit."},"503":{"description":"Payments disabled, provider unavailable or settlement unknown."}}}},"/v1/tools/data.json-pointer":{"post":{"operationId":"data_json_pointer","description":"Select JSON values with up to 100 RFC 6901 pointer strings, preserving missing versus null.","x-price-micro-usdc":300,"parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}},{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Quote","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Quote-Signature","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Max-Credit-Micro-Usd","in":"header","required":false,"description":"Prepaid credits only. Reject a new reservation above this ceiling without debit (412). A matching existing retry makes no new reservation; zero allows recovery only. Does not cancel a prior reservation.","schema":{"type":"string","pattern":"^(0|[1-9][0-9]{0,11})$"},"example":"300"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"paths":{"type":"array","items":{"type":"string","maxLength":2048},"maxItems":100}},"required":["data","paths"],"additionalProperties":false},"example":{"data":{"product":{"name":"Cup"}},"paths":["/product/name","/price"]}}}},"responses":{"200":{"description":"Result and service-credit debit or Gateway acceptance receipt; not final on-chain confirmation.","content":{"application/json":{"schema":{"type":"object","required":["result","receipt","settlementStatus","finalOnchainSettlementVerified","recoveryExpiresAt"],"properties":{"result":{"type":"object","properties":{"selections":{"type":"array","items":{"type":"object","properties":{"pointer":{"type":"string"},"found":{"type":"boolean"},"value":{}},"required":["pointer","found"],"additionalProperties":false}}},"required":["selections"],"additionalProperties":false},"receipt":{"type":"object"},"settlementStatus":{"enum":["gateway-accepted","service-credits-debited"]},"finalOnchainSettlementVerified":{"const":false},"recoveryExpiresAt":{"type":"string"}}}}}},"400":{"description":"Invalid input or payment."},"401":{"description":"Invalid credit API key."},"402":{"description":"Insufficient service credits, or x402 v2 requirements with mandatory request binding."},"403":{"description":"Credit account frozen after refund or dispute."},"409":{"description":"Replay or request mismatch."},"410":{"description":"Quote or result recovery expired."},"412":{"description":"Current tool price exceeds the supplied credit ceiling. No new reservation or debit."},"413":{"description":"Input too large."},"422":{"description":"Tool cannot process this input."},"429":{"description":"Capacity limit."},"503":{"description":"Payments disabled, provider unavailable or settlement unknown."}}}},"/v1/tools/data.json-diff":{"post":{"operationId":"data_json_diff","description":"Compare JSON structures and return bounded changes at JSON Pointer paths.","x-price-micro-usdc":500,"parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}},{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Quote","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Quote-Signature","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Max-Credit-Micro-Usd","in":"header","required":false,"description":"Prepaid credits only. Reject a new reservation above this ceiling without debit (412). A matching existing retry makes no new reservation; zero allows recovery only. Does not cancel a prior reservation.","schema":{"type":"string","pattern":"^(0|[1-9][0-9]{0,11})$"},"example":"500"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"before":{},"after":{},"maxChanges":{"type":"integer","minimum":1,"maximum":200}},"required":["before","after"],"additionalProperties":false},"example":{"before":{"price":10},"after":{"price":12,"inStock":true}}}}},"responses":{"200":{"description":"Result and service-credit debit or Gateway acceptance receipt; not final on-chain confirmation.","content":{"application/json":{"schema":{"type":"object","required":["result","receipt","settlementStatus","finalOnchainSettlementVerified","recoveryExpiresAt"],"properties":{"result":{"type":"object","properties":{"equal":{"type":"boolean"},"changes":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"kind":{"type":"string"},"before":{},"after":{}},"required":["path","kind"],"additionalProperties":false}},"truncated":{"type":"boolean"},"scope":{"type":"string"}},"required":["equal","changes","truncated","scope"],"additionalProperties":false},"receipt":{"type":"object"},"settlementStatus":{"enum":["gateway-accepted","service-credits-debited"]},"finalOnchainSettlementVerified":{"const":false},"recoveryExpiresAt":{"type":"string"}}}}}},"400":{"description":"Invalid input or payment."},"401":{"description":"Invalid credit API key."},"402":{"description":"Insufficient service credits, or x402 v2 requirements with mandatory request binding."},"403":{"description":"Credit account frozen after refund or dispute."},"409":{"description":"Replay or request mismatch."},"410":{"description":"Quote or result recovery expired."},"412":{"description":"Current tool price exceeds the supplied credit ceiling. No new reservation or debit."},"413":{"description":"Input too large."},"422":{"description":"Tool cannot process this input."},"429":{"description":"Capacity limit."},"503":{"description":"Payments disabled, provider unavailable or settlement unknown."}}}},"/v1/tools/data.json-canonical":{"post":{"operationId":"data_json_canonical","description":"Serialize JSON with sorted object keys for deterministic comparison; not RFC 8785 certification.","x-price-micro-usdc":300,"parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}},{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Quote","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Quote-Signature","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Max-Credit-Micro-Usd","in":"header","required":false,"description":"Prepaid credits only. Reject a new reservation above this ceiling without debit (412). A matching existing retry makes no new reservation; zero allows recovery only. Does not cancel a prior reservation.","schema":{"type":"string","pattern":"^(0|[1-9][0-9]{0,11})$"},"example":"300"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"data":{}},"required":["data"],"additionalProperties":false},"example":{"data":{"z":2,"a":1}}}}},"responses":{"200":{"description":"Result and service-credit debit or Gateway acceptance receipt; not final on-chain confirmation.","content":{"application/json":{"schema":{"type":"object","required":["result","receipt","settlementStatus","finalOnchainSettlementVerified","recoveryExpiresAt"],"properties":{"result":{"type":"object","properties":{"text":{"type":"string"},"profile":{"type":"string"}},"required":["text","profile"],"additionalProperties":false},"receipt":{"type":"object"},"settlementStatus":{"enum":["gateway-accepted","service-credits-debited"]},"finalOnchainSettlementVerified":{"const":false},"recoveryExpiresAt":{"type":"string"}}}}}},"400":{"description":"Invalid input or payment."},"401":{"description":"Invalid credit API key."},"402":{"description":"Insufficient service credits, or x402 v2 requirements with mandatory request binding."},"403":{"description":"Credit account frozen after refund or dispute."},"409":{"description":"Replay or request mismatch."},"410":{"description":"Quote or result recovery expired."},"412":{"description":"Current tool price exceeds the supplied credit ceiling. No new reservation or debit."},"413":{"description":"Input too large."},"422":{"description":"Tool cannot process this input."},"429":{"description":"Capacity limit."},"503":{"description":"Payments disabled, provider unavailable or settlement unknown."}}}},"/v1/tools/security.jwt-inspect":{"post":{"operationId":"security_jwt_inspect","description":"Decode untrusted JWT claims and optionally compare timestamps; never verifies a signature.","x-price-micro-usdc":300,"parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}},{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Quote","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Quote-Signature","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Max-Credit-Micro-Usd","in":"header","required":false,"description":"Prepaid credits only. Reject a new reservation above this ceiling without debit (412). A matching existing retry makes no new reservation; zero allows recovery only. Does not cancel a prior reservation.","schema":{"type":"string","pattern":"^(0|[1-9][0-9]{0,11})$"},"example":"300"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"token":{"type":"string","minLength":1,"maxLength":20000},"atUnixSeconds":{"type":"integer","minimum":0}},"required":["token"],"additionalProperties":false},"example":{"token":"eyJhbGciOiJub25lIn0.eyJzdWIiOiJkZW1vIn0."}}}},"responses":{"200":{"description":"Result and service-credit debit or Gateway acceptance receipt; not final on-chain confirmation.","content":{"application/json":{"schema":{"type":"object","required":["result","receipt","settlementStatus","finalOnchainSettlementVerified","recoveryExpiresAt"],"properties":{"result":{"type":"object","properties":{"header":{"type":"object"},"claims":{"type":"object"},"signatureVerified":{"const":false},"expired":{"type":["boolean","null"]},"notYetValid":{"type":["boolean","null"]},"warnings":{"type":"array","items":{"type":"string"}},"scope":{"type":"string"}},"required":["header","claims","signatureVerified","expired","notYetValid","warnings","scope"],"additionalProperties":false},"receipt":{"type":"object"},"settlementStatus":{"enum":["gateway-accepted","service-credits-debited"]},"finalOnchainSettlementVerified":{"const":false},"recoveryExpiresAt":{"type":"string"}}}}}},"400":{"description":"Invalid input or payment."},"401":{"description":"Invalid credit API key."},"402":{"description":"Insufficient service credits, or x402 v2 requirements with mandatory request binding."},"403":{"description":"Credit account frozen after refund or dispute."},"409":{"description":"Replay or request mismatch."},"410":{"description":"Quote or result recovery expired."},"412":{"description":"Current tool price exceeds the supplied credit ceiling. No new reservation or debit."},"413":{"description":"Input too large."},"422":{"description":"Tool cannot process this input."},"429":{"description":"Capacity limit."},"503":{"description":"Payments disabled, provider unavailable or settlement unknown."}}}},"/v1/tools/security.csp-audit":{"post":{"operationId":"security_csp_audit","description":"Parse a supplied Content Security Policy and flag selected risky or missing directives.","x-price-micro-usdc":500,"parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}},{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Quote","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Quote-Signature","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Max-Credit-Micro-Usd","in":"header","required":false,"description":"Prepaid credits only. Reject a new reservation above this ceiling without debit (412). A matching existing retry makes no new reservation; zero allows recovery only. Does not cancel a prior reservation.","schema":{"type":"string","pattern":"^(0|[1-9][0-9]{0,11})$"},"example":"500"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"policy":{"type":"string","maxLength":16000}},"required":["policy"],"additionalProperties":false},"example":{"policy":"default-src 'self'; object-src 'none'; base-uri 'self'; frame-ancestors 'none'"}}}},"responses":{"200":{"description":"Result and service-credit debit or Gateway acceptance receipt; not final on-chain confirmation.","content":{"application/json":{"schema":{"type":"object","required":["result","receipt","settlementStatus","finalOnchainSettlementVerified","recoveryExpiresAt"],"properties":{"result":{"type":"object","properties":{"directives":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"sources":{"type":"array","items":{"type":"string"}}},"required":["name","sources"],"additionalProperties":false}},"findings":{"type":"array","items":{"type":"object","properties":{"rule":{"type":"string"},"severity":{"type":"string"},"message":{"type":"string"}},"required":["rule","severity","message"],"additionalProperties":false}},"scope":{"type":"string"}},"required":["directives","findings","scope"],"additionalProperties":false},"receipt":{"type":"object"},"settlementStatus":{"enum":["gateway-accepted","service-credits-debited"]},"finalOnchainSettlementVerified":{"const":false},"recoveryExpiresAt":{"type":"string"}}}}}},"400":{"description":"Invalid input or payment."},"401":{"description":"Invalid credit API key."},"402":{"description":"Insufficient service credits, or x402 v2 requirements with mandatory request binding."},"403":{"description":"Credit account frozen after refund or dispute."},"409":{"description":"Replay or request mismatch."},"410":{"description":"Quote or result recovery expired."},"412":{"description":"Current tool price exceeds the supplied credit ceiling. No new reservation or debit."},"413":{"description":"Input too large."},"422":{"description":"Tool cannot process this input."},"429":{"description":"Capacity limit."},"503":{"description":"Payments disabled, provider unavailable or settlement unknown."}}}},"/v1/tools/security.header-audit":{"post":{"operationId":"security_header_audit","description":"Review supplied response headers for selected security and CORS issues without echoing values.","x-price-micro-usdc":500,"parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}},{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Quote","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Quote-Signature","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Max-Credit-Micro-Usd","in":"header","required":false,"description":"Prepaid credits only. Reject a new reservation above this ceiling without debit (412). A matching existing retry makes no new reservation; zero allows recovery only. Does not cancel a prior reservation.","schema":{"type":"string","pattern":"^(0|[1-9][0-9]{0,11})$"},"example":"500"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"headers":{"type":"object","maxProperties":100,"additionalProperties":{"type":"string","maxLength":8192}}},"required":["headers"],"additionalProperties":false},"example":{"headers":{"X-Content-Type-Options":"nosniff"}}}}},"responses":{"200":{"description":"Result and service-credit debit or Gateway acceptance receipt; not final on-chain confirmation.","content":{"application/json":{"schema":{"type":"object","required":["result","receipt","settlementStatus","finalOnchainSettlementVerified","recoveryExpiresAt"],"properties":{"result":{"type":"object","properties":{"headerNames":{"type":"array","items":{"type":"string"}},"findings":{"type":"array","items":{"type":"object","properties":{"rule":{"type":"string"},"severity":{"type":"string"},"message":{"type":"string"}},"required":["rule","severity","message"],"additionalProperties":false}},"scope":{"type":"string"}},"required":["headerNames","findings","scope"],"additionalProperties":false},"receipt":{"type":"object"},"settlementStatus":{"enum":["gateway-accepted","service-credits-debited"]},"finalOnchainSettlementVerified":{"const":false},"recoveryExpiresAt":{"type":"string"}}}}}},"400":{"description":"Invalid input or payment."},"401":{"description":"Invalid credit API key."},"402":{"description":"Insufficient service credits, or x402 v2 requirements with mandatory request binding."},"403":{"description":"Credit account frozen after refund or dispute."},"409":{"description":"Replay or request mismatch."},"410":{"description":"Quote or result recovery expired."},"412":{"description":"Current tool price exceeds the supplied credit ceiling. No new reservation or debit."},"413":{"description":"Input too large."},"422":{"description":"Tool cannot process this input."},"429":{"description":"Capacity limit."},"503":{"description":"Payments disabled, provider unavailable or settlement unknown."}}}},"/v1/tools/security.cookie-audit":{"post":{"operationId":"security_cookie_audit","description":"Check up to 50 Set-Cookie headers for security attributes and prefix rules; masks cookie values.","x-price-micro-usdc":500,"parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}},{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Quote","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Quote-Signature","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Max-Credit-Micro-Usd","in":"header","required":false,"description":"Prepaid credits only. Reject a new reservation above this ceiling without debit (412). A matching existing retry makes no new reservation; zero allows recovery only. Does not cancel a prior reservation.","schema":{"type":"string","pattern":"^(0|[1-9][0-9]{0,11})$"},"example":"500"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"setCookies":{"type":"array","items":{"type":"string","maxLength":8192},"maxItems":50}},"required":["setCookies"],"additionalProperties":false},"example":{"setCookies":["demo=example; Secure; HttpOnly; SameSite=Lax; Path=/"]}}}},"responses":{"200":{"description":"Result and service-credit debit or Gateway acceptance receipt; not final on-chain confirmation.","content":{"application/json":{"schema":{"type":"object","required":["result","receipt","settlementStatus","finalOnchainSettlementVerified","recoveryExpiresAt"],"properties":{"result":{"type":"object","properties":{"cookies":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"value":{"const":"[REDACTED]"},"secure":{"type":"boolean"},"httpOnly":{"type":"boolean"},"sameSite":{"type":"string"},"hasDomain":{"type":"boolean"},"findings":{"type":"array","items":{"type":"object","properties":{"rule":{"type":"string"},"severity":{"type":"string"},"message":{"type":"string"}},"required":["rule","severity","message"],"additionalProperties":false}}},"required":["name","value","secure","httpOnly","sameSite","hasDomain","findings"],"additionalProperties":false}},"scope":{"type":"string"}},"required":["cookies","scope"],"additionalProperties":false},"receipt":{"type":"object"},"settlementStatus":{"enum":["gateway-accepted","service-credits-debited"]},"finalOnchainSettlementVerified":{"const":false},"recoveryExpiresAt":{"type":"string"}}}}}},"400":{"description":"Invalid input or payment."},"401":{"description":"Invalid credit API key."},"402":{"description":"Insufficient service credits, or x402 v2 requirements with mandatory request binding."},"403":{"description":"Credit account frozen after refund or dispute."},"409":{"description":"Replay or request mismatch."},"410":{"description":"Quote or result recovery expired."},"412":{"description":"Current tool price exceeds the supplied credit ceiling. No new reservation or debit."},"413":{"description":"Input too large."},"422":{"description":"Tool cannot process this input."},"429":{"description":"Capacity limit."},"503":{"description":"Payments disabled, provider unavailable or settlement unknown."}}}},"/v1/tools/agents.env-template-check":{"post":{"operationId":"agents_env_template_check","description":"Compare environment-variable names against a template; never returns assignment values.","x-price-micro-usdc":500,"parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}},{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Quote","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Quote-Signature","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Max-Credit-Micro-Usd","in":"header","required":false,"description":"Prepaid credits only. Reject a new reservation above this ceiling without debit (412). A matching existing retry makes no new reservation; zero allows recovery only. Does not cancel a prior reservation.","schema":{"type":"string","pattern":"^(0|[1-9][0-9]{0,11})$"},"example":"500"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"template":{"type":"string","maxLength":100000},"actual":{"type":"string","maxLength":100000}},"required":["template","actual"],"additionalProperties":false},"example":{"template":"APP_URL=\nLOG_LEVEL=","actual":"APP_URL=https://example.com"}}}},"responses":{"200":{"description":"Result and service-credit debit or Gateway acceptance receipt; not final on-chain confirmation.","content":{"application/json":{"schema":{"type":"object","required":["result","receipt","settlementStatus","finalOnchainSettlementVerified","recoveryExpiresAt"],"properties":{"result":{"type":"object","properties":{"missing":{"type":"array","items":{"type":"string"}},"extra":{"type":"array","items":{"type":"string"}},"duplicateNames":{"type":"array","items":{"type":"string"}},"templateDuplicateNames":{"type":"array","items":{"type":"string"}},"unrecognizedLines":{"type":"object","properties":{"template":{"type":"number"},"actual":{"type":"number"}},"required":["template","actual"],"additionalProperties":false},"scope":{"type":"string"}},"required":["missing","extra","duplicateNames","templateDuplicateNames","unrecognizedLines","scope"],"additionalProperties":false},"receipt":{"type":"object"},"settlementStatus":{"enum":["gateway-accepted","service-credits-debited"]},"finalOnchainSettlementVerified":{"const":false},"recoveryExpiresAt":{"type":"string"}}}}}},"400":{"description":"Invalid input or payment."},"401":{"description":"Invalid credit API key."},"402":{"description":"Insufficient service credits, or x402 v2 requirements with mandatory request binding."},"403":{"description":"Credit account frozen after refund or dispute."},"409":{"description":"Replay or request mismatch."},"410":{"description":"Quote or result recovery expired."},"412":{"description":"Current tool price exceeds the supplied credit ceiling. No new reservation or debit."},"413":{"description":"Input too large."},"422":{"description":"Tool cannot process this input."},"429":{"description":"Capacity limit."},"503":{"description":"Payments disabled, provider unavailable or settlement unknown."}}}},"/v1/tools/agents.tool-name-conflicts":{"post":{"operationId":"agents_tool_name_conflicts","description":"Find duplicate or easily confused tool names after Unicode, case and separator normalization.","x-price-micro-usdc":300,"parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}},{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Quote","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Quote-Signature","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Max-Credit-Micro-Usd","in":"header","required":false,"description":"Prepaid credits only. Reject a new reservation above this ceiling without debit (412). A matching existing retry makes no new reservation; zero allows recovery only. Does not cancel a prior reservation.","schema":{"type":"string","pattern":"^(0|[1-9][0-9]{0,11})$"},"example":"300"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"names":{"type":"array","items":{"type":"string","maxLength":200},"maxItems":200}},"required":["names"],"additionalProperties":false},"example":{"names":["get_price","Get-Price","checkout"]}}}},"responses":{"200":{"description":"Result and service-credit debit or Gateway acceptance receipt; not final on-chain confirmation.","content":{"application/json":{"schema":{"type":"object","required":["result","receipt","settlementStatus","finalOnchainSettlementVerified","recoveryExpiresAt"],"properties":{"result":{"type":"object","properties":{"conflicts":{"type":"array","items":{"type":"object","properties":{"normalized":{"type":"string"},"kind":{"type":"string"},"items":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"index":{"type":"number"}},"required":["name","index"],"additionalProperties":false}}},"required":["normalized","kind","items"],"additionalProperties":false}},"scope":{"type":"string"}},"required":["conflicts","scope"],"additionalProperties":false},"receipt":{"type":"object"},"settlementStatus":{"enum":["gateway-accepted","service-credits-debited"]},"finalOnchainSettlementVerified":{"const":false},"recoveryExpiresAt":{"type":"string"}}}}}},"400":{"description":"Invalid input or payment."},"401":{"description":"Invalid credit API key."},"402":{"description":"Insufficient service credits, or x402 v2 requirements with mandatory request binding."},"403":{"description":"Credit account frozen after refund or dispute."},"409":{"description":"Replay or request mismatch."},"410":{"description":"Quote or result recovery expired."},"412":{"description":"Current tool price exceeds the supplied credit ceiling. No new reservation or debit."},"413":{"description":"Input too large."},"422":{"description":"Tool cannot process this input."},"429":{"description":"Capacity limit."},"503":{"description":"Payments disabled, provider unavailable or settlement unknown."}}}},"/v1/tools/text.chunk":{"post":{"operationId":"text_chunk","description":"Split text into at most 200 overlapping chunks with offsets and intact UTF-16 surrogate pairs.","x-price-micro-usdc":300,"parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}},{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Quote","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Quote-Signature","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Max-Credit-Micro-Usd","in":"header","required":false,"description":"Prepaid credits only. Reject a new reservation above this ceiling without debit (412). A matching existing retry makes no new reservation; zero allows recovery only. Does not cancel a prior reservation.","schema":{"type":"string","pattern":"^(0|[1-9][0-9]{0,11})$"},"example":"300"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","maxLength":100000},"maxChars":{"type":"integer","minimum":32,"maximum":10000},"overlap":{"type":"integer","minimum":0,"maximum":500}},"required":["text"],"additionalProperties":false},"example":{"text":"Agents can reuse bounded snippets of a longer document.","maxChars":32,"overlap":8}}}},"responses":{"200":{"description":"Result and service-credit debit or Gateway acceptance receipt; not final on-chain confirmation.","content":{"application/json":{"schema":{"type":"object","required":["result","receipt","settlementStatus","finalOnchainSettlementVerified","recoveryExpiresAt"],"properties":{"result":{"type":"object","properties":{"chunks":{"type":"array","items":{"type":"object","properties":{"start":{"type":"number"},"end":{"type":"number"},"text":{"type":"string"}},"required":["start","end","text"],"additionalProperties":false}},"offsetUnit":{"type":"string"},"count":{"type":"number"}},"required":["chunks","offsetUnit","count"],"additionalProperties":false},"receipt":{"type":"object"},"settlementStatus":{"enum":["gateway-accepted","service-credits-debited"]},"finalOnchainSettlementVerified":{"const":false},"recoveryExpiresAt":{"type":"string"}}}}}},"400":{"description":"Invalid input or payment."},"401":{"description":"Invalid credit API key."},"402":{"description":"Insufficient service credits, or x402 v2 requirements with mandatory request binding."},"403":{"description":"Credit account frozen after refund or dispute."},"409":{"description":"Replay or request mismatch."},"410":{"description":"Quote or result recovery expired."},"412":{"description":"Current tool price exceeds the supplied credit ceiling. No new reservation or debit."},"413":{"description":"Input too large."},"422":{"description":"Tool cannot process this input."},"429":{"description":"Capacity limit."},"503":{"description":"Payments disabled, provider unavailable or settlement unknown."}}}},"/v1/tools/commerce.gtin-validate":{"post":{"operationId":"commerce_gtin_validate","description":"Validate GTIN-8, UPC/GTIN-12, EAN/GTIN-13 and GTIN-14 check digits; no product lookup.","x-price-micro-usdc":300,"parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}},{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Quote","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Quote-Signature","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Max-Credit-Micro-Usd","in":"header","required":false,"description":"Prepaid credits only. Reject a new reservation above this ceiling without debit (412). A matching existing retry makes no new reservation; zero allows recovery only. Does not cancel a prior reservation.","schema":{"type":"string","pattern":"^(0|[1-9][0-9]{0,11})$"},"example":"300"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string","maxLength":32}},"required":["code"],"additionalProperties":false},"example":{"code":"036000291452"}}}},"responses":{"200":{"description":"Result and service-credit debit or Gateway acceptance receipt; not final on-chain confirmation.","content":{"application/json":{"schema":{"type":"object","required":["result","receipt","settlementStatus","finalOnchainSettlementVerified","recoveryExpiresAt"],"properties":{"result":{"type":"object","properties":{"valid":{"type":"boolean"},"format":{"type":"string"},"expectedCheckDigit":{"type":["string","null"]},"scope":{"type":"string"}},"required":["valid","format","expectedCheckDigit","scope"],"additionalProperties":false},"receipt":{"type":"object"},"settlementStatus":{"enum":["gateway-accepted","service-credits-debited"]},"finalOnchainSettlementVerified":{"const":false},"recoveryExpiresAt":{"type":"string"}}}}}},"400":{"description":"Invalid input or payment."},"401":{"description":"Invalid credit API key."},"402":{"description":"Insufficient service credits, or x402 v2 requirements with mandatory request binding."},"403":{"description":"Credit account frozen after refund or dispute."},"409":{"description":"Replay or request mismatch."},"410":{"description":"Quote or result recovery expired."},"412":{"description":"Current tool price exceeds the supplied credit ceiling. No new reservation or debit."},"413":{"description":"Input too large."},"422":{"description":"Tool cannot process this input."},"429":{"description":"Capacity limit."},"503":{"description":"Payments disabled, provider unavailable or settlement unknown."}}}},"/v1/tools/commerce.variant-compare":{"post":{"operationId":"commerce_variant_compare","description":"Compare requested product attributes with an offered variant and list missing or mismatched fields.","x-price-micro-usdc":500,"parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}},{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Quote","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Quote-Signature","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Max-Credit-Micro-Usd","in":"header","required":false,"description":"Prepaid credits only. Reject a new reservation above this ceiling without debit (412). A matching existing retry makes no new reservation; zero allows recovery only. Does not cancel a prior reservation.","schema":{"type":"string","pattern":"^(0|[1-9][0-9]{0,11})$"},"example":"500"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"requested":{"type":"object","maxProperties":100},"offered":{"type":"object","maxProperties":100}},"required":["requested","offered"],"additionalProperties":false},"example":{"requested":{"color":"blue","size":"M"},"offered":{"color":"blue","size":"L","stock":true}}}}},"responses":{"200":{"description":"Result and service-credit debit or Gateway acceptance receipt; not final on-chain confirmation.","content":{"application/json":{"schema":{"type":"object","required":["result","receipt","settlementStatus","finalOnchainSettlementVerified","recoveryExpiresAt"],"properties":{"result":{"type":"object","properties":{"matches":{"type":"boolean"},"missing":{"type":"array","items":{"type":"string"}},"mismatched":{"type":"array","items":{"type":"object","properties":{"attribute":{"type":"string"},"requested":{},"offered":{}},"required":["attribute","requested","offered"],"additionalProperties":false}},"extra":{"type":"array","items":{"type":"string"}},"scope":{"type":"string"}},"required":["matches","missing","mismatched","extra","scope"],"additionalProperties":false},"receipt":{"type":"object"},"settlementStatus":{"enum":["gateway-accepted","service-credits-debited"]},"finalOnchainSettlementVerified":{"const":false},"recoveryExpiresAt":{"type":"string"}}}}}},"400":{"description":"Invalid input or payment."},"401":{"description":"Invalid credit API key."},"402":{"description":"Insufficient service credits, or x402 v2 requirements with mandatory request binding."},"403":{"description":"Credit account frozen after refund or dispute."},"409":{"description":"Replay or request mismatch."},"410":{"description":"Quote or result recovery expired."},"412":{"description":"Current tool price exceeds the supplied credit ceiling. No new reservation or debit."},"413":{"description":"Input too large."},"422":{"description":"Tool cannot process this input."},"429":{"description":"Capacity limit."},"503":{"description":"Payments disabled, provider unavailable or settlement unknown."}}}},"/v1/tools/commerce.pack-plan":{"post":{"operationId":"commerce_pack_plan","description":"Choose the lowest-cost whole-pack combination for a required count with exact prices and explicit pack limits; up to 20 interchangeable offers.","x-price-micro-usdc":800,"parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}},{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Quote","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Quote-Signature","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Max-Credit-Micro-Usd","in":"header","required":false,"description":"Prepaid credits only. Reject a new reservation above this ceiling without debit (412). A matching existing retry makes no new reservation; zero allows recovery only. Does not cancel a prior reservation.","schema":{"type":"string","pattern":"^(0|[1-9][0-9]{0,11})$"},"example":"800"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"minorUnitDigits":{"type":"integer","minimum":0,"maximum":6},"requiredUnits":{"type":"integer","minimum":1,"maximum":1000},"offers":{"type":"array","minItems":1,"maxItems":20,"items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":100},"unitsPerPack":{"type":"integer","minimum":1,"maximum":1000},"price":{"type":"string","pattern":"^(0|[1-9]\\d{0,11})(\\.\\d{1,6})?$","maxLength":19},"maxPacks":{"type":"integer","minimum":0,"maximum":1000}},"required":["id","unitsPerPack","price","maxPacks"],"additionalProperties":false}}},"required":["currency","minorUnitDigits","requiredUnits","offers"],"additionalProperties":false},"example":{"currency":"USD","minorUnitDigits":2,"requiredUnits":12,"offers":[{"id":"six-pack","unitsPerPack":6,"price":"7.99","maxPacks":10},{"id":"ten-pack","unitsPerPack":10,"price":"11.99","maxPacks":10}]}}}},"responses":{"200":{"description":"Result and service-credit debit or Gateway acceptance receipt; not final on-chain confirmation.","content":{"application/json":{"schema":{"type":"object","required":["result","receipt","settlementStatus","finalOnchainSettlementVerified","recoveryExpiresAt"],"properties":{"result":{"type":"object","properties":{"currency":{"type":"string"},"minorUnitDigits":{"type":"number"},"requiredUnits":{"type":"number"},"feasible":{"type":"boolean"},"totalUnits":{"type":["integer","null"]},"excessUnits":{"type":["integer","null"]},"itemSubtotal":{"type":["string","null"]},"packCount":{"type":["integer","null"]},"lines":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"packs":{"type":"number"},"units":{"type":"number"},"lineSubtotal":{"type":"string"}},"required":["id","packs","units","lineSubtotal"],"additionalProperties":false}},"scope":{"type":"string"}},"required":["currency","minorUnitDigits","requiredUnits","feasible","totalUnits","excessUnits","itemSubtotal","packCount","lines","scope"],"additionalProperties":false},"receipt":{"type":"object"},"settlementStatus":{"enum":["gateway-accepted","service-credits-debited"]},"finalOnchainSettlementVerified":{"const":false},"recoveryExpiresAt":{"type":"string"}}}}}},"400":{"description":"Invalid input or payment."},"401":{"description":"Invalid credit API key."},"402":{"description":"Insufficient service credits, or x402 v2 requirements with mandatory request binding."},"403":{"description":"Credit account frozen after refund or dispute."},"409":{"description":"Replay or request mismatch."},"410":{"description":"Quote or result recovery expired."},"412":{"description":"Current tool price exceeds the supplied credit ceiling. No new reservation or debit."},"413":{"description":"Input too large."},"422":{"description":"Tool cannot process this input."},"429":{"description":"Capacity limit."},"503":{"description":"Payments disabled, provider unavailable or settlement unknown."}}}},"/v1/tools/commerce.money-parse":{"post":{"operationId":"commerce_money_parse","description":"Normalize up to 50 displayed prices with explicit locale, currency and decimal scale; exact amounts, strict grouping and per-price errors.","x-price-micro-usdc":300,"parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}},{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Quote","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Quote-Signature","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Max-Credit-Micro-Usd","in":"header","required":false,"description":"Prepaid credits only. Reject a new reservation above this ceiling without debit (412). A matching existing retry makes no new reservation; zero allows recovery only. Does not cancel a prior reservation.","schema":{"type":"string","pattern":"^(0|[1-9][0-9]{0,11})$"},"example":"300"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"locale":{"type":"string","enum":["en-US","en-GB","de-DE","fr-FR","en-IN"]},"currency":{"type":"string","enum":["USD","EUR","GBP","CAD","AUD","JPY","INR"]},"minorUnitDigits":{"type":"integer","minimum":0,"maximum":6},"amounts":{"type":"array","minItems":1,"maxItems":50,"items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":100},"text":{"type":"string","minLength":1,"maxLength":100}},"required":["id","text"],"additionalProperties":false}}},"required":["locale","currency","minorUnitDigits","amounts"],"additionalProperties":false},"example":{"locale":"de-DE","currency":"EUR","minorUnitDigits":2,"amounts":[{"id":"offer-1","text":"1.234,56 €"},{"id":"offer-2","text":"EUR 999,95"},{"id":"range","text":"10–20 €"}]}}}},"responses":{"200":{"description":"Result and service-credit debit or Gateway acceptance receipt; not final on-chain confirmation.","content":{"application/json":{"schema":{"type":"object","required":["result","receipt","settlementStatus","finalOnchainSettlementVerified","recoveryExpiresAt"],"properties":{"result":{"type":"object","properties":{"locale":{"type":"string"},"currency":{"type":"string"},"minorUnitDigits":{"type":"number"},"amounts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"valid":{"type":"boolean"},"amount":{"type":["string","null"]},"minorUnits":{"type":["string","null"]},"currencyToken":{"type":["string","null"]},"issue":{"type":["string","null"]}},"required":["id","valid","amount","minorUnits","currencyToken","issue"],"additionalProperties":false}},"allValid":{"type":"boolean"},"acceptedCurrencyTokens":{"type":"array","items":{"type":"string"}},"scope":{"type":"string"}},"required":["locale","currency","minorUnitDigits","amounts","allValid","acceptedCurrencyTokens","scope"],"additionalProperties":false},"receipt":{"type":"object"},"settlementStatus":{"enum":["gateway-accepted","service-credits-debited"]},"finalOnchainSettlementVerified":{"const":false},"recoveryExpiresAt":{"type":"string"}}}}}},"400":{"description":"Invalid input or payment."},"401":{"description":"Invalid credit API key."},"402":{"description":"Insufficient service credits, or x402 v2 requirements with mandatory request binding."},"403":{"description":"Credit account frozen after refund or dispute."},"409":{"description":"Replay or request mismatch."},"410":{"description":"Quote or result recovery expired."},"412":{"description":"Current tool price exceeds the supplied credit ceiling. No new reservation or debit."},"413":{"description":"Input too large."},"422":{"description":"Tool cannot process this input."},"429":{"description":"Capacity limit."},"503":{"description":"Payments disabled, provider unavailable or settlement unknown."}}}},"/v1/tools/commerce.offer-extract":{"post":{"operationId":"commerce_offer_extract","description":"Extract bounded Product offers from supplied JSON-LD HTML with source pointers, missing-price warnings and separate aggregate ranges.","x-price-micro-usdc":800,"parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}},{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Quote","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Quote-Signature","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Max-Credit-Micro-Usd","in":"header","required":false,"description":"Prepaid credits only. Reject a new reservation above this ceiling without debit (412). A matching existing retry makes no new reservation; zero allows recovery only. Does not cancel a prior reservation.","schema":{"type":"string","pattern":"^(0|[1-9][0-9]{0,11})$"},"example":"800"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"html":{"type":"string","maxLength":100000},"baseUrl":{"type":"string","maxLength":2048},"maxOffers":{"type":"integer","minimum":1,"maximum":50}},"required":["html"],"additionalProperties":false},"example":{"html":"","baseUrl":"https://example.com/shop"}}}},"responses":{"200":{"description":"Result and service-credit debit or Gateway acceptance receipt; not final on-chain confirmation.","content":{"application/json":{"schema":{"type":"object","required":["result","receipt","settlementStatus","finalOnchainSettlementVerified","recoveryExpiresAt"],"properties":{"result":{"type":"object","properties":{"offers":{"type":"array","items":{"type":"object","properties":{"productName":{"type":["string","null"]},"sku":{"type":["string","null"]},"gtin":{"type":["string","null"]},"offerType":{"type":"string"},"price":{"type":["string","null"]},"currency":{"type":["string","null"]},"lowPrice":{"type":["string","null"]},"highPrice":{"type":["string","null"]},"url":{"type":["string","null"]},"availability":{"type":["string","null"]},"itemCondition":{"type":["string","null"]},"priceValidUntil":{"type":["string","null"]},"source":{"type":"object","properties":{"productBlock":{"type":"number"},"productPointer":{"type":"string"},"offerBlock":{"type":"number"},"offerPointer":{"type":"string"}},"required":["productBlock","productPointer","offerBlock","offerPointer"],"additionalProperties":false},"warnings":{"type":"array","items":{"type":"string"}}},"required":["productName","sku","gtin","offerType","price","currency","lowPrice","highPrice","url","availability","itemCondition","priceValidUntil","source","warnings"],"additionalProperties":false}},"productsFound":{"type":"number"},"productsWithoutOffers":{"type":"number"},"invalidBlocks":{"type":"number"},"unresolvedReferences":{"type":"number"},"unsupportedOffers":{"type":"number"},"truncated":{"type":"boolean"},"scope":{"type":"string"}},"required":["offers","productsFound","productsWithoutOffers","invalidBlocks","unresolvedReferences","unsupportedOffers","truncated","scope"],"additionalProperties":false},"receipt":{"type":"object"},"settlementStatus":{"enum":["gateway-accepted","service-credits-debited"]},"finalOnchainSettlementVerified":{"const":false},"recoveryExpiresAt":{"type":"string"}}}}}},"400":{"description":"Invalid input or payment."},"401":{"description":"Invalid credit API key."},"402":{"description":"Insufficient service credits, or x402 v2 requirements with mandatory request binding."},"403":{"description":"Credit account frozen after refund or dispute."},"409":{"description":"Replay or request mismatch."},"410":{"description":"Quote or result recovery expired."},"412":{"description":"Current tool price exceeds the supplied credit ceiling. No new reservation or debit."},"413":{"description":"Input too large."},"422":{"description":"Tool cannot process this input."},"429":{"description":"Capacity limit."},"503":{"description":"Payments disabled, provider unavailable or settlement unknown."}}}},"/v1/tools/commerce.unit-price":{"post":{"operationId":"commerce_unit_price","description":"Compare up to 50 explicit pack prices with exact arithmetic across compatible mass, volume or count units; no currency conversion.","x-price-micro-usdc":500,"parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}},{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Quote","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Quote-Signature","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Max-Credit-Micro-Usd","in":"header","required":false,"description":"Prepaid credits only. Reject a new reservation above this ceiling without debit (412). A matching existing retry makes no new reservation; zero allows recovery only. Does not cancel a prior reservation.","schema":{"type":"string","pattern":"^(0|[1-9][0-9]{0,11})$"},"example":"500"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"reference":{"type":"object","properties":{"quantity":{"type":"string","pattern":"^(0|[1-9]\\d{0,11})(\\.\\d{1,6})?$","maxLength":19},"unit":{"type":"string","enum":["mg","g","kg","oz","lb","ml","l","each"]}},"required":["quantity","unit"],"additionalProperties":false},"offers":{"type":"array","minItems":1,"maxItems":50,"items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":100},"price":{"type":"string","pattern":"^(0|[1-9]\\d{0,11})(\\.\\d{1,6})?$","maxLength":19},"quantity":{"type":"string","pattern":"^(0|[1-9]\\d{0,11})(\\.\\d{1,6})?$","maxLength":19},"unit":{"type":"string","enum":["mg","g","kg","oz","lb","ml","l","each"]},"packCount":{"type":"integer","minimum":1,"maximum":10000}},"required":["id","price","quantity","unit"],"additionalProperties":false}}},"required":["currency","reference","offers"],"additionalProperties":false},"example":{"currency":"USD","reference":{"quantity":"100","unit":"g"},"offers":[{"id":"500g-bag","price":"8.99","quantity":"500","unit":"g"},{"id":"1kg-bag","price":"16.49","quantity":"1","unit":"kg"}]}}}},"responses":{"200":{"description":"Result and service-credit debit or Gateway acceptance receipt; not final on-chain confirmation.","content":{"application/json":{"schema":{"type":"object","required":["result","receipt","settlementStatus","finalOnchainSettlementVerified","recoveryExpiresAt"],"properties":{"result":{"type":"object","properties":{"currency":{"type":"string"},"reference":{"type":"object","properties":{"quantity":{"type":"string","pattern":"^(0|[1-9]\\d{0,11})(\\.\\d{1,6})?$","maxLength":19},"unit":{"type":"string","enum":["mg","g","kg","oz","lb","ml","l","each"]}},"required":["quantity","unit"],"additionalProperties":false},"offers":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"totalQuantity":{"type":"object","properties":{"numerator":{"type":"string"},"denominator":{"type":"string"},"unit":{"type":"string"}},"required":["numerator","denominator","unit"],"additionalProperties":false},"pricePerReference":{"type":"string"},"exactPricePerReference":{"type":"object","properties":{"numerator":{"type":"string"},"denominator":{"type":"string"}},"required":["numerator","denominator"],"additionalProperties":false}},"required":["id","totalQuantity","pricePerReference","exactPricePerReference"],"additionalProperties":false}},"cheapestIds":{"type":"array","items":{"type":"string"}},"scope":{"type":"string"}},"required":["currency","reference","offers","cheapestIds","scope"],"additionalProperties":false},"receipt":{"type":"object"},"settlementStatus":{"enum":["gateway-accepted","service-credits-debited"]},"finalOnchainSettlementVerified":{"const":false},"recoveryExpiresAt":{"type":"string"}}}}}},"400":{"description":"Invalid input or payment."},"401":{"description":"Invalid credit API key."},"402":{"description":"Insufficient service credits, or x402 v2 requirements with mandatory request binding."},"403":{"description":"Credit account frozen after refund or dispute."},"409":{"description":"Replay or request mismatch."},"410":{"description":"Quote or result recovery expired."},"412":{"description":"Current tool price exceeds the supplied credit ceiling. No new reservation or debit."},"413":{"description":"Input too large."},"422":{"description":"Tool cannot process this input."},"429":{"description":"Capacity limit."},"503":{"description":"Payments disabled, provider unavailable or settlement unknown."}}}},"/v1/tools/commerce.price-components":{"post":{"operationId":"commerce_price_components","description":"Reconcile item, discount, shipping, tax and fee amounts using exact decimals; missing costs stay unknown and declared totals can be checked.","x-price-micro-usdc":500,"parameters":[{"name":"Authorization","in":"header","required":false,"schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"type":"string"}},{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Quote","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Quote-Signature","in":"header","required":false,"schema":{"type":"string"}},{"name":"X-Max-Credit-Micro-Usd","in":"header","required":false,"description":"Prepaid credits only. Reject a new reservation above this ceiling without debit (412). A matching existing retry makes no new reservation; zero allows recovery only. Does not cancel a prior reservation.","schema":{"type":"string","pattern":"^(0|[1-9][0-9]{0,11})$"},"example":"500"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"minorUnitDigits":{"type":"integer","minimum":0,"maximum":6},"items":{"type":"array","minItems":1,"maxItems":100,"items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":100},"unitPrice":{"type":"string","pattern":"^(0|[1-9]\\d{0,11})(\\.\\d{1,6})?$","maxLength":19},"quantity":{"type":"integer","minimum":1,"maximum":100000},"discount":{"type":"string","pattern":"^(0|[1-9]\\d{0,11})(\\.\\d{1,6})?$","maxLength":19}},"required":["id","unitPrice","quantity","discount"],"additionalProperties":false}},"orderDiscount":{"type":"string","pattern":"^(0|[1-9]\\d{0,11})(\\.\\d{1,6})?$","maxLength":19},"shipping":{"anyOf":[{"type":"string","pattern":"^(0|[1-9]\\d{0,11})(\\.\\d{1,6})?$","maxLength":19},{"type":"null"}]},"tax":{"anyOf":[{"type":"string","pattern":"^(0|[1-9]\\d{0,11})(\\.\\d{1,6})?$","maxLength":19},{"type":"null"}]},"fees":{"anyOf":[{"type":"string","pattern":"^(0|[1-9]\\d{0,11})(\\.\\d{1,6})?$","maxLength":19},{"type":"null"}]},"declaredTotal":{"type":"string","pattern":"^(0|[1-9]\\d{0,11})(\\.\\d{1,6})?$","maxLength":19}},"required":["currency","minorUnitDigits","items","orderDiscount","shipping","tax","fees"],"additionalProperties":false},"example":{"currency":"USD","minorUnitDigits":2,"items":[{"id":"1kg-bag","unitPrice":"16.49","quantity":2,"discount":"0.00"}],"orderDiscount":"2.00","shipping":"4.99","tax":null,"fees":"0.00"}}}},"responses":{"200":{"description":"Result and service-credit debit or Gateway acceptance receipt; not final on-chain confirmation.","content":{"application/json":{"schema":{"type":"object","required":["result","receipt","settlementStatus","finalOnchainSettlementVerified","recoveryExpiresAt"],"properties":{"result":{"type":"object","properties":{"currency":{"type":"string"},"minorUnitDigits":{"type":"number"},"lines":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"subtotal":{"type":"string"},"discount":{"type":"string"},"total":{"type":"string"}},"required":["id","subtotal","discount","total"],"additionalProperties":false}},"itemSubtotal":{"type":"string"},"lineDiscounts":{"type":"string"},"orderDiscount":{"type":"string"},"knownTotal":{"type":"string"},"total":{"type":["string","null"]},"missingComponents":{"type":"array","items":{"type":"string"}},"matchesDeclaredTotal":{"type":["boolean","null"]},"difference":{"type":["string","null"]},"scope":{"type":"string"}},"required":["currency","minorUnitDigits","lines","itemSubtotal","lineDiscounts","orderDiscount","knownTotal","total","missingComponents","matchesDeclaredTotal","difference","scope"],"additionalProperties":false},"receipt":{"type":"object"},"settlementStatus":{"enum":["gateway-accepted","service-credits-debited"]},"finalOnchainSettlementVerified":{"const":false},"recoveryExpiresAt":{"type":"string"}}}}}},"400":{"description":"Invalid input or payment."},"401":{"description":"Invalid credit API key."},"402":{"description":"Insufficient service credits, or x402 v2 requirements with mandatory request binding."},"403":{"description":"Credit account frozen after refund or dispute."},"409":{"description":"Replay or request mismatch."},"410":{"description":"Quote or result recovery expired."},"412":{"description":"Current tool price exceeds the supplied credit ceiling. No new reservation or debit."},"413":{"description":"Input too large."},"422":{"description":"Tool cannot process this input."},"429":{"description":"Capacity limit."},"503":{"description":"Payments disabled, provider unavailable or settlement unknown."}}}}}}