> ## 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.
