Skip to main content

2026-11-05

Docs
  • Error codes [UPDATE]
    • Added business logic error codes 122–158
    • Documented the error response format: error_id, signature error IDs, and per-field validation details
  • TWAP [NEW]
  • Operation types [UPDATE]
    • Added the signing types for Print orders, order strategies, account settings, TWAP orders, two-factor authentication, and notifications

2026-10-20

REST API
  • Create Print order [UPDATE]
    • A Print order with a builder code now also pays the code’s builder fee on the perp position it delivers, on top of the 10% premium share
    • The user’s approval max_fee_rate must now cover the code’s fee_rate, as for an order

2026-10-17

REST API
  • Create Print order [NEW]
    • Documented POST /api/v1/game/deposit for placing Print orders
    • Added builder_code: the code’s owner earns 10% of each premium of the order
WebSocket
  • Account liquidations [NEW]
    • Streams each of an account’s positions that liquidation or ADL closed. Requires the account’s API config key

2026-10-16

REST API
  • Web Push notifications [NEW]
    • Register a browser’s Web Push subscription to get notifications in browsers and installed web apps

2026-10-08

REST API
  • Two-factor authentication [NEW]
    • Endpoints under /api/v1/account/2fa to turn on 2FA with an authenticator app or a passkey, manage factors, and regenerate recovery keys
  • Request withdrawal and Withdraw spot asset [UPDATE]
    • Accounts with two-factor authentication on must send a two_factor proof and an idempotency_key. This applies to agent wallets too
    • Retrying with the same idempotency_key and the same request now returns the first result. Status 409 means the key was used for a different request
  • Notifications [NEW]
    • Endpoints under /api/v1/account/notifications for mobile push devices, notification preferences, test notifications, and the in-app notification history

2026-10-04

REST API & WS
  • Get positions and Account positions [UPDATE]
    • Added realized PnL since the position opened: realized_pnl (REST) and r (WS). null for positions opened before this date

2026-10-03

REST API

2026-09-29

REST API
  • Input validation [UPDATE]
    • Requests with invalid fields return status 400 with an error_id and a details list of the bad fields. See Error codes

2026-09-17

REST API & WS
  • Last ID [UPDATE]
    • account_positions and REST /api/v1/positions / /api/v1/orders now include a per-row li alongside the set-level value
    • Documented Last ID as a per-symbol sequence number for ordering and gap detection

2026-09-13

REST API & WS
  • Order strategies [NEW]
    • Create, edit, cancel, and list server-side order strategies under /api/v1/order_strategies: OCO, conditional, trailing stop, chase, swarm, trigger swarm, and TWAP
    • Account order strategy updates websocket streams lifecycle changes
    • Orders and trades that a strategy places carry the strategy ID as parent_id
  • Get order history records [NEW]
    • Returns orders and finished order strategies in one cursor-paginated list
  • Get TWAP records and Get TWAP record history [NEW]
    • /api/v1/twaps and /api/v1/twaps/history list TWAP orders and TWAP order strategies together

2026-09-04

REST API & WS WebSocket
  • Orderbook [UPDATE]
    • agg_level values are now 1, 2, 5, 10, 100, 1000. Levels 2 and 5 are new. Breaking: 10000 is no longer accepted
  • Compression [NEW]
    • Connect with ?compress=deflate to receive subscription data as raw DEFLATE binary frames

2026-08-27

REST API & WS
  • Order expiry [NEW]
    • Added optional order_expiry (milliseconds) to create limit order for TIF GTC, ALO, and TOB. The expiry must be 5 minutes to 30 days from now
    • Edit order accepts order_expiry: omit it to keep the current expiry, or send null to remove it
    • Get open orders returns order_expiry
    • Batch Create and Edit actions accept the same field
  • Edit order [UPDATE]
    • Edits, including edits in a batch, are no longer subject to the taker speed bump
WebSocket
  • WebSocket limits [UPDATE]
    • New per-IP connection limits and per-connection limits on subscriptions, distinct accounts, and subscribe messages

2026-08-06

REST API & WS
  • Get account info and Account info websocket [NEW]
    • Added optional full parameter. It adds Print order equity and total account equity (print_order_equity, total_account_equity on REST; cae, poe, tae on WS)

2026-07-28

REST API & WS
  • Error IDs [NEW]
    • Error responses now include an error_id. Signature failures return JSON with an error_id such as signature_expired, instead of plain text. See Error codes

2026-07-25

GENERAL API
  • Open order limits [NEW]
    • Accounts on fee tier 1 can hold up to 300 open orders per market. Higher tiers and market makers can hold up to 1,000

2026-06-30

