# Pacifica

## Docs

- [Overview](https://docs.pacifica.fi/api-documentation/api.md)
- [API FAQ](https://docs.pacifica.fi/api-documentation/api/api-faq.md)
- [403 CloudFront](https://docs.pacifica.fi/api-documentation/api/api-faq/403-cloudfront.md): Common error caused by GET requests with an empty request body.
- [Delayed account\_positions](https://docs.pacifica.fi/api-documentation/api/api-faq/delayed-account_positions.md): Potential delay of snapshot endpoints and best practice for reconstructing local state
- [Error Codes](https://docs.pacifica.fi/api-documentation/api/error-codes.md): This section provides a comprehensive list and definition of all error codes generated by the Pacifica API
- [Last Order ID](https://docs.pacifica.fi/api-documentation/api/last-order-id.md): Pacifica uses last order ID as an exchange-wide identifier to order all exchange events
- [Market Symbols](https://docs.pacifica.fi/api-documentation/api/market-symbols.md): Symbols accepted by the Pacifica API are CASE SENSITIVE.
- [MCP Server](https://docs.pacifica.fi/api-documentation/api/mcp.md): The Pacifica MCP server exposes the REST API as Model Context Protocol tools for AI agents.
- [Client Setup](https://docs.pacifica.fi/api-documentation/api/mcp/clients.md): Configure the Pacifica MCP server in Claude Desktop, Claude Code, OpenAI Codex, Factory, Hermes, and Crush.
- [Configuration](https://docs.pacifica.fi/api-documentation/api/mcp/configuration.md): Environment variables, authentication modes, and security for the Pacifica MCP server.
- [Tools](https://docs.pacifica.fi/api-documentation/api/mcp/tools.md): The full list of tools the Pacifica MCP server exposes, grouped by category.
- [Rate Limits](https://docs.pacifica.fi/api-documentation/api/rate-limits.md): Pacifica uses a credit-based rate limiting system with a 60-second rolling window.
- [API Config Keys](https://docs.pacifica.fi/api-documentation/api/rate-limits/api-config-keys.md): The following guide covers the creation and usage of Pacifica API Config Keys.
- [REST API](https://docs.pacifica.fi/api-documentation/api/rest-api.md)
- [Account](https://docs.pacifica.fi/api-documentation/api/rest-api/account.md): This section covers details for interacting with user accounts on Pacifica.
- [Add Isolated Margin](https://docs.pacifica.fi/api-documentation/api/rest-api/account/add-isolated-margin.md): This endpoint allows users to add margin to an isolated position.
- [Get Account Balance History](https://docs.pacifica.fi/api-documentation/api/rest-api/account/get-account-balance-history.md): This endpoint allows users to get account balance history. Returns all balance effects that affect the queried account.
- [Get Account Equity History](https://docs.pacifica.fi/api-documentation/api/rest-api/account/get-account-equity-history.md): This endpoint allows users to get account equity and PnL history (over time).
- [Get Account Info](https://docs.pacifica.fi/api-documentation/api/rest-api/account/get-account-info.md): This endpoint allows users to get all high-level account info such as balance, fee level, equity, etc.
- [Get Account Loan Info](https://docs.pacifica.fi/api-documentation/api/rest-api/account/get-account-loan-info.md): This endpoint returns loan and collateral information for a given account under unified margin.
- [Get Account Settings](https://docs.pacifica.fi/api-documentation/api/rest-api/account/get-account-settings.md): This endpoint allows users to get account margin and leverage settings (if they are not at default values)
- [Get Funding History](https://docs.pacifica.fi/api-documentation/api/rest-api/account/get-funding-history.md): This endpoint allows users to get funding history.
- [Get Pending Spot Withdrawals](https://docs.pacifica.fi/api-documentation/api/rest-api/account/get-pending-spot-withdrawals.md): This endpoint returns pending spot asset withdrawals.
- [Get Positions](https://docs.pacifica.fi/api-documentation/api/rest-api/account/get-positions.md): This endpoint allows users to get current positions.
- [Get Spot Balance History](https://docs.pacifica.fi/api-documentation/api/rest-api/account/get-spot-balance-history.md): This endpoint allows users to get spot asset balance history.
- [Get Spot Deposit History](https://docs.pacifica.fi/api-documentation/api/rest-api/account/get-spot-deposit-history.md): This endpoint returns spot asset deposit history.
- [Get Spot Withdrawal History](https://docs.pacifica.fi/api-documentation/api/rest-api/account/get-spot-withdrawal-history.md): This endpoint returns spot asset withdrawal history.
- [Get Trade History](https://docs.pacifica.fi/api-documentation/api/rest-api/account/get-trade-history.md): This endpoint allows users to get trade history
- [Request Withdrawal](https://docs.pacifica.fi/api-documentation/api/rest-api/account/request-withdrawal.md): This endpoint allows users to request withdrawal.
- [Toggle Auto-Lending](https://docs.pacifica.fi/api-documentation/api/rest-api/account/toggle-auto-lending.md): This endpoint allows users to enable or disable automatic lending.
- [Update Leverage](https://docs.pacifica.fi/api-documentation/api/rest-api/account/update-leverage.md): This endpoint allows users to change their account leverage for a specific trading pair. For open positions, users can only increase the leverage setting.
- [Update Margin Mode](https://docs.pacifica.fi/api-documentation/api/rest-api/account/update-margin-mode.md): This endpoint allows users to switch between isolated and cross margin modes for a specific trading pair. For open positions, users cannot change the margin mode.
- [Update Spot Settings](https://docs.pacifica.fi/api-documentation/api/rest-api/account/update-spot-settings.md): This endpoint allows users to update spot asset settings for unified margin.
- [Withdraw Spot Asset](https://docs.pacifica.fi/api-documentation/api/rest-api/account/withdraw-spot-asset.md): This endpoint allows users to withdraw a spot asset.
- [Markets](https://docs.pacifica.fi/api-documentation/api/rest-api/markets.md): This section covers details for interacting with all perpetual futures markets listed on Pacifica.
- [Get Candle Data](https://docs.pacifica.fi/api-documentation/api/rest-api/markets/get-candle-data.md): This endpoint allows users to get historical price candles for a specific market and time interval.
- [Get Fee Levels](https://docs.pacifica.fi/api-documentation/api/rest-api/markets/get-fee-levels.md): This endpoint returns all fee level tiers and their corresponding maker and taker fee rates.
- [Get Historical Funding](https://docs.pacifica.fi/api-documentation/api/rest-api/markets/get-historical-funding.md): This endpoint retrieves the historical funding for a particular symbol
- [Get Loan Pool](https://docs.pacifica.fi/api-documentation/api/rest-api/markets/get-loan-pool.md): This endpoint returns the current state of the loan pool including utilization, borrow and lend rates.
- [Get Mark Price Candle Data](https://docs.pacifica.fi/api-documentation/api/rest-api/markets/get-mark-price-candle-data.md): This endpoint allows users to get historical mark price candles for a specific market and time interval.
- [Get Market Info](https://docs.pacifica.fi/api-documentation/api/rest-api/markets/get-market-info.md): This endpoint allows users to get exchange information, including market specifications for all available trading pairs.
- [Get Orderbook](https://docs.pacifica.fi/api-documentation/api/rest-api/markets/get-orderbook.md): This endpoint allows users to retrieve the current orderbook (bid/ask levels) for a specified trading symbol.
- [Get Prices](https://docs.pacifica.fi/api-documentation/api/rest-api/markets/get-prices.md): This endpoint allows users to get price information for all symbols, including mark prices, funding rates, and market statistics.
- [Get Recent Trades](https://docs.pacifica.fi/api-documentation/api/rest-api/markets/get-recent-trades.md): This endpoint allows users to get recent trades for a specific market.
- [Orders](https://docs.pacifica.fi/api-documentation/api/rest-api/orders.md): This section covers details for interacting with current and historical orders on Pacifica.
- [Batch Order](https://docs.pacifica.fi/api-documentation/api/rest-api/orders/batch-order.md): This endpoint allows users to submit multiple order operations in a single request. Batched orders are executed in the order they are batched in, and will not be split up by other users' orders.
- [Cancel All Orders](https://docs.pacifica.fi/api-documentation/api/rest-api/orders/cancel-all-orders.md): This endpoint allows users to cancel all orders for all/given symbol(s).
- [Cancel Order](https://docs.pacifica.fi/api-documentation/api/rest-api/orders/cancel-order.md): This endpoint allows users to cancel an existing order.
- [Cancel Stop Order](https://docs.pacifica.fi/api-documentation/api/rest-api/orders/cancel-stop-order.md): This endpoint allows users to cancel a stop order by its (CL)OID.
- [Create Limit Order](https://docs.pacifica.fi/api-documentation/api/rest-api/orders/create-limit-order.md): This endpoint allows users to create a new limit order with optional take profit and stop loss levels.
- [Create Market Order](https://docs.pacifica.fi/api-documentation/api/rest-api/orders/create-market-order.md): This endpoint allows users to create a new market order with optional take profit and stop loss levels.
- [Create Position TP/SL](https://docs.pacifica.fi/api-documentation/api/rest-api/orders/create-position-tp-sl.md): This endpoint allows users to set take profit and stop loss levels for an existing position.
- [Create Stop Order](https://docs.pacifica.fi/api-documentation/api/rest-api/orders/create-stop-order.md): This endpoint allows users to create stop order.
- [Edit Order](https://docs.pacifica.fi/api-documentation/api/rest-api/orders/edit-order.md): This endpoint allows users to edit an existing limit order by modifying its size and/or price.
- [Get Open Orders](https://docs.pacifica.fi/api-documentation/api/rest-api/orders/get-open-orders.md): This endpoint allows users to get open orders on their account.
- [Get Order History](https://docs.pacifica.fi/api-documentation/api/rest-api/orders/get-order-history.md): This endpoint allows users to get a summarized order history.
- [Get Order History by ID](https://docs.pacifica.fi/api-documentation/api/rest-api/orders/get-order-history-by-id.md): This endpoint allows users to get order history by id.
- [Spot](https://docs.pacifica.fi/api-documentation/api/rest-api/spot.md)
- [Get Bridge Info](https://docs.pacifica.fi/api-documentation/api/rest-api/spot/get-bridge-info.md): This endpoint returns bridge parameters for all spot assets, including deposit minimums, withdrawal fees, and on-chain program addresses.
- [Get Bridge Parameters](https://docs.pacifica.fi/api-documentation/api/rest-api/spot/get-bridge-parameters.md): This endpoint returns bridge parameters for a single spot asset by symbol, including deposit minimums, withdrawal fees, and on-chain program addresses.
- [Get Spot Assets](https://docs.pacifica.fi/api-documentation/api/rest-api/spot/get-spot-assets.md): This endpoint returns a list of all spot assets available on the exchange, including their trading parameters and collateral eligibility.
- [Subaccounts](https://docs.pacifica.fi/api-documentation/api/rest-api/subaccounts.md)
- [Create Subaccount](https://docs.pacifica.fi/api-documentation/api/rest-api/subaccounts/create-subaccount.md): This endpoint allows regular accounts to create subaccounts with a secure authentication scheme. Both the main account and subaccount must sign to establish the relationship.
- [List Subaccounts](https://docs.pacifica.fi/api-documentation/api/rest-api/subaccounts/list-subaccounts.md): Lists all subaccounts associated with a main (parent) account. Returns address, balance, and other account details for each subaccount.
- [Subaccount Fund Transfer](https://docs.pacifica.fi/api-documentation/api/rest-api/subaccounts/subaccount-fund-transfer.md): This endpoint allows transfer of funds between main and subaccounts
- [Subaccount Spot Transfer](https://docs.pacifica.fi/api-documentation/api/rest-api/subaccounts/subaccount-spot-transfer.md): This endpoint allows users to transfer spot assets between a main account and its subaccounts
- [Vaults](https://docs.pacifica.fi/api-documentation/api/rest-api/vaults.md): REST API endpoints for creating, funding, configuring, and listing vaults.
- [Add Vault Blacklist](https://docs.pacifica.fi/api-documentation/api/rest-api/vaults/add-vault-blacklist.md): Add blocked symbols to a vault blacklist.
- [Add Vault Max Leverage](https://docs.pacifica.fi/api-documentation/api/rest-api/vaults/add-vault-max-leverage.md): Add per-symbol max leverage limits for a vault.
- [Add Vault Whitelist](https://docs.pacifica.fi/api-documentation/api/rest-api/vaults/add-vault-whitelist.md): Add tradable symbols to a vault whitelist.
- [Claim Vault Manager](https://docs.pacifica.fi/api-documentation/api/rest-api/vaults/claim-vault-manager.md): Claim the manager role on a fresh vault.
- [Claim Vault Referral Code](https://docs.pacifica.fi/api-documentation/api/rest-api/vaults/claim-vault-referral-code.md): Claim a referral code for an existing vault.
- [Create Vault](https://docs.pacifica.fi/api-documentation/api/rest-api/vaults/create-vault.md): Create a new vault (lake) and optionally set its initial configuration and seed deposit.
- [Deposit to Vault](https://docs.pacifica.fi/api-documentation/api/rest-api/vaults/deposit-to-vault.md): Deposit funds into a vault and receive vault shares.
- [List Vaults](https://docs.pacifica.fi/api-documentation/api/rest-api/vaults/list-vaults.md): List all vaults and optionally include the querying account's share balance.
- [Remove Vault Blacklist](https://docs.pacifica.fi/api-documentation/api/rest-api/vaults/remove-vault-blacklist.md): Remove blocked symbols from a vault blacklist.
- [Remove Vault Max Leverage](https://docs.pacifica.fi/api-documentation/api/rest-api/vaults/remove-vault-max-leverage.md): Remove per-symbol max leverage limits from a vault.
- [Remove Vault Whitelist](https://docs.pacifica.fi/api-documentation/api/rest-api/vaults/remove-vault-whitelist.md): Remove tradable symbols from a vault whitelist.
- [Update Vault Deposit Cap](https://docs.pacifica.fi/api-documentation/api/rest-api/vaults/update-vault-deposit-cap.md): Update or clear the deposit cap for a vault.
- [Withdraw From Vault](https://docs.pacifica.fi/api-documentation/api/rest-api/vaults/withdraw-from-vault.md): Redeem vault shares and withdraw funds from a vault.
- [Signing](https://docs.pacifica.fi/api-documentation/api/signing.md): Pacifica uses deterministic JSON formatting to generate Ed25519 signatures for API authentication.
- [API Agent Keys](https://docs.pacifica.fi/api-documentation/api/signing/api-agent-keys.md)
- [Error Handling](https://docs.pacifica.fi/api-documentation/api/signing/error-handling.md): An invalid signed message can result in a variety of Status 400 errors. The following illustrate error messages and common causes.
- [Hardware Wallet](https://docs.pacifica.fi/api-documentation/api/signing/hardware-wallet.md)
- [Implementation](https://docs.pacifica.fi/api-documentation/api/signing/implementation.md): The following guide provides a step-by-step breakdown of Pacifica's signing implementation
- [Operation Types](https://docs.pacifica.fi/api-documentation/api/signing/operation-types.md): The following table provides the "type"s required by the signature header and their corresponding API endpoints
- [Tick and Lot Size](https://docs.pacifica.fi/api-documentation/api/tick-and-lot-size.md): The following doc describes how tick and lot size, as well as rounding, are handled at an API level when Pacifica's endpoints receive requests with price and amount fields.
- [Websocket](https://docs.pacifica.fi/api-documentation/api/websocket.md)
- [Subscriptions](https://docs.pacifica.fi/api-documentation/api/websocket/subscriptions.md)
- [Account Info](https://docs.pacifica.fi/api-documentation/api/websocket/subscriptions/account-info.md): Streams all changes made to an account's overall info such as equity, balance, order count, etc.
- [Account Leverage](https://docs.pacifica.fi/api-documentation/api/websocket/subscriptions/account-leverage.md): Streams all changes made to an account's max leverage in any market.
- [Account Margin](https://docs.pacifica.fi/api-documentation/api/websocket/subscriptions/account-margin.md): Streams all changes made to an account's margin mode in any market.
- [Account Order Updates](https://docs.pacifica.fi/api-documentation/api/websocket/subscriptions/account-order-updates.md): Streams the amount and nature of changes made to any of an account's open orders in any market.
- [Account Positions](https://docs.pacifica.fi/api-documentation/api/websocket/subscriptions/account-positions.md): Streams all changes made to an account's positions in any market. A position that has been fully closed will be streamed and return empty.
- [Account Trades](https://docs.pacifica.fi/api-documentation/api/websocket/subscriptions/account-trades.md): Streams all trades that take place for an account
- [Account Transfers](https://docs.pacifica.fi/api-documentation/api/websocket/subscriptions/account-transfers.md): Streams deposit, withdrawal, and transfer events for an account.
- [Best Bid Offer (BBO)](https://docs.pacifica.fi/api-documentation/api/websocket/subscriptions/best-bid-offer-bbo.md): Real-time updates of the best bid and ask prices and amounts for a specific symbol. Updates are sent whenever the top of book changes.
- [Candle](https://docs.pacifica.fi/api-documentation/api/websocket/subscriptions/candle.md): Streams candle information for given symbol and candle time interval
- [Mark Price Candle](https://docs.pacifica.fi/api-documentation/api/websocket/subscriptions/mark-price-candle.md): Streams real-time mark price candlestick data for a specific market.
- [Orderbook](https://docs.pacifica.fi/api-documentation/api/websocket/subscriptions/orderbook.md): Streams book data for given symbol at a set aggregation level as they update
- [Prices](https://docs.pacifica.fi/api-documentation/api/websocket/subscriptions/prices.md): Streams all symbols' price information on Pacifica as they update
- [Trades](https://docs.pacifica.fi/api-documentation/api/websocket/subscriptions/trades.md): Streams all trades on the taker side as they occur in a chosen market.
- [Trading Operations](https://docs.pacifica.fi/api-documentation/api/websocket/trading-operations.md)
- [Batch Order](https://docs.pacifica.fi/api-documentation/api/websocket/trading-operations/batch-order.md): This endpoint allows users to submit multiple order operations in a single websocket request.
- [Cancel All Orders](https://docs.pacifica.fi/api-documentation/api/websocket/trading-operations/cancel-all-orders.md): This request type allows users to cancel all orders through Pacifica's websocket API.
- [Cancel Order](https://docs.pacifica.fi/api-documentation/api/websocket/trading-operations/cancel-order.md): This request type allows users to cancel orders through Pacifica's websocket API.
- [Create Limit Order](https://docs.pacifica.fi/api-documentation/api/websocket/trading-operations/create-limit-order.md): This request type allows users to place limit orders through Pacifica's websocket API.
- [Create Market Order](https://docs.pacifica.fi/api-documentation/api/websocket/trading-operations/create-market-order.md): This request type allows users to place market orders through Pacifica's websocket API.
- [Edit Order](https://docs.pacifica.fi/api-documentation/api/websocket/trading-operations/edit-order.md): This request type allows users to modify existing orders (price and/or size) through websocket API in one request.
- [Changelog](https://docs.pacifica.fi/api-documentation/changelog.md): Changelog for Pacifica's API documentation
- [Audits](https://docs.pacifica.fi/other/audits.md)
- [Brand Assets](https://docs.pacifica.fi/other/brand-assets.md)
- [Contact Us](https://docs.pacifica.fi/other/contact-us.md)
- [Glossary of Terms](https://docs.pacifica.fi/other/glossary-of-terms.md)
- [Close Beta Guide](https://docs.pacifica.fi/pacifica/close-beta-guide.md)
- [About Us](https://docs.pacifica.fi/pacifica/readme.md)
- [Testnet Guide](https://docs.pacifica.fi/pacifica/testnet-guide.md)
- [Bug Bounty Program](https://docs.pacifica.fi/programs/bug-bounty-program.md)
- [Builder Program](https://docs.pacifica.fi/programs/builder-program.md)
- [Educators Program](https://docs.pacifica.fi/programs/educators-program.md)
- [Market Maker Program](https://docs.pacifica.fi/programs/market-maker-program.md)
- [Points Program](https://docs.pacifica.fi/programs/points-program.md)
- [Referral and Affiliate Program](https://docs.pacifica.fi/programs/referral-and-affiliate-program.md)
- [VIP Program](https://docs.pacifica.fi/programs/vip-program.md)
- [Deposit/Withdrawal](https://docs.pacifica.fi/support/deposit-withdrawal.md)
- [Mobile App Account Deletion](https://docs.pacifica.fi/support/mobile-app-account-deletion.md)
- [Recover Assets After Reown to Privy Migration](https://docs.pacifica.fi/support/recover-assets-after-reown-to-privy-migration.md)
- [Trade Outcomes](https://docs.pacifica.fi/support/trade-outcomes.md)
- [My TP/SL Did Not Execute Properly](https://docs.pacifica.fi/support/trade-outcomes/my-tp-sl-did-not-execute-properly.md)
- [Why Was I Liquidated?](https://docs.pacifica.fi/support/trade-outcomes/why-was-i-liquidated.md)
- [Swim](https://docs.pacifica.fi/swim/swim.md)
- [Contract Specifications](https://docs.pacifica.fi/trading-on-pacifica/contract-specifications.md)
- [Oracle Price & Mark Price](https://docs.pacifica.fi/trading-on-pacifica/contract-specifications/oracle-price-and-mark-price.md)
- [Pre-Markets](https://docs.pacifica.fi/trading-on-pacifica/contract-specifications/pre-markets.md)
- [Deposits & Withdrawals](https://docs.pacifica.fi/trading-on-pacifica/deposits-and-withdrawals.md)
- [Fund Security](https://docs.pacifica.fi/trading-on-pacifica/fund-security.md)
- [Funding Rates](https://docs.pacifica.fi/trading-on-pacifica/funding-rates.md)
- [Liquidations](https://docs.pacifica.fi/trading-on-pacifica/liquidations.md)
- [Margin & Leverage](https://docs.pacifica.fi/trading-on-pacifica/margin-and-leverage.md)
- [Money Market](https://docs.pacifica.fi/trading-on-pacifica/money-market.md)
- [Order Types](https://docs.pacifica.fi/trading-on-pacifica/order-types.md)
- [Overview](https://docs.pacifica.fi/trading-on-pacifica/overview.md)
- [Self-Trade Prevention](https://docs.pacifica.fi/trading-on-pacifica/self-trade-prevention.md)
- [Spot Collateral](https://docs.pacifica.fi/trading-on-pacifica/spot-collateral.md)
- [Spot Trading](https://docs.pacifica.fi/trading-on-pacifica/spot-trading.md)
- [Trading Fees](https://docs.pacifica.fi/trading-on-pacifica/trading-fees.md)
- [Unified Margin](https://docs.pacifica.fi/trading-on-pacifica/unified-margin.md)
- [Depositing Into a Vault](https://docs.pacifica.fi/vaults/depositing.md)
- [Managing a Vault](https://docs.pacifica.fi/vaults/managing-a-vault.md)
- [Profit & Loss](https://docs.pacifica.fi/vaults/profit-and-loss.md)
- [Risk Controls](https://docs.pacifica.fi/vaults/risk-controls.md)
- [Overview](https://docs.pacifica.fi/vaults/vaults.md)