This dictionary documents every major object in Warconomy's data model and machine-readable exports — what each field means, its type, and where it appears (data.json, CSV/JSONL, graph.json, and the public pages). Use it to consume the dataset programmatically. Values are source-linked and manually maintained; not real-time. Sample rows are clearly labeled and must not be cited as current data.
- 9 object types documented, with field types and locations.
- Maps to data.json, the CSV/JSONL distributions, and graph.json.
- Source-linked, manually maintained; not real-time.
Observation
Appears in: data.json observations[]; observations.csv/jsonl; /indicators/<id>
| Field | Type | Description |
|---|---|---|
id | string | Stable observation id (e.g. obs-hormuz-brent). |
metricId | slug | The economic metric this measures. |
value | number | string | The source-reported value. |
unit | string? | Unit of the value (e.g. USD/bbl). |
dataMode | live | sample | Live/static = source-linked; sample = illustrative, not current. |
confidence | high | medium | low | Reflects source quality/freshness. |
asOf | ISO date | The period the value refers to. |
lastReviewed | ISO date? | When a human last verified it. |
sourceId | string | The cited source. |
subjectType/subjectId | enum/string | Which page/category it belongs to. |
Source
Appears in: data.json sources[]; sources.csv/jsonl; /sources/<id>(.json)
| Field | Type | Description |
|---|---|---|
id | string | Stable source id. |
title / publisher | string | Display title and publishing organization. |
url | url | Deep link to the source page/series. |
type | official | intergovernmental | academic | market | industry | Source category. |
cadence | monthly | annual | unknown | Update cadence; drives freshness thresholds. |
accessedDate / publishedDate | ISO date? | When accessed / published. |
Citation fact
Appears in: data.json facts[]; facts.csv
| Field | Type | Description |
|---|---|---|
id | string | Stable fact id. |
statement | string | Qualitative, attributed statement. |
value | string? | Optional headline value. |
dataMode | sample | Facts are labeled sample (qualitative context). |
sourceId / asOf | string / ISO? | Cited source and period. |
Indicator series & snapshot
Appears in: data.json series[]; series.csv/jsonl; /series, /series/<id>
| Field | Type | Description |
|---|---|---|
id / title | slug / string | Series id and title. |
metricId / unit / cadence | slug / string / enum | What/how the series measures. |
latestObservationId | string? | Current observation the latest snapshot matches. |
snapshots[] | array | Dated points: period, asOf, value, sourceId, confidence. |
Policy threshold
Appears in: data.json policyThresholds[]; policy-thresholds.csv/jsonl
| Field | Type | Description |
|---|---|---|
id / label / value / unit | mixed | Policy parameter (e.g. a price cap). |
jurisdiction | string | Which authority sets it (caps differ by jurisdiction). |
isMarketPrice | false | A policy threshold, not a market price; not legal advice. |
Source quality
Appears in: data.json sourceQuality; source-quality.csv/jsonl/json; /source-quality
| Field | Type | Description |
|---|---|---|
authority | enum | Official, international institution, research, industry. |
citationRole | enum | source_of_record | supporting_context | unused. |
readiness | high | medium | low | How directly it backs a maintained value. |
reasons / limitations | string[] | Why trusted; caveats. Not a correctness claim. |
Category summary
Appears in: data.json dataReview.categorySummaries[]; categories.csv/jsonl
| Field | Type | Description |
|---|---|---|
id / live / sample / sourceCount | mixed | Per-category counts. |
review | object | current/due-soon/overdue/stale/highPriority/totalLive. |
worstStatus | enum | Worst review status in the category. |
Query intent
Appears in: data.json queryHub.intents[]; query-intents.csv/jsonl; /economic-impact
| Field | Type | Description |
|---|---|---|
id / question | string | A routed natural-language question. |
recommendedPath | path | The best page for it. |
caveats | object | partialCoverage / notRealTime / notLegalAdvice / notCausalAttribution. |
Graph node / edge
Appears in: graph.json; graph-nodes.csv; graph-edges.csv; /graph
| Field | Type | Description |
|---|---|---|
node.id / type / path | string | id/path-based node (page, source, observation, series, …). |
edge.from / to / type | string | Citation/structural link; not a causal claim. |
Exports
Full JSON: data.json · graph: graph.json · per-record provenance.json · all CSV/JSONL on the dataset page · researcher manifest.json · static OpenAPI 3.1 contract api/openapi.json · representative contract examples · the schema validation report.
JSON Schemas (data contract v2)
Conservative, backward-compatible draft-07 schemas pin the required, stable fields and allow additional properties, so new export fields never break a consumer:
- schema.json
- observation.schema.json
- source.schema.json
- series.schema.json
- graph.schema.json
- diff.schema.json
See data audit for the integrity checks and version registry for frozen per-version payloads.
Key terms
- Time series — An append-only history of dated, source-linked snapshots for a recurring indicator. The current observation remains the source of record; snapshots add the trend. Not a live chart.
- Source quality — Warconomy's derived view of a source's citation-readiness — authority, role, and how directly it backs a maintained value. Surfaced on the /source-quality dashboard.
- Citation graph — A deterministic node/edge graph (graph.json) connecting pages, observations, facts, sources, dashboards, series, and the dataset — for AI and tooling.
- Benchmark price — A widely-referenced market price (e.g. Brent crude, Henry Hub gas) used to price a broader class of trade. Warconomy tracks benchmarks as context, not as proof of a specific cause.