MCP
  • MCP Server [NEW]
    • Added documentation for the Pacifica MCP server (@pacifica-fi/mcp-server), which exposes the REST API as Model Context Protocol tools
    • Covers the Claude Desktop quickstart, configuration (environment variables, auth modes, security), client setup for Claude Code, OpenAI Codex, Factory, Hermes, and Crush, and the full tool reference
    • Documents the on-chain funding tools mintUsdp (testnet faucet) and depositUsdp (deposit USDC/USDP into your exchange balance), plus the SOLANA_RPC_URL, PACIFICA_PROGRAM_ID, and PACIFICA_USDC_MINT environment variables

2026-05-04

Docs
  • Vaults [NEW]
    • Added a new vaults section covering overview, depositing, managing a vault, profit and loss, and risk controls
REST API
  • Vaults [NEW]
    • Added REST API docs for vault creation, deposits, withdrawals, manager claims, referral codes, deposit cap updates, whitelist/blacklist updates, max leverage updates, and vault listing under /api/v1/lake/*
  • Operation Types [UPDATE]
    • Added signing operation types for all documented vault endpoints

2026-04-23

REST API & WS
  • Batch order [UPDATE]
    • Expanded action types: CreateMarket, Edit, SetPositionTpsl, CancelStopOrder now supported alongside Create and Cancel
  • Added builder_code parameter to all order creation endpoints [UPDATE]
    • Supports Builder Program fee attribution (3-16 alphanumeric characters)
  • Added trigger_price_type to all stop order and TP/SL configurations [UPDATE]
    • Options: mark_price (default), last_trade_price, mid_price
REST API WebSocket
  • Account transfers [NEW]
    • Real-time deposit, withdrawal, and transfer event stream
  • Account info [UPDATE]
    • Added sb (spot_balances) field with per-asset collateral details
  • Account order updates [UPDATE]
    • Added tp (trigger_price_type) field
    • Added order types: stop_limit, stop_market, take_profit_limit, stop_loss_limit, take_profit_market, stop_loss_market

2026-03-11

  • Account settings REST API to include margin_settings, spot_settings and auto_lend_disabled, in order to support spot assets and unified margin [UPDATE]

2026-02-19

  • VIP Tier rate-limits increased [UPDATE]

2026-02-05

  • Remove account_orders websocket endpoint. Note that open orders snapshot can be obtained from REST API /api/v1/orders and real time order updates can be obtained from websocket account_order_updates [UPDATE]
  • Enforce main+subaccount rate limit based on fee tier for requests with API Config Keys [NEW]

2026-01-24

  • Update agg_level to 1, 10, 100, 1000, 10000 for api/v1/book and websocket book [UPDATE]

2026-01-20

  • Add maker_fee and taker_fee to /api/v1/account endpoint [UPDATE]

2026-01-12

  • Add li (Last ID) to bbo websocket stream [UPDATE]

2026-01-01

  • Add li (Last ID) to orderbook websocket stream [UPDATE]

2025-12-16

WebSocket
  • Initialization added to account_orders endpoint [UPDATE]
    • account_orders endpoint now sends snapshot of account’s open orders upon subscription.

2025-12-06

REST API & WS
  • Last ID added [NEW]
    • Added field in multiple REST and WS endpoints as an exchange-wide identifier to order all exchange events

2025-11-19

REST API
  • Market info endpoint updated [UPDATE]
    • Added created_at field to /api/v1/info response showing when each market was listed
WEBSOCKET
  • Account positions snapshot [UPDATE]
    • account_positions websocket endpoint now returns immediate snapshot of current positions upon subscription
  • Batch orders [NEW]
    • Order batching now supported via websocket
  • Best bid offer (BBO) [NEW]
    • bbo endpoint now supported via websocket
    • constantly streams top of book for selected symbol
REST API & WS
  • Edit order type added [NEW]
    • Added endpoint in REST and WS to edit price and/or size of existing orders
  • Mark price candle added [NEW]
    • Added endpoint in REST and WS to show mark price candles
    • Returns candle data based on mark price instead of traded prices
  • Batch order speed bump optimization [UPDATE]
    • Speed bump now applied conditionally based on order types in batch
    • Only applied if batch contains market orders or limit orders with TIF GTC/IOC
    • Speed bump not applied if batch only contains ALO/TOB orders, cancellations, or TP/SL updates

2025-11-12

GENERAL API
  • Taker latency increased. [UPDATE]
    • All market orders, TIF GTC, and TIF IOC orders are subject to a ~200ms delay

2025-11-10

REST API & WS

2025-11-09

GENERAL API
  • Taker latency added. [NEW]
    • All market orders, TIF GTC, and TIF IOC orders are subject to a randomized 50-100ms delay

2025-10-30

REST API
  • Cursor based pagination added for all history endpoints [UPDATE]
    • Offset pagination deprecated

2025-10-25

REST API
  • List subaccounts [NEW]
    • Added a new endpoint to retrieve subaccount information
WEBSOCKET
  • Orderbook websocket [UPDATE]
    • ‘book’ websocket update interval improved from 500ms to 100ms