# Pacifica Perpetuals DEX API
> Live market data for Pacifica, the Solana-based perpetuals DEX, with no key. List every perpetual market with its contract specs; pull an all-market price feed with mark/mid/oracle price, funding rate, open interest and 24h volume per symbol; read the live order book; and stream recent public trades. Symbols are plain coin tickers (BTC, SOL, WIF) — ideal for Solana-perp dashboards, funding-rate monitors and trading analytics across 69+ perpetual markets.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/pacifica-api/..."
```

## Pricing
- **Free** (Free) — 1,700 calls/Mo, 3 req/s
- **Basic** ($15/Mo) — 48,000 calls/Mo, 8 req/s
- **Pro** ($42/Mo) — 192,000 calls/Mo, 20 req/s
- **Business** ($90/Mo) — 798,000 calls/Mo, 48 req/s

## Endpoints

### Markets

#### `GET /v1/book` — Live order book for a symbol

**Parameters:**
- `symbol` (query, required, string) — Coin ticker Example: `SOL`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/pacifica-api/v1/book?symbol=SOL"
```

**Response:**
```json
{
    "data": {
        "asks": [
            {
                "size": 713.06,
                "price": 72.03,
                "orders": 5
            },
            {
                "size": 458.45,
                "price": 72.04,
                "orders": 7
            },
            {
                "size": 321.84,
                "price": 72.05,
                "orders": 3
            },
            {
                "size": 1057.04,
                "price": 72.06,
                "orders": 6
            },
            {
                "size": 317.33,
                "price": 72.07,
                "orders": 2
            },
            {
                "size": 1887.21,
                "price": 72.08,
                "orders": 7
            },
            {
                "size": 376.12,
                "price": 72.09,
                "orders": 3
            },
            {
                "size": 668.79,
                "price": 72.1,
                "orders": 5
            },
            {
                "size": 548.14,
                "price": 72.12,
                "orders": 2
            },
            {
                "size": 370.12,
                "price": 72.13,
                "orders": 5
            }
        ],
        "bids": [
            {
                "size": 427.87,
                "price": 72.02,
                "orders": 9
            },
            {
                "size": 167,
                "price": 72.01,
                "orders": 5
   
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/markets` — List every perpetual market with specs

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/pacifica-api/v1/markets"
```

**Response:**
```json
{
    "data": {
        "count": 69,
        "venue": "pacifica",
        "markets": [
            {
                "symbol": "SOL",
                "lot_size": 0.01,
                "tick_size": 0.01,
                "max_leverage": 20,
                "isolated_only": false,
                "max_order_size": 1000000,
                "min_order_size": 10
            },
            {
                "symbol": "BTC",
                "lot_size": 1.0e-5,
                "tick_size": 1,
                "max_leverage": 50,
                "isolated_only": false,
                "max_order_size": 5000000,
                "min_order_size": 10
            },
            {
                "symbol": "ETH",
                "lot_size": 0.0001,
                "tick_size": 0.1,
                "max_leverage": 50,
                "isolated_only": false,
                "max_order_size": 5000000,
                "min_order_size": 10
            },
            {
                "symbol": "PUMP",
                "lot_size": 1,
                "tick_size": 1.0e-6,
                "max_leverage": 10,
                "isolated_only": false,
                "max_order_size": 1000000,
                "min_order_size": 10
            },
            {
                "symbol": "XRP",
                "lot_size": 0.01,
                "tick_size": 0.0001,
                "max_leverage": 20,
                "isolated_only": false,
                "max_order_size": 1000000,
                "min_order_s
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/prices` — All-market price feed (mark/mid/oracle, funding, OI, volume)

**Parameters:**
- `symbol` (query, optional, string) — Coin ticker Example: `BTC`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/pacifica-api/v1/prices?symbol=BTC"
```

**Response:**
```json
{
    "data": {
        "mid": 65924.5,
        "mark": 65939.654261,
        "oracle": 65972.030435,
        "symbol": "BTC",
        "funding": -3.248e-5,
        "timestamp": 1781522154758,
        "volume_24h": 376984838.81584,
        "next_funding": -2.233e-5,
        "open_interest": 452.98447
    },
    "meta": {
        "timestamp": "2026-06-15T11:15:55.845Z",
        "request_id": "9dc45cbf-888a-4a63-9d84-af2ad0b1422b"
    },
    "status": "ok",
    "message": "Prices retrieved successfully",
    "success": true
}
```

#### `GET /v1/trades` — Recent public trades for a symbol

**Parameters:**
- `symbol` (query, required, string) — Coin ticker Example: `BTC`
- `limit` (query, optional, string) — Number of trades (1-100) Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/pacifica-api/v1/trades?symbol=BTC&limit=25"
```

**Response:**
```json
{
    "data": {
        "count": 25,
        "symbol": "BTC",
        "trades": [
            {
                "side": "close_long",
                "price": 65924,
                "amount": 0.25532,
                "created_at": 1781522148592,
                "event_type": "fulfill_taker"
            },
            {
                "side": "close_short",
                "price": 65924,
                "amount": 0.25532,
                "created_at": 1781522148592,
                "event_type": "fulfill_maker"
            },
            {
                "side": "close_long",
                "price": 65924,
                "amount": 0.30049,
                "created_at": 1781522148592,
                "event_type": "fulfill_taker"
            },
            {
                "side": "close_short",
                "price": 65924,
                "amount": 0.30049,
                "created_at": 1781522148592,
                "event_type": "fulfill_maker"
            },
            {
                "side": "close_long",
                "price": 65924,
                "amount": 0.33794,
                "created_at": 1781522148592,
                "event_type": "fulfill_taker"
            },
            {
                "side": "close_short",
                "price": 65924,
                "amount": 0.33794,
                "created_at": 1781522148592,
                "event_type": "fulfill_maker"
            },
            {
                "side": "close_long",
             
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Venue metadata & endpoint guide

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/pacifica-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "chain": "Solana",
        "venue": "Pacifica",
        "source": "Pacifica public REST (api.pacifica.fi/api/v1), keyless",
        "examples": {
            "book": "/v1/book?symbol=SOL",
            "prices": "/v1/prices?symbol=BTC",
            "trades": "/v1/trades?symbol=BTC&limit=10",
            "markets": "/v1/markets"
        },
        "endpoints": {
            "/v1/book": "live order book for a symbol (symbol=BTC)",
            "/v1/prices": "all-market price feed: mark/mid/oracle price, funding, open interest, 24h volume (symbol optional)",
            "/v1/trades": "recent public trades (symbol, limit)",
            "/v1/markets": "list every perpetual market with contract specs"
        },
        "instrument": "perpetual futures",
        "cache_ttl_ms": 5000
    },
    "meta": {
        "timestamp": "2026-06-15T11:15:56.316Z",
        "request_id": "8514e658-f7e4-4828-a1a4-09088b0b1745"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/pacifica-api
OpenAPI spec: https://www.oanor.com/api/pacifica-api/openapi.json
