# Pacifica (/providers-market-data/pacifica)



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.

| Product   | Exchange    | Canonical symbol | Provider symbol |
| --------- | ----------- | ---------------- | --------------- |
| Perpetual | `pacificaf` | `BTC`            | `BTC`           |
| Spot      | `pacifica`  | `SOL/USDC`       | `SOL-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](/providers-execution/pacifica#optional-api-configuration-key).

## Discover markets [#discover-markets]

```bash
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 [#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.

```bash
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 [#python-selectors]

```python
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](/providers-execution/pacifica) and [Pacifica Python scripts](/scripting-v2/pacifica).
