- Read tools are GET requests and work in any mode, including read-only (
ADDRESSonly). - Write tools are signed POST requests and require a signing key (
AGENT_PRIVATE_KEYorPRIVATE_KEY). In read-only mode they return a clear “read-only mode” error. - On-chain tools sign and send a Solana transaction directly rather than calling the REST API, so they require
PRIVATE_KEYspecifically - an agent key cannot sign on-chain transactions.
Markets
Market data and exchange info. All read-only.| Tool | Access | Description |
|---|---|---|
getInfo | Read | Exchange/market info (tick and lot size, max leverage, order limits) for all tradable pairs. |
getPrices | Read | Funding, mark, oracle, and mid prices, plus open interest and 24h volume, for all pairs. |
getOrderbook | Read | Current orderbook snapshot (bids and asks) for a pair. |
getRecentTrades | Read | Recent trades for a pair. |
getKline | Read | Candlestick (K-line) data for a pair and time interval. |
getMarkPriceKline | Read | Mark-price candlestick data for a pair and time interval. |
getSparklines | Read | Compact sparkline price series for one or more pairs. |
getFees | Read | Fee tiers and their maker/taker fee rates. |
getFundingRateHistory | Read | Funding rate history for a pair (cursor-paginated). |
getAggregatedFundingRates | Read | Aggregated funding rates across exchanges. |
getLoanPool | Read | Loan pool statistics (borrowed, borrowable, utilization, APR/APY). |
getPositionLiquidationPrices | Read | Liquidation prices for the account’s open positions. |
getCurrentTime | Read | Current server time in milliseconds since the Unix epoch. |
Account
Account info, settings, and history.| Tool | Access | Description |
|---|---|---|
getAccountInfo | Read | High-level account info: balance, equity, margin usage, fee tier, and spot balances. |
getAccountSettings | Read | Non-default margin/leverage settings, auto-lend status, and per-asset spot settings. |
getAccountLoanInfo | Read | Loan info: borrowed amounts, pending interest, and collateral utilization. |
getPortfolioHistory | Read | Account equity and PnL history over a time range. |
getBalanceHistory | Read | Balance-change history: deposits, withdrawals, transfers, and payouts. |
getFundingHistory | Read | Funding-payment history on perpetual positions (cursor-paginated). |
getDailyAccountActivity | Read | Daily activity summary (points, fees, volume) for a time range. |
getPayoutHistory | Read | Payout history (cursor-paginated). |
getDepositHistory | Read | Deposit history (cursor-paginated). |
getWithdrawalHistory | Read | Withdrawal history (cursor-paginated). |
getPendingWithdrawals | Read | Pending withdrawals not yet batched. |
updateLeverage | Write | Set the leverage multiplier for a pair. |
updateMarginMode | Write | Switch a pair between isolated and cross margin. |
updateSpotSettings | Write | Set whether a spot asset is included in unified margin collateral. |
setAutoLendDisabled | Write | Set the auto-lend preference for spot collateral. |
withdraw | Write | Withdraw funds from the perp account. |
bindAgentWallet | Write | Bind an agent wallet to the account (legacy direct-bind endpoint). |
Orders & Positions
Order management and position tools.| Tool | Access | Description |
|---|---|---|
getOpenOrders | Read | All open (unfilled) orders for the account. |
getOrderHistory | Read | Summarized order history (cursor-paginated). |
getOrderHistoryById | Read | Full event history of a single order by ID. |
getCurrentPositions | Read | All currently held positions. |
getPositionHistory | Read | Per-fill trade/position history (cursor-paginated, max 30-day range). |
getOpenTwapOrders | Read | All running TWAP orders. |
getTwapOrderHistory | Read | Summarized TWAP order history (cursor-paginated). |
getTwapOrderHistoryById | Read | Full per-event history of a single TWAP order by ID. |
openOrder | Write | Create a limit order, optionally with an attached take-profit and/or stop-loss. |
createMarketOrder | Write | Create a market order with max slippage, optionally with TP/SL. |
editOrder | Write | Edit a limit order (cancels the original and creates a new post-only order). |
cancelOrder | Write | Cancel an unfilled order by symbol and order ID. |
cancelAllOrders | Write | Cancel all unfilled orders, or all for a single pair. |
createStopOrder | Write | Create a standalone stop-loss/take-profit order. |
cancelStopOrder | Write | Cancel a stop-loss/take-profit order by ID. |
setPositionTpsl | Write | Attach take-profit and/or stop-loss to an existing position. |
addIsolatedMargin | Write | Add USDC margin to an isolated position. |
createTwapOrder | Write | Create a TWAP order that splits the total amount into market sub-orders over a duration. |
cancelTwapOrder | Write | Cancel a running TWAP order by ID. |
batchOrders | Write | Execute up to 10 order actions (create, cancel, edit, TP/SL) in one request. |
Spot
Spot asset data, balances, and withdrawals.| Tool | Access | Description |
|---|---|---|
getSpotAssets | Read | List available spot assets and their parameters. |
getBridgeInfo | Read | Bridge parameters for all spot assets. |
getBridgeParameters | Read | Bridge parameters for a single spot asset. |
getSpotBalanceHistory | Read | Spot asset balance history (cursor-paginated). |
getSpotDepositHistory | Read | Spot asset deposit history (cursor-paginated). |
getSpotWithdrawalHistory | Read | Spot asset withdrawal history (cursor-paginated). |
getPendingSpotWithdrawals | Read | Pending spot asset withdrawals not yet batched. |
withdrawSpotAsset | Write | Queue an on-chain spot asset withdrawal to your wallet (not reversible). |
Funding
On-chain tools that fund your wallet and exchange balance. They sign and send Solana transactions directly rather than calling the REST API, so they requirePRIVATE_KEY - an agent key cannot sign on-chain transactions - and they use SOLANA_RPC_URL (defaults to public devnet). See Configuration.
| Tool | Access | Description |
|---|---|---|
mintUsdp | On-chain | Mint test USDP into your wallet’s token account. Testnet only - registered only when PACIFICA_BASE_URL targets testnet. |
depositUsdp | On-chain | Deposit your wallet’s USDC/USDP into the Pacifica exchange balance used for trading. Works on testnet and mainnet; on mainnet it moves real USDC. |
mintUsdp to credit your wallet, then depositUsdp to move those funds into your exchange balance.