Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.pacificalens.xyz/llms.txt

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

AlphaBoard turns the Pacifica leaderboard into an actionable intelligence feed. You can filter and sort more than 7,800 tracked traders by proprietary score, PnL, volume, equity, and trading style, then inspect any trader’s active positions and trade history in a detail drawer. From there you can open a copy of any position manually with your own risk settings, or enable fully automated mirroring that opens, scales, and closes positions on your account in real time as the trader moves.

AlphaBoard

AlphaBoard is the main leaderboard table on the Smart Money page. It loads up to 7,800+ trader accounts sourced from the Pacifica leaderboard API and enriches each row with a computed Trader Score and style classification. Every row shows:
ColumnDescription
ScoreTrader Score v3 (0–100) with tier badge (S / A / B / C) and style icon.
PnL 7DRealized + unrealized PnL over the last 7 days.
PnL 30DRealized + unrealized PnL over the last 30 days.
PnL All TimeCumulative all-time PnL.
Vol 7D / 30D / AllTrading volume over 7 days, 30 days, and all time.
EquityCurrent account equity in USD.
Open Int.Current open position notional value.
StyleTrader classification (High Risk, Whale, Scalper, Swing Trader, or Balanced).
Click any column header to sort. Use the search box to filter by wallet address. The Watching tab narrows the list to traders you have starred.

Trader Score v3

Every active trader receives a composite score from 0 to 100 computed from eight weighted components. Traders with zero 30-day volume receive a score of 0 and are excluded from percentile ranking.
ComponentMax ptsHow it is calculated
PnL20Percentile rank of 30-day PnL versus all active traders. Negative 30-day PnL is capped at 4 points regardless of percentile.
Consistency20Alignment between 7-day and 30-day momentum. A 7-day PnL close to one-quarter of the 30-day PnL scores highest; sudden spikes or crashes are penalized.
EPR15Exposure Profit Ratio — 30-day PnL divided by current open interest (or volume when OI is zero). Higher ratios indicate capital-efficient profitability.
Win Rate15Long-term PnL divided by all-time volume. Acts as a proxy for overall trade efficiency across the account’s full history.
Drawdown10Loss control over the recent period. A positive 30-day PnL with a non-negative 7-day PnL scores the full 10 points. Scores decrease as the 7-day drop grows relative to the 30-day gain.
Track Record10All-time PnL size and long-term efficiency. Rewards traders who have accumulated significant absolute profit over their full history.
OI Risk5Open interest divided by equity. An OI/equity ratio above 10x receives zero points; a ratio at or below 1x receives the full 5 points.
Cap. Efficiency530-day PnL relative to current equity. A small account generating large gains scores higher than a large account generating the same absolute PnL.
The component scores sum to a maximum of 100.

Trader tiers

Tier thresholds are recalculated dynamically each time scores are computed, based on the percentile distribution of all active traders at that moment.
TierThresholdLabel
STop 5%Elite
ATop 20%Strong
BTop 45%Average
CBottom 55%Weak
Because tiers are percentile-based, the raw score needed to reach each tier shifts as the overall trader pool improves or declines.

Trader styles

Each trader is assigned one style based on their account metrics:
StyleClassification rule
High RiskOI/equity ratio above 5×, or all-time PnL is negative with 30-day volume above $100K.
Whale30-day volume above 5million,orcurrentequityabove5 million, or current equity above 500K.
ScalperMore than 55% of 30-day volume concentrated in the last 7 days, with at least $10K in 7-day volume.
Swing TraderPositive 30-day PnL with moderate recent activity (15–55% of monthly volume in the last 7 days).
BalancedAll other traders.

Trader detail drawer

Click any row in AlphaBoard to open the trader detail drawer. The drawer loads the trader’s current data and shows three tabs:
  • Open Positions — all active positions with entry price, mark price, unrealized PnL, PnL percentage, position value, contracts, estimated liquidation price, and margin. An Open Trade button appears on each position.
  • Trade History — last 50 executed trades with time, market, side, price, size, realized PnL, and fee.
  • Score Breakdown — the Trader Score card with a bar chart showing each component’s contribution out of its maximum, plus tooltips explaining each metric.

Manual copy trading

From any position in the trader detail drawer, click Open Trade to open a copy modal pre-filled with the trader’s symbol and direction. The copy modal shows:
  • Trader entry — the price at which the trader opened the position.
  • Mark price — the current market price.
  • Price drift — the percentage difference between the trader’s entry and the current mark price. A large drift means you would be entering at a significantly different price than the original trade.
You set your own margin (in USDC), leverage (slider from 1x to the market maximum), and order type (market or limit). The modal calculates and displays the resulting position value, contract count, and estimated liquidation price in real time. Click the execute button to send the order to Pacifica DEX from your connected wallet.
A price drift warning appears automatically when the difference between the trader’s entry price and the current mark price is significant. Review the drift percentage before executing to understand how much your fill price differs from the original trade.

Auto copy trading

Auto copy trading fully automates position mirroring using a Pacifica Agent Key. Once active, Pacifica Lens scans the trader’s positions every 10 seconds and acts on any changes without requiring manual confirmation.
1

Star the trader

Find the trader in AlphaBoard and click the star icon to add them to your Watching list. Switch to the Watching tab to see only starred traders.
2

Open the copy panel

Click Copy Trade on the trader’s card in the Watching tab to expand the copy configuration panel.
3

Enter your Agent Key

Paste your Pacifica Agent Private Key and Agent Public Key into the key fields. Generate a key pair at app.pacifica.fi/apikey. Keys are saved only in your browser’s local storage and are never transmitted to any server.
4

Configure copy settings

Set your margin per trade, leverage mode, position caps, and optional stop loss and take profit percentages (see configuration options below).
5

Start copy trading

Click Start Copy Trade. Pacifica Lens begins polling the trader’s positions every 10 seconds. Keep the browser tab open while auto copy is running.

Auto copy configuration

SettingOptionsDescription
Copy openToggleMirror when the trader opens a new position.
Copy closeToggleClose your position when the trader closes theirs.
Size modeFixed USDC / % of equityFixed: a set dollar amount per trade. Proportional: a percentage of your current account equity.
LeverageMirror / CustomMirror uses the trader’s actual leverage per symbol, capped at the market maximum. Custom applies a fixed multiplier you specify.
Margin per tradeDollar amount (min $10)Collateral committed per copied trade. Position size = margin × leverage.
Max positionsInteger (0 = unlimited)Stops opening new copies once this many positions are open on your account.
Stop lossToggle + % sliderAutomatically places a stop loss order at the specified percentage from the entry price.
Take profitToggle + % sliderAutomatically places a take profit order at the specified percentage from the entry price.
When auto copy is active, Pacifica Lens detects three types of trader actions:
  • New position — opens the same symbol and direction on your account using your configured size and leverage.
  • Full close — closes your matching position when the trader exits entirely.
  • Partial close — proportionally reduces your position when the trader reduces theirs by 30% or more.

Order log

Every auto copy action is recorded in the Activity Log within the copy panel. Each entry shows:
FieldDescription
Statusopened, closed, skipped, or error
SymbolThe perpetual market involved
SideLong or short
SizeContracts opened or closed
PriceMark price at execution time
SourceThe trader account being copied
TimestampTime of the action
The log retains the last 120 entries per session. Full order history is also visible in the Portfolio page under the PacificaLens Orders tab.
Auto copy trading requires a valid Pacifica Agent Key entered in the copy panel. Without both the Agent Private Key and Agent Public Key, the Start button remains disabled. Generate your key pair at app.pacifica.fi/apikey before activating auto copy.