{"openapi":"3.1.0","info":{"title":"Sense by Quorumz — agent API","version":"1.0.0","summary":"World news for agents: each story split into the viewpoints being expressed, with support by source.","description":"Sense by Quorumz is current, geo-tagged world news for AI agents, organised as **quorums**. A quorum is one story split into the distinct viewpoints being expressed about it. Each viewpoint has a summary, a support count split by source (media, socials, and iWitness: first-hand reports from people on the ground) and a 0 to 1 confidence: how well sourced it is.\n\n**Feeds**\n\n- **Quorums**: the newest quorums, worldwide or for one country. $0.01 per quorum returned; one quorum by id $0.01.\n- **Alpha signals**: stories found ahead of the wider press, with the quorum on the story when there is one. Filter by country or geohash cell. $0.02 per event returned.\n- **News**: articles, each with the quorums on its story. $0.005 per event returned; one article by id $0.005.\n\n`limit` is records per page (1 by default, at most 50); pass `next_cursor` back as `cursor` for older records. You pay for the records returned: an empty page is free, and a missing id is a 404 and is not charged. The catalog and a sample quorum are free.\n\n**Two ways to pay, on every paid route**\n\n1. **API key**: `Authorization: Bearer qz_pk_live_…` from https://sense.quorumz.com/agents/keys. The first 100 calls within 7 days are free; then prepaid credits bought by card or PayPal, at the same prices. Each response's `payment` object shows the trial calls left or the credit balance.\n2. **x402**, no account: an unpaid call answers HTTP 402 with a `PAYMENT-REQUIRED` header offering an exact USDC payment on Base, Polygon or Arbitrum. Sign one and retry with `PAYMENT-SIGNATURE`; the receipt is the `PAYMENT-RESPONSE` header. Payments settle to `0x9ce92953d33237af061c6b1aa29c597c8656b547` (the `payTo` on every 402).\n\n**MCP**\n\nThe same feeds are tools on a remote MCP server (streamable HTTP) at `https://api.quorumz.com/mcp`, listed in the official MCP Registry as `com.quorumz.api/sense`. Send the same API key as `Authorization: Bearer <key>`; listing the tools and the free sample need no key.","termsOfService":"https://sense.quorumz.com/terms","contact":{"name":"Quorumz support","email":"support@quorumz.com","url":"https://sense.quorumz.com/agents/docs"},"x-guidance":"Quorumz: current, geo-tagged world news for agents. Each story is a quorum: the distinct viewpoints being expressed about it, each with a summary and a support_count split into media, social and on-the-ground posts. Alpha events flag stories ahead of the wider press.\n\nCall it when a user asks what is happening, or what people are saying, about a country, a conflict or a public story; wants the positions on a story rather than one headline; or wants an early signal. Not for general web search.\n\nGET routes, JSON out: /api/agent/v1 is the free catalog. /api/agent/v1/quorums?country=LB costs $0.01 per quorum returned; /api/agent/v1/quorums/{quorum_id} $0.01; /api/agent/v1/events?stream=alpha&country=LB $0.02 per event; /api/agent/v1/events?stream=news&country=LB $0.005 per event; /api/agent/v1/articles/{article_id} $0.005. Inputs: country is an ISO 3166 alpha-2 code; cell is a geohash of precision 3 to 5 (alpha); limit is records per page (1 by default, at most 50); cursor is the next_cursor of the previous page. An empty page is free; a paid call for a missing id is a 404 and is not charged.\n\nPay: an unpaid call answers HTTP 402 with a PAYMENT-REQUIRED header (x402 exact, USDC on Base, Polygon or Arbitrum); sign one of its accepts and retry with PAYMENT-SIGNATURE. Or send Authorization: Bearer <key> from https://sense.quorumz.com/agents/keys: the first 100 calls within 7 days are free, then prepaid credits by card. Docs: https://sense.quorumz.com/agents/docs"},"externalDocs":{"description":"Agent API docs","url":"https://sense.quorumz.com/agents/docs"},"servers":[{"url":"https://api.quorumz.com","description":"Production"}],"tags":[{"name":"Discovery","description":"Free: the catalog and a sample quorum."},{"name":"Quorums","description":"Stories split into viewpoints, with support by source."},{"name":"Events","description":"Alpha signals and news, as paged streams."},{"name":"Articles","description":"One news article with its quorums."}],"paths":{"/api/agent/v1":{"get":{"operationId":"getCatalog","summary":"Service catalog (free)","description":"What the API offers before you pay: the streams, every route and its price, both ways to pay, and whether payment is enforced. Free; no key.","tags":["Discovery"],"security":[],"responses":{"200":{"description":"The catalog.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Catalog"},"example":{"service":"Quorumz for agents","differentiator":"A quorum is one story split into the distinct viewpoints being expressed, with the number of media, social, and on-the-ground posts supporting each viewpoint.","streams":[{"name":"quorum","description":"Live quorums, each with viewpoints and support counts.","unit_price_usd":0.01,"path":"/api/agent/v1/quorums"},{"name":"alpha","description":"Signals before the wider press, with the quorum behind the story when one exists.","unit_price_usd":0.02,"path":"/api/agent/v1/events?stream=alpha"},{"name":"news","description":"Canonical news articles, each carrying its related quorums and viewpoints.","unit_price_usd":0.005,"path":"/api/agent/v1/events?stream=news"}],"routes":[{"method":"GET","path":"/api/agent/v1","price":"free","purpose":"This catalog."},{"method":"GET","path":"/api/agent/v1/sample","price":"free","purpose":"A recent, well-sourced quorum, in the shape /quorums returns."},{"method":"GET","path":"/api/agent/v1/quorums","price":"0.01 USD per quorum returned","query":["country","limit","cursor"]},{"method":"GET","path":"/api/agent/v1/quorums/{quorum_id}","price":"0.01 USD"},{"method":"GET","path":"/api/agent/v1/events","price":"0.02 USD per alpha event, 0.005 USD per news event","query":["stream","country","cell","limit","cursor"]},{"method":"GET","path":"/api/agent/v1/articles/{article_id}","price":"0.005 USD"}],"filters":["country","cell"],"access":[{"method":"x402","summary":"Pay per call in USDC on Base, Polygon or Arbitrum. No account.","how":"Call a route; on HTTP 402 sign the PAYMENT-REQUIRED authorization and retry with PAYMENT-SIGNATURE."},{"method":"api_key","summary":"An API key paid by credit card (or PayPal): the first 100 calls over 7 days are free, then prepaid credits at the same per-item prices, or a monthly plan.","how":"Sign up at signup, then send Authorization: Bearer <key> on every call.","signup":"https://sense.quorumz.com/agents/keys"}],"docs":"https://sense.quorumz.com/agents/docs","landing":"https://sense.quorumz.com/agents","payment":{"status":"enforced","scheme":"exact","network":"eip155:8453","networks":["eip155:8453","eip155:137","eip155:42161"],"pay_to":"0x9ce92953d33237af061c6b1aa29c597c8656b547","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","facilitator":"https://api.cdp.coinbase.com/platform/v2/x402","prices_usd":{"alpha":0.02,"news":0.005,"quorum":0.01}}}}},"headers":{"Cache-Control":{"description":"Cached for 5 minutes.","schema":{"type":"string","example":"public, max-age=300"}}}}},"x-price":"Free"}},"/api/agent/v1/sample":{"get":{"operationId":"getSampleQuorum","summary":"Sample quorum (free)","description":"One recent, well-sourced quorum (several viewpoints, support from several kinds of source), in exactly the page shape GET /api/agent/v1/quorums returns, without the `payment` object, plus `get_started`: how to get a free API key, the MCP server and x402. Free; no key. Check the data before paying.","tags":["Discovery"],"security":[],"responses":{"200":{"description":"A page with one quorum, and how to go on.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SamplePage"},"example":{"stream":"quorum","filter":{"world":true},"quorums":[{"quorum_id":"qrm_top_5f0c2a9e41b7d386","headline":"Border crossing closed after flood damage","summary":"Two readings of the closure: a short repair, or weeks of diverted freight.","category":"infrastructure","countries":["LB","SY"],"support_count":55,"confidence":0.68,"is_alpha":true,"updated_at":"2026-11-03T09:40:00Z","viewpoints":[{"viewpoint_id":"qrm_op_8d14e6b2a07c5f91","label":"The closure is temporary","summary":"Officials and local outlets say the crossing reopens once the approach road is repaired.","support_count":38,"support_by_source":{"media":11,"socials":25,"iwitness":2},"confidence":0.74,"is_alpha":false},{"viewpoint_id":"qrm_op_2b9f7e0c63a1d548","label":"Freight is diverted for weeks","summary":"Freight operators report rerouted shipments and multi-day waits at the next crossing north.","support_count":17,"support_by_source":{"media":3,"socials":14,"iwitness":0},"confidence":0.41,"is_alpha":true}],"article_url":"https://sense.quorumz.com/quorum/qrm_top_5f0c2a9e41b7d386"}],"next_cursor":null,"get_started":{"free_sample":"https://api.quorumz.com/api/agent/v1/sample","api_key":{"get_one":"https://sense.quorumz.com/agents/keys","how":"Sign in with your email to get a key, then send it as 'Authorization: Bearer <key>'.","free_trial":"the first 100 calls over 7 days","after_trial":"prepaid credits by credit card or PayPal"},"mcp":{"url":"https://api.quorumz.com/mcp","auth":"Authorization: Bearer <key>"},"x402":"https://api.quorumz.com/.well-known/x402"}}}},"headers":{"Cache-Control":{"description":"Cached for 5 minutes.","schema":{"type":"string","example":"public, max-age=300"}}}}},"x-price":"Free"}},"/api/agent/v1/quorums":{"get":{"operationId":"listQuorums","summary":"List quorums","description":"The newest quorums, each split into its viewpoints with support by source, worldwide or for one country. Page with `cursor`.\n\nPrice: $0.01 per quorum returned (at most $0.50 a page). An empty page is free.","tags":["Quorums"],"security":[{"apiKey":[]},{}],"parameters":[{"name":"country","in":"query","required":false,"description":"Only quorums about this country: an ISO 3166-1 alpha-2 code, any case. Omit for the whole world.","schema":{"type":"string","pattern":"^[A-Za-z]{2}$","minLength":2,"maxLength":2},"example":"LB"},{"name":"limit","in":"query","required":false,"description":"Quorums per page: 1 by default, at most 50 (a larger value returns 50). You pay for the quorums returned, not the number asked for.","schema":{"type":"integer","minimum":1,"maximum":50,"default":1},"example":10},{"name":"cursor","in":"query","required":false,"description":"Opaque. Pass the previous page's `next_cursor` to get the next, older page; omit it for the newest.","schema":{"type":"string"}},{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"description":"x402 only: the Base64 payment payload signing one of the `accepts` from this route's 402. Send it on the retry of the same request. Not needed with an API key.","schema":{"type":"string","contentEncoding":"base64"}}],"responses":{"200":{"description":"A page of quorums.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuorumFeedResponse"},"examples":{"x402":{"summary":"Paid with x402 (USDC on Polygon)","value":{"stream":"quorum","filter":{"country":"LB"},"quorums":[{"quorum_id":"qrm_top_5f0c2a9e41b7d386","headline":"Border crossing closed after flood damage","summary":"Two readings of the closure: a short repair, or weeks of diverted freight.","category":"infrastructure","countries":["LB","SY"],"support_count":55,"confidence":0.68,"is_alpha":true,"updated_at":"2026-11-03T09:40:00Z","viewpoints":[{"viewpoint_id":"qrm_op_8d14e6b2a07c5f91","label":"The closure is temporary","summary":"Officials and local outlets say the crossing reopens once the approach road is repaired.","support_count":38,"support_by_source":{"media":11,"socials":25,"iwitness":2},"confidence":0.74,"is_alpha":false},{"viewpoint_id":"qrm_op_2b9f7e0c63a1d548","label":"Freight is diverted for weeks","summary":"Freight operators report rerouted shipments and multi-day waits at the next crossing north.","support_count":17,"support_by_source":{"media":3,"socials":14,"iwitness":0},"confidence":0.41,"is_alpha":true}],"article_url":"https://sense.quorumz.com/quorum/qrm_top_5f0c2a9e41b7d386"}],"next_cursor":"2026-11-03T09:40:00Z|qrm_top_5f0c2a9e41b7d386","payment":{"status":"enforced","scheme":"exact","network":"eip155:137","networks":["eip155:8453","eip155:137","eip155:42161"],"pay_to":"0x9ce92953d33237af061c6b1aa29c597c8656b547","asset":"0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359","facilitator":"https://api.cdp.coinbase.com/platform/v2/x402","prices_usd":{"alpha":0.02,"news":0.005,"quorum":0.01},"charged_events":1,"settled":true}}},"api_key":{"summary":"Paid with an API key, in its free trial","value":{"stream":"quorum","filter":{"country":"LB"},"quorums":[{"quorum_id":"qrm_top_5f0c2a9e41b7d386","headline":"Border crossing closed after flood damage","summary":"Two readings of the closure: a short repair, or weeks of diverted freight.","category":"infrastructure","countries":["LB","SY"],"support_count":55,"confidence":0.68,"is_alpha":true,"updated_at":"2026-11-03T09:40:00Z","viewpoints":[{"viewpoint_id":"qrm_op_8d14e6b2a07c5f91","label":"The closure is temporary","summary":"Officials and local outlets say the crossing reopens once the approach road is repaired.","support_count":38,"support_by_source":{"media":11,"socials":25,"iwitness":2},"confidence":0.74,"is_alpha":false},{"viewpoint_id":"qrm_op_2b9f7e0c63a1d548","label":"Freight is diverted for weeks","summary":"Freight operators report rerouted shipments and multi-day waits at the next crossing north.","support_count":17,"support_by_source":{"media":3,"socials":14,"iwitness":0},"confidence":0.41,"is_alpha":true}],"article_url":"https://sense.quorumz.com/quorum/qrm_top_5f0c2a9e41b7d386"}],"next_cursor":"2026-11-03T09:40:00Z|qrm_top_5f0c2a9e41b7d386","payment":{"status":"enforced","scheme":"exact","network":"eip155:8453","networks":["eip155:8453","eip155:137","eip155:42161"],"pay_to":"0x9ce92953d33237af061c6b1aa29c597c8656b547","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","facilitator":"https://api.cdp.coinbase.com/platform/v2/x402","prices_usd":{"alpha":0.02,"news":0.005,"quorum":0.01},"charged_events":0,"settled":false,"plan":"trial","trial":{"active":true,"calls_used":12,"calls_left":88,"calls_limit":100,"ends_at":"2026-11-10T08:15:00+00:00"}}}}}}},"headers":{"PAYMENT-RESPONSE":{"$ref":"#/components/headers/PaymentResponse"}}},"400":{"description":"`country` is not a two-letter code.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"country":{"value":{"error":"country must be an ISO alpha-2 code"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"description":"Payment required ($0.01 per quorum). An unpaid call that would return records gets this, and no records: sign one of `accepts` (exact USDC on Base, Polygon or Arbitrum) and retry with PAYMENT-SIGNATURE, or call again with an API key. Also returned when an API key has no free calls or credits left (`error` no_credits or trial_over, with `get_a_key`), and when a payment does not verify or settle (`error` says why).","headers":{"PAYMENT-REQUIRED":{"$ref":"#/components/headers/PaymentRequired"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"},"examples":{"unpaid":{"summary":"An unpaid call that would return one quorum","value":{"x402Version":2,"resource":{"url":"https://api.quorumz.com/api/agent/v1/quorums","description":"One story, the viewpoints being expressed, and the posts supporting each viewpoint.","mimeType":"application/json","serviceName":"Quorumz","tags":["news","quorum","geopolitics"],"iconUrl":"https://sense.quorumz.com/brand/quorumz-tile-512.png"},"accepts":[{"scheme":"exact","network":"eip155:8453","amount":"10000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x9ce92953d33237af061c6b1aa29c597c8656b547","maxTimeoutSeconds":300,"extra":{"name":"USD Coin","version":"2"}},{"scheme":"exact","network":"eip155:137","amount":"10000","asset":"0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359","payTo":"0x9ce92953d33237af061c6b1aa29c597c8656b547","maxTimeoutSeconds":300,"extra":{"name":"USD Coin","version":"2"}},{"scheme":"exact","network":"eip155:42161","amount":"10000","asset":"0xaf88d065e77c8cC2239327C5EDb3A432268e5831","payTo":"0x9ce92953d33237af061c6b1aa29c597c8656b547","maxTimeoutSeconds":300,"extra":{"name":"USD Coin","version":"2"}}],"extensions":{"bazaar":{"info":{"input":{"type":"http","method":"GET","queryParams":{"country":"LB","limit":"1"}},"output":{"type":"json","example":{"stream":"quorum","filter":{"country":"LB"},"quorums":[{"quorum_id":"qrm_7c1e","headline":"Border crossing closed after flood damage","summary":"Two readings of the closure: a short repair or a long diversion of freight.","category":"infrastructure","countries":["LB"],"support_count":55,"confidence":0.68,"is_alpha":true,"updated_at":"2026-10-27T09:40:00Z","viewpoints":[{"viewpoint_id":"opn_8f2c","label":"The closure is temporary","summary":"Officials and local outlets say the crossing reopens once repairs finish.","support_count":38,"support_by_source":{"media":11,"socials":25,"iwitness":2},"confidence":0.74,"is_alpha":false},{"viewpoint_id":"opn_8f2d","label":"Traffic is being diverted for weeks","summary":"Freight operators report rerouted shipments and longer waits.","support_count":17,"support_by_source":{"media":3,"socials":14,"iwitness":0},"confidence":0.41,"is_alpha":true}],"article_url":"https://sense.quorumz.com/quorum/qrm_7c1e"}],"next_cursor":"c_2026-10-27T09:40:00Z_qrm_7c1e"}}},"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"input":{"type":"object","properties":{"type":{"type":"string","const":"http"},"method":{"type":"string","enum":["GET"]},"queryParams":{"type":"object","properties":{"country":{"type":"string"},"limit":{"type":"string"}}}},"required":["type","method"]},"output":{"type":"object","properties":{"type":{"type":"string"},"example":{"type":"object"}},"required":["type"]}},"required":["input"]}}},"error":"PAYMENT-SIGNATURE header is required","alternatives":{"api_key":{"signup":"https://sense.quorumz.com/agents/keys","pay_with":"credit card or PayPal","free_trial":"the first 100 calls over 7 days"}},"message":"This route is paid. Get a free API key at https://sense.quorumz.com/agents/keys and send it as 'Authorization: Bearer <key>', or pay per call with x402 (sign one of 'accepts' and retry with PAYMENT-SIGNATURE). The sample is free: https://api.quorumz.com/api/agent/v1/sample","get_started":{"free_sample":"https://api.quorumz.com/api/agent/v1/sample","api_key":{"get_one":"https://sense.quorumz.com/agents/keys","how":"Sign in with your email to get a key, then send it as 'Authorization: Bearer <key>'.","free_trial":"the first 100 calls over 7 days","after_trial":"prepaid credits by credit card or PayPal"},"mcp":{"url":"https://api.quorumz.com/mcp","auth":"Authorization: Bearer <key>"},"x402":"https://api.quorumz.com/.well-known/x402"}}}}}}},"422":{"$ref":"#/components/responses/InvalidParameter"}},"x-payment-info":{"protocols":["x402"],"network":"eip155:8453","networks":["eip155:8453","eip155:137","eip155:42161"],"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x9ce92953d33237af061c6b1aa29c597c8656b547","price":{"mode":"dynamic","currency":"USD","min":"0.01","max":"0.50"}},"x-price":"$0.01 per quorum returned"}},"/api/agent/v1/quorums/{quorum_id}":{"get":{"operationId":"getQuorum","summary":"Get one quorum","description":"One quorum by id, with all its viewpoints and their support by source.\n\nPrice: $0.01. A missing id is a 404 and is not charged.","tags":["Quorums"],"security":[{"apiKey":[]},{}],"parameters":[{"name":"quorum_id","in":"path","required":true,"description":"The quorum's id (`quorum_id` in any quorum).","schema":{"type":"string"},"example":"qrm_top_5f0c2a9e41b7d386"},{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"description":"x402 only: the Base64 payment payload signing one of the `accepts` from this route's 402. Send it on the retry of the same request. Not needed with an API key.","schema":{"type":"string","contentEncoding":"base64"}}],"responses":{"200":{"description":"The quorum.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuorumResponse"},"examples":{"x402":{"summary":"Paid with x402 (USDC on Polygon)","value":{"quorum_id":"qrm_top_5f0c2a9e41b7d386","headline":"Border crossing closed after flood damage","summary":"Two readings of the closure: a short repair, or weeks of diverted freight.","category":"infrastructure","countries":["LB","SY"],"support_count":55,"confidence":0.68,"is_alpha":true,"updated_at":"2026-11-03T09:40:00Z","viewpoints":[{"viewpoint_id":"qrm_op_8d14e6b2a07c5f91","label":"The closure is temporary","summary":"Officials and local outlets say the crossing reopens once the approach road is repaired.","support_count":38,"support_by_source":{"media":11,"socials":25,"iwitness":2},"confidence":0.74,"is_alpha":false},{"viewpoint_id":"qrm_op_2b9f7e0c63a1d548","label":"Freight is diverted for weeks","summary":"Freight operators report rerouted shipments and multi-day waits at the next crossing north.","support_count":17,"support_by_source":{"media":3,"socials":14,"iwitness":0},"confidence":0.41,"is_alpha":true}],"article_url":"https://sense.quorumz.com/quorum/qrm_top_5f0c2a9e41b7d386","payment":{"status":"enforced","scheme":"exact","network":"eip155:137","networks":["eip155:8453","eip155:137","eip155:42161"],"pay_to":"0x9ce92953d33237af061c6b1aa29c597c8656b547","asset":"0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359","facilitator":"https://api.cdp.coinbase.com/platform/v2/x402","prices_usd":{"alpha":0.02,"news":0.005,"quorum":0.01},"charged_events":1,"settled":true}}},"api_key":{"summary":"Paid with an API key, from prepaid credits","value":{"quorum_id":"qrm_top_5f0c2a9e41b7d386","headline":"Border crossing closed after flood damage","summary":"Two readings of the closure: a short repair, or weeks of diverted freight.","category":"infrastructure","countries":["LB","SY"],"support_count":55,"confidence":0.68,"is_alpha":true,"updated_at":"2026-11-03T09:40:00Z","viewpoints":[{"viewpoint_id":"qrm_op_8d14e6b2a07c5f91","label":"The closure is temporary","summary":"Officials and local outlets say the crossing reopens once the approach road is repaired.","support_count":38,"support_by_source":{"media":11,"socials":25,"iwitness":2},"confidence":0.74,"is_alpha":false},{"viewpoint_id":"qrm_op_2b9f7e0c63a1d548","label":"Freight is diverted for weeks","summary":"Freight operators report rerouted shipments and multi-day waits at the next crossing north.","support_count":17,"support_by_source":{"media":3,"socials":14,"iwitness":0},"confidence":0.41,"is_alpha":true}],"article_url":"https://sense.quorumz.com/quorum/qrm_top_5f0c2a9e41b7d386","payment":{"status":"enforced","scheme":"exact","network":"eip155:8453","networks":["eip155:8453","eip155:137","eip155:42161"],"pay_to":"0x9ce92953d33237af061c6b1aa29c597c8656b547","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","facilitator":"https://api.cdp.coinbase.com/platform/v2/x402","prices_usd":{"alpha":0.02,"news":0.005,"quorum":0.01},"charged_events":1,"settled":false,"plan":"credits","credits":{"charged_usd":0.01,"balance_usd":4.37}}}}}}},"headers":{"PAYMENT-RESPONSE":{"$ref":"#/components/headers/PaymentResponse"}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"description":"Payment required ($0.01). An unpaid call that would return records gets this, and no records: sign one of `accepts` (exact USDC on Base, Polygon or Arbitrum) and retry with PAYMENT-SIGNATURE, or call again with an API key. Also returned when an API key has no free calls or credits left (`error` no_credits or trial_over, with `get_a_key`), and when a payment does not verify or settle (`error` says why).","headers":{"PAYMENT-REQUIRED":{"$ref":"#/components/headers/PaymentRequired"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"},"examples":{"unpaid":{"summary":"An unpaid call","value":{"x402Version":2,"resource":{"url":"https://api.quorumz.com/api/agent/v1/quorums/qrm_top_5f0c2a9e41b7d386","description":"One story, the viewpoints being expressed, and the posts supporting each viewpoint.","mimeType":"application/json","serviceName":"Quorumz","tags":["news","quorum","geopolitics"],"iconUrl":"https://sense.quorumz.com/brand/quorumz-tile-512.png"},"accepts":[{"scheme":"exact","network":"eip155:8453","amount":"10000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x9ce92953d33237af061c6b1aa29c597c8656b547","maxTimeoutSeconds":300,"extra":{"name":"USD Coin","version":"2"}},{"scheme":"exact","network":"eip155:137","amount":"10000","asset":"0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359","payTo":"0x9ce92953d33237af061c6b1aa29c597c8656b547","maxTimeoutSeconds":300,"extra":{"name":"USD Coin","version":"2"}},{"scheme":"exact","network":"eip155:42161","amount":"10000","asset":"0xaf88d065e77c8cC2239327C5EDb3A432268e5831","payTo":"0x9ce92953d33237af061c6b1aa29c597c8656b547","maxTimeoutSeconds":300,"extra":{"name":"USD Coin","version":"2"}}],"extensions":{"bazaar":{"info":{"input":{"type":"http","method":"GET","queryParams":{}},"output":{"type":"json","example":{"stream":"quorum","filter":{"country":"LB"},"quorums":[{"quorum_id":"qrm_7c1e","headline":"Border crossing closed after flood damage","summary":"Two readings of the closure: a short repair or a long diversion of freight.","category":"infrastructure","countries":["LB"],"support_count":55,"confidence":0.68,"is_alpha":true,"updated_at":"2026-10-27T09:40:00Z","viewpoints":[{"viewpoint_id":"opn_8f2c","label":"The closure is temporary","summary":"Officials and local outlets say the crossing reopens once repairs finish.","support_count":38,"support_by_source":{"media":11,"socials":25,"iwitness":2},"confidence":0.74,"is_alpha":false},{"viewpoint_id":"opn_8f2d","label":"Traffic is being diverted for weeks","summary":"Freight operators report rerouted shipments and longer waits.","support_count":17,"support_by_source":{"media":3,"socials":14,"iwitness":0},"confidence":0.41,"is_alpha":true}],"article_url":"https://sense.quorumz.com/quorum/qrm_7c1e"}],"next_cursor":"c_2026-10-27T09:40:00Z_qrm_7c1e"}}},"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"input":{"type":"object","properties":{"type":{"type":"string","const":"http"},"method":{"type":"string","enum":["GET"]},"queryParams":{"type":"object","properties":{}}},"required":["type","method"]},"output":{"type":"object","properties":{"type":{"type":"string"},"example":{"type":"object"}},"required":["type"]}},"required":["input"]}}},"error":"PAYMENT-SIGNATURE header is required","alternatives":{"api_key":{"signup":"https://sense.quorumz.com/agents/keys","pay_with":"credit card or PayPal","free_trial":"the first 100 calls over 7 days"}},"message":"This route is paid. Get a free API key at https://sense.quorumz.com/agents/keys and send it as 'Authorization: Bearer <key>', or pay per call with x402 (sign one of 'accepts' and retry with PAYMENT-SIGNATURE). The sample is free: https://api.quorumz.com/api/agent/v1/sample","get_started":{"free_sample":"https://api.quorumz.com/api/agent/v1/sample","api_key":{"get_one":"https://sense.quorumz.com/agents/keys","how":"Sign in with your email to get a key, then send it as 'Authorization: Bearer <key>'.","free_trial":"the first 100 calls over 7 days","after_trial":"prepaid credits by credit card or PayPal"},"mcp":{"url":"https://api.quorumz.com/mcp","auth":"Authorization: Bearer <key>"},"x402":"https://api.quorumz.com/.well-known/x402"}}}}}}},"404":{"$ref":"#/components/responses/NotFound"}},"x-payment-info":{"protocols":["x402"],"network":"eip155:8453","networks":["eip155:8453","eip155:137","eip155:42161"],"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x9ce92953d33237af061c6b1aa29c597c8656b547","price":{"mode":"dynamic","currency":"USD","min":"0.01","max":"0.01"}},"x-price":"$0.01"}},"/api/agent/v1/events":{"get":{"operationId":"listEvents","summary":"List alpha or news events","description":"`stream=alpha`: stories found ahead of the wider press, each with the quorum on the story when there is one; filter by country or geohash cell. `stream=news`: news articles, each with the quorums on its story; filter by country. Newest first; page with `cursor`.\n\nPrice: $0.02 per alpha event and $0.005 per news event returned (at most $1.00 a page). An empty page is free.","tags":["Events"],"security":[{"apiKey":[]},{}],"parameters":[{"name":"stream","in":"query","required":false,"description":"`alpha` ($0.02 per event) or `news` ($0.005 per event).","schema":{"type":"string","enum":["alpha","news"],"default":"alpha"}},{"name":"country","in":"query","required":false,"description":"Only events in this country: an ISO 3166-1 alpha-2 code, any case. Alpha: where the signal is. News: a country the article discusses. A code with no events returns an empty page.","schema":{"type":"string","pattern":"^[A-Za-z]{2}$","minLength":2,"maxLength":2},"example":"LB"},{"name":"cell","in":"query","required":false,"description":"Alpha only: only events inside this geohash cell (lower-case base32, precision 3 to 5; precision 4 is about 40 km by 20 km). Ignored for news.","schema":{"type":"string","pattern":"^[0123456789bcdefghjkmnpqrstuvwxyz]{3,5}$","minLength":3,"maxLength":5},"example":"sv8s"},{"name":"limit","in":"query","required":false,"description":"Events per page: 1 by default, at most 50 (a larger value returns 50). You pay for the events returned, not the number asked for.","schema":{"type":"integer","minimum":1,"maximum":50,"default":1},"example":10},{"name":"cursor","in":"query","required":false,"description":"Opaque. Pass the previous page's `next_cursor` to get the next, older page; omit it for the newest.","schema":{"type":"string"}},{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"description":"x402 only: the Base64 payment payload signing one of the `accepts` from this route's 402. Send it on the retry of the same request. Not needed with an API key.","schema":{"type":"string","contentEncoding":"base64"}}],"responses":{"200":{"description":"A page of events of the stream asked for.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventsResponse"},"examples":{"alpha":{"summary":"stream=alpha, paid with x402","value":{"stream":"alpha","filter":{"country":"LB","cell":null},"events":[{"id":"alpha_7e2b91c04d5fa8","type":"alpha.created","cursor":"2026-11-03T09:12:00Z|alpha_7e2b91c04d5fa8","country":"LB","lat":33.89,"lon":35.5,"alpha_kind":"early_signal","alpha_score":0.82,"rationale":"Local reports of the closure came 40 minutes before wire coverage.","detected_at":"2026-11-03T09:12:00Z","quorum":{"quorum_id":"qrm_top_5f0c2a9e41b7d386","headline":"Border crossing closed after flood damage","summary":"Two readings of the closure: a short repair, or weeks of diverted freight.","category":"infrastructure","countries":["LB","SY"],"support_count":55,"confidence":0.68,"is_alpha":true,"updated_at":"2026-11-03T09:40:00Z","viewpoints":[{"viewpoint_id":"qrm_op_8d14e6b2a07c5f91","label":"The closure is temporary","summary":"Officials and local outlets say the crossing reopens once the approach road is repaired.","support_count":38,"support_by_source":{"media":11,"socials":25,"iwitness":2},"confidence":0.74,"is_alpha":false},{"viewpoint_id":"qrm_op_2b9f7e0c63a1d548","label":"Freight is diverted for weeks","summary":"Freight operators report rerouted shipments and multi-day waits at the next crossing north.","support_count":17,"support_by_source":{"media":3,"socials":14,"iwitness":0},"confidence":0.41,"is_alpha":true}],"article_url":"https://sense.quorumz.com/quorum/qrm_top_5f0c2a9e41b7d386"}}],"next_cursor":"2026-11-03T09:12:00Z|alpha_7e2b91c04d5fa8","charged_events":1,"payment":{"status":"enforced","scheme":"exact","network":"eip155:137","networks":["eip155:8453","eip155:137","eip155:42161"],"pay_to":"0x9ce92953d33237af061c6b1aa29c597c8656b547","asset":"0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359","facilitator":"https://api.cdp.coinbase.com/platform/v2/x402","prices_usd":{"alpha":0.02,"news":0.005,"quorum":0.01},"charged_events":1,"settled":true}}},"news":{"summary":"stream=news, paid with an API key in its free trial","value":{"stream":"news","filter":{"country":"LB"},"events":[{"id":"can_top_c41e9a07b2d85f36","type":"news.created","cursor":"2026-11-03T10:05:00Z|can_top_c41e9a07b2d85f36","title":"Border crossing closed after flood damage","summary":"Authorities closed the crossing after overnight flooding damaged the approach road.","countries":["LB"],"updated_at":"2026-11-03T10:05:00Z","quorums":[{"quorum_id":"qrm_top_5f0c2a9e41b7d386","headline":"Border crossing closed after flood damage","summary":"Two readings of the closure: a short repair, or weeks of diverted freight.","category":"infrastructure","countries":["LB","SY"],"support_count":55,"confidence":0.68,"is_alpha":true,"updated_at":"2026-11-03T09:40:00Z","viewpoints":[{"viewpoint_id":"qrm_op_8d14e6b2a07c5f91","label":"The closure is temporary","summary":"Officials and local outlets say the crossing reopens once the approach road is repaired.","support_count":38,"support_by_source":{"media":11,"socials":25,"iwitness":2},"confidence":0.74,"is_alpha":false},{"viewpoint_id":"qrm_op_2b9f7e0c63a1d548","label":"Freight is diverted for weeks","summary":"Freight operators report rerouted shipments and multi-day waits at the next crossing north.","support_count":17,"support_by_source":{"media":3,"socials":14,"iwitness":0},"confidence":0.41,"is_alpha":true}],"article_url":"https://sense.quorumz.com/quorum/qrm_top_5f0c2a9e41b7d386"}],"article_url":"https://sense.quorumz.com/news/can_top_c41e9a07b2d85f36"}],"next_cursor":"2026-11-03T10:05:00Z|can_top_c41e9a07b2d85f36","charged_events":1,"payment":{"status":"enforced","scheme":"exact","network":"eip155:8453","networks":["eip155:8453","eip155:137","eip155:42161"],"pay_to":"0x9ce92953d33237af061c6b1aa29c597c8656b547","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","facilitator":"https://api.cdp.coinbase.com/platform/v2/x402","prices_usd":{"alpha":0.02,"news":0.005,"quorum":0.01},"charged_events":0,"settled":false,"plan":"trial","trial":{"active":true,"calls_used":12,"calls_left":88,"calls_limit":100,"ends_at":"2026-11-10T08:15:00+00:00"}}}}}}},"headers":{"PAYMENT-RESPONSE":{"$ref":"#/components/headers/PaymentResponse"}}},"400":{"description":"`stream` is not alpha or news, or `cell` is not a geohash of precision 3 to 5.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"examples":{"stream":{"value":{"error":"stream must be alpha or news"}},"cell":{"value":{"error":"cell must be a geohash of precision 3, 4, or 5"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"description":"Payment required ($0.02 per alpha event, $0.005 per news event). An unpaid call that would return records gets this, and no records: sign one of `accepts` (exact USDC on Base, Polygon or Arbitrum) and retry with PAYMENT-SIGNATURE, or call again with an API key. Also returned when an API key has no free calls or credits left (`error` no_credits or trial_over, with `get_a_key`), and when a payment does not verify or settle (`error` says why).","headers":{"PAYMENT-REQUIRED":{"$ref":"#/components/headers/PaymentRequired"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"},"examples":{"alpha":{"summary":"An unpaid call that would return one alpha event","value":{"x402Version":2,"resource":{"url":"https://api.quorumz.com/api/agent/v1/events","description":"Alpha signals ahead of the wider press, with the quorum on the story when one exists.","mimeType":"application/json","serviceName":"Quorumz","tags":["news","quorum","geopolitics"],"iconUrl":"https://sense.quorumz.com/brand/quorumz-tile-512.png"},"accepts":[{"scheme":"exact","network":"eip155:8453","amount":"20000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x9ce92953d33237af061c6b1aa29c597c8656b547","maxTimeoutSeconds":300,"extra":{"name":"USD Coin","version":"2"}},{"scheme":"exact","network":"eip155:137","amount":"20000","asset":"0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359","payTo":"0x9ce92953d33237af061c6b1aa29c597c8656b547","maxTimeoutSeconds":300,"extra":{"name":"USD Coin","version":"2"}},{"scheme":"exact","network":"eip155:42161","amount":"20000","asset":"0xaf88d065e77c8cC2239327C5EDb3A432268e5831","payTo":"0x9ce92953d33237af061c6b1aa29c597c8656b547","maxTimeoutSeconds":300,"extra":{"name":"USD Coin","version":"2"}}],"extensions":{"bazaar":{"info":{"input":{"type":"http","method":"GET","queryParams":{"stream":"alpha","country":"LB","cell":""}},"output":{"type":"json","example":{"stream":"alpha","filter":{"country":"LB","cell":null},"charged_events":1,"events":[{"id":"alp_41b9","type":"alpha.created","cursor":"c_2026-10-27T09:12:00Z_alp_41b9","country":"LB","lat":33.89,"lon":35.5,"alpha_kind":"early_signal","alpha_score":0.82,"rationale":"Local reports of the closure came 40 minutes before wire coverage.","detected_at":"2026-10-27T09:12:00Z","quorum":{"quorum_id":"qrm_7c1e","headline":"Border crossing closed after flood damage","summary":"Two readings of the closure: a short repair or a long diversion of freight.","category":"infrastructure","countries":["LB"],"support_count":55,"confidence":0.68,"is_alpha":true,"updated_at":"2026-10-27T09:40:00Z","viewpoints":[{"viewpoint_id":"opn_8f2c","label":"The closure is temporary","summary":"Officials and local outlets say the crossing reopens once repairs finish.","support_count":38,"support_by_source":{"media":11,"socials":25,"iwitness":2},"confidence":0.74,"is_alpha":false},{"viewpoint_id":"opn_8f2d","label":"Traffic is being diverted for weeks","summary":"Freight operators report rerouted shipments and longer waits.","support_count":17,"support_by_source":{"media":3,"socials":14,"iwitness":0},"confidence":0.41,"is_alpha":true}],"article_url":"https://sense.quorumz.com/quorum/qrm_7c1e"}}],"next_cursor":"c_2026-10-27T09:12:00Z_alp_41b9"}}},"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"input":{"type":"object","properties":{"type":{"type":"string","const":"http"},"method":{"type":"string","enum":["GET"]},"queryParams":{"type":"object","properties":{"stream":{"type":"string"},"country":{"type":"string"},"cell":{"type":"string"}}}},"required":["type","method"]},"output":{"type":"object","properties":{"type":{"type":"string"},"example":{"type":"object"}},"required":["type"]}},"required":["input"]}}},"error":"PAYMENT-SIGNATURE header is required","alternatives":{"api_key":{"signup":"https://sense.quorumz.com/agents/keys","pay_with":"credit card or PayPal","free_trial":"the first 100 calls over 7 days"}},"message":"This route is paid. Get a free API key at https://sense.quorumz.com/agents/keys and send it as 'Authorization: Bearer <key>', or pay per call with x402 (sign one of 'accepts' and retry with PAYMENT-SIGNATURE). The sample is free: https://api.quorumz.com/api/agent/v1/sample","get_started":{"free_sample":"https://api.quorumz.com/api/agent/v1/sample","api_key":{"get_one":"https://sense.quorumz.com/agents/keys","how":"Sign in with your email to get a key, then send it as 'Authorization: Bearer <key>'.","free_trial":"the first 100 calls over 7 days","after_trial":"prepaid credits by credit card or PayPal"},"mcp":{"url":"https://api.quorumz.com/mcp","auth":"Authorization: Bearer <key>"},"x402":"https://api.quorumz.com/.well-known/x402"}}},"news":{"summary":"An unpaid call that would return one news event","value":{"x402Version":2,"resource":{"url":"https://api.quorumz.com/api/agent/v1/events","description":"News articles, each with the quorums and viewpoints related to the article.","mimeType":"application/json","serviceName":"Quorumz","tags":["news","quorum","geopolitics"],"iconUrl":"https://sense.quorumz.com/brand/quorumz-tile-512.png"},"accepts":[{"scheme":"exact","network":"eip155:8453","amount":"5000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x9ce92953d33237af061c6b1aa29c597c8656b547","maxTimeoutSeconds":300,"extra":{"name":"USD Coin","version":"2"}},{"scheme":"exact","network":"eip155:137","amount":"5000","asset":"0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359","payTo":"0x9ce92953d33237af061c6b1aa29c597c8656b547","maxTimeoutSeconds":300,"extra":{"name":"USD Coin","version":"2"}},{"scheme":"exact","network":"eip155:42161","amount":"5000","asset":"0xaf88d065e77c8cC2239327C5EDb3A432268e5831","payTo":"0x9ce92953d33237af061c6b1aa29c597c8656b547","maxTimeoutSeconds":300,"extra":{"name":"USD Coin","version":"2"}}],"extensions":{"bazaar":{"info":{"input":{"type":"http","method":"GET","queryParams":{"stream":"news","country":"LB","cell":""}},"output":{"type":"json","example":{"stream":"news","filter":{"country":"LB"},"charged_events":1,"events":[{"id":"can_5d20","type":"news.created","cursor":"c_2026-10-27T10:05:00Z_can_5d20","title":"Border crossing closed after flood damage","summary":"Authorities closed the crossing after overnight flooding damaged the approach road.","countries":["LB"],"updated_at":"2026-10-27T10:05:00Z","quorums":[{"quorum_id":"qrm_7c1e","headline":"Border crossing closed after flood damage","summary":"Two readings of the closure: a short repair or a long diversion of freight.","category":"infrastructure","countries":["LB"],"support_count":55,"confidence":0.68,"is_alpha":true,"updated_at":"2026-10-27T09:40:00Z","viewpoints":[{"viewpoint_id":"opn_8f2c","label":"The closure is temporary","summary":"Officials and local outlets say the crossing reopens once repairs finish.","support_count":38,"support_by_source":{"media":11,"socials":25,"iwitness":2},"confidence":0.74,"is_alpha":false},{"viewpoint_id":"opn_8f2d","label":"Traffic is being diverted for weeks","summary":"Freight operators report rerouted shipments and longer waits.","support_count":17,"support_by_source":{"media":3,"socials":14,"iwitness":0},"confidence":0.41,"is_alpha":true}],"article_url":"https://sense.quorumz.com/quorum/qrm_7c1e"}],"article_url":"https://sense.quorumz.com/news/can_5d20"}],"next_cursor":"c_2026-10-27T10:05:00Z_can_5d20"}}},"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"input":{"type":"object","properties":{"type":{"type":"string","const":"http"},"method":{"type":"string","enum":["GET"]},"queryParams":{"type":"object","properties":{"stream":{"type":"string"},"country":{"type":"string"},"cell":{"type":"string"}}}},"required":["type","method"]},"output":{"type":"object","properties":{"type":{"type":"string"},"example":{"type":"object"}},"required":["type"]}},"required":["input"]}}},"error":"PAYMENT-SIGNATURE header is required","alternatives":{"api_key":{"signup":"https://sense.quorumz.com/agents/keys","pay_with":"credit card or PayPal","free_trial":"the first 100 calls over 7 days"}},"message":"This route is paid. Get a free API key at https://sense.quorumz.com/agents/keys and send it as 'Authorization: Bearer <key>', or pay per call with x402 (sign one of 'accepts' and retry with PAYMENT-SIGNATURE). The sample is free: https://api.quorumz.com/api/agent/v1/sample","get_started":{"free_sample":"https://api.quorumz.com/api/agent/v1/sample","api_key":{"get_one":"https://sense.quorumz.com/agents/keys","how":"Sign in with your email to get a key, then send it as 'Authorization: Bearer <key>'.","free_trial":"the first 100 calls over 7 days","after_trial":"prepaid credits by credit card or PayPal"},"mcp":{"url":"https://api.quorumz.com/mcp","auth":"Authorization: Bearer <key>"},"x402":"https://api.quorumz.com/.well-known/x402"}}}}}}},"422":{"$ref":"#/components/responses/InvalidParameter"}},"x-payment-info":{"protocols":["x402"],"network":"eip155:8453","networks":["eip155:8453","eip155:137","eip155:42161"],"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x9ce92953d33237af061c6b1aa29c597c8656b547","price":{"mode":"dynamic","currency":"USD","min":"0.005","max":"1.00"}},"x-price":"$0.02 per alpha event, $0.005 per news event"}},"/api/agent/v1/articles/{article_id}":{"get":{"operationId":"getArticle","summary":"Get one news article with its quorums","description":"One news article by id, with every quorum on its story and their viewpoints.\n\nPrice: $0.005. A missing id is a 404 and is not charged.","tags":["Articles"],"security":[{"apiKey":[]},{}],"parameters":[{"name":"article_id","in":"path","required":true,"description":"The article's id (`id` of a news event).","schema":{"type":"string"},"example":"can_top_c41e9a07b2d85f36"},{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"description":"x402 only: the Base64 payment payload signing one of the `accepts` from this route's 402. Send it on the retry of the same request. Not needed with an API key.","schema":{"type":"string","contentEncoding":"base64"}}],"responses":{"200":{"description":"The article.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArticleResponse"},"examples":{"x402":{"summary":"Paid with x402 (USDC on Polygon)","value":{"article_id":"can_top_c41e9a07b2d85f36","title":"Border crossing closed after flood damage","summary":"Authorities closed the crossing after overnight flooding damaged the approach road.","category":"infrastructure","countries":["LB"],"updated_at":"2026-11-03T10:05:00Z","quorums":[{"quorum_id":"qrm_top_5f0c2a9e41b7d386","headline":"Border crossing closed after flood damage","summary":"Two readings of the closure: a short repair, or weeks of diverted freight.","category":"infrastructure","countries":["LB","SY"],"support_count":55,"confidence":0.68,"is_alpha":true,"updated_at":"2026-11-03T09:40:00Z","viewpoints":[{"viewpoint_id":"qrm_op_8d14e6b2a07c5f91","label":"The closure is temporary","summary":"Officials and local outlets say the crossing reopens once the approach road is repaired.","support_count":38,"support_by_source":{"media":11,"socials":25,"iwitness":2},"confidence":0.74,"is_alpha":false},{"viewpoint_id":"qrm_op_2b9f7e0c63a1d548","label":"Freight is diverted for weeks","summary":"Freight operators report rerouted shipments and multi-day waits at the next crossing north.","support_count":17,"support_by_source":{"media":3,"socials":14,"iwitness":0},"confidence":0.41,"is_alpha":true}],"article_url":"https://sense.quorumz.com/quorum/qrm_top_5f0c2a9e41b7d386"}],"article_url":"https://sense.quorumz.com/news/can_top_c41e9a07b2d85f36","payment":{"status":"enforced","scheme":"exact","network":"eip155:137","networks":["eip155:8453","eip155:137","eip155:42161"],"pay_to":"0x9ce92953d33237af061c6b1aa29c597c8656b547","asset":"0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359","facilitator":"https://api.cdp.coinbase.com/platform/v2/x402","prices_usd":{"alpha":0.02,"news":0.005,"quorum":0.01},"charged_events":1,"settled":true}}},"api_key":{"summary":"Paid with an API key, from prepaid credits","value":{"article_id":"can_top_c41e9a07b2d85f36","title":"Border crossing closed after flood damage","summary":"Authorities closed the crossing after overnight flooding damaged the approach road.","category":"infrastructure","countries":["LB"],"updated_at":"2026-11-03T10:05:00Z","quorums":[{"quorum_id":"qrm_top_5f0c2a9e41b7d386","headline":"Border crossing closed after flood damage","summary":"Two readings of the closure: a short repair, or weeks of diverted freight.","category":"infrastructure","countries":["LB","SY"],"support_count":55,"confidence":0.68,"is_alpha":true,"updated_at":"2026-11-03T09:40:00Z","viewpoints":[{"viewpoint_id":"qrm_op_8d14e6b2a07c5f91","label":"The closure is temporary","summary":"Officials and local outlets say the crossing reopens once the approach road is repaired.","support_count":38,"support_by_source":{"media":11,"socials":25,"iwitness":2},"confidence":0.74,"is_alpha":false},{"viewpoint_id":"qrm_op_2b9f7e0c63a1d548","label":"Freight is diverted for weeks","summary":"Freight operators report rerouted shipments and multi-day waits at the next crossing north.","support_count":17,"support_by_source":{"media":3,"socials":14,"iwitness":0},"confidence":0.41,"is_alpha":true}],"article_url":"https://sense.quorumz.com/quorum/qrm_top_5f0c2a9e41b7d386"}],"article_url":"https://sense.quorumz.com/news/can_top_c41e9a07b2d85f36","payment":{"status":"enforced","scheme":"exact","network":"eip155:8453","networks":["eip155:8453","eip155:137","eip155:42161"],"pay_to":"0x9ce92953d33237af061c6b1aa29c597c8656b547","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","facilitator":"https://api.cdp.coinbase.com/platform/v2/x402","prices_usd":{"alpha":0.02,"news":0.005,"quorum":0.01},"charged_events":1,"settled":false,"plan":"credits","credits":{"charged_usd":0.005,"balance_usd":4.37}}}}}}},"headers":{"PAYMENT-RESPONSE":{"$ref":"#/components/headers/PaymentResponse"}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"description":"Payment required ($0.005). An unpaid call that would return records gets this, and no records: sign one of `accepts` (exact USDC on Base, Polygon or Arbitrum) and retry with PAYMENT-SIGNATURE, or call again with an API key. Also returned when an API key has no free calls or credits left (`error` no_credits or trial_over, with `get_a_key`), and when a payment does not verify or settle (`error` says why).","headers":{"PAYMENT-REQUIRED":{"$ref":"#/components/headers/PaymentRequired"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"},"examples":{"unpaid":{"summary":"An unpaid call","value":{"x402Version":2,"resource":{"url":"https://api.quorumz.com/api/agent/v1/articles/can_top_c41e9a07b2d85f36","description":"News articles, each with the quorums and viewpoints related to the article.","mimeType":"application/json","serviceName":"Quorumz","tags":["news","quorum","geopolitics"],"iconUrl":"https://sense.quorumz.com/brand/quorumz-tile-512.png"},"accepts":[{"scheme":"exact","network":"eip155:8453","amount":"5000","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x9ce92953d33237af061c6b1aa29c597c8656b547","maxTimeoutSeconds":300,"extra":{"name":"USD Coin","version":"2"}},{"scheme":"exact","network":"eip155:137","amount":"5000","asset":"0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359","payTo":"0x9ce92953d33237af061c6b1aa29c597c8656b547","maxTimeoutSeconds":300,"extra":{"name":"USD Coin","version":"2"}},{"scheme":"exact","network":"eip155:42161","amount":"5000","asset":"0xaf88d065e77c8cC2239327C5EDb3A432268e5831","payTo":"0x9ce92953d33237af061c6b1aa29c597c8656b547","maxTimeoutSeconds":300,"extra":{"name":"USD Coin","version":"2"}}],"extensions":{"bazaar":{"info":{"input":{"type":"http","method":"GET","queryParams":{}},"output":{"type":"json","example":{"stream":"news","filter":{"country":"LB"},"charged_events":1,"events":[{"id":"can_5d20","type":"news.created","cursor":"c_2026-10-27T10:05:00Z_can_5d20","title":"Border crossing closed after flood damage","summary":"Authorities closed the crossing after overnight flooding damaged the approach road.","countries":["LB"],"updated_at":"2026-10-27T10:05:00Z","quorums":[{"quorum_id":"qrm_7c1e","headline":"Border crossing closed after flood damage","summary":"Two readings of the closure: a short repair or a long diversion of freight.","category":"infrastructure","countries":["LB"],"support_count":55,"confidence":0.68,"is_alpha":true,"updated_at":"2026-10-27T09:40:00Z","viewpoints":[{"viewpoint_id":"opn_8f2c","label":"The closure is temporary","summary":"Officials and local outlets say the crossing reopens once repairs finish.","support_count":38,"support_by_source":{"media":11,"socials":25,"iwitness":2},"confidence":0.74,"is_alpha":false},{"viewpoint_id":"opn_8f2d","label":"Traffic is being diverted for weeks","summary":"Freight operators report rerouted shipments and longer waits.","support_count":17,"support_by_source":{"media":3,"socials":14,"iwitness":0},"confidence":0.41,"is_alpha":true}],"article_url":"https://sense.quorumz.com/quorum/qrm_7c1e"}],"article_url":"https://sense.quorumz.com/news/can_5d20"}],"next_cursor":"c_2026-10-27T10:05:00Z_can_5d20"}}},"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"input":{"type":"object","properties":{"type":{"type":"string","const":"http"},"method":{"type":"string","enum":["GET"]},"queryParams":{"type":"object","properties":{}}},"required":["type","method"]},"output":{"type":"object","properties":{"type":{"type":"string"},"example":{"type":"object"}},"required":["type"]}},"required":["input"]}}},"error":"PAYMENT-SIGNATURE header is required","alternatives":{"api_key":{"signup":"https://sense.quorumz.com/agents/keys","pay_with":"credit card or PayPal","free_trial":"the first 100 calls over 7 days"}},"message":"This route is paid. Get a free API key at https://sense.quorumz.com/agents/keys and send it as 'Authorization: Bearer <key>', or pay per call with x402 (sign one of 'accepts' and retry with PAYMENT-SIGNATURE). The sample is free: https://api.quorumz.com/api/agent/v1/sample","get_started":{"free_sample":"https://api.quorumz.com/api/agent/v1/sample","api_key":{"get_one":"https://sense.quorumz.com/agents/keys","how":"Sign in with your email to get a key, then send it as 'Authorization: Bearer <key>'.","free_trial":"the first 100 calls over 7 days","after_trial":"prepaid credits by credit card or PayPal"},"mcp":{"url":"https://api.quorumz.com/mcp","auth":"Authorization: Bearer <key>"},"x402":"https://api.quorumz.com/.well-known/x402"}}}}}}},"404":{"$ref":"#/components/responses/NotFound"}},"x-payment-info":{"protocols":["x402"],"network":"eip155:8453","networks":["eip155:8453","eip155:137","eip155:42161"],"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","payTo":"0x9ce92953d33237af061c6b1aa29c597c8656b547","price":{"mode":"dynamic","currency":"USD","min":"0.005","max":"0.005"}},"x-price":"$0.005"}}},"components":{"securitySchemes":{"apiKey":{"type":"http","scheme":"bearer","bearerFormat":"qz_pk_live_…","description":"An API key: `Authorization: Bearer qz_pk_live_…` (or `X-Api-Key: <key>`). Get one at https://sense.quorumz.com/agents/keys. The first 100 calls within 7 days are free (an empty page never counts); after that, calls are paid from prepaid credits bought by card or PayPal, at the same prices. Paid routes also take no key at all: pay each call with x402 instead."}},"schemas":{"SupportBySource":{"type":"object","description":"The posts supporting a viewpoint, by kind of source.","properties":{"media":{"type":"integer","minimum":0,"description":"Posts from news outlets."},"socials":{"type":"integer","minimum":0,"description":"Posts on social networks."},"iwitness":{"type":"integer","minimum":0,"description":"First-hand reports from people on the ground (iWitness)."}},"required":["media","socials","iwitness"],"additionalProperties":false},"Viewpoint":{"type":"object","description":"One distinct position being expressed about the story.","properties":{"viewpoint_id":{"type":"string","description":"Stable id of the viewpoint."},"label":{"type":"string","description":"A few words naming the position."},"summary":{"type":"string","description":"The position, in a sentence or two."},"support_count":{"type":"integer","minimum":0,"description":"Posts supporting this viewpoint."},"support_by_source":{"$ref":"#/components/schemas/SupportBySource"},"confidence":{"type":["number","null"],"minimum":0,"maximum":1,"description":"0 to 1: how well sourced this viewpoint is (the amount of support and the credibility of its sources). Null until it is scored."},"is_alpha":{"type":"boolean","description":"True when this viewpoint is ahead of the wider press."}},"required":["viewpoint_id","label","summary","support_count","support_by_source","confidence","is_alpha"],"additionalProperties":false},"Quorum":{"type":"object","description":"A quorum: one story split into the distinct viewpoints being expressed about it, with the support behind each.","properties":{"quorum_id":{"type":"string","description":"Stable id. GET /api/agent/v1/quorums/{quorum_id} returns this quorum."},"headline":{"type":"string","description":"The story, in one line."},"summary":{"type":["string","null"],"description":"What the viewpoints disagree about."},"category":{"type":["string","null"],"description":"Topic category, e.g. conflict, politics, economy, infrastructure."},"countries":{"type":"array","items":{"type":"string"},"description":"ISO 3166-1 alpha-2 codes (upper case) of the countries the story is about."},"support_count":{"type":"integer","minimum":0,"description":"Posts across all viewpoints."},"confidence":{"type":["number","null"],"minimum":0,"maximum":1,"description":"0 to 1: how well sourced the story is. Null until it is scored."},"is_alpha":{"type":"boolean","description":"True when the story is ahead of the wider press."},"updated_at":{"type":"string","format":"date-time","description":"When a post last joined the story (UTC)."},"viewpoints":{"type":"array","items":{"$ref":"#/components/schemas/Viewpoint"},"description":"The viewpoints, most supported first."},"article_url":{"type":"string","format":"uri","description":"The quorum's page on sense.quorumz.com."}},"required":["quorum_id","headline","summary","category","countries","support_count","confidence","is_alpha","updated_at","viewpoints","article_url"],"additionalProperties":false},"QuorumFilter":{"description":"The filter applied: one country, or the whole world.","oneOf":[{"type":"object","description":"One country.","properties":{"country":{"type":"string","description":"ISO 3166-1 alpha-2 code, upper case."}},"required":["country"],"additionalProperties":false},{"type":"object","description":"No country filter.","properties":{"world":{"type":"boolean","const":true}},"required":["world"],"additionalProperties":false}]},"QuorumPage":{"type":"object","description":"A page of quorums, newest first.","properties":{"stream":{"type":"string","const":"quorum"},"filter":{"$ref":"#/components/schemas/QuorumFilter"},"quorums":{"type":"array","items":{"$ref":"#/components/schemas/Quorum"},"maxItems":50},"next_cursor":{"type":["string","null"],"description":"Pass it back as `cursor` for the next, older page. Null when this page is empty. The next page may be empty; an empty page is free."}},"required":["stream","filter","quorums","next_cursor"],"additionalProperties":false},"SamplePage":{"type":"object","description":"One quorum in the page shape GET /api/agent/v1/quorums returns, plus how to go on.","properties":{"stream":{"type":"string","const":"quorum"},"filter":{"$ref":"#/components/schemas/QuorumFilter"},"quorums":{"type":"array","items":{"$ref":"#/components/schemas/Quorum"},"maxItems":50},"next_cursor":{"type":["string","null"],"description":"Pass it back as `cursor` for the next, older page. Null when this page is empty. The next page may be empty; an empty page is free."},"get_started":{"$ref":"#/components/schemas/GetStarted"}},"required":["stream","filter","quorums","next_cursor","get_started"],"additionalProperties":false},"GetStarted":{"type":"object","description":"How to go on from here: the free sample, a free trial key, the MCP server, or x402.","properties":{"free_sample":{"type":"string","format":"uri","description":"The free sample quorum; no key."},"api_key":{"type":"object","description":"An API key, with free trial calls, then prepaid credits.","properties":{"get_one":{"type":"string","format":"uri","description":"Where to sign in with your email and get a key."},"how":{"type":"string","description":"How to send the key."},"free_trial":{"type":"string","description":"The key's free trial."},"after_trial":{"type":"string","description":"How calls are paid after the trial."}},"required":["get_one","how","free_trial","after_trial"],"additionalProperties":false},"mcp":{"type":"object","description":"The MCP server (streamable HTTP).","properties":{"url":{"type":"string","format":"uri","description":"The MCP endpoint."},"auth":{"type":"string","description":"The header the paid tools need."}},"required":["url","auth"],"additionalProperties":false},"x402":{"type":"string","format":"uri","description":"x402 discovery: pay per call in USDC, no account."}},"required":["free_sample","api_key","mcp","x402"],"additionalProperties":false},"Article":{"type":"object","description":"A news article and the quorums on its story.","properties":{"article_id":{"type":"string","description":"Stable id. GET /api/agent/v1/articles/{article_id} returns this article."},"title":{"type":"string","description":"The article's title."},"summary":{"type":["string","null"],"description":"What the article reports."},"category":{"type":["string","null"],"description":"Topic category, e.g. conflict, politics, economy."},"countries":{"type":"array","items":{"type":"string"},"description":"ISO 3166-1 alpha-2 codes of the countries the article discusses."},"updated_at":{"type":"string","format":"date-time","description":"Last activity on the story (UTC)."},"quorums":{"type":"array","items":{"$ref":"#/components/schemas/Quorum"},"description":"The quorums on this story, each with its viewpoints. May be empty."},"article_url":{"type":"string","format":"uri","description":"The article's page on sense.quorumz.com."}},"required":["article_id","title","summary","category","countries","updated_at","quorums","article_url"],"additionalProperties":false},"AlphaEvent":{"type":"object","description":"An alpha signal: a story found ahead of the wider press.","properties":{"id":{"type":"string","description":"Signal id."},"type":{"type":"string","const":"alpha.created"},"cursor":{"type":"string","description":"This event's position in the stream. Opaque."},"country":{"type":["string","null"],"description":"ISO 3166-1 alpha-2 code of where the signal is, when known."},"lat":{"type":["number","null"],"minimum":-90,"maximum":90,"description":"Latitude, when known."},"lon":{"type":["number","null"],"minimum":-180,"maximum":180,"description":"Longitude, when known."},"alpha_kind":{"type":"string","description":"Why it is alpha, e.g. early_signal (seen before the press), unreported_event (not in the press), counter_factual (contradicts the press), ground_truth_evidence (first-hand evidence)."},"alpha_score":{"type":"number","minimum":0,"maximum":1,"description":"0 to 1: how novel, corroborated and consequential the signal is."},"rationale":{"type":"string","description":"Why it was flagged, in plain English."},"detected_at":{"type":"string","format":"date-time","description":"When it was flagged (UTC)."},"quorum":{"anyOf":[{"$ref":"#/components/schemas/Quorum"},{"type":"null"}],"description":"The quorum on the story when the signal is a quorum topic; otherwise null."}},"required":["id","type","cursor","country","lat","lon","alpha_kind","alpha_score","rationale","detected_at","quorum"],"additionalProperties":false},"NewsEvent":{"type":"object","description":"A news article as an event, with the quorums on its story.","properties":{"id":{"type":"string","description":"Article id. GET /api/agent/v1/articles/{article_id} returns the article."},"type":{"type":"string","const":"news.created"},"cursor":{"type":"string","description":"This event's position in the stream. Opaque."},"title":{"type":"string","description":"The article's title."},"summary":{"type":["string","null"],"description":"What the article reports."},"countries":{"type":"array","items":{"type":"string"},"description":"ISO 3166-1 alpha-2 codes of the countries the article discusses."},"updated_at":{"type":"string","format":"date-time","description":"Last activity on the story (UTC)."},"quorums":{"type":"array","items":{"$ref":"#/components/schemas/Quorum"},"description":"The quorums on this story, each with its viewpoints. May be empty."},"article_url":{"type":"string","format":"uri","description":"The article's page on sense.quorumz.com."}},"required":["id","type","cursor","title","summary","countries","updated_at","quorums","article_url"],"additionalProperties":false},"AlphaEventPage":{"type":"object","description":"A page of alpha events, newest first.","properties":{"stream":{"type":"string","const":"alpha"},"filter":{"type":"object","description":"The filters applied.","properties":{"country":{"type":["string","null"],"description":"ISO 3166-1 alpha-2 code, upper case."},"cell":{"type":["string","null"],"description":"Geohash cell, as sent."}},"required":["country","cell"],"additionalProperties":false},"events":{"type":"array","items":{"$ref":"#/components/schemas/AlphaEvent"},"maxItems":50},"next_cursor":{"type":["string","null"],"description":"Pass it back as `cursor` for the next, older page. Null when this page is empty. The next page may be empty; an empty page is free."},"charged_events":{"type":"integer","minimum":0,"description":"Events on this page: the number a paid call is billed for. `payment.charged_events` says what was."}},"required":["stream","filter","events","next_cursor","charged_events"],"additionalProperties":false},"NewsEventPage":{"type":"object","description":"A page of news events, newest first.","properties":{"stream":{"type":"string","const":"news"},"filter":{"type":"object","description":"The filter applied.","properties":{"country":{"type":["string","null"],"description":"ISO 3166-1 alpha-2 code, upper case."}},"required":["country"],"additionalProperties":false},"events":{"type":"array","items":{"$ref":"#/components/schemas/NewsEvent"},"maxItems":50},"next_cursor":{"type":["string","null"],"description":"Pass it back as `cursor` for the next, older page. Null when this page is empty. The next page may be empty; an empty page is free."},"charged_events":{"type":"integer","minimum":0,"description":"Events on this page: the number a paid call is billed for. `payment.charged_events` says what was."}},"required":["stream","filter","events","next_cursor","charged_events"],"additionalProperties":false},"QuorumFeedResponse":{"type":"object","description":"A page of quorums, newest first, and how the call was paid.","properties":{"stream":{"type":"string","const":"quorum"},"filter":{"$ref":"#/components/schemas/QuorumFilter"},"quorums":{"type":"array","items":{"$ref":"#/components/schemas/Quorum"},"maxItems":50},"next_cursor":{"type":["string","null"],"description":"Pass it back as `cursor` for the next, older page. Null when this page is empty. The next page may be empty; an empty page is free."},"payment":{"$ref":"#/components/schemas/PaymentInfo"}},"required":["stream","filter","quorums","next_cursor","payment"],"additionalProperties":false},"QuorumResponse":{"type":"object","description":"One quorum, and how the call was paid.","properties":{"quorum_id":{"type":"string","description":"Stable id. GET /api/agent/v1/quorums/{quorum_id} returns this quorum."},"headline":{"type":"string","description":"The story, in one line."},"summary":{"type":["string","null"],"description":"What the viewpoints disagree about."},"category":{"type":["string","null"],"description":"Topic category, e.g. conflict, politics, economy, infrastructure."},"countries":{"type":"array","items":{"type":"string"},"description":"ISO 3166-1 alpha-2 codes (upper case) of the countries the story is about."},"support_count":{"type":"integer","minimum":0,"description":"Posts across all viewpoints."},"confidence":{"type":["number","null"],"minimum":0,"maximum":1,"description":"0 to 1: how well sourced the story is. Null until it is scored."},"is_alpha":{"type":"boolean","description":"True when the story is ahead of the wider press."},"updated_at":{"type":"string","format":"date-time","description":"When a post last joined the story (UTC)."},"viewpoints":{"type":"array","items":{"$ref":"#/components/schemas/Viewpoint"},"description":"The viewpoints, most supported first."},"article_url":{"type":"string","format":"uri","description":"The quorum's page on sense.quorumz.com."},"payment":{"$ref":"#/components/schemas/PaymentInfo"}},"required":["quorum_id","headline","summary","category","countries","support_count","confidence","is_alpha","updated_at","viewpoints","article_url","payment"],"additionalProperties":false},"ArticleResponse":{"type":"object","description":"One article with its quorums, and how the call was paid.","properties":{"article_id":{"type":"string","description":"Stable id. GET /api/agent/v1/articles/{article_id} returns this article."},"title":{"type":"string","description":"The article's title."},"summary":{"type":["string","null"],"description":"What the article reports."},"category":{"type":["string","null"],"description":"Topic category, e.g. conflict, politics, economy."},"countries":{"type":"array","items":{"type":"string"},"description":"ISO 3166-1 alpha-2 codes of the countries the article discusses."},"updated_at":{"type":"string","format":"date-time","description":"Last activity on the story (UTC)."},"quorums":{"type":"array","items":{"$ref":"#/components/schemas/Quorum"},"description":"The quorums on this story, each with its viewpoints. May be empty."},"article_url":{"type":"string","format":"uri","description":"The article's page on sense.quorumz.com."},"payment":{"$ref":"#/components/schemas/PaymentInfo"}},"required":["article_id","title","summary","category","countries","updated_at","quorums","article_url","payment"],"additionalProperties":false},"AlphaEventsResponse":{"type":"object","description":"A page of alpha events, and how the call was paid.","properties":{"stream":{"type":"string","const":"alpha"},"filter":{"type":"object","description":"The filters applied.","properties":{"country":{"type":["string","null"],"description":"ISO 3166-1 alpha-2 code, upper case."},"cell":{"type":["string","null"],"description":"Geohash cell, as sent."}},"required":["country","cell"],"additionalProperties":false},"events":{"type":"array","items":{"$ref":"#/components/schemas/AlphaEvent"},"maxItems":50},"next_cursor":{"type":["string","null"],"description":"Pass it back as `cursor` for the next, older page. Null when this page is empty. The next page may be empty; an empty page is free."},"charged_events":{"type":"integer","minimum":0,"description":"Events on this page: the number a paid call is billed for. `payment.charged_events` says what was."},"payment":{"$ref":"#/components/schemas/PaymentInfo"}},"required":["stream","filter","events","next_cursor","charged_events","payment"],"additionalProperties":false},"NewsEventsResponse":{"type":"object","description":"A page of news events, and how the call was paid.","properties":{"stream":{"type":"string","const":"news"},"filter":{"type":"object","description":"The filter applied.","properties":{"country":{"type":["string","null"],"description":"ISO 3166-1 alpha-2 code, upper case."}},"required":["country"],"additionalProperties":false},"events":{"type":"array","items":{"$ref":"#/components/schemas/NewsEvent"},"maxItems":50},"next_cursor":{"type":["string","null"],"description":"Pass it back as `cursor` for the next, older page. Null when this page is empty. The next page may be empty; an empty page is free."},"charged_events":{"type":"integer","minimum":0,"description":"Events on this page: the number a paid call is billed for. `payment.charged_events` says what was."},"payment":{"$ref":"#/components/schemas/PaymentInfo"}},"required":["stream","filter","events","next_cursor","charged_events","payment"],"additionalProperties":false},"EventsResponse":{"description":"A page of alpha or news events, as `stream` says.","oneOf":[{"$ref":"#/components/schemas/AlphaEventsResponse"},{"$ref":"#/components/schemas/NewsEventsResponse"}],"discriminator":{"propertyName":"stream","mapping":{"alpha":"#/components/schemas/AlphaEventsResponse","news":"#/components/schemas/NewsEventsResponse"}}},"PaymentInfo":{"type":"object","description":"How this call was paid; on every 200 from a paid route. With an API key, `plan` says what paid: `trial` (free; `trial` shows the calls left), `credits` (`credits` shows the charge and the balance) or `internal`. With x402, `settled` is true, `network` and `asset` name the chain it settled on, and the PAYMENT-RESPONSE header is the receipt. With neither, the call was free (an empty page): `charged_events` is 0.","properties":{"status":{"type":"string","enum":["enforced","address_set_facilitator_missing","preview"],"description":"Whether the server charges for calls. `enforced` in production; under `preview` nothing is charged."},"scheme":{"type":"string","enum":["exact","x402"],"description":"The x402 payment scheme: `exact` when payment is enforced."},"reason":{"type":"string","description":"Preview only: why payment is not enforced."},"network":{"type":"string","description":"CAIP-2 chain id: the default x402 network, or the chain this call's x402 payment settled on (eip155:8453 Base, eip155:137 Polygon, eip155:42161 Arbitrum)."},"networks":{"type":"array","items":{"type":"string"},"description":"Every chain an x402 payment is accepted on, the default first."},"pay_to":{"type":"string","description":"The address x402 payments go to."},"asset":{"type":"string","description":"The USDC contract address on `network`."},"facilitator":{"type":"string","format":"uri","description":"The x402 facilitator that verifies and settles payments."},"prices_usd":{"type":"object","description":"Price per record returned, in US dollars, by stream.","properties":{"alpha":{"type":"number","description":"Per alpha event."},"news":{"type":"number","description":"Per news event or article."},"quorum":{"type":"number","description":"Per quorum."}},"required":["alpha","news","quorum"],"additionalProperties":false},"charged_events":{"type":"integer","minimum":0,"description":"Records this call was billed for, by x402 or credits. 0 when it was free."},"settled":{"type":"boolean","description":"True when an x402 payment settled on chain for this call."},"plan":{"type":"string","enum":["trial","credits","internal"],"description":"API-key calls only: what paid for this call."},"trial":{"$ref":"#/components/schemas/TrialStatus"},"credits":{"$ref":"#/components/schemas/CreditCharge"}},"required":["status","scheme","prices_usd","charged_events","settled"],"additionalProperties":false},"TrialStatus":{"type":"object","description":"An API key's free trial.","properties":{"active":{"type":"boolean","description":"True while free calls remain and the trial has not ended."},"calls_used":{"type":"integer","minimum":0,"description":"Free calls used."},"calls_left":{"type":"integer","minimum":0,"description":"Free calls left."},"calls_limit":{"type":"integer","minimum":0,"description":"Free calls in the trial."},"ends_at":{"type":["string","null"],"format":"date-time","description":"When the trial ends (UTC)."}},"required":["active","calls_used","calls_left","calls_limit","ends_at"],"additionalProperties":false},"CreditCharge":{"type":"object","description":"Prepaid credits, which pay for calls after the trial.","properties":{"charged_usd":{"type":"number","minimum":0,"description":"This call's cost, deducted from the balance."},"balance_usd":{"type":"number","description":"Credits left, in US dollars."}},"required":["charged_usd","balance_usd"],"additionalProperties":false},"PaymentRequired":{"type":"object","description":"An x402 v2 payment challenge. No records are returned. The PAYMENT-REQUIRED header carries the same object, Base64-encoded.","properties":{"x402Version":{"type":"integer","const":2},"resource":{"type":"object","description":"The resource being paid for.","properties":{"url":{"type":"string","format":"uri","description":"The URL called."},"description":{"type":"string","description":"What the resource returns."},"mimeType":{"type":"string","description":"Response media type."},"serviceName":{"type":"string","description":"Service name."},"tags":{"type":"array","items":{"type":"string"}},"iconUrl":{"type":"string","format":"uri","description":"Service icon."}},"required":["url","description","mimeType","serviceName","tags","iconUrl"],"additionalProperties":false},"accepts":{"type":"array","items":{"$ref":"#/components/schemas/PaymentRequirement"},"minItems":1,"description":"Sign any one of these and retry with PAYMENT-SIGNATURE."},"extensions":{"type":"object","description":"x402 extensions.","properties":{"bazaar":{"type":"object","description":"Discovery metadata for x402 catalogs: the route's input and an output example."}},"required":["bazaar"],"additionalProperties":false},"error":{"type":"string","description":"Why payment is required: `PAYMENT-SIGNATURE header is required` on an unpaid call; `no_credits` or `trial_over` when an API key has nothing left; otherwise why a payment failed (e.g. payment_invalid, payment_already_used, facilitator_unavailable)."},"alternatives":{"type":"object","description":"The other way to pay.","properties":{"api_key":{"type":"object","description":"An API key, paid by card.","properties":{"signup":{"type":"string","format":"uri","description":"Where to get a key."},"pay_with":{"type":"string","description":"Accepted payment methods."},"free_trial":{"type":"string","description":"The key's free trial."}},"required":["signup","pay_with","free_trial"],"additionalProperties":false}},"required":["api_key"],"additionalProperties":false},"trial":{"anyOf":[{"$ref":"#/components/schemas/TrialStatus"},{"type":"null"}],"description":"The key's trial, when an API key ran out."},"get_a_key":{"type":"string","format":"uri","description":"Where to add credits. Present when an API key has no free calls or credits left."},"message":{"type":"string","description":"What to do next, in plain words: get a free API key or pay with x402, and where the free sample is. When an API key has no free calls or credits left, how to add credits."},"get_started":{"$ref":"#/components/schemas/GetStarted"}},"required":["x402Version","resource","accepts","extensions","error","alternatives","message","get_started"],"additionalProperties":false},"PaymentRequirement":{"type":"object","description":"One way to pay this call with x402: an exact USDC transfer on one chain.","properties":{"scheme":{"type":"string","const":"exact"},"network":{"type":"string","description":"CAIP-2 chain id: eip155:8453 (Base), eip155:137 (Polygon) or eip155:42161 (Arbitrum)."},"amount":{"type":"string","pattern":"^[0-9]+$","description":"The price of the records this call would return, in atomic USDC (6 decimals): 10000 is $0.01."},"asset":{"type":"string","description":"The USDC contract address on that chain."},"payTo":{"type":"string","description":"The address the payment goes to."},"maxTimeoutSeconds":{"type":"integer","minimum":0,"description":"How long the signed authorization may take to settle."},"extra":{"type":"object","description":"The EIP-712 domain of the USDC contract.","properties":{"name":{"type":"string","description":"Token name."},"version":{"type":"string","description":"Domain version."}},"required":["name","version"],"additionalProperties":false}},"required":["scheme","network","amount","asset","payTo","maxTimeoutSeconds","extra"],"additionalProperties":false},"Error":{"type":"object","description":"An error.","properties":{"error":{"type":"string","description":"What went wrong."},"get_a_key":{"type":"string","format":"uri","description":"Where to get an API key (401 only)."}},"required":["error"],"additionalProperties":false},"ValidationError":{"type":"object","description":"A query parameter has the wrong type (FastAPI's validation error).","properties":{"detail":{"type":"array","items":{"type":"object"}}},"required":["detail"]},"Catalog":{"type":"object","description":"The free service description: streams, routes, prices, both ways to pay, and payment status.","properties":{"service":{"type":"string"},"differentiator":{"type":"string"},"streams":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","enum":["quorum","alpha","news"]},"description":{"type":"string"},"unit_price_usd":{"type":"number","description":"Price per record returned."},"path":{"type":"string"}},"required":["name","unit_price_usd","path"]}},"routes":{"type":"array","items":{"type":"object","properties":{"method":{"type":"string"},"path":{"type":"string"},"price":{"type":"string"},"purpose":{"type":"string"},"query":{"type":"array","items":{"type":"string"}}},"required":["method","path","price"]}},"filters":{"type":"array","items":{"type":"string"}},"access":{"type":"array","items":{"type":"object","properties":{"method":{"type":"string","enum":["x402","api_key"]},"summary":{"type":"string"},"how":{"type":"string"},"signup":{"type":"string","format":"uri"}},"required":["method","summary","how"]}},"docs":{"type":"string","format":"uri"},"landing":{"type":"string","format":"uri"},"payment":{"type":"object","description":"Whether payment is enforced, and where x402 payments go.","properties":{"status":{"type":"string","enum":["enforced","address_set_facilitator_missing","preview"],"description":"Whether the server charges for calls. `enforced` in production; under `preview` nothing is charged."},"scheme":{"type":"string","enum":["exact","x402"],"description":"The x402 payment scheme: `exact` when payment is enforced."},"reason":{"type":"string","description":"Preview only: why payment is not enforced."},"network":{"type":"string","description":"CAIP-2 chain id: the default x402 network, or the chain this call's x402 payment settled on (eip155:8453 Base, eip155:137 Polygon, eip155:42161 Arbitrum)."},"networks":{"type":"array","items":{"type":"string"},"description":"Every chain an x402 payment is accepted on, the default first."},"pay_to":{"type":"string","description":"The address x402 payments go to."},"asset":{"type":"string","description":"The USDC contract address on `network`."},"facilitator":{"type":"string","format":"uri","description":"The x402 facilitator that verifies and settles payments."},"prices_usd":{"type":"object","description":"Price per record returned, in US dollars, by stream.","properties":{"alpha":{"type":"number","description":"Per alpha event."},"news":{"type":"number","description":"Per news event or article."},"quorum":{"type":"number","description":"Per quorum."}},"required":["alpha","news","quorum"],"additionalProperties":false}},"required":["status","scheme","prices_usd"],"additionalProperties":false}},"required":["service","streams","routes","access","payment"]}},"responses":{"Unauthorized":{"description":"The API key is unknown, revoked or expired. Get one at `get_a_key`, or send no key and pay with x402.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"invalid api key","get_a_key":"https://sense.quorumz.com/agents/keys"}}}},"NotFound":{"description":"No record with that id. Not charged. A call with neither an API key nor PAYMENT-SIGNATURE gets the 402 first: the id is looked up only on a paid call.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"error":"not_found"}}}},"InvalidParameter":{"description":"A query parameter has the wrong type, e.g. a `limit` that is not a whole number.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationError"},"example":{"detail":[{"type":"int_parsing","loc":["query","limit"],"msg":"Input should be a valid integer, unable to parse string as an integer","input":"ten"}]}}}}},"headers":{"PaymentRequired":{"description":"The x402 challenge: the 402 body as compact JSON, Base64-encoded. Sign one of its `accepts` and retry with PAYMENT-SIGNATURE.","required":true,"schema":{"type":"string","contentEncoding":"base64"}},"PaymentResponse":{"description":"The x402 receipt, on calls paid with x402 only: the facilitator's settlement as JSON, Base64-encoded (success, transaction hash, network, payer).","schema":{"type":"string","contentEncoding":"base64"}}}},"x-discovery":{"ownershipProofs":["0x9ce92953d33237af061c6b1aa29c597c8656b547"],"docs":"https://sense.quorumz.com/agents/docs"}}