← FINITEPUBLIC READ-ONLY INTERFACE / v1METHODOLOGY ↗
BUILD AGAINST THE EVIDENCE

Open data.
Finite claims.

A small, versioned public surface for serious users. Every response carries source attribution, an observation time and explicit continuity metadata.

BASE URLhttps://finitebtc.com
AUTHENTICATIONNONE · READ ONLY
SCHEMAv1.0 · METHOD 2.1
MODELconviction-v2
ENDPOINTSPublic Bitcoin intelligence surfaces
GET
/api/v1/market

Aggregate price, attributed venue books, derivatives, on-chain context, structure and validation in one versioned envelope.

1–2S EDGE CACHEOPEN ↗
GET
/api/v1/brief

The exact one-sentence ten-minute brief shown on Pulse: one dry state, one sentence and one nearest verified level.

CURRENT FRAMEOPEN ↗
GET
/api/v1/stone

One immutable daily public monetary record. Missing fields stay missing; past dates are never reconstructed.

ONCE PER UTC DAYOPEN ↗
GET
/api/v1/stones?from=&to=

Read an explicit UTC date range of captured daily stones. Empty dates remain unknown.

APPEND ONLYOPEN ↗
GET
/api/v1/embed/pulse

One-line dark embed: sats per dollar, block height and the canonical state.

CURRENT FRAMEOPEN ↗
GET
/api/v1/status

Semantic venue freshness, retained-state disclosure, depth coverage, derivative availability and daily on-chain age.

LIVE SNAPSHOTOPEN ↗
WS/SSE
/api/v1/stream

Anonymous read-only stream with sequence numbers, heartbeats, selected channels and an SSE fallback when WebSocket upgrade is unavailable.

2S FRAMESOPEN ↗
GET
/api/v1/status/history?days=30

Observed venue and feed uptime history. Never backfilled or inferred; empty intervals remain unknown.

5M OBSERVATIONSOPEN ↗
GET
/api/v1/performance

7/30/90-day structure-proxy validation with sample sizes, false-signal rates, subsequent moves and Wilson intervals.

SOURCE CANDLEOPEN ↗
GET
/api/v1/export?dataset=venues

UTF-8 CSV for venues, depth, derivatives, onchain, structure, candles or validation.

ON REQUESTOPEN ↗
RESPONSE CONTRACT

Freshness stays visible.

{
  "apiVersion": "1.0",
  "modelVersion": "conviction-v2",
  "asOf": "ISO-8601",
  "data": {
    "aggregate": { "fieldTimestamps": {} },
    "venues": [{ "fieldAvailability": {}, "fieldTimestamps": {}, "retainedFields": [] }],
    "derivatives": [{ "fieldAvailability": {}, "fieldTimestamps": {}, "retainedFields": [] }]
  },
  "meta": {
    "continuity": {},
    "freshness": {},
    "sources": {},
    "timestampKinds": ["source-event", "received", "retrieved"]
  }
}
OPERATING LIMITS