Brierly API

One public documentation page for current, supportable settlement-risk data. The API is intended for exchanges, market operators, funds, market makers, risk teams, researchers, and builders who need RuleScore or dispute data programmatically.

Availability

Private access

Keys are issued directly

Authentication

API key

X-Brierly-Key header

Format

JSON

Derived and Brierly-authored data

What the API provides

Capability	Endpoint	Current fields
Health	GET /api/v1/health	Service time, feed reachability, database state, and scheduled-job freshness. No key.
RuleScore ratings	GET /api/v1/grades	Market identifiers, venue, title, letter rating, score, band, language-risk and event-execution components, anchoring tier, short hazard excerpts, methodology version, canonical rating-input receipt, and legacy rules-text checksum.
Single contract rating	GET /api/v1/grades/{venue}/{market_id}	Current rating detail for a retrievable live contract.
Dispute data	GET /api/v1/disputes	Brierly-authored sourced case-study data. The full census remains a separate analytical dataset.
EMU data	GET /api/v1/index/emu	Supported secondary index values and canonical daily history.
Rules-change alerts	GET /api/v1/rules-changes	Detected hashes and rating changes, never full venue rules text.

RuleReview is currently an in-browser product, not a public API. RuleDraft is a professional service, not an API endpoint.

Example request

curl "https://prerender.local/api/v1/grades?band=elevated&limit=1" \
  -H "X-Brierly-Key: br_live_xxx"

Example response shape

{
  "methodology": "rulescore-v2.0",
  "count": 1,
  "items": [{
    "market_id": "…",
    "venue": "polymarket",
    "rating": "BR-Baa",
    "score": 31,
    "band": "elevated",
    "lrs": 24,
    "eer": 7,
    "rating_input_sha256": "…",
    "rules_sha256": "…"
  }]
}

Representative shape only; values vary by live contract. Field names match the current implementation.

Limits and data rights

The API does not redistribute full venue rules corpora or bulk raw market data. Ratings are editorial opinions about settlement risk, not event predictions. Live coverage depends on venue availability and retrievable rules text. Authentication, quotas, and access are arranged directly.

Request API access

Do not send API keys or confidential contract language through this form. Machine-readable overview: llms.txt ↗.