Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/pacifica-fi/docs-migrate/llms.txt

Use this file to discover all available pages before exploring further.

The Markets endpoints expose all public, read-only data about Pacifica’s perpetual futures markets. No authentication is required for any of these endpoints — they are safe to call from any client without signing.

​
GET /api/v1/info — Get Market Info

Returns exchange information and market specifications for every available perpetual trading pair. Request This endpoint takes no query parameters. 
curl https://api.pacifica.fi/api/v1/info
Response 
{
  "success": true,
  "data": [
    {
      "symbol": "ETH",
      "tick_size": "0.1",
      "min_tick": "0",
      "max_tick": "1000000",
      "lot_size": "0.0001",
      "max_leverage": 50,
      "isolated_only": false,
      "min_order_size": "10",
      "max_order_size": "5000000",
      "funding_rate": "0.0000125",
      "next_funding_rate": "0.0000125",
      "created_at": 1748881333944
    },
    {
      "symbol": "BTC",
      "tick_size": "1",
      "min_tick": "0",
      "max_tick": "1000000",
      "lot_size": "0.00001",
      "max_leverage": 50,
      "isolated_only": false,
      "min_order_size": "10",
      "max_order_size": "5000000",
      "funding_rate": "0.0000125",
      "next_funding_rate": "0.0000125",
      "created_at": 1748881333944
    }
  ],
  "error": null,
  "code": null
}
​
symbol
string
Trading pair symbol.
​
tick_size
decimal string
Tick size. All prices must be a multiple of this value.
​
min_tick
decimal string
Minimum tick. API-submitted prices cannot be below this value.
​
max_tick
decimal string
Maximum tick. API-submitted prices cannot be above this value.
​
lot_size
decimal string
Lot size. All order sizes (token-denominated) must be a multiple of this value.
​
max_leverage
integer
Maximum leverage allowed on this symbol when opening positions.
​
isolated_only
boolean
Whether the market only allows isolated margin positions.
​
min_order_size
decimal string
Minimum order size in USD.
​
max_order_size
decimal string
Maximum order size in USD.
​
funding_rate
decimal string
Funding rate paid in the most recent funding epoch (hourly).
​
next_funding_rate
decimal string
Estimated funding rate to be paid in the next funding epoch.
​
created_at
integer
Timestamp (ms) when the market was listed on Pacifica. Markets are returned oldest first.

​
GET /api/v1/info/prices — Get Prices

Returns live price data for all symbols, including mark price, oracle price, funding rates, open interest, and 24-hour volume. Request This endpoint takes no query parameters. 
curl https://api.pacifica.fi/api/v1/info/prices
Response 
{
  "success": true,
  "data": [
    {
      "funding": "0.00010529",
      "mark": "1.084819",
      "mid": "1.08615",
      "next_funding": "0.00011096",
      "open_interest": "3634796",
      "oracle": "1.084524",
      "symbol": "XPL",
      "timestamp": 1759222967974,
      "volume_24h": "20896698.0672",
      "yesterday_price": "1.3412"
    }
  ],
  "error": null,
  "code": null
}
​
funding
decimal string
Funding rate paid in the most recent funding epoch (hourly).
​
mark
decimal string
Mark price, used for unrealized PnL and liquidation calculations.
​
mid
decimal string
Mid price: average of the best bid and best ask.
​
next_funding
decimal string
Estimated funding rate to be paid in the next epoch.
​
open_interest
decimal string
Current open interest for this symbol in USD.
​
oracle
decimal string
Oracle price, sourced externally and used for funding rate calculations.
​
symbol
string
Trading pair symbol.
​
timestamp
integer
Response timestamp in milliseconds.
​
volume_24h
decimal string
USD trading volume over the past 24 hours.
​
yesterday_price
decimal string
Oracle price 24 hours ago in USD.

​
GET /api/v1/kline — Get Candle Data

