API Guide

curl https://api.mecone.trade/api/v1/info

​

API keys

curl -H "X-API-Key: mck_…" https://api.mecone.trade/api/v1/indices
curl -H "Authorization: Bearer mck_…" https://api.mecone.trade/api/v1/indices

• an unknown, revoked, or expired key is a 401 credential-invalid problem;
• a valid key that lacks the plane’s scope is a 403 credential-scope problem;
• an entitled key reading a benchmark or flagship index outside its list is a 403 benchmark-not-entitled problem;
• a key over its per-minute limit is a 429 rate-limited problem carrying Retry-After, RateLimit-Limit, RateLimit-Remaining, and RateLimit-Reset headers.

​

Resources

​

Response envelope

{
  "data": { "type": "index", "id": "MCPI" },
  "meta": {
    "api_version": "v1",
    "schema_version": "mecone-public-api-v1"
  },
  "links": { "self": "/api/v1/indices/us-cpi-yoy" }
}

​

Index metadata

curl https://api.mecone.trade/api/v1/indices/MCPI

• identity and the curated thesis description;
• methodology version, estimand, high-level calculation class, transformation disclosure status, and venue weights. The methodology.index_transformation block describes the calculation class without exposing implementation parameters; lifecycle and release records remain available in their specifically labeled resources;
• prediction-market contracts, roles, lifecycle clocks, links, and source-native volume/open-interest units;
• latest and next release or resolution details; and
• links to the latest snapshot, committed round, and distribution.

​

Live snapshot

curl https://api.mecone.trade/api/v1/indices/MCPI/snapshots/latest

​

Stored history

curl "https://api.mecone.trade/api/v1/indices/MANTH/history?range=1m&resolution=auto"

​

Latest committed round

curl https://api.mecone.trade/api/v1/indices/MCPI/rounds/latest

{
  "data": {
    "type": "index_round",
    "status": "api_committed",
    "official": true,
    "round_id": "2026-07-16T04:00:00+00:00",
    "value": {
      "decimal": "3.4972978473895",
      "number": 3.4972978473895,
      "unit": "%",
      "display": null
    },
    "chain_confirmation": {
      "status": "not_asserted"
    }
  }
}

​

Probability distribution

curl https://api.mecone.trade/api/v1/indices/MCPI/distributions/latest

​

Index news

curl "https://api.mecone.trade/api/v1/indices/MCPI/news?limit=20&kind=official_release,venue_context"

• kind — official_release (the anchor agency’s own print, e.g. the BLS CPI release), official_statement (FOMC statements and minutes), filing (SEC EDGAR Form D / S-1 / F-1 by the pre-IPO entity — relevance: direct — or a fund/SPV vehicle named after it — related; links go to the human-readable EDGAR filing index), venue_context (the source venue’s own context on the bound contract: Polymarket’s market-context narrative, which is AI-generated by the venue and not verified by Mecone — such items say so in their title, source.name, provenance.note and payload.generated_by: "venue_ai", and should be displayed as the venue’s commentary, never as fact; or Kalshi’s contract terms — strike ladder, settlement sources, expected settlement and close — versioned so a change is a new item), venue_event (something the venue did or scheduled: a Kalshi settlement with the winning strike, or a Kalshi milestone such as “BLS CPI data release for August 2026” with its start/end window), editorial (a publisher post that links the bound contract — headline and link only);
• relevance — direct (about the index’s own release or contract) or related (surrounding context such as monetary-policy statements attached to the macro indices);
• licence — public_domain (US-government publication), venue_public_api (read from the venue’s public API; display with venue attribution, subject to its terms) or headline_link_only (the publisher’s text is never served);
• source{id,name,domain}, url, t (the item’s own clock), observed_at (first seen by the backend), an optional summary (≤ 2,000 characters; always null for headline_link_only), and provenance{feed, retrieved_at}.
• authorship — the editorial classification, made explicit so no client has to infer it: primary_document (an agency release, an SEC filing, a settled Kalshi market, a venue’s contract terms or milestone — a document that exists independently of anyone’s model), venue_generated (text a venue’s own model wrote — Polymarket’s market context; always carries provenance.note), editorial (a publisher headline, link only).

​

Mecone Data Lake

curl https://api.mecone.trade/api/v1/lake
curl https://api.mecone.trade/api/v1/lake/venues/limitless/snapshots?date=2026-08-17
curl "https://api.mecone.trade/api/v1/lake/venues/limitless/quotes?date=2026-08-17&at=0002"

• An unquoted side is null, never 0. Limitless, Myriad and ForecastEx publish no order book at all — one indicative price per outcome. mid and spread are emitted only when both sides were quoted on a venue with a two-sided book; for a bookless venue they are absent, not zero.
• Populated price fields differ per venue. Each venue publishes quote_fields, the columns it actually fills. Do not assume bid and ask exist.
• tape_origin names any venue that mirrors another exchange’s book. A mirror is not a second opinion on a price, and averaging it against its source is averaging a book with itself.
• A snapshot may be a partial board. completeness.status is incomplete when the collector recorded a failure and not_recorded when the writing collector does not record completeness at all — absence of a failure is not a claim of completeness.

​

HTTP behavior

• Responses include X-Request-ID and X-API-Version.
• Read resources include an ETag; send If-None-Match to receive 304 Not Modified.
• Current resources use short, explicit cache lifetimes.
• Any resource that cannot be served safely fails closed with a 503 problem document (e.g. official-round-unavailable, index-unavailable) carrying Retry-After — never a stale or fabricated payload.
• Errors use application/problem+json with type, title, status, detail, instance, and request_id.
• Temporary failures may include Retry-After.
• Timestamps are RFC 3339 strings with explicit UTC offsets.

{
  "type": "https://docs.mecone.trade/problems#index-not-found",
  "title": "Index not found",
  "status": 404,
  "detail": "The requested public index does not exist.",
  "instance": "/api/v1/indices/not-a-feed",
  "request_id": "5e5a51b8c8c24dbf93e403bdc36ed84b"
}

​

Legacy compatibility

​

Standards and conventions

• OpenAPI Specification
• RFC 9457: Problem Details for HTTP APIs
• RFC 9111: HTTP Caching
• RFC 3339: Internet timestamps
• RFC 9745: Deprecation header
• NIST SP 800-228: API protection
• OWASP API Security Top 10