Skip to content

Pacifica

🛠 Connector Info

  • Exchange Type: Decentralized Exchange (DEX)
  • Market Type: Central Limit Order Book (CLOB)
Component Status Notes
🔀 Spot Connector Not available
🔀 Perp Connector ✅ Supports testnet
đŸ•¯ Spot Candles Feed Not available
đŸ•¯ Perp Candles Feed ✅

ℹī¸ Exchange Info

🔑 Getting Keys Ready

In order to start trading, you would need the following parts ready:

  1. API Agent Keys (aka Agent Wallet)
  2. Public key
  3. Private key
  4. Public key of your Solana wallet

Another important key is API Config Key, which would be automatically generated for you. If you have one already, then the first one would be picked.

It all starts with "Connect" button, so you could login and have you Solana wallet connected.

Then you should go to API Keys page.

If you see "Join Closed Beta" button at the top right cortner, then you need to click it first. And use one of the invitation codes.

Now you could generate Agent Wallet. You should click on "Generate" and then on "Create" button. What you've just generated is your Agent Wallet Private Key. What you see below (and what you'll see after key creation) is your Agent Wallet Public Key.

Don't forget to whitelist the IP address

🔀 Perp Connector

Integration to perpetual futures markets API endpoints

Usage

From inside the Hummingbot client, run connect pacifica_perpetual:

>>> connect pacifica_perpetual

Enter your Pacifica Perpetual Agent Wallet Public Key >>>
Enter your Pacifica Perpetual Agent Wallet Private Key >>>
Enter your Pacifica Perpetual User Wallet Public Key >>>

If connection is successful:

You are now connected to pacifica_perpetual.

Order Types

This connector supports the following OrderType constants:

  • LIMIT
  • LIMIT_MAKER
  • MARKET

Position Modes

This connector supports the following position modes:

  • One-way

Rate Oracle

The connector comes with its own rate oracle implementation. You can use it by using the following command:

config rate_oracle_source pacifica_perpetual

Make sure to set global token name to USDC as USDC is the main quote token for trading on Pacifica

config global_token.global_token_name USDC

Paper Trading (Pacifica Testnet)

This perp exchange offers a paper trading mode: https://test-app.pacifica.fi/

[!NOTE] Please note that Testnet is a separate environment from Mainnet. It has different URL, different balances and you would need to generate new API keys (Agent Wallet) for it. More about Agent Wallets

You would also need to connect a Solana Devnet Wallet. To trade on Testnet, you need USDP (Pacifica's testing token). You can get it from the Pacifica Faucet. To enable the Deposit button and fund your account with USDP, you might need to enter an invitation code at Pacifica Referral. Note: Claiming from the Pacifica Faucet requires some SOL on your Devnet wallet for transaction fees. You can get Devnet SOL from the Solana Faucet.

After you create an account and create the API keys, you can enter them by using the connect pacifica_perpetual_testnet command within the Hummingbot client. Once connected, you should be able to use the testnet with the available perpetual strategies / scripts.

connect pacifica_perpetual_testnet

đŸ•¯ Perp Candles Feed

OHLCV candles data collector from perpetual futures markets

  • ID: pacifica_perpetual
  • Supported Intervals: 1m | 3m | 5m | 15m | 30m | 1h | 2h | 4h | 8h | 12h | 1d
  • Github Folder

Usage

In a Hummingbot script, import CandlesFactory to create the candles that you want: 

    from hummingbot.data_feed.candles_feed.candles_factory import CandlesFactory
    candles = CandlesFactory.get_candle(connector="pacifica_perpetual",
                                        trading_pair=trading_pair,
                                        interval="3m", max_records=50)