The public dataset
The core catalogue is served from one compiled dataset: 500 companies, 10 markets, and 24 issuer-specific core references, frozen at edition compile time. Measured-entity anatomy is a separately bound current-state edition with its own definition and quote clocks. Both are public as static JSON files and query routes, and both are documented below and on the methodology page.
Static endpoints
Static files under /hedgebook/static-api/ are regenerated on every deploy and served from the CDN. Core-catalogue payloads carry the site's edition, issuer-universe, quote-overlay, and public-build clocks. Company-line payloads carry their separate line-definition edition and quote-overlay clock, so consumers do not have to pretend the two freezes happened together.
| Endpoint | Returns |
|---|---|
/hedgebook/static-api/snapshot.json | Dataset metadata and ticker aliases. |
/hedgebook/static-api/companies.json | The full company index: all 500 constituents with sector, market cap, and lead market. |
/hedgebook/static-api/markets.json | The full market index: all 10 markets with quotes and company counts. |
/hedgebook/static-api/company/{TICKER}.json | One company payload with variable core/context references and evidence receipts. Tickers are uppercase, e.g. NVDA.json. |
/hedgebook/static-api/company-lines/index.json | Compact company-line edition index: clocks, company-level counts, and exact shard pointers. |
/hedgebook/static-api/company-lines/company/{ENTITY_ID}.json | One issuer or measured brand/product anatomy with source-backed lines, listing families, exact rungs, and potential lines. The route ID is not necessarily an exchange ticker. |
/hedgebook/static-api/market/{MARKET_TICKER}.json | One market payload with quotes and the companies that carry it. |
/hedgebook/static-api/history.json | Daily quote history per market (2026.08.25 through 2026.08.25); gaps reflect days without an archived refresh. |
/hedgebook/static-api/notes/index.json | Index of published weekly notes; each week is served at /hedgebook/static-api/notes/{YYYY-Www}.json. |
Company anatomy edition
Line definitions and contract quotes have separate clocks. Every public state is derived from the mapped contract and quote facts below.
- Edition
- company-kpi-current-state-2026-09-01
- Line definitions frozen
- 2026-09-01
- Quote overlay generated
- 2026-09-01T11:05:25Z
- Current edition
- Entity maps: 164 · measured lines: 259 · lines with a current listing: 243 · potential lines: 16
- Entity scope
- Issuer companies: 141 · measured brands/products: 23 · S&P 500 members: 61
- Source classes
- Issuer-reported and panel estimate · panel-estimate lines: 80
Definitions and limits
A measured line is a dated business metric attached to an issuer, brand, or product with a public source receipt. Public state is one of live and priced, live with price unavailable, previously listed, or potential. A potential line is not an announced Kalshi product and carries no market economics.
issuer_reported uses the company's own reporting definition. panel_estimate uses a named third-party observation and is never presented as the issuer's reported result. Exact market pages inherit the same source class and line identity.
This dated edition is not a KPI browser or recommendation universe. It does not establish business exposure, causality, present availability, liquidity, fill capacity, or suitability. Contract state and quotes belong only to the overlay time above.
Query routes
Routes under /hedgebook/api/ serve the same data with query parameters, cached at the edge. All routes are GET-only and return JSON.
| Route | Returns |
|---|---|
/hedgebook/api/snapshot | Dataset metadata and ticker aliases. |
/hedgebook/api/companies?q=§or=&sort= | Filtered company index; all parameters optional. |
/hedgebook/api/company?ticker= | One company payload; alias tickers resolve to the canonical record. |
/hedgebook/api/markets?q=&category= | Filtered market index; all parameters optional. |
/hedgebook/api/market?ticker= | One market payload. |
Full-dataset downloads
The complete catalogue is reachable from two files: companies.json enumerates every constituent and markets.json enumerates every market; the per-ticker files under /hedgebook/static-api/company/ and /hedgebook/static-api/market/ carry the full payloads, including every rationale line. The internal compile artifact (public-data.json) is not itself exposed; the static endpoints above are exports of the same compile and together contain its public content.
Citation
Suggested citation for the dataset, in any register that records both dates:
Hedgebook on Blanket (tryblanket.app/hedgebook), edition hedgebook-2026-08-25-v2, matching cutoff 2026-08-25. Kalshi market quotes as of 2026-08-25T17:38:59.860431Z.Schema summary
Four record shapes cover most of the dataset. Fields marked ? are optional; probabilities are decimals in [0, 1]; timestamps are ISO 8601 UTC.
Company
| Field | Type | Description |
|---|---|---|
ticker | string | Canonical S&P 500 ticker. |
name | string | Company name. |
sector | string | GICS sector label. |
sub_industry | string? | GICS sub-industry label. |
market_cap_usd | number? | Market capitalization in USD at the issuer-universe date. |
market_count | number | Variable number of published core and context references. |
core_count / context_count | number | Separate layer counts; zero is valid. |
markets | CompanyMarket[] | Evidence-backed references, ordered core before context. |
CompanyMarket (rows of company.markets)
| Field | Type | Description |
|---|---|---|
rank | number | Display position within the variable edition result. |
layer | core | context | Issuer-specific core or separately labeled shared context. |
market_ticker | string | Kalshi market ticker. |
title | string | Market title as displayed. |
category_ids / category_labels | string[]? | Hedgebook category taxonomy assignments. |
risk_channel | string? | The channel through which the market touches the company. |
probability | number? | Last quoted probability (0-1) from the Kalshi tape. |
bid / ask | number? | Best bid and ask at the quote timestamp. |
status | string? | Market status on the tape (active, finalized, ...). |
resolution_date | string? | Scheduled resolution date, when published. |
quote_as_of | string? | Timestamp of the quote carried on this row. |
why_this_company_cares | string? | Descriptive line citing the documented business reference. |
mechanism | object | Typed descriptive connection between the filing driver and settlement variable. |
measurement_basis / measurement_evidence | object | Public-safe issuer or third-party panel classification with an exact source receipt. |
Market
| Field | Type | Description |
|---|---|---|
market_ticker | string | Kalshi market ticker. |
title | string | Market title as displayed. |
series_ticker / event_ticker | string? | Kalshi series and event identifiers. |
category_ids / category_labels | string[]? | Hedgebook category taxonomy assignments. |
company_count | number | Number of S&P 500 companies mapped to this market. |
sector_distribution | object[]? | Company counts by GICS sector. |
probability | number? | Last quoted probability (0-1) from the Kalshi tape. |
bid / ask | number? | Best bid and ask at the quote timestamp. |
status | string? | Market status on the tape. |
resolution_date | string? | Scheduled resolution date, when published. |
selected_companies | SelectedCompany[] | Companies carrying this market, with per-company rationale lines. |
MarketIndex (rows of markets.json)
| Field | Type | Description |
|---|---|---|
market_ticker | string | Kalshi market ticker. |
title | string | Market title as displayed. |
category_ids / category_labels | string[]? | Hedgebook category taxonomy assignments. |
company_count | number | Number of companies mapped to the market. |
probability_display / bid_ask | string? | Formatted quote strings for index surfaces. |
href | string? | Site-relative path of the market page. |
CompanyLinePublicationIndex
| Field | Type | Description |
|---|---|---|
edition_id | string | Immutable company-line edition identifier. |
line_edition_as_of | date | Cutoff for the current operating-line definitions. |
quote_overlay_generated_at | timestamp | Capture time for contract state and quotes; separate from the line-definition clock. |
counts | object | Company, line-state, source-class, and exact market-record totals for this edition. |
companies | CompanyLineIndexEntry[] | Measured-entity counts, lead line, authored share order, and exact shard path. |
company_id / canonical_ticker | string | Stable route and join identity. It is not necessarily an exchange ticker and is not used as a display label. |
exchange_ticker | string? | Public exchange symbol when the mapped entity is an issuer and one is known. |
sp500_member | boolean | S&P 500 membership at capture; enrichment only, never a company-line eligibility gate. |
entity_kind | issuer_company | brand_or_product | Distinguishes an issuer company from the measured brand or product named by the contract. |
cik | string? | Zero-padded SEC issuer identifier when applicable; absent for measured brands/products. |
market_lookup | object | Exact contract ticker to company, operating line, listing family, and shard pointer. |
License and provenance
Hedgebook is a descriptive dataset, published as-is and without warranty. Nothing in it is investment advice, a recommendation, or a solicitation to buy or sell any contract or security. Market quote data originates from Kalshi and remains © Kalshi; company disclosures are quoted from SEC EDGAR filings, which are public records. Records reused with the citation above carry the edition and quote clocks with them; the numbers are meaningful only in that context.