Returns historical OHLCV candles for a specific market and time interval. Request
​
symbol
string
required
Trading pair symbol, e.g. BTC.
​
interval
string
required
Candlestick interval. Valid values: 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 8h, 12h, 1d.
​
start_time
integer
required
Start time in milliseconds, e.g. 1716200000000.
​
end_time
integer
End time in milliseconds. Defaults to the current time if omitted.
curl "https://api.pacifica.fi/api/v1/kline?symbol=BTC&interval=1m&start_time=1742243160000&end_time=1742243220000"
Response 
{
  "success": true,
  "data": [
    {
      "t": 1748954160000,
      "T": 1748954220000,
      "s": "BTC",
      "i": "1m",
      "o": "105376",
      "c": "105376",
      "h": "105376",
      "l": "105376",
      "v": "0.00022",
      "n": 2
    }
  ],
  "error": null,
  "code": null
}
​
t
integer
Candle open (start) timestamp in milliseconds.
​
T
integer
Candle close (end) timestamp in milliseconds.
​
s
string
Symbol.
​
i
string
Candlestick interval.
​
o
decimal string
Open price.
​
c
decimal string
Close price.
​
h
decimal string
High price.
​
l
decimal string
Low price.
​
v
decimal string
Volume.
​
n
integer
Number of trades during the candle period.

​
GET /api/v1/kline/mark — Get Mark Price Candle Data

Returns historical mark price candles for a specific market and time interval. Request
​
symbol
string
required
Trading pair symbol, e.g. BTC.
​
interval
string
required
Candlestick interval. Valid values: 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 8h, 12h, 1d.
​
start_time
integer
required
Start time in milliseconds.
​
end_time
integer
End time in milliseconds. Defaults to the current time if omitted.
curl "https://api.pacifica.fi/api/v1/kline/mark?symbol=BTC&interval=1m&start_time=1742243160000&end_time=1742243220000"
Response 
{
  "success": true,
  "data": [
    {
      "t": 1764126720000,
      "T": 1764126780000,
      "s": "BTC",
      "i": "1m",
      "o": "87701",
      "c": "87687.303362",
      "h": "87739",
      "l": "87687.303362",
      "v": "0.84106",
      "n": 62
    },
    {
      "t": 1764126780000,
      "T": 1764126840000,
      "s": "BTC",
      "i": "1m",
      "o": "87684.118667",
      "c": "87654",
      "h": "87684.118667",
      "l": "87645",
      "v": "4.5997",
      "n": 91
    }
  ],
  "error": null,
  "code": null
}
​
t
integer
Candle open timestamp in milliseconds.
​
T
integer
Candle close timestamp in milliseconds.
​
s
string
Symbol.
​
i
string
Candlestick interval.
​
o
decimal string
Open mark price.
​
c
decimal string
Close mark price.
​
h
decimal string
High mark price.
​
l
decimal string
Low mark price.
​
v
decimal string
Volume (always "0" for mark price candles).
​
n
integer
Number of trades during the candle period.

​
GET /api/v1/book — Get Orderbook

Returns the current orderbook (bids and asks up to 10 levels each) for a specified trading symbol. Request
​
symbol
string
required
Trading pair symbol, e.g. BTC.
​
agg_level
integer
Aggregation level for price grouping. Defaults to 1.
curl "https://api.pacifica.fi/api/v1/book?symbol=BTC"
Response 
{
  "success": true,
  "data": {
    "s": "BTC",
    "l": [
      [
        { "p": "106504", "a": "0.26203", "n": 1 },
        { "p": "106498", "a": "0.29281", "n": 1 }
      ],
      [
        { "p": "106559", "a": "0.26802", "n": 1 },
        { "p": "106564", "a": "0.3002",  "n": 1 }
      ]
    ],
    "t": 1751370536325
  },
  "error": null,
  "code": null
}
​
s
string
Symbol.
​
l
array
Two-dimensional array. Index 0 contains bid levels; index 1 contains ask levels. Each side contains up to 10 price levels.
​
t
integer
Response timestamp in milliseconds.

​
GET /api/v1/trades — Get Recent Trades

Returns the most recent trades executed on a specific market. Request
​
symbol
string
required
Trading pair symbol, e.g. BTC.
curl "https://api.pacifica.fi/api/v1/trades?symbol=BTC"
Response 
{
  "success": true,
  "data": [
    {
      "event_type": "fulfill_taker",
      "price": "104721",
      "amount": "0.0001",
      "side": "close_long",
      "cause": "normal",
      "created_at": 1765006315306
    }
  ],
  "error": null,
  "code": null,
  "last_order_id": 1557404170
}
​
event_type
string
"fulfill_taker" if the aggressor was the taker; "fulfill_maker" if the aggressor was the maker.
​
price
decimal string
Price in USD at which the trade occurred.
​
amount
decimal string
Trade amount in the asset’s base unit.
​
side
string
One of "open_long", "open_short", "close_long", "close_short".
​
cause
string
Reason for the trade: "normal" (user-initiated), "market_liquidation", "backstop_liquidation", or "settlement" (ADL or other settlement).
​
created_at
integer
Timestamp in milliseconds when the trade occurred.
​
last_order_id
integer
Exchange-wide nonce for reliable event ordering; sequential and not subject to clock drift.

