Tools - Pacifica

The server exposes the tools below, grouped by category. Access indicates the mode required:

Read tools are GET requests and work in any mode, including read-only (ADDRESS only).
Write tools are signed POST requests and require a signing key (AGENT_PRIVATE_KEY or PRIVATE_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_KEY specifically - an agent key cannot sign on-chain transactions.

See Configuration for how to set the mode.

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 require PRIVATE_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.

On testnet, a typical flow is mintUsdp to credit your wallet, then depositUsdp to move those funds into your exchange balance.

​Markets

​Account

​Orders & Positions

​Spot

​Funding

Markets

Account

Orders & Positions

Spot

Funding