Pacifica

Pacifica spot and perpetual market data, with network-specific markets and live order books.

Pacifica uses pacificaf for perpetuals and pacifica for spot. Public market data needs no trading credential. Mainnet is the default. Market discovery, trading commands and Python jobs accept --testnet for the Pacifica testnet; the direct mlab source examples below use mainnet.

ProductExchangeCanonical symbolProvider symbol
PerpetualpacificafBTCBTC
SpotpacificaSOL/USDCSOL-USDC

Use the listed market rather than assuming that every perpetual has a spot pair. Mainnet and testnet have different listings and trading rules. Pacifica's wire symbols are case-sensitive; Market Lab preserves names such as kBONK at the provider boundary.

Standalone clients can optionally set PACIFICA_API_CONFIG_KEY for Pacifica’s PF-API-KEY header. This is an API access/rate-limit setting, not a trading key. Managed runtimes use their node’s upstream configuration. See Pacifica API configuration.

Discover markets

mlab markets --exchange pacificaf --refresh
mlab markets --exchange pacificaf --symbol BTC
mlab markets --exchange pacifica --symbol SOL/USDC
mlab markets --exchange pacificaf --testnet
mlab markets --exchange pacifica --testnet --symbol BTC/USDC

The refreshed Pacifica snapshot contains both product catalogs. Standalone --testnet discovery reads the testnet catalog live and leaves the saved mainnet snapshot untouched. Execution resolves current tick sizes, lot sizes, minimum order value and leverage from the selected network's live metadata.

Available data

  • Historical candles and volume bars.
  • Live full-snapshot order books and trades.
  • Live candles, tickers and 24-hour market statistics.
  • Hourly funding and open interest for perpetuals.
  • Trade-derived volume delta and the shared indexed aggregation feeds on Furge nodes configured for Pacifica.

Pacifica order books contain up to ten levels per side. A larger requested depth does not create additional levels. Native aggregation levels are 1, 2, 5, 10, 100, 1000 and 10000 multiples of the market tick size. Each book message replaces the previous snapshot.

A quiet market can repeat a WebSocket book with its last-change timestamp. When that happens, Market Lab can revalidate the book through Pacifica's REST feed using the same upstream budget. Requests share a per-market cache, have a five-second timeout and a ten-second retry cooldown. The returned exchange timestamp must still pass freshness checks; the client never substitutes its own time. Revalidation starts only after a received WebSocket frame. Display refreshes keep the current read alive, and stopping the consumer cancels it.

mlab source orderbook \
  --exchange pacificaf --symbol BTC --depth 10 --stream

mlab source orderbook \
  --exchange pacifica --symbol SOL/USDC --depth 10 --stream

mlab source candles \
  --exchange pacificaf --symbol BTC --timeframe 60 --stream

Pacifica's direct historical candle intervals are 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 8h, 12h, 1d, 1w and 1M. Historical reads page through the requested range. Furge supplies its indexed candle and trade-derived feeds through the assigned node; standalone clients subscribe to Pacifica’s native candle stream.

Pacifica's prices feed supplies mark/oracle prices, quote volume, and perpetual funding/open interest. It does not supply a last-trade price, 24-hour high/low or base volume; those unsupported fields in the legacy numeric ticker record remain zero. Use candles and trades for those observations.

Python selectors

history.source("btc@candles@pacificaf:timeframe=60")
history.source("btc@orderbook@pacificaf:depth=10")
history.source("btc@trades@pacificaf")
history.source("sol/usdc@trades@pacifica")

See Pacifica execution and Pacifica Python scripts.

On this page