---
title: "Get live market-data availability and freshness"
method: GET
path: "/api/status/v1.json"
tags: ["Market data"]
---

# Get live market-data availability and freshness

`GET /api/status/v1.json`

Public, read-only endpoint; no API key or authentication is required. Returns a machine-readable best-effort availability and freshness signal derived from the same validated nine-market Binance Spot snapshot used by the price endpoints. This is an operational signal, not a contractual uptime guarantee or SLA.

## Headers

- `If-None-Match` string
- `If-Modified-Since` string, http-date

## Response `200`

The live market-data service and all nine required markets are currently available and fresh.

- MarketDataStatus
  - `schemaVersion` '1.0', required — Version of this status response contract.
  - `id` 'https://btcwar.net/api/status/v1.json', uri, required — Stable identifier for this machine status resource.
  - `checkedAt` string, date-time, required — UTC time when BTC War generated the validated snapshot behind this status.
  - `service` object, required
    - `name` 'BTC War Live Market Data API', required
    - `status` 'operational' | 'degraded', required
    - `serviceClass` 'best-effort-public', required
  - `source` object, required
    - `name` 'Binance Spot', required
    - `status` 'reachable', required
  - `data` object, required
    - `status` 'fresh' | 'degraded', required
    - `totalMarkets` unknown, required
    - `freshMarkets` integer, required
    - `oldestSourceObservedAt` string, date-time, required
    - `newestSourceObservedAt` string, date-time, required
    - `maxSourceLagSeconds` integer, required
  - `endpoints` object, required
    - `snapshot` 'https://btcwar.net/api/market-snapshot/v1.json', uri, required
    - `openapi` 'https://btcwar.net/api/openapi.json', uri, required
    - `apiCatalog` 'https://btcwar.net/.well-known/api-catalog', uri, required
  - `limitations` string, required — States that the response is a best-effort signal rather than an SLA.

## Other responses

- `304` — The current status matches If-None-Match or has not changed since If-Modified-Since.
- `405` — Only GET and HEAD are supported.
- `503` — A complete and trustworthy live market snapshot is unavailable, so the service cannot report an operational state.

---

[API](https://skmtc.dev/btcwar/apis/btc-war-live-market-data-api.md) · [All operations](https://skmtc.dev/btcwar/apis/btc-war-live-market-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/btcwar/btc-war-live-market-data-api/revisions/c893fd0a8e73/schema)