bitfinex premium

Metered Bitfinex Premium read: the latest daily residual + regime state; ?updates=true appends the rolling hourly reading.

The Bitfinex cross-exchange residual on BTC daily closes: residual_bps = ((bitfinex − binance) / coinbase) × 10000. Returns the last CLOSED daily value (closed-bar, no repaint) and the regime state (stress = residual ≥ 15 bps confirmed over 5 consecutive closed days). Pass updates=true to also get the latest CLOSED rolling (hourly) bucket appended — same flat price. Call at least 15s after the 00:00 UTC boundary so all three venues have posted their closed candle; earlier, a required venue may not be settled yet. When updates=true and no update can be produced — a required venue is unavailable OR the rolling bucket has not settled yet — the whole call returns 503 and is not billed (never a partial/null reading).

get/api/bfx-premium

Request

  • Base URL: https://snowsignals.io/v1
  • URL: https://snowsignals.io/v1/api/bfx-premium
  • Auth: one of:
    • API key in query parameter apiKey
    • API key in header Authorization

Query parameters

updatesboolean

Append the latest rolling hourly reading (hourly) to the response. Does not change the price.

Response

The daily residual + regime state (+ the rolling hourly reading when updates=true) + metering meta.

Example response

{
  "daily": {
    "day": "2026-05-21",
    "residual_bps": 12.6,
    "state": "calm",
    "closes": {
      "coinbase": 111820,
      "binance": 111835.5,
      "bitfinex": 111955.2
    }
  },
  "hourly": {
    "bucket": "2026-05-21T14:00:00.000Z",
    "reading_bps": 41.3
  },
  "meta": {
    "debitMicroUsd": 30000,
    "cached": true
  }
}

Changes

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