Get snapshot metadata — Adjacent News API

/api/v1/public/metaGET

Returns the pinned snapshot timestamp, last refresh time, and the daily-bucket timezone for the public snapshot tier.

Response

200 · Snapshot metadata

snapshot_at *string (date-time)

The pinned snapshot timestamp (≈ now - 15 minutes).

refreshed_at *string (date-time)

Wall-clock time at which the public snapshot was last rebuilt. It tells you how recently the rebuild ran, not how recent the data is: the data cutoff is snapshot_at, which each rebuild pins roughly 15 minutes earlier.

day_boundary_timezone *string

IANA tz that daily buckets align to (America/New_York).

market_statuses *string[]

Valid market status values.

market_platforms *string[]

Distinct platforms present in the catalog.

market_categories *string[]

Distinct event categories present in the catalog.

freshness *object[]

Per-tier list freshness. Markets and events lists are rebuilt every 10 minutes (with price and constituent membership refreshed every minute); indices, rates, and news are pinned snapshot_at behind live. Single-market detail is live, and time-series and price reads are as-of snapshot_at for every tier.

Show item properties

tier?string

markets, events, indices, rates, or news.

mode?string

snapshot (periodically rebuilt) or delayed (pinned behind live).

delay_seconds?integer

Maximum normal delay from live data, in seconds.

Request example

curl -X GET "https://api.dev.adjacent.markets/api/v1/public/meta"

Response example

{
  "snapshot_at": "2026-07-29T14:02:34.885595Z",
  "refreshed_at": "2026-07-29T14:17:34.885595Z",
  "day_boundary_timezone": "America/New_York",
  "market_statuses": [
    "unknown",
    "active",
    "closed",
    "resolved",
    "expired"
  ],
  "market_platforms": [
    "kalshi",
    "polymarket"
  ],
  "market_categories": [
    "Politics",
    "Elections",
    "World",
    "Economics",
    "Crypto"
  ],
  "freshness": [
    {
      "tier": "markets",
      "mode": "snapshot",
      "delay_seconds": 600
    },
    {
      "tier": "indices",
      "mode": "delayed",
      "delay_seconds": 900
    }
  ]
}