​
GET /api/v1/funding_rate/history — Get Historical Funding

Returns paginated historical funding rate records for a particular symbol. Request
​
symbol
string
required
Market symbol, e.g. BTC.
​
limit
integer
Number of records to return. Default 100, maximum 4000.
​
cursor
string
Cursor for pagination. Omit to start from the most recent record.
curl "https://api.pacifica.fi/api/v1/funding_rate/history?symbol=BTC&limit=20"
Response 
{
  "success": true,
  "data": [
    {
      "oracle_price": "117170.410304",
      "bid_impact_price": "117126",
      "ask_impact_price": "117142",
      "funding_rate": "0.0000125",
      "next_funding_rate": "0.0000125",
      "created_at": 1753806934249
    }
  ],
  "next_cursor": "11114Lz77",
  "has_more": true
}
​
oracle_price
decimal string
Oracle price used in the funding rate calculation.
​
bid_impact_price
decimal string
Bid impact price at the time of calculation.
​
ask_impact_price
decimal string
Ask impact price at the time of calculation.
​
funding_rate
decimal string
Settled funding rate for this epoch.
​
next_funding_rate
decimal string
Predicted funding rate for the next settlement epoch.
​
created_at
integer
Timestamp in milliseconds.
​
next_cursor
string
Cursor value for the next page of results.
​
has_more
boolean
true when additional pages exist.

​
GET /api/v1/info/fees — Get Fee Levels

Returns all fee tier levels and their corresponding maker and taker fee rates. Request This endpoint takes no query parameters. 
curl https://api.pacifica.fi/api/v1/info/fees
Response 
{
  "success": true,
  "data": [
    {
      "level": 0,
      "maker_fee_rate": "0.00020",
      "taker_fee_rate": "0.00050"
    },
    {
      "level": 1,
      "maker_fee_rate": "0.00015",
      "taker_fee_rate": "0.00040"
    }
  ],
  "error": null,
  "code": null
}
​
level
integer
Fee tier level (0 is the base tier).
​
maker_fee_rate
decimal string
Maker fee rate for this tier.
​
taker_fee_rate
decimal string
Taker fee rate for this tier.

​
GET /api/v1/loan_pool — Get Loan Pool

Returns the current state of the USDC loan pool, including utilization, borrow rates, and lend rates. Request This endpoint takes no query parameters. 
curl https://api.pacifica.fi/api/v1/loan_pool
Response 
{
  "success": true,
  "data": {
    "total_borrowed": "500000.000000",
    "total_borrowable": "2000000.000000",
    "utilization": "0.25",
    "borrow_rate_apr": "0.08",
    "borrow_rate_apy": "0.0833",
    "lend_rate_apr": "0.06",
    "lend_rate_apy": "0.0618",
    "utilization_max": "0.85",
    "auto_lender_entry_threshold": "1000.000000",
    "last_interest_accrual_at": 1716200000000,
    "last_interest_payout_at": 1716200000000,
    "updated_at": 1716200000000
  },
  "error": null,
  "code": null
}
​
total_borrowed
decimal string
Total amount currently borrowed from the pool in USD.
​
total_borrowable
decimal string
Total amount available to borrow in USD.
​
utilization
decimal string
Pool utilization ratio (borrowed ÷ total).
​
borrow_rate_apr
decimal string
Current annualized borrow rate.
​
borrow_rate_apy
decimal string
Current compounded annual borrow rate.
​
lend_rate_apr
decimal string
Current annualized lending rate.
​
lend_rate_apy
decimal string
Current compounded annual lending rate.
​
utilization_max
decimal string
Maximum utilization cap for the pool.
​
auto_lender_entry_threshold
decimal string
Minimum balance threshold to participate in auto-lending.
​
last_interest_accrual_at
integer or null
Timestamp (ms) of the last interest accrual. null if interest has never been accrued.
​
last_interest_payout_at
integer or null
Timestamp (ms) of the last interest payout. null if no payout has occurred.
​
updated_at
integer
Timestamp (ms) of the last data update.

Build docs developers (and LLMs) love

Get started for freeTalk to us