Coinbase

Once a data agreement with Coinbase is in place, we capture Coinbase independently from two regions and merge the two streams by venue sequence number, as we do for every venue. Production capture starts at least 90 days before early access, so depth history covers three months or more on day one.

Venue type

Centralized exchange (spot)

Funding interval

Not applicable (spot only)

Integrity

Venue sequence numbers, and book checksums where the feed includes them, verified at capture

Snapshots

A full-depth book snapshot at the top of every UTC hour (the 00:00 snapshot opens each daily file), plus the venue's own snapshots on reconnect, flagged with is_snapshot and snapshot_reason

Timestamps

Microseconds in ts_exchange. ts_capture is int64 nanoseconds from a PTP-disciplined clock.

Regions

Two independent regions, assigned once the data agreement is in place

Participant id

Offered if the data agreement includes participant-level data

Coinbase uses a BASE-QUOTE format, so symbol and venue_symbol match for every spot pair. The full rules are in symbology.

• Fiat pairs (USD, EUR, GBP) are kept separate from stablecoin pairs; BTC-USD and BTC-USDC are different instruments.
• Self-trade prevention cancels appear in L3 as cancel events, with the original message kept in the raw tier.
• Capture for US venues is planned from our N. Virginia region, which comes online in Phase 2.

Extended fields are computed on ts_capture and published on a 100 ms grid. A field is available on a venue when its source data is.

The same calls work on every venue; only venue and symbol change. Endpoints go live with Phase 1, and the v1 spec is a draft until then.

from fdc import Client

fdc = Client(api_key="fdc_live_...")

# L4 order events with participant ids
book = fdc.book(
    venue="coinbase",
    symbol="BTC-USD",
    depth="L4",
    start="2028-05-02",
    end="2028-05-02T01:00:00",
)
df = book.to_polars()

curl -H "Authorization: Bearer fdc_live_..." \
  "https://api.financedatacloud.com/v1/book/l4?venue=coinbase&symbol=BTC-USD&start=2028-05-02T00:00:00Z&end=2028-05-02T00:05:00Z"

{"op":"subscribe","channel":"book_l4","venue":"coinbase","symbol":"BTC-USD"}

aws s3 cp \
  s3://fdc-archive/book_l4/venue=coinbase/date=2028-05-02/BTC-USD.parquet .