spot

Dated spot reference price for one coin (Binance stream or stored consensus)

Reference data only. Returns the Binance spot 24h-ticker last price (USDT) for the coin's single verified Binance/USDT mapping when a recent stream snapshot exists, plus the stored REST consensus price (USD) as an individually dated fallback. Both values keep their own units; preferredSource is not a USDT/USD conversion, an executable price or a paper-fill promise. Spot quotes, orders and market context never read this endpoint, so their prices are unchanged by it.

The stream observation is refused (with stream.reason) unless the snapshot is connected, at most 10 s old, its universe metadata at most 10 min old, and the coin's identity and source policy match. fallback.status is fresh when the stored row was written at most 120 s ago. Requires scope read. Any query parameter returns 400. Responses carry Cache-Control: no-store.

get/api/agent/spot/reference/{coinId}

Request

  • Base URL: https://api.coinrithm.com
  • URL: https://api.coinrithm.com/api/agent/spot/reference/{coinId}
  • Auth: HTTP bearer

Path parameters

coinIdstring required

Coin UCID (e.g. "1" = BTC). Use /api/agent/resolve to find it.

Response

OK

version1 required
policyVersionstring required
evaluatedAtstring date-time required

Server time at which ages and expiries were checked (after all I/O).

referenceOnlytrue required
preferredSource'binance_stream' | 'rest_consensus' | 'null' nullable required

binance_stream when stream.observation is present, else rest_consensus when a stored price exists, else null. A preference between two values in different units, not a conversion or an executable price.

Example response

{
  "policyVersion": "binance_spot_reference_v1",
  "stream": {
    "observation": {
      "pair": "BTCUSDT"
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.