> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pacifica.fi/llms.txt
> Use this file to discover all available pages before exploring further.

# Tools

> The full list of tools the Pacifica MCP server exposes, grouped by category.

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](/api-documentation/api/mcp/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](/api-documentation/api/mcp/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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.