{"openapi":"3.1.0","info":{"title":"enclave402 x402 gateway","version":"2.1.0","summary":"Pay-per-call APIs for autonomous agents, settled in USDC on Base via x402.","description":"Every gated route returns HTTP 402 with x402 v2 requirements until a valid EIP-3009 authorization is presented in the Payment-Signature header. Settlement is executed by the facilitator after the handler succeeds and canceled otherwise, so failed calls cost nothing. Replay protection, payer serialization, and rate limits are enforced at the gateway.","contact":{"email":"security@enclave402.com"},"x-transparency":"https://enclave402.com/transparency","x-trust":"https://enclave402.com/trust","x-errors":"https://enclave402.com/errors","x-ledger":"https://enclave402.com/api/ledger"},"externalDocs":{"description":"Agent instructions, payment recipe and the resolvable error catalog","url":"https://enclave402.com/llms-full.txt"},"servers":[{"url":"https://enclave402.com"}],"x-x402":{"version":2,"network":"eip155:8453","chainId":8453,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0xbeF3e7CFd486C14dD8c3aA5911134bF361B973C5","facilitator":"https://api.cdp.coinbase.com/platform/v2/x402","attestor":"0xB068B1a633D56EbeE0657C4bc44f1cF97303E580","discovery":"https://enclave402.com/api/discovery","mcp":"https://enclave402.com/mcp.json"},"paths":{"/api/market/signal":{"get":{"operationId":"get_market_signal","summary":"Polymarket signal with derived edge: 1h/6h probability deltas, realized volatility and whale flow from the trade tape.","description":"Polymarket signal plus fields the free listing does not have: 1h and 6h probability deltas, 24h realized volatility, and whale flow from the trade tape (net YES notional, largest print, whale count, flow label). Plus prices, bid/ask, spread, 24h change, momentum, volume, liquidity. MUST be invoked when an agent needs where a market is MOVING, not just where it is. Do NOT use for spot prices or order execution. Settles $0.010 USDC on Base; no charge on failure; receipts at /api/ledger.","tags":["market-data"],"x-bazaar":{"discoverable":true,"category":"market-data","cost":{"amount":"10000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","network":"eip155:8453","humanReadable":"$0.010"},"settlement":"after-handler; canceled on non-2xx (no charge on failure)","qualityScoreFactors":{"deterministicOutputs":true,"replayProtected":true,"receiptGated":true}},"responses":{"200":{"description":"Paid response. PAYMENT-RESPONSE header carries the base64 facilitator settlement receipt (transaction hash, network, payer).","headers":{"PAYMENT-RESPONSE":{"schema":{"type":"string"},"description":"base64 JSON settlement receipt from the facilitator"},"Server-Timing":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"source":{"type":"string","enum":["polymarket-gamma","polymarket-gamma+clob+trades"],"description":"Upstream data providers"},"query":{"type":"object","description":"Echo of the resolved query (slug, or top/orderBy)"},"markets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Polymarket market id"},"slug":{"type":"string","description":"URL slug of the market"},"question":{"type":"string","description":"Market question text"},"conditionId":{"type":["string","null"],"description":"On-chain condition id (bytes32 hex)"},"outcomes":{"type":"array","items":{"type":"string"},"description":"Outcome labels, index-aligned with outcomePrices"},"outcomePrices":{"type":"array","items":{"type":"number"},"description":"Current outcome prices in [0,1] (implied probabilities)"},"impliedProbability":{"type":["number","null"],"description":"Price of the first outcome (YES) in [0,1]"},"bestBid":{"type":["number","null"],"description":"Best bid for the first outcome"},"bestAsk":{"type":["number","null"],"description":"Best ask for the first outcome"},"spread":{"type":["number","null"],"description":"bestAsk - bestBid"},"oneDayPriceChange":{"type":["number","null"],"description":"24h change of the first outcome price (absolute, in probability points)"},"momentum":{"type":"string","enum":["RISING","FALLING","FLAT","UNKNOWN"],"description":"Deterministic label: RISING if 24h change >= +0.02, FALLING if <= -0.02, else FLAT"},"volume24hr":{"type":["number","null"],"description":"24h notional volume in USD"},"liquidity":{"type":["number","null"],"description":"Order-book liquidity in USD"},"endDate":{"type":["string","null"],"description":"ISO-8601 market end date"},"derived":{"type":"object","description":"Fields not in the free listing: computed from the CLOB price history and the public trade tape. Null with a reason in errors when a provider is unavailable.","properties":{"priceDelta1h":{"type":["number","null"],"description":"YES price now minus YES price 1h ago"},"priceDelta6h":{"type":["number","null"],"description":"YES price now minus YES price 6h ago"},"realizedVol24h":{"type":["number","null"],"description":"Std-dev of 10-minute log returns over the last 24h"},"historySamples":{"type":"integer","description":"Price points used"},"whaleFlow":{"type":["object","null"],"description":"Trade-tape summary over the last 6h; BUY of NO counts as SELL of YES","properties":{"windowSec":{"type":"integer"},"trades":{"type":"integer"},"buyYesUsdc":{"type":"number"},"sellYesUsdc":{"type":"number"},"netYesUsdc":{"type":"number"},"largestTradeUsdc":{"type":"number"},"whaleThresholdUsdc":{"type":"number"},"whaleTrades":{"type":"integer"},"flow":{"type":"string","enum":["YES_ACCUMULATION","YES_DISTRIBUTION","BALANCED","NO_TRADES"]}},"required":["windowSec","trades","netYesUsdc","largestTradeUsdc","whaleTrades","flow"],"additionalProperties":false},"errors":{"type":"array","items":{"type":"string"},"description":"Provider-scoped reasons a derived field is null (e.g. clob:timeout)"}},"required":["priceDelta1h","priceDelta6h","realizedVol24h","whaleFlow","errors"],"additionalProperties":false}},"required":["id","slug","question","outcomes","outcomePrices","impliedProbability","momentum"],"additionalProperties":false},"description":"Normalized market rows"},"asOf":{"type":"string","description":"ISO-8601 timestamp the data was fetched"},"settled":{"type":"boolean","description":"true when an x402 payment settled for this response (false on free-quota or dry-run)"},"ts":{"type":"integer","description":"Response timestamp, UNIX milliseconds"}},"required":["source","query","markets","asOf","settled","ts"],"additionalProperties":false}}}},"400":{"description":"Invalid parameter or malformed payment envelope (RFC 7807).","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"402":{"description":"Payment required. PAYMENT-REQUIRED header carries the base64 x402 v2 requirements; body is RFC 7807 with a remedy block.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"base64 JSON x402 PaymentRequired (accepts[], resource)"},"WWW-Authenticate":{"schema":{"type":"string"},"description":"RFC 9110 Payment challenge (id, realm, method, intent, request, expires)"}},"content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"409":{"description":"REPLAY_DETECTED or PAYMENT_PENDING (RFC 7807).","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"429":{"description":"Rate limited; honor Retry-After.","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"503":{"description":"Upstream unavailable; the caller is not charged.","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}}},"parameters":[{"name":"slug","in":"query","required":false,"schema":{"type":"string","pattern":"^[a-z0-9-]{3,200}$","maxLength":200,"description":"Optional Polymarket market slug for one specific market. Omit to receive the top markets by 24h volume.","examples":["will-there-be-no-change-in-fed-interest-rates-after-the-october-2026-meeting-20260617190324031"]},"description":"Optional Polymarket market slug for one specific market. Omit to receive the top markets by 24h volume."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":10,"default":5,"description":"Number of top markets to return when slug is omitted."},"description":"Number of top markets to return when slug is omitted."}]}},"/api/storage/pin":{"post":{"operationId":"pin_storage","summary":"Store a JSON document on IPFS via a managed pinning service; returns its CID and a gateway URL.","description":"Store a JSON document (object or string, up to 8 KB) on IPFS through a managed pinning service and return its content identifier (CID v1) plus an HTTP gateway URL. MUST be invoked when an agent needs durable, content-addressed storage for memory, decisions, artifacts or metadata that other agents can fetch by CID. Do NOT send raw binary, files over 8 KB, or an existing CID to re-pin. Settles $0.008 USDC via x402 on Base; failed or unavailable pins are never charged; receipts at /api/ledger.","tags":["storage"],"x-bazaar":{"discoverable":true,"category":"storage","cost":{"amount":"8000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","network":"eip155:8453","humanReadable":"$0.008"},"settlement":"after-handler; canceled on non-2xx (no charge on failure)","qualityScoreFactors":{"deterministicOutputs":true,"replayProtected":true,"receiptGated":true}},"responses":{"200":{"description":"Paid response. PAYMENT-RESPONSE header carries the base64 facilitator settlement receipt (transaction hash, network, payer).","headers":{"PAYMENT-RESPONSE":{"schema":{"type":"string"},"description":"base64 JSON settlement receipt from the facilitator"},"Server-Timing":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"pinned":{"type":"boolean","description":"true when the provider accepted and pinned the content"},"cid":{"type":"string","description":"IPFS CID of the stored content"},"provider":{"type":"string","description":"Pinning provider"},"size":{"type":"integer","description":"Pinned size in bytes as reported by the provider"},"status":{"type":"string","description":"Provider pin status (pinned)"},"gateway":{"type":["string","null"],"description":"Resolvable HTTP gateway URL for the CID"},"settled":{"type":"boolean","description":"true when an x402 payment settled for this response"},"ts":{"type":"integer","description":"Response timestamp, UNIX milliseconds"}},"required":["pinned","cid","provider","status","settled","ts"],"additionalProperties":false}}}},"400":{"description":"Invalid parameter or malformed payment envelope (RFC 7807).","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"402":{"description":"Payment required. PAYMENT-REQUIRED header carries the base64 x402 v2 requirements; body is RFC 7807 with a remedy block.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"base64 JSON x402 PaymentRequired (accepts[], resource)"},"WWW-Authenticate":{"schema":{"type":"string"},"description":"RFC 9110 Payment challenge (id, realm, method, intent, request, expires)"}},"content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"409":{"description":"REPLAY_DETECTED or PAYMENT_PENDING (RFC 7807).","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"429":{"description":"Rate limited; honor Retry-After.","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"503":{"description":"Upstream unavailable; the caller is not charged.","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"content":{"type":["object","string"],"description":"JSON object or string to store (serialized size up to 8 KB).","examples":[{"agent":"planner-1","decision":"hold","at":1789650000}]},"name":{"type":"string","maxLength":120,"description":"Optional human label stored with the pin."}},"required":["content"],"additionalProperties":false}}}}}},"/api/agent/attest":{"post":{"operationId":"attest_agent","summary":"EIP-712 signed, timestamped attestation over an agent state digest, verifiable offline.","description":"EIP-712 signed, timestamped attestation binding an agentId, the keccak256 digest of a declared state, and the paying wallet; attestor key at /transparency, verify offline with ethers.verifyTypedData. MUST be invoked when an agent needs third-party, non-repudiable proof that a state or decision existed at a point in time (audit trails, hand-offs, escrow). Do NOT use for hardware TEE, zk proofs or on-chain EAS. Settles $0.040 USDC via x402 on Base; no charge on failure; receipts at /api/ledger.","tags":["attestation"],"x-bazaar":{"discoverable":true,"category":"attestation","cost":{"amount":"40000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","network":"eip155:8453","humanReadable":"$0.040"},"settlement":"after-handler; canceled on non-2xx (no charge on failure)","qualityScoreFactors":{"deterministicOutputs":true,"replayProtected":true,"receiptGated":true}},"responses":{"200":{"description":"Paid response. PAYMENT-RESPONSE header carries the base64 facilitator settlement receipt (transaction hash, network, payer).","headers":{"PAYMENT-RESPONSE":{"schema":{"type":"string"},"description":"base64 JSON settlement receipt from the facilitator"},"Server-Timing":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"attestation":{"type":"string","enum":["SIGNED"],"description":"Attestation status"},"attestationId":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$","description":"keccak256 of the signature"},"attestor":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Gateway attestor address (published at /transparency)"},"digest":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$","description":"EIP-712 typed-data hash that was signed"},"signature":{"type":"string","description":"65-byte secp256k1 signature, hex"},"eip712":{"type":"object","description":"domain, types, primaryType and message needed to verify offline"},"verify":{"type":"string","description":"One-line verification recipe"},"teeProvider":{"type":["string","null"],"description":"Hardware TEE provider when configured, else null"},"enclaveRpc":{"type":["string","null"],"description":"Enclave verification endpoint when configured, else null"},"teeQuote":{"type":["string","null"],"description":"Hardware quote when a TEE is configured, else null"},"settled":{"type":"boolean","description":"true when an x402 payment settled for this response"},"ts":{"type":"integer","description":"Response timestamp, UNIX milliseconds"}},"required":["attestation","attestationId","attestor","digest","signature","eip712","settled","ts"],"additionalProperties":false}}}},"400":{"description":"Invalid parameter or malformed payment envelope (RFC 7807).","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"402":{"description":"Payment required. PAYMENT-REQUIRED header carries the base64 x402 v2 requirements; body is RFC 7807 with a remedy block.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"base64 JSON x402 PaymentRequired (accepts[], resource)"},"WWW-Authenticate":{"schema":{"type":"string"},"description":"RFC 9110 Payment challenge (id, realm, method, intent, request, expires)"}},"content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"409":{"description":"REPLAY_DETECTED or PAYMENT_PENDING (RFC 7807).","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"429":{"description":"Rate limited; honor Retry-After.","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"503":{"description":"Upstream unavailable; the caller is not charged.","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"agentId":{"type":"string","minLength":1,"maxLength":200,"description":"Stable identifier or EVM address of the agent being attested.","examples":["agent-0x402-1","did:web:example.com:agents:planner"]},"state":{"type":"string","maxLength":8192,"description":"Serialized state, decision, or payload hash to bind. Hashed with keccak256(utf8); the raw string is never stored.","examples":["{\"task\":\"rebalance\",\"decision\":\"hold\",\"at\":1789650000}"]}},"required":["agentId"],"additionalProperties":false}}}}}},"/api/seller/vet":{"get":{"operationId":"vet_seller","summary":"Scored, signed verdict on any x402 seller: challenge shape, Bazaar usage, trust surfaces.","description":"Vet an x402 seller before paying it: probes its live 402, reads its CDP Bazaar entry (payers, calls, last call, repeat vs evaluation usage), checks trust surfaces, returns a scored LIVE/STALE/UNLISTED/MISCONFIGURED/UNREACHABLE verdict and what changed since our last check, signed by our attestor. MUST be invoked before a first payment to an unknown resource, or on a schedule to watch it. Do NOT use to pay it. Settles $0.010 USDC; no charge on failure; receipts at /api/ledger.","tags":["trust"],"x-bazaar":{"discoverable":true,"category":"trust","cost":{"amount":"10000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","network":"eip155:8453","humanReadable":"$0.010"},"settlement":"after-handler; canceled on non-2xx (no charge on failure)","qualityScoreFactors":{"deterministicOutputs":true,"replayProtected":true,"receiptGated":true}},"responses":{"200":{"description":"Paid response. PAYMENT-RESPONSE header carries the base64 facilitator settlement receipt (transaction hash, network, payer).","headers":{"PAYMENT-RESPONSE":{"schema":{"type":"string"},"description":"base64 JSON settlement receipt from the facilitator"},"Server-Timing":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"resource":{"type":"string","description":"Normalized resource URL that was vetted"},"method":{"type":"string","enum":["GET","POST"]},"checkedAt":{"type":"string","description":"ISO-8601 time of the probe"},"verdict":{"type":"string","enum":["LIVE","STALE","UNLISTED","MISCONFIGURED","UNREACHABLE"],"description":"LIVE = payable, indexed, recently called. STALE = indexed but not called within VET_STALE_DAYS. UNLISTED = payable but never counted by the Bazaar. MISCONFIGURED = an x402 buyer cannot pay it as served. UNREACHABLE = no answer."},"score":{"type":"integer","minimum":0,"maximum":100,"description":"40 challenge shape + 40 Bazaar usage + 20 trust surfaces"},"usagePattern":{"type":"string","enum":["none","evaluation","repeat","unknown"],"description":"repeat = calls/payer at or above the repeat threshold; evaluation = buyers try once and leave"},"findings":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"severity":{"type":"string","enum":["critical","high","medium","low","info"]},"message":{"type":"string"}},"required":["code","severity","message"],"additionalProperties":false},"description":"Every deduction, machine-coded and human-readable"},"challenge":{"type":"object","description":"What the target 402 actually said: status, x402Version, accepts[0], description length, WWW-Authenticate presence, networks offered"},"bazaar":{"type":"object","description":"CDP Bazaar index entry for the resource: indexed, lastCalledAt, uniquePayers30d, totalCalls30d, callsPerPayer"},"trust":{"type":"object","description":"Which of /.well-known/x402, /llms.txt, /.well-known/security.txt, /transparency the origin publishes"},"previous":{"type":["object","null"],"description":"Summary of the last verdict this gateway issued for the same resource (checkedAt, verdict, score, usagePattern); null on first check. Call on a schedule and this is your watch."},"changes":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"from":{},"to":{}},"required":["field","from","to"],"additionalProperties":false},"description":"Fields that differ from the previous verdict (verdict, score, usagePattern, findingCodes, priceUsdc, payTo, indexed, uniquePayers30d, totalCalls30d, lastCalledAt); empty when unchanged or first check"},"attestation":{"type":["object","null"],"description":"EIP-712 signature over resource, checkedAt, verdict, score, usagePattern and changes by the published attestor, verifiable offline; null when the attestor is unconfigured"},"settled":{"type":"boolean","description":"true when an x402 payment settled for this response"},"ts":{"type":"integer","description":"Response timestamp, UNIX milliseconds"}},"required":["resource","method","checkedAt","verdict","score","usagePattern","findings","challenge","bazaar","trust","previous","changes","settled","ts"],"additionalProperties":false}}}},"400":{"description":"Invalid parameter or malformed payment envelope (RFC 7807).","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"402":{"description":"Payment required. PAYMENT-REQUIRED header carries the base64 x402 v2 requirements; body is RFC 7807 with a remedy block.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"base64 JSON x402 PaymentRequired (accepts[], resource)"},"WWW-Authenticate":{"schema":{"type":"string"},"description":"RFC 9110 Payment challenge (id, realm, method, intent, request, expires)"}},"content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"409":{"description":"REPLAY_DETECTED or PAYMENT_PENDING (RFC 7807).","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"429":{"description":"Rate limited; honor Retry-After.","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"503":{"description":"Upstream unavailable; the caller is not charged.","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}}},"parameters":[{"name":"resource","in":"query","required":true,"schema":{"type":"string","pattern":"^https://","maxLength":2048,"description":"Absolute https URL of the x402 resource to vet (the paid route itself, not the seller homepage).","examples":["https://seller.example/api/route"]},"description":"Absolute https URL of the x402 resource to vet (the paid route itself, not the seller homepage)."},{"name":"method","in":"query","required":false,"schema":{"type":"string","enum":["GET","POST"],"default":"GET","description":"HTTP method the resource expects; POST resources are probed with an empty JSON body."},"description":"HTTP method the resource expects; POST resources are probed with an empty JSON body."}]}},"/api/market/verdict":{"get":{"operationId":"get_market_verdict","summary":"Attested, rule-based verdict on one Polymarket market: lean, confidence, reasons, signed before resolution.","description":"Rule-based verdict on one Polymarket market by slug: YES/NO/TOSS_UP lean, 0-100 confidence with every reason stated (price distance, liquidity, volume, spread, momentum), days to resolution, and an EIP-712 attestation so an agent can prove what it read and when. Not a forecast model. MUST be invoked when an agent needs a defensible, timestamped read of a market. Do NOT use to discover markets (use market/signal). Settles $0.020 USDC; no charge on failure; receipts at /api/ledger.","tags":["market-data"],"x-bazaar":{"discoverable":true,"category":"market-data","cost":{"amount":"20000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","network":"eip155:8453","humanReadable":"$0.020"},"settlement":"after-handler; canceled on non-2xx (no charge on failure)","qualityScoreFactors":{"deterministicOutputs":true,"replayProtected":true,"receiptGated":true}},"responses":{"200":{"description":"Paid response. PAYMENT-RESPONSE header carries the base64 facilitator settlement receipt (transaction hash, network, payer).","headers":{"PAYMENT-RESPONSE":{"schema":{"type":"string"},"description":"base64 JSON settlement receipt from the facilitator"},"Server-Timing":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"slug":{"type":"string"},"question":{"type":"string"},"lean":{"type":"string","enum":["YES","NO","TOSS_UP"],"description":"Where the crowd sits at the lean thresholds"},"confidence":{"type":"integer","minimum":0,"maximum":100,"description":"How much the reading can be trusted, per the stated rules"},"confidenceBand":{"type":"string","enum":["HIGH","MEDIUM","LOW"]},"impliedProbability":{"type":["number","null"]},"daysToResolution":{"type":["number","null"]},"reasons":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"effect":{"type":"string"},"message":{"type":"string"}},"required":["code","effect","message"],"additionalProperties":false},"description":"Every rule that fired and its effect on the verdict"},"method":{"type":"string","description":"The exact rules and thresholds used, so the verdict is reproducible"},"market":{"type":"object","properties":{"id":{"type":"string","description":"Polymarket market id"},"slug":{"type":"string","description":"URL slug of the market"},"question":{"type":"string","description":"Market question text"},"conditionId":{"type":["string","null"],"description":"On-chain condition id (bytes32 hex)"},"outcomes":{"type":"array","items":{"type":"string"},"description":"Outcome labels, index-aligned with outcomePrices"},"outcomePrices":{"type":"array","items":{"type":"number"},"description":"Current outcome prices in [0,1] (implied probabilities)"},"impliedProbability":{"type":["number","null"],"description":"Price of the first outcome (YES) in [0,1]"},"bestBid":{"type":["number","null"],"description":"Best bid for the first outcome"},"bestAsk":{"type":["number","null"],"description":"Best ask for the first outcome"},"spread":{"type":["number","null"],"description":"bestAsk - bestBid"},"oneDayPriceChange":{"type":["number","null"],"description":"24h change of the first outcome price (absolute, in probability points)"},"momentum":{"type":"string","enum":["RISING","FALLING","FLAT","UNKNOWN"],"description":"Deterministic label: RISING if 24h change >= +0.02, FALLING if <= -0.02, else FLAT"},"volume24hr":{"type":["number","null"],"description":"24h notional volume in USD"},"liquidity":{"type":["number","null"],"description":"Order-book liquidity in USD"},"endDate":{"type":["string","null"],"description":"ISO-8601 market end date"},"derived":{"type":"object","description":"Fields not in the free listing: computed from the CLOB price history and the public trade tape. Null with a reason in errors when a provider is unavailable.","properties":{"priceDelta1h":{"type":["number","null"],"description":"YES price now minus YES price 1h ago"},"priceDelta6h":{"type":["number","null"],"description":"YES price now minus YES price 6h ago"},"realizedVol24h":{"type":["number","null"],"description":"Std-dev of 10-minute log returns over the last 24h"},"historySamples":{"type":"integer","description":"Price points used"},"whaleFlow":{"type":["object","null"],"description":"Trade-tape summary over the last 6h; BUY of NO counts as SELL of YES","properties":{"windowSec":{"type":"integer"},"trades":{"type":"integer"},"buyYesUsdc":{"type":"number"},"sellYesUsdc":{"type":"number"},"netYesUsdc":{"type":"number"},"largestTradeUsdc":{"type":"number"},"whaleThresholdUsdc":{"type":"number"},"whaleTrades":{"type":"integer"},"flow":{"type":"string","enum":["YES_ACCUMULATION","YES_DISTRIBUTION","BALANCED","NO_TRADES"]}},"required":["windowSec","trades","netYesUsdc","largestTradeUsdc","whaleTrades","flow"],"additionalProperties":false},"errors":{"type":"array","items":{"type":"string"},"description":"Provider-scoped reasons a derived field is null (e.g. clob:timeout)"}},"required":["priceDelta1h","priceDelta6h","realizedVol24h","whaleFlow","errors"],"additionalProperties":false}},"required":["id","slug","question","outcomes","outcomePrices","impliedProbability","momentum"],"additionalProperties":false},"asOf":{"type":"string"},"attestation":{"type":["object","null"],"description":"EIP-712 signature over slug, asOf, lean, confidence and impliedProbability by the published attestor; null when unconfigured"},"settled":{"type":"boolean"},"ts":{"type":"integer"}},"required":["slug","question","lean","confidence","confidenceBand","impliedProbability","daysToResolution","reasons","method","market","asOf","settled","ts"],"additionalProperties":false}}}},"400":{"description":"Invalid parameter or malformed payment envelope (RFC 7807).","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"402":{"description":"Payment required. PAYMENT-REQUIRED header carries the base64 x402 v2 requirements; body is RFC 7807 with a remedy block.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"base64 JSON x402 PaymentRequired (accepts[], resource)"},"WWW-Authenticate":{"schema":{"type":"string"},"description":"RFC 9110 Payment challenge (id, realm, method, intent, request, expires)"}},"content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"409":{"description":"REPLAY_DETECTED or PAYMENT_PENDING (RFC 7807).","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"429":{"description":"Rate limited; honor Retry-After.","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"503":{"description":"Upstream unavailable; the caller is not charged.","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}}},"parameters":[{"name":"slug","in":"query","required":true,"schema":{"type":"string","pattern":"^[a-z0-9-]{3,200}$","maxLength":200,"description":"Polymarket market slug (get one from market/signal).","examples":["will-there-be-no-change-in-fed-interest-rates-after-the-october-2026-meeting-20260617190324031"]},"description":"Polymarket market slug (get one from market/signal)."}]}},"/api/census/verdict":{"get":{"operationId":"census_verdict","summary":"Signed pay/caution/avoid verdict for any Bazaar-indexed x402 resource or payTo, from the continuous census; bulk feed for routers.","description":"Pre-spend check from the seller census: each Bazaar-indexed resource is re-probed periodically (liveness, 402-envelope compliance, declared output schema, latency, usage) and mapped to pay | caution | avoid with an EIP-712 signature a router checks offline. Query one resource, a payTo, or page the feed by verdict. MUST be invoked before dispatching to an unknown seller. Do NOT use to probe on demand (see /api/seller/vet). Settles $0.002 USDC; no charge on failure; receipts at /api/ledger.","tags":["trust"],"x-bazaar":{"discoverable":true,"category":"trust","cost":{"amount":"2000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","network":"eip155:8453","humanReadable":"$0.002"},"settlement":"after-handler; canceled on non-2xx (no charge on failure)","qualityScoreFactors":{"deterministicOutputs":true,"replayProtected":true,"receiptGated":true}},"responses":{"200":{"description":"Paid response. PAYMENT-RESPONSE header carries the base64 facilitator settlement receipt (transaction hash, network, payer).","headers":{"PAYMENT-RESPONSE":{"schema":{"type":"string"},"description":"base64 JSON settlement receipt from the facilitator"},"Server-Timing":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"mode":{"type":"string","enum":["resource","payTo","feed"]},"items":{"type":"array","items":{"type":"object","properties":{"resource":{"type":"string"},"payTo":{"type":["string","null"]},"verdict":{"type":"string","enum":["pay","caution","avoid"]},"score":{"type":"integer"},"vetVerdict":{"type":"string"},"schemaDeclared":{"type":"boolean"},"latencyMs":{"type":["integer","null"]},"checkedAt":{"type":"string"},"stale":{"type":"boolean"},"attestation":{"type":["object","null"]}},"required":["resource","verdict","score","checkedAt"]}},"total":{"type":"integer"},"census":{"type":"object","description":"Sweep status: assessed count, cadence, last sweep."},"settled":{"type":"boolean"},"ts":{"type":"integer"}},"required":["mode","items","total","census","settled","ts"],"additionalProperties":false}}}},"400":{"description":"Invalid parameter or malformed payment envelope (RFC 7807).","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"402":{"description":"Payment required. PAYMENT-REQUIRED header carries the base64 x402 v2 requirements; body is RFC 7807 with a remedy block.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"base64 JSON x402 PaymentRequired (accepts[], resource)"},"WWW-Authenticate":{"schema":{"type":"string"},"description":"RFC 9110 Payment challenge (id, realm, method, intent, request, expires)"}},"content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"409":{"description":"REPLAY_DETECTED or PAYMENT_PENDING (RFC 7807).","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"429":{"description":"Rate limited; honor Retry-After.","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"503":{"description":"Upstream unavailable; the caller is not charged.","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}}},"parameters":[{"name":"resource","in":"query","required":false,"schema":{"type":"string","pattern":"^https://","maxLength":2048,"description":"Absolute https URL of one x402 resource."},"description":"Absolute https URL of one x402 resource."},{"name":"payTo","in":"query","required":false,"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"EVM payee address; returns every assessed resource paid to it."},"description":"EVM payee address; returns every assessed resource paid to it."},{"name":"verdict","in":"query","required":false,"schema":{"type":"string","enum":["pay","caution","avoid"],"description":"Bulk feed filter (used when neither resource nor payTo is given)."},"description":"Bulk feed filter (used when neither resource nor payTo is given)."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":500,"default":100,"description":"Bulk feed page size."},"description":"Bulk feed page size."},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"description":"Bulk feed page offset."},"description":"Bulk feed page offset."}]}},"/api/census/export":{"get":{"operationId":"census_export","summary":"Full signed census dump: every fresh pay/caution/avoid verdict across the Bazaar in one call, with a manifest digest signed by the attestor.","description":"Whole-Bazaar seller census in one payload: every fresh verdict row (resource, payTo, verdict, score, schema, latency, checkedAt, per-row signature) plus a sha256 manifest and one EIP-712 attestation over it, so a router verifies the full dump offline. MUST be invoked when an agent needs the complete trust map for routing or analytics. Do NOT use for a single lookup (see /api/census/verdict). Settles $3.500 USDC; no charge on failure; receipts at /api/ledger.","tags":["trust"],"x-bazaar":{"discoverable":true,"category":"trust","cost":{"amount":"3500000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","network":"eip155:8453","humanReadable":"$3.500"},"settlement":"after-handler; canceled on non-2xx (no charge on failure)","qualityScoreFactors":{"deterministicOutputs":true,"replayProtected":true,"receiptGated":true}},"responses":{"200":{"description":"Paid response. PAYMENT-RESPONSE header carries the base64 facilitator settlement receipt (transaction hash, network, payer).","headers":{"PAYMENT-RESPONSE":{"schema":{"type":"string"},"description":"base64 JSON settlement receipt from the facilitator"},"Server-Timing":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"generatedAt":{"type":"string"},"count":{"type":"integer"},"counts":{"type":"object","properties":{"pay":{"type":"integer"},"caution":{"type":"integer"},"avoid":{"type":"integer"}}},"sha256":{"type":"string","description":"Hex sha256 of JSON.stringify(items)."},"items":{"type":"array","items":{"type":"object","properties":{"resource":{"type":"string"},"payTo":{"type":["string","null"]},"verdict":{"type":"string","enum":["pay","caution","avoid"]},"score":{"type":"integer"},"vetVerdict":{"type":"string"},"schemaDeclared":{"type":"boolean"},"latencyMs":{"type":["integer","null"]},"checkedAt":{"type":"string"},"attestation":{"type":["object","null"]}},"required":["resource","verdict","score","checkedAt"]}},"attestation":{"type":["object","null"],"description":"EIP-712 signature over generatedAt, sha256, count and counts by the published attestor; null when unconfigured"},"census":{"type":"object","description":"Sweep status: assessed count, cadence, last sweep."},"settled":{"type":"boolean"},"ts":{"type":"integer"}},"required":["generatedAt","count","counts","sha256","items","census","settled","ts"],"additionalProperties":false}}}},"400":{"description":"Invalid parameter or malformed payment envelope (RFC 7807).","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"402":{"description":"Payment required. PAYMENT-REQUIRED header carries the base64 x402 v2 requirements; body is RFC 7807 with a remedy block.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"base64 JSON x402 PaymentRequired (accepts[], resource)"},"WWW-Authenticate":{"schema":{"type":"string"},"description":"RFC 9110 Payment challenge (id, realm, method, intent, request, expires)"}},"content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"409":{"description":"REPLAY_DETECTED or PAYMENT_PENDING (RFC 7807).","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"429":{"description":"Rate limited; honor Retry-After.","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"503":{"description":"Upstream unavailable; the caller is not charged.","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}}},"parameters":[{"name":"includeStale","in":"query","required":false,"schema":{"type":"boolean","default":false,"description":"Include rows older than the verdict TTL."},"description":"Include rows older than the verdict TTL."}]}},"/api/compute/hash":{"post":{"operationId":"compute_hash","summary":"Deterministic hashing: SHA-256, SHA-384, SHA-512, HMAC, PBKDF2, scrypt.","description":"Deterministic hashing of arbitrary input: SHA-256, SHA-384, SHA-512, HMAC-SHA256, PBKDF2, scrypt. Returns hex digest. MUST be invoked when an agent needs a cryptographic hash or key derivation. Do NOT use for encryption or signing. Settles $0.001 USDC; no charge on failure; receipts at /api/ledger.","tags":["compute"],"x-bazaar":{"discoverable":true,"category":"compute","cost":{"amount":"1000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","network":"eip155:8453","humanReadable":"$0.001"},"settlement":"after-handler; canceled on non-2xx (no charge on failure)","qualityScoreFactors":{"deterministicOutputs":true,"replayProtected":true,"receiptGated":true}},"responses":{"200":{"description":"Paid response. PAYMENT-RESPONSE header carries the base64 facilitator settlement receipt (transaction hash, network, payer).","headers":{"PAYMENT-RESPONSE":{"schema":{"type":"string"},"description":"base64 JSON settlement receipt from the facilitator"},"Server-Timing":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"algorithm":{"type":"string"},"digest":{"type":"string","description":"Hash output in the requested encoding"},"encoding":{"type":"string"},"inputLength":{"type":"integer"},"settled":{"type":"boolean"},"ts":{"type":"integer"}},"required":["algorithm","digest","encoding","inputLength","settled","ts"],"additionalProperties":false}}}},"400":{"description":"Invalid parameter or malformed payment envelope (RFC 7807).","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"402":{"description":"Payment required. PAYMENT-REQUIRED header carries the base64 x402 v2 requirements; body is RFC 7807 with a remedy block.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"base64 JSON x402 PaymentRequired (accepts[], resource)"},"WWW-Authenticate":{"schema":{"type":"string"},"description":"RFC 9110 Payment challenge (id, realm, method, intent, request, expires)"}},"content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"409":{"description":"REPLAY_DETECTED or PAYMENT_PENDING (RFC 7807).","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"429":{"description":"Rate limited; honor Retry-After.","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"503":{"description":"Upstream unavailable; the caller is not charged.","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"algorithm":{"type":"string","enum":["sha256","sha384","sha512","hmac-sha256","pbkdf2","scrypt"],"description":"Hash algorithm"},"input":{"type":"string","maxLength":100000,"description":"Data to hash (UTF-8 string)"},"key":{"type":"string","maxLength":1000,"description":"Key for HMAC/PBKDF2/scrypt (required for keyed algorithms)"},"encoding":{"type":"string","enum":["hex","base64"],"default":"hex","description":"Output encoding"}},"required":["algorithm","input"],"additionalProperties":false}}}}}},"/api/compute/encode":{"post":{"operationId":"compute_encode","summary":"Encode/decode: base64, hex, URL-encode, JWT decode, JSON stringify/parse.","description":"Encoding and decoding utility: base64 encode/decode, hex encode/decode, URL encode/decode, JWT decode (no verification), JSON stringify/parse. MUST be invoked when an agent needs format conversion. Do NOT use for cryptographic operations (use compute/hash). Settles $0.001 USDC; no charge on failure; receipts at /api/ledger.","tags":["compute"],"x-bazaar":{"discoverable":true,"category":"compute","cost":{"amount":"1000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","network":"eip155:8453","humanReadable":"$0.001"},"settlement":"after-handler; canceled on non-2xx (no charge on failure)","qualityScoreFactors":{"deterministicOutputs":true,"replayProtected":true,"receiptGated":true}},"responses":{"200":{"description":"Paid response. PAYMENT-RESPONSE header carries the base64 facilitator settlement receipt (transaction hash, network, payer).","headers":{"PAYMENT-RESPONSE":{"schema":{"type":"string"},"description":"base64 JSON settlement receipt from the facilitator"},"Server-Timing":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"operation":{"type":"string"},"result":{"description":"Encoded/decoded output (string or object for jwt-decode/json-parse)"},"inputLength":{"type":"integer"},"settled":{"type":"boolean"},"ts":{"type":"integer"}},"required":["operation","result","inputLength","settled","ts"],"additionalProperties":false}}}},"400":{"description":"Invalid parameter or malformed payment envelope (RFC 7807).","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"402":{"description":"Payment required. PAYMENT-REQUIRED header carries the base64 x402 v2 requirements; body is RFC 7807 with a remedy block.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"base64 JSON x402 PaymentRequired (accepts[], resource)"},"WWW-Authenticate":{"schema":{"type":"string"},"description":"RFC 9110 Payment challenge (id, realm, method, intent, request, expires)"}},"content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"409":{"description":"REPLAY_DETECTED or PAYMENT_PENDING (RFC 7807).","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"429":{"description":"Rate limited; honor Retry-After.","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"503":{"description":"Upstream unavailable; the caller is not charged.","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"operation":{"type":"string","enum":["base64-encode","base64-decode","hex-encode","hex-decode","url-encode","url-decode","jwt-decode","json-stringify","json-parse"],"description":"Operation to perform"},"input":{"type":"string","maxLength":500000,"description":"Data to encode/decode"}},"required":["operation","input"],"additionalProperties":false}}}}}},"/api/compute/search":{"post":{"operationId":"compute_search","summary":"Web search with ranked results and cited sources, designed for agent consumption.","description":"Web search returning ranked results with title, URL, description, and source domain. MUST be invoked when an agent needs current web information. Returns up to 10 results. Do NOT use for cached/static data lookups. Settles $0.005 USDC; no charge on failure; receipts at /api/ledger.","tags":["web-search"],"x-bazaar":{"discoverable":true,"category":"web-search","cost":{"amount":"5000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","network":"eip155:8453","humanReadable":"$0.005"},"settlement":"after-handler; canceled on non-2xx (no charge on failure)","qualityScoreFactors":{"deterministicOutputs":true,"replayProtected":true,"receiptGated":true}},"responses":{"200":{"description":"Paid response. PAYMENT-RESPONSE header carries the base64 facilitator settlement receipt (transaction hash, network, payer).","headers":{"PAYMENT-RESPONSE":{"schema":{"type":"string"},"description":"base64 JSON settlement receipt from the facilitator"},"Server-Timing":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string"},"results":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":"string"},"description":{"type":"string"},"domain":{"type":"string"}},"required":["title","url","description"],"additionalProperties":false}},"count":{"type":"integer"},"settled":{"type":"boolean"},"ts":{"type":"integer"}},"required":["query","results","count","settled","ts"],"additionalProperties":false}}}},"400":{"description":"Invalid parameter or malformed payment envelope (RFC 7807).","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"402":{"description":"Payment required. PAYMENT-REQUIRED header carries the base64 x402 v2 requirements; body is RFC 7807 with a remedy block.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"base64 JSON x402 PaymentRequired (accepts[], resource)"},"WWW-Authenticate":{"schema":{"type":"string"},"description":"RFC 9110 Payment challenge (id, realm, method, intent, request, expires)"}},"content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"409":{"description":"REPLAY_DETECTED or PAYMENT_PENDING (RFC 7807).","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"429":{"description":"Rate limited; honor Retry-After.","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"503":{"description":"Upstream unavailable; the caller is not charged.","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","maxLength":500,"description":"Search query"},"limit":{"type":"integer","minimum":1,"maximum":10,"default":5,"description":"Max results to return"}},"required":["query"],"additionalProperties":false}}}}}},"/api/compute/infer":{"post":{"operationId":"compute_infer","summary":"Cheap small-model text completion: prompt in, text (or JSON object) out. Token-capped, schema-declared.","description":"Cheap small-model text completion for agent sub-tasks: classify, extract, summarize, rewrite. MUST be invoked when an agent needs a short LLM answer without paying flagship rates. Prompt <=8000 chars, maxTokens <=1024, json:true forces a JSON object. Do NOT use for long-form generation or tool calling. Settles $0.003 USDC; no charge on failure; receipts at /api/ledger.","tags":["compute"],"x-bazaar":{"discoverable":true,"category":"compute","cost":{"amount":"3000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","network":"eip155:8453","humanReadable":"$0.003"},"settlement":"after-handler; canceled on non-2xx (no charge on failure)","qualityScoreFactors":{"deterministicOutputs":true,"replayProtected":true,"receiptGated":true}},"responses":{"200":{"description":"Paid response. PAYMENT-RESPONSE header carries the base64 facilitator settlement receipt (transaction hash, network, payer).","headers":{"PAYMENT-RESPONSE":{"schema":{"type":"string"},"description":"base64 JSON settlement receipt from the facilitator"},"Server-Timing":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"output":{"type":"string"},"model":{"type":"string"},"usage":{"type":"object","properties":{"promptTokens":{"type":"integer"},"completionTokens":{"type":"integer"}},"required":["promptTokens","completionTokens"]},"settled":{"type":"boolean"},"ts":{"type":"integer"}},"required":["output","model","usage","settled","ts"],"additionalProperties":false}}}},"400":{"description":"Invalid parameter or malformed payment envelope (RFC 7807).","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"402":{"description":"Payment required. PAYMENT-REQUIRED header carries the base64 x402 v2 requirements; body is RFC 7807 with a remedy block.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"base64 JSON x402 PaymentRequired (accepts[], resource)"},"WWW-Authenticate":{"schema":{"type":"string"},"description":"RFC 9110 Payment challenge (id, realm, method, intent, request, expires)"}},"content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"409":{"description":"REPLAY_DETECTED or PAYMENT_PENDING (RFC 7807).","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"429":{"description":"Rate limited; honor Retry-After.","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"503":{"description":"Upstream unavailable; the caller is not charged.","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string","maxLength":8000,"description":"User prompt","examples":["Classify the sentiment of: \"the settlement was fast and cheap\". Reply with one word."]},"system":{"type":"string","maxLength":2000,"description":"Optional system instruction"},"maxTokens":{"type":"integer","minimum":1,"maximum":1024,"default":256},"json":{"type":"boolean","default":false,"description":"Force a JSON object response"}},"required":["prompt"],"additionalProperties":false}}}}}},"/api/audit/host":{"post":{"operationId":"audit_host","summary":"Signed remediation audit of every assessed x402 endpoint on one host: verdicts, finding codes, severity and the exact fix for each.","description":"Full audit of one host's x402 surface from the continuous census: every assessed endpoint with its pay|caution|avoid verdict, score, and each finding code mapped to severity, business impact and the exact fix, under an EIP-712 attestation. MUST be invoked before remediating a host you own or are evaluating. Do NOT use for a single pre-spend verdict (see /api/census/verdict). Settles $25.000 USDC; no charge on failure; prepaid credit is drawn down first. Receipts at /api/ledger.","tags":["trust"],"x-bazaar":{"discoverable":true,"category":"trust","cost":{"amount":"25000000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","network":"eip155:8453","humanReadable":"$25.000"},"settlement":"after-handler; canceled on non-2xx (no charge on failure)","qualityScoreFactors":{"deterministicOutputs":true,"replayProtected":true,"receiptGated":true}},"responses":{"200":{"description":"Paid response. PAYMENT-RESPONSE header carries the base64 facilitator settlement receipt (transaction hash, network, payer).","headers":{"PAYMENT-RESPONSE":{"schema":{"type":"string"},"description":"base64 JSON settlement receipt from the facilitator"},"Server-Timing":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"kind":{"type":"string"},"generatedAt":{"type":"string"},"host":{"type":"string"},"assessed":{"type":"integer"},"counts":{"type":"object"},"worstScore":{"type":["integer","null"]},"payable":{"type":"boolean"},"blockingFindings":{"type":"array","items":{"type":"string"}},"findingTally":{"type":"object"},"resources":{"type":"array","items":{"type":"object"}},"attestation":{"type":["object","null"]}},"required":["kind","host","assessed","counts","resources"]}}}},"400":{"description":"Invalid parameter or malformed payment envelope (RFC 7807).","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"402":{"description":"Payment required. PAYMENT-REQUIRED header carries the base64 x402 v2 requirements; body is RFC 7807 with a remedy block.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"base64 JSON x402 PaymentRequired (accepts[], resource)"},"WWW-Authenticate":{"schema":{"type":"string"},"description":"RFC 9110 Payment challenge (id, realm, method, intent, request, expires)"}},"content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"409":{"description":"REPLAY_DETECTED or PAYMENT_PENDING (RFC 7807).","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"429":{"description":"Rate limited; honor Retry-After.","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"503":{"description":"Upstream unavailable; the caller is not charged.","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"host":{"type":"string","maxLength":253,"description":"Domain or https URL, e.g. \"example.com\" or \"https://example.com/api/x\"."}},"required":["host"],"additionalProperties":false}}}}}},"/api/audit/portfolio":{"post":{"operationId":"audit_portfolio","summary":"The host audit across up to 50 hosts as one signed corpus, with a 30-day re-check date.","description":"The host audit across up to 50 hosts as one signed corpus: per-endpoint verdicts, finding codes and remediation, roll-up totals and a 30-day recheck date, under one EIP-712 attestation. MUST be invoked when routing spend across many sellers at once. Do NOT use for a single host (see /api/audit/host). Settles $150.000 USDC; no charge on failure; prepaid credit is drawn down first. Receipts at /api/ledger.","tags":["trust"],"x-bazaar":{"discoverable":true,"category":"trust","cost":{"amount":"150000000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","network":"eip155:8453","humanReadable":"$150.000"},"settlement":"after-handler; canceled on non-2xx (no charge on failure)","qualityScoreFactors":{"deterministicOutputs":true,"replayProtected":true,"receiptGated":true}},"responses":{"200":{"description":"Paid response. PAYMENT-RESPONSE header carries the base64 facilitator settlement receipt (transaction hash, network, payer).","headers":{"PAYMENT-RESPONSE":{"schema":{"type":"string"},"description":"base64 JSON settlement receipt from the facilitator"},"Server-Timing":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"kind":{"type":"string"},"generatedAt":{"type":"string"},"hosts":{"type":"integer"},"totals":{"type":"object"},"recheckDueAt":{"type":"string"},"items":{"type":"array","items":{"type":"object"}},"attestation":{"type":["object","null"]}},"required":["kind","hosts","totals","items"]}}}},"400":{"description":"Invalid parameter or malformed payment envelope (RFC 7807).","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"402":{"description":"Payment required. PAYMENT-REQUIRED header carries the base64 x402 v2 requirements; body is RFC 7807 with a remedy block.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"base64 JSON x402 PaymentRequired (accepts[], resource)"},"WWW-Authenticate":{"schema":{"type":"string"},"description":"RFC 9110 Payment challenge (id, realm, method, intent, request, expires)"}},"content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"409":{"description":"REPLAY_DETECTED or PAYMENT_PENDING (RFC 7807).","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"429":{"description":"Rate limited; honor Retry-After.","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"503":{"description":"Upstream unavailable; the caller is not charged.","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"hosts":{"type":"array","minItems":1,"maxItems":50,"items":{"type":"string","maxLength":253},"description":"Domains or https URLs; duplicates are collapsed and the list is capped at 50."}},"required":["hosts"],"additionalProperties":false}}}}}},"/api/census/license":{"get":{"operationId":"census_license","summary":"Full signed census dump under a commercial redistribution licence, with a monthly refresh entitlement.","description":"Everything /api/census/export returns, plus the right to redistribute it in your own product and refreshed dumps for 30 days. One manifest digest and one EIP-712 attestation verify the whole corpus offline. MUST be invoked when you need the corpus rather than a lookup. Do NOT use for a single resource verdict (see /api/census/verdict). Settles $300.000 USDC; no charge on failure; prepaid credit is drawn down first. Receipts at /api/ledger.","tags":["trust"],"x-bazaar":{"discoverable":true,"category":"trust","cost":{"amount":"300000000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","network":"eip155:8453","humanReadable":"$300.000"},"settlement":"after-handler; canceled on non-2xx (no charge on failure)","qualityScoreFactors":{"deterministicOutputs":true,"replayProtected":true,"receiptGated":true}},"responses":{"200":{"description":"Paid response. PAYMENT-RESPONSE header carries the base64 facilitator settlement receipt (transaction hash, network, payer).","headers":{"PAYMENT-RESPONSE":{"schema":{"type":"string"},"description":"base64 JSON settlement receipt from the facilitator"},"Server-Timing":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"licence":{"type":"object"},"generatedAt":{"type":"string"},"rows":{"type":"array","items":{"type":"object"}},"manifestDigest":{"type":"string"},"attestation":{"type":["object","null"]}},"required":["licence","rows"]}}}},"400":{"description":"Invalid parameter or malformed payment envelope (RFC 7807).","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"402":{"description":"Payment required. PAYMENT-REQUIRED header carries the base64 x402 v2 requirements; body is RFC 7807 with a remedy block.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"base64 JSON x402 PaymentRequired (accepts[], resource)"},"WWW-Authenticate":{"schema":{"type":"string"},"description":"RFC 9110 Payment challenge (id, realm, method, intent, request, expires)"}},"content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"409":{"description":"REPLAY_DETECTED or PAYMENT_PENDING (RFC 7807).","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"429":{"description":"Rate limited; honor Retry-After.","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"503":{"description":"Upstream unavailable; the caller is not charged.","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}}},"parameters":[{"name":"includeStale","in":"query","required":false,"schema":{"type":"boolean","default":false,"description":"Include rows past the freshness window."},"description":"Include rows past the freshness window."}]}},"/api/credit/block":{"post":{"operationId":"buy_credit_block","summary":"Buy a prepaid credit block; audits draw it down with no further settlement.","description":"Buy one prepaid block of $50.000 credit, held against the paying wallet address - no account, no API key. Audits and the census licence spend it automatically before requesting any new settlement; check any balance free at GET /api/credit/balance. MUST be invoked before a run of audits to avoid per-call settlement. Do NOT use on a free or dry-run call, which has no payer to credit. Settles $50.000 USDC; no charge on failure. Receipts at /api/ledger.","tags":["trust"],"x-bazaar":{"discoverable":true,"category":"trust","cost":{"amount":"50000000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","network":"eip155:8453","humanReadable":"$50.000"},"settlement":"after-handler; canceled on non-2xx (no charge on failure)","qualityScoreFactors":{"deterministicOutputs":true,"replayProtected":true,"receiptGated":true}},"responses":{"200":{"description":"Paid response. PAYMENT-RESPONSE header carries the base64 facilitator settlement receipt (transaction hash, network, payer).","headers":{"PAYMENT-RESPONSE":{"schema":{"type":"string"},"description":"base64 JSON settlement receipt from the facilitator"},"Server-Timing":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"address":{"type":"string"},"granted":{"type":"number"},"balance":{"type":"number"},"settled":{"type":"boolean"}},"required":["address","granted","balance"]}}}},"400":{"description":"Invalid parameter or malformed payment envelope (RFC 7807).","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"402":{"description":"Payment required. PAYMENT-REQUIRED header carries the base64 x402 v2 requirements; body is RFC 7807 with a remedy block.","headers":{"PAYMENT-REQUIRED":{"schema":{"type":"string"},"description":"base64 JSON x402 PaymentRequired (accepts[], resource)"},"WWW-Authenticate":{"schema":{"type":"string"},"description":"RFC 9110 Payment challenge (id, realm, method, intent, request, expires)"}},"content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"409":{"description":"REPLAY_DETECTED or PAYMENT_PENDING (RFC 7807).","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"429":{"description":"Rate limited; honor Retry-After.","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}},"503":{"description":"Upstream unavailable; the caller is not charged.","content":{"application/problem+json":{"schema":{"type":"object","properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"},"retryable":{"type":"boolean"},"remedy":{"type":"object","description":"Machine-actionable recovery instructions"}},"required":["type","title","status"]}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false}}}}}}}}