@2oolkit/pacifica-cli

Trade perpetual futures on Pacifica — a decentralized derivatives exchange on Solana — from your terminal or AI agent.

One package, three interfaces:

25+ perpetual instruments: crypto (BTC, ETH, SOL), forex (EURUSD), commodities (XAU, XAG), equities (NVDA, GOOGL).

Installation

npm install -g @2oolkit/pacifica-cli

This installs both pacifica-cli (CLI) and pacifica-mcp (MCP server).

Prerequisites

• Node.js >= 20
• A Solana wallet with an Ed25519 private key (base58 encoded)

CLI Usage

Quick Start

# 1. Interactive setup (prompts for private key)
pacifica-cli config init

# 2. Check a price (no auth needed)
pacifica-cli market prices --symbol BTC

# 3. Place a market buy
pacifica-cli order market -s BTC -a 0.001 --side bid

# 4. View open positions
pacifica-cli position list

Configuration

Interactive setup (recommended):

pacifica-cli config init

Prompts for your Ed25519 private key (base58 encoded). Account address is automatically derived.

Manual setup:

pacifica-cli config set privateKey <base58-ed25519-private-key>

Environment variables (CI/CD, Docker):

export PACIFICA_WALLET_PRIVATE_KEY=<your-private-key>
export PACIFICA_WALLET_ADDRESS=<your-wallet-address>

Config is stored at ~/.pacifica-cli/config.json with 0600 permissions.

Command Reference

Market Data (no auth required)

pacifica-cli market info                      # List all instruments
pacifica-cli market info --symbol ETH         # Filter by symbol
pacifica-cli market prices                    # All symbol prices
pacifica-cli market prices --symbol BTC       # Single symbol
pacifica-cli market orderbook BTC             # Orderbook
pacifica-cli market orderbook BTC --depth 5   # With aggregation
pacifica-cli market trades ETH                # Recent trades
pacifica-cli market candles BTC -i 4h         # Candlestick data
pacifica-cli market funding SOL -l 50         # Funding rate history

Orders (auth required)

# Market order
pacifica-cli order market -s ETH -a 0.1 --side bid
pacifica-cli order market -s ETH -a 0.1 --side ask --reduce-only

# Limit order
pacifica-cli order limit -s BTC -p 60000 -a 0.01 --side bid
pacifica-cli order limit -s BTC -p 70000 -a 0.01 --side ask --tif IOC

# With take-profit / stop-loss
pacifica-cli order market -s ETH -a 0.1 --side bid --tp 2500 --sl 1800

# Manage
pacifica-cli order list                       # Open orders
pacifica-cli order history -l 50              # Order history
pacifica-cli order cancel -s ETH --order-id 123456
pacifica-cli order cancel-all                 # Cancel all
pacifica-cli order cancel-all -s ETH          # Cancel all for symbol

Order options:

Positions, Account & Funding

pacifica-cli position list                    # All open positions

pacifica-cli account info                     # Balances & equity
pacifica-cli account settings                 # Margin & leverage settings
pacifica-cli account leverage -s BTC -l 20    # Set leverage
pacifica-cli account margin-mode -s BTC --mode isolated
pacifica-cli account trades -s ETH -l 20      # Trade history
pacifica-cli account funding-history -l 20    # Funding payments

Config

pacifica-cli config init                      # Interactive setup
pacifica-cli config set <key> <value>         # Set a value
pacifica-cli config get <key>                 # Get a value
pacifica-cli config list                      # Show all (secrets masked)

Output Formats

All commands support -o json for scripting and piping:

pacifica-cli market prices -o json
pacifica-cli order list -o json | jq '.[].order_id'

MCP Server

The MCP (Model Context Protocol) server exposes all Pacifica functionality as tools for AI agents. Works with Claude Code, Claude Desktop, Cursor, Windsurf, and any MCP-compatible client.

Setup for Claude Code

claude mcp add pacifica -- pacifica-mcp

Setup for Claude Desktop / Cursor / Windsurf

Add to your MCP config file:

{
  "mcpServers": {
    "pacifica": {
      "command": "pacifica-mcp",
      "env": {
        "PACIFICA_WALLET_PRIVATE_KEY": "<your-private-key>"
      }
    }
  }
}

Or without global install:

{
  "mcpServers": {
    "pacifica": {
      "command": "npx",
      "args": ["-y", "-p", "@2oolkit/pacifica-cli", "pacifica-mcp"],
      "env": {
        "PACIFICA_WALLET_PRIVATE_KEY": "<your-private-key>"
      }
    }
  }
}

The env field passes your credentials directly to the MCP server — no separate CLI config needed. Alternatively, you can set up credentials via pacifica-cli config init and omit the env field.

Available Tools (19)

MCP Authentication

Credentials can be provided in two ways:

1. env field in MCP config (recommended) — set PACIFICA_WALLET_PRIVATE_KEY directly in your MCP config as shown above
2. CLI config — run pacifica-cli config init and the MCP server reads ~/.pacifica-cli/config.json automatically

OpenClaw Skill

This package includes an OpenClaw skill definition for AI agent ecosystems. The skill file is located at skill/SKILL.md with detailed reference docs in skill/references/.

Compatible with OpenClaw, ClawdBot, and other agent skill platforms.

Common Workflows

Close a Position

# Long position → sell reduce-only
pacifica-cli order market -s ETH -a 0.1 --side ask --reduce-only

# Short position → buy reduce-only
pacifica-cli order market -s ETH -a 0.1 --side bid --reduce-only

Always use --reduce-only when closing positions to prevent accidentally opening the opposite direction.

Bracket Order (Entry + TP/SL)

pacifica-cli order market -s ETH -a 0.1 --side bid --tp 2500 --sl 1800

Scale-In (DCA)

pacifica-cli order limit -s ETH -p 2000 -a 0.1 --side bid
pacifica-cli order limit -s ETH -p 1950 -a 0.1 --side bid
pacifica-cli order limit -s ETH -p 1900 -a 0.1 --side bid

Portfolio Health Check

pacifica-cli account info -o json              # Balance & equity
pacifica-cli position list -o json             # Open positions
pacifica-cli order list -o json                # Open orders

Safety Rules

1. Use --reduce-only for all exit orders — prevents accidental position flips
2. Check instrument specs before placing orders — pacifica-cli market info --symbol BTC
3. Check account balance before large orders — pacifica-cli account info
4. Start with small sizes when testing strategies
5. Never expose your private key — it's used locally for signing, never transmitted

Security

• Secret input masking — config init hides your private key as you type (displays *)
• File permissions — config file is created with 0600 (owner read/write only)
• Local signing — Ed25519 signatures computed locally with tweetnacl, only signatures are transmitted
• Signature expiry — each signed request includes a timestamp and expiry window to prevent replay attacks

Environment Variables

Resources

• Pacifica Exchange: https://pacifica.fi
• npm Package: https://www.npmjs.com/package/@2oolkit/pacifica-cli
• GitHub: https://github.com/haeminmoon/pacifica-cli
• Pacifica API Docs: https://docs.pacifica.fi/api-documentation/api

License

MIT