Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/pacifica-fi/docs-migrate/llms.txt

Use this file to discover all available pages before exploring further.

Swim is Pacifica’s live price prediction game, built directly into the trading platform. Instead of placing a traditional buy or sell order, you watch a real-time price chart overlaid with a grid of price-and-time zones and tap the cells you think price will move into. Get it right, and you collect your bet multiplied by that zone’s payout — no expiry to wait for, no settlement delay. More markets are coming soon.
Swim draws directly from your Pacifica trading balance — the same balance you use for spot and perpetual trading. There is no separate deposit, wallet, or account required. Any USDC in your trading account is immediately available for Swim predictions.

How the Grid Works

The live price chart sits on top of a two-dimensional grid. Each cell in the grid represents a specific price range (vertical axis) at a specific time window (horizontal axis) ahead of the current moment. As the chart moves in real time, the grid scrolls with it, so the cells always describe future price territory relative to where price is right now. Every cell has a multiplier that reflects how far that zone is from the current price — both in price distance and in time. The further away a zone is, the higher its multiplier.

How to Place a Prediction

1

Open Swim

Navigate to the Swim section in the Pacifica app. Select the market you want to predict.
2

Choose a bet size

Enter the amount of USDC you want to wager. The amount is deducted from your trading balance immediately when you tap a zone.
3

Read the grid

Look at the live grid overlaid on the chart. Each cell shows its current multiplier. Multipliers update continuously as price moves, but once you tap a cell your multiplier is locked in permanently at the value shown at that instant.
4

Tap a zone

Tap any cell on the grid to place your prediction. The bet amount is locked and the multiplier is recorded. You can tap multiple zones in the same session.
5

Collect your payout

If price enters a zone you tapped, you receive bet × multiplier credited to your trading balance immediately. No manual claim is required.

Multipliers

Zone multipliers ladder based on two dimensions of distance from the current price:
Distance dimensionEffect on multiplier
Price distanceZones further from the current price in either direction carry higher multipliers.
Time distanceZones further in the future carry higher multipliers.
The multiplier shown in each cell updates continuously as the chart moves. However, the moment you tap a zone, your multiplier is locked in at the value shown at tap time, regardless of how the grid shifts afterward. This means tapping early, before a zone becomes consensus, can lock in a more favorable multiple.
Multipliers can shift rapidly during volatile price action. If you see a high multiplier on a nearby zone, it reflects the market’s live estimate of how unlikely that price level is — not a guaranteed rate. Tap decisively if the multiple meets your threshold; it may not persist.

Payouts

When price enters a zone you have tapped, the payout is calculated immediately:
payout = bet_amount × locked_multiplier
The payout is credited to your Pacifica trading balance as soon as price crosses into the zone. There is no expiry window to wait for and no manual collection step.
Payouts are triggered when price enters a zone — meaning the live price passes through the cell’s price range within its time window. If price moves past a zone so quickly that it never registers within the time window, that zone does not pay out. The time dimension of each cell means zones are active for a defined window; once that window closes, an untouched zone expires.

Balance and Funds

Swim uses the same USDC trading balance as spot and perpetual trading. Tapping a zone immediately deducts the bet from available_to_withdraw. Winnings are credited to the same balance. You do not need to transfer funds or maintain a separate account.
Because the balance is shared, bets placed in Swim reduce the margin available for open perpetual or spot positions. Make sure your available balance is sufficient to cover both active trades and any Swim predictions you place simultaneously.

Oracle

Swim uses a purpose-built price oracle that aggregates live orderbook data from leading centralized and decentralized venues. Raw venue prices are combined via an exponentially weighted moving average (EWMA) and then merged through a venue-weighted mean. The result is a smooth, manipulation-resistant reference price that drives both the chart display and zone settlement.
A simple average of raw last-trade prices would be highly susceptible to momentary spikes on any single venue. EWMA smoothing gives more weight to recent prices while dampening short-lived noise. Venue weighting adjusts the contribution of each source by its relative liquidity and reliability, preventing any single exchange from unduly influencing the Swim reference price.

Build docs developers (and LLMs) love