---
title: "Get one directly citable live market observation"
method: GET
path: "/api/market-observation/v1/{symbol}.json"
tags: ["Market data"]
---

# Get one directly citable live market observation

`GET /api/market-observation/v1/{symbol}.json`

## Request

- Base URL: `https://btcwar.net`
- URL: `https://btcwar.net/api/market-observation/v1/{symbol}.json`
- Auth: none required

Public, read-only endpoint; no API key or authentication is required. Selects one supported symbol from BTC War's complete, validated nine-market Binance Spot snapshot and returns its exact decimal-string values with shared source, provenance, freshness and generation timestamps. The endpoint fails closed when the complete source snapshot is unavailable.

## Path parameters

- `symbol` 'BTCUSDT' | 'ETHUSDT' | 'BNBUSDT' | 'SOLUSDT' | 'XRPUSDT' | 'TRXUSDT' | 'DOGEUSDT' | 'ZECUSDT' | 'ADAUSDT', required

## Headers

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

## Response `200`

One fresh, sourced Binance Spot market observation.

- V1SchemaJson (unresolved $ref)

## Other responses

- `304`: The current observation matches If-None-Match or has not changed since If-Modified-Since.
- `404`: The requested market symbol is not supported.
- `405`: Only GET and HEAD are supported.
- `502`: A complete and trustworthy source snapshot is temporarily unavailable.

---

[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.dev/btcwar/apis/btc-war-live-market-data-api/revisions/c893fd0a8e73?raw)