Demo supply and coverage
The demo exchange answers from four kinds of supply. Everything except Wikipedia and Wikinews is fictional demo supply: invented publishers with original synthetic content written for this repository. Their prices are demo prices and no money moves.
| Supply | Source id(s) | What it is |
|---|---|---|
| Demo verticals | vertical-finance, vertical-developer-docs, vertical-research | Twelve fictional publishers in three verticals, about 300 dated items, each publisher with its own rate card |
| Seeded general catalogue | local-catalogue | Four fictional general-interest publishers, sixteen items (data/catalogue/) |
| Demo publisher endpoints | demo-* (with DEMO_PUBLISHERS=on) | Five fictional publishers speaking the v1 offer contract over HTTP |
| Live fallback | wikinews-en, wikipedia-en (with WIKIMEDIA_SOURCES) | Real, openly licensed content searched live. See Live sources |
What is live on a given deployment is listed, with item counts and prices, at /coverage (a page) and GET /v1/coverage (JSON; see the API reference).
The verticals
Each vertical is one source, so routing sends a query to the verticals whose profile matches it and leaves the others out. Within a vertical, publishers overlap on purpose, so a typical query gets competing offers at different prices and terms.
Finance and business news (data/verticals/finance)
| Publisher | Style | Base prices (grounding / display / full text, USD) | Rules |
|---|---|---|---|
| Ledgerwick Wire | Short wire-style business news | 0.003 / 0.007 / 0.018 | Breaking (2 days) x1.5, archive (180 days) x0.4 |
| Copperfield Markets Daily | Markets news and analysis | 0.005 / 0.012 / 0.030 | Analysis section x1.25, archive (1 year) x0.5 |
| Ashgrove Business Review | Long-form strategy and industry analysis | 0.004 / 0.010 / 0.045 | Archive (1 year) x0.5 |
| Tallyhouse Money | Personal finance news and explainers | 0.0015 / 0.004 / 0.009 | Explainers x0.8 |
Developer documentation (data/verticals/developer-docs)
| Publisher | Style | Base prices | Rules |
|---|---|---|---|
| Stackhollow Guides | Task-oriented how-to guides | 0.001 / 0.003 / 0.008 | None |
| Quaymark Reference | Concise reference pages | 0.0005 / 0.0015 / 0.004 | None |
| Lintel Security Notes | Secure-coding guides and advisories | 0.002 / 0.005 / 0.015 | Advisories under 30 days x1.4 |
| Patchwell Weekly | Release notes, deprecations, migration guides | 0.0012 / 0.0035 / 0.009 | Fresh (30 days) x1.3, archive (1 year) x0.5 |
Scholarly and research abstracts (data/verticals/research)
| Publisher | Style | Base prices | Rules |
|---|---|---|---|
| Halvard Research Press | Peer-reviewed journals: climate, energy, materials, ecology | 0.012 / 0.030 / 0.40 | Open-access items at fixed low prices; backfile (2 years) x0.6 |
| Emberline Preprints | Preprints in computing, ML, physics, quantitative biology (not peer reviewed) | 0.002 / 0.005 / 0.015 | None |
| Quillon Clinical Reviews | Systematic reviews, trials and guidelines | 0.030 / 0.080 / 1.50 | Guidelines x1.3 |
| Bramblegate University Press | Economics, education and social science journals and working papers | 0.008 / 0.020 / 0.25 | Working papers x0.5 |
The rate cards are in each vertical's rate-cards/ directory and follow the rate card schema. Every one carries extensions["com.clear-exchange"].demo_publisher: true.
Content rules
- Publisher names, domains (all under
.example), people, companies, studies and results are invented. Nothing is copied from a real publisher. - News items never attribute fabricated decisions, figures or quotes to real companies, people or named institutions. They use a fictional economy (an unnamed "central bank", invented companies).
- Developer documentation describes real technologies (PostgreSQL, Git, OAuth and so on) accurately, in original wording. Security advisories are about invented packages.
- Research abstracts are about invented studies by invented authors. Clinical items describe interventions generically, give no dosing and are not medical advice.
- Openly licensed public content may be added where its licence allows, labelled with its licence in the rate card's
content_licenceand the item's metadata. None is included today.
Layout and adding a vertical
data/verticals/<vertical_id>/
vertical.json { vertical_id, name, description, demo, notice, topics }
publishers.json [{ publisher_id, name, domain, description, rate_card, topics }]
rate-cards/*.json one rate card per publisher
articles/*.json arrays of items: content_id, publisher_id, title, url, section, tags, published_at, summary, bodyEvery directory under data/verticals/ is loaded at startup as a source with id vertical-<directory> (source type demo-vertical, src/supply/registry.ts). Adding a vertical is a new directory; no code changes. The loader rejects unknown publishers, duplicate content ids, missing fields and bad dates, and test/verticals.test.ts checks every vertical for volume, freshness and overlap.
DEMO_VERTICALS=off leaves the verticals out (the seeded catalogue and anything else configured stay). The default is on, locally and on the deployed demo.
Why the content is synthetic
A customer survey run against the demo found that live supply was essentially Wikipedia and Wikinews plus the sixteen-item catalogue, so buyers in finance, developer tooling and research judged coverage too thin to evaluate the product. The verticals give the demo realistic depth (several publishers, competing rate cards, dated items) in those three markets without using anyone's content without permission. They are a stand-in for real publishers connected through the v1 offer contract, and are labelled as demo supply everywhere they appear.