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.

Pacifica is a high-performance crypto perpetual and spot trading platform built on Solana. Whether you’re setting up your first wallet, managing a position, or integrating via the API, the answers below cover the most common questions traders ask. If you don’t find what you need here, reach out in the Pacifica Discord.

​
General

To start trading you’ll need:
  • A supported crypto wallet — Phantom, Solflare, Backpack, Ledger, or any WalletConnect-compatible wallet. You can also create a wallet instantly through Pacifica using your Email, Google, or X account.
  • USDC collateral to deposit (minimum $10).
  • A small amount of SOL in your wallet to cover Solana network transaction fees.
Pacifica supports the following wallets:
  • Phantom
  • Solflare
  • Backpack
  • Ledger (hardware wallet)
  • All WalletConnect-compatible wallets
You can also create an embedded wallet directly through the Pacifica interface using your Email, Google, or X (Twitter) account — no prior wallet setup required.
Pacifica offers perpetual futures contracts on popular crypto assets including SOL, BTC, ETH, and more. New markets are added regularly. Visit the platform for a live list of all available trading pairs.
  • Maker fees are lower charges applied to orders that add liquidity to the order book (e.g., resting limit orders).
  • Taker fees are higher charges applied to orders that remove liquidity by executing immediately against existing orders.
Pacifica uses a volume-based VIP fee program: your rolling trading volume determines your fee tier, so higher-volume traders pay lower rates. See the Trading Fees page for the full tier schedule.
The Oracle Price, also called the Mark Price, is an aggregated reference price calculated from multiple external sources:
  • For liquid assets: a weighted median derived from major centralized exchanges.
  • For less liquid assets: a TWAP (Time-Weighted Average Price) sourced from decentralized exchanges.
The Oracle Price is used to calculate margin requirements, funding fees, liquidation thresholds, and unrealized PnL — making it resistant to short-term price manipulation on any single venue.
Withdrawal controls temporarily restrict how much collateral you can withdraw during periods of extreme market volatility. This safeguard ensures your open positions stay adequately collateralized and helps maintain overall platform stability. Withdrawal limits are automatically lifted once volatility subsides.
No. Dynamic margin requirement changes apply only to new orders and subsequent margin adjustments. Your existing open positions are not retroactively affected when margin requirements change.

​
Deposits & Withdrawals

Deposits are made in USDC on the Solana network only. The minimum deposit is 10 USDC.
Deposits sent via any other network (e.g., Ethereum, Arbitrum) or in any other token (e.g., USDT, SOL) will not be credited to your account.
Deposits are usually credited within minutes. Delays may occur due to Solana network congestion, RPC instability, or temporary infrastructure load. Always verify your transaction on a Solana block explorer before contacting support.
Withdrawals are processed in USDC on Solana only. A 1fee∗∗isdeductedfromeachwithdrawaltocovernetworkcosts.Theminimumwithdrawalamountis∗∗1 fee** is deducted from each withdrawal to cover network costs. The minimum withdrawal amount is **1.Your Solana wallet must have a valid USDC token account. If you encounter an error during withdrawal, ensure your wallet already holds a non-zero amount of USDC to initialize the token account, then retry.
For large transfers, consider sending a small test transaction first to confirm everything is working correctly before moving the full amount.
  • Minimum deposit: 10 USDC. Deposits below this threshold will not trigger an on-chain credit event. You can send additional USDC to the same address to reach the minimum.
  • Minimum withdrawal: 1(afterthe1 (after the 1 withdrawal fee). Withdrawal requests below $1 are not processed.
Deposit delays can occur due to:
  • Solana network congestion — check the Solana network status.
  • RPC instability — temporary issues with Solana RPC nodes.
  • Infrastructure load — occasional processing queues on the Pacifica side.
Verify your transaction signature (TXID) on a Solana block explorer first. If the on-chain transaction is confirmed but funds haven’t appeared, contact support with your TXID.
No. Pacifica currently only supports USDC on Solana for both deposits and withdrawals. Always double-check the network and token before sending funds. Deposits of unsupported assets cannot be recovered by Pacifica.

​
Trading

Funding fees are exchanged between long and short positions every hour to keep the perpetual contract price aligned with the underlying spot market.The hourly funding rate is derived from the Premium Index (the deviation between the Impact Price and the Oracle Price) plus a fixed interest rate component, divided by 8. Funding fees are applied to your position based on:
  • Your position size
  • The current Oracle Price
The funding rate is capped at ±4% per period. For a full breakdown, see the Funding Rates page.
If your position’s margin falls below the maintenance margin requirement, Pacifica’s three-tiered liquidation process is triggered:
  1. Initial Liquidation — Market orders are used to partially or fully close the position.
  2. Backstop Liquidation — If order book liquidity is insufficient, the remaining position and its collateral are transferred to a dedicated liquidation vault, which systematically closes it.
  3. Auto-Deleveraging (ADL) — As a last resort, opposing profitable positions may be partially closed to cover the shortfall.
Any collateral remaining after fees is returned to your account. Losses that exceed your deposited collateral are absorbed by the liquidation vault — you cannot lose more than your account balance.
TP/SL orders are conditional orders attached to a position:
  • Take-Profit (TP): Automatically closes all or part of your position when the market reaches a specified profit target.
  • Stop-Loss (SL): Automatically closes all or part of your position when the market moves against you to a specified level, limiting your downside.
Both order types are triggered based on the Oracle (Mark) Price, helping to prevent manipulation from brief price wicks on a single exchange.

​
API

This error occurs when a GET request is sent with an empty request body (e.g., -d '{}'). After Pacifica’s migration to CloudFront, GET requests that include any request body — even an empty one — are rejected with a 403 error.Remove the empty body from your GET requests.
The following will not work:
curl -X GET -H "PF-API-KEY: your-api-key" -H "Content-Type: application/json" -d '{}' \
  "https://api.pacifica.fi/api/v1/positions?account=..."
This will work:
curl -X GET -H "PF-API-KEY: your-api-key" \
  "https://api.pacifica.fi/api/v1/positions?account=..."
GET requests should never include a request body. Move all parameters to query string arguments instead.
The account_positions and account_orders channels are snapshot-driven: they reflect your current state but can lag under high load.For real-time, zero-delay updates, switch to the event-driven channels:
ChannelTriggers on
account_tradesEvery fill as it happens
account_order_updatesEvery order state change
Best practice: Use the snapshot channels (account_positions, account_orders) for initialisation and periodic state checks. Use the event-driven channels to maintain a real-time local state.

​
Still Need Help?

Discord Community

Join the Pacifica Discord to ask questions, connect with other traders, and open a support ticket.

Follow on X

Follow @pacifica_fi for the latest announcements, product updates, and market insights.

Build docs developers (and LLMs) love

Get started for freeTalk to us