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

# Frequently asked questions about Pacifica Lens features

> Common questions about wallet requirements, guest mode, copy trading, Agent Keys, builder fees, the Trader Score system, and how live market data refreshes.

Find answers to the most common questions about Pacifica Lens below.

<AccordionGroup>
  <Accordion title="Do I need a wallet to use Pacifica Lens?">
    No — not for everything. You can use the following features without connecting a wallet:

    * **Market Overview** — live prices, funding rates, order books, and charts for all 63 markets
    * **Risk Calculator** — calculate position size, required margin, and liquidation price
    * **Price Alerts** — set and receive browser notifications for any market
    * **Arbitrage Scanner** — view cross-exchange funding-rate spreads

    The following features require a connected wallet:

    * **Trade execution** — placing or cancelling orders
    * **Copy trading** — both manual and auto-copy
    * **AI Assistant** — market analysis and on-chain queries
    * **Portfolio** — your positions, trade history, funding history, and journal

    Click **Continue as Guest** on the landing page to enter the app without connecting.
  </Accordion>

  <Accordion title="What wallets does Pacifica Lens support?">
    Pacifica Lens supports the following Solana wallets:

    | Wallet         | Type                                          |
    | -------------- | --------------------------------------------- |
    | Phantom        | Browser extension                             |
    | Solflare       | Browser extension                             |
    | Backpack       | Browser extension                             |
    | Privy embedded | In-app wallet — no browser extension required |

    The Privy embedded option lets you create or import a wallet entirely within the app using an email address or social login, with no extension to install.
  </Accordion>

  <Accordion title="What is the builder fee?">
    Every order submitted through Pacifica Lens carries a 0.02\*\*% builder fee\*\* tagged to the `PACIFICALENS` builder code. This fee is applied automatically by the Pacifica protocol at the time of order execution — there is nothing extra you need to configure. The fee is on top of your standard Pacifica maker or taker fee.
  </Accordion>

  <Accordion title="What is the Builder Code approval?">
    Before your first order through Pacifica Lens, the app will prompt you to sign a one-time **Builder Code approval** transaction. This transaction registers the `PACIFICALENS` builder code with your wallet on-chain, enabling builder attribution for all subsequent orders.

    You only need to approve this once per wallet. After approval, all future orders — including auto-copy trades — are submitted instantly without another approval prompt.
  </Accordion>

  <Accordion title="What is an Agent Key and why do I need it?">
    An **Agent Key** is a delegated signing key that allows Pacifica Lens to submit orders on your behalf without requiring a manual wallet approval for each trade. Agent Keys are required for **auto copy trading** — they enable the automated engine to open and close positions automatically when a watched trader's position changes.

    To get an Agent Key:

    1. Go to [Pacifica.fi](https://app.pacifica.fi) and open **Account Settings**.
    2. Generate a new Agent Key pair.
    3. Copy the private key and paste it into the Agent Key field in the Pacifica Lens copy-trading panel.

    For manual copy trading (the **Open Trade** button in the trader detail drawer), an Agent Key is not required — your connected wallet signs each order directly.
  </Accordion>

  <Accordion title="Is my Agent Key private key safe?">
    Your Agent Key private key is stored **only in your browser's local storage** and is never transmitted to any server, including Pacifica Lens servers. All order signing happens locally in your browser.

    Because it is stored in local storage, the key exists only in the browser where you pasted it. Clearing your browser data will remove it and you will need to paste it again.
  </Accordion>

  <Accordion title="What is the Trader Score?">
    The **Trader Score** is a proprietary 0–100 composite score that Pacifica Lens calculates for every trader on the AlphaBoard. It is built from eight weighted components:

    | Component          | Max points | What it measures                                           |
    | ------------------ | ---------- | ---------------------------------------------------------- |
    | PnL                | 20         | Percentile rank of 30-day PnL versus all active traders    |
    | Consistency        | 20         | Alignment between 7-day and 30-day momentum                |
    | EPR                | 15         | Exposure Profit Ratio — PnL relative to open interest      |
    | Win Rate           | 15         | Long-term PnL-to-volume efficiency                         |
    | Drawdown           | 10         | Recent loss control versus overall gains                   |
    | Track Record       | 10         | All-time PnL size and long-term profitability              |
    | OI Risk            | 5          | Open interest relative to equity (high leverage penalized) |
    | Capital Efficiency | 5          | 30-day PnL relative to current equity                      |

    Tier thresholds are **dynamic** and percentile-based: S = top 5%, A = top 20%, B = top 45%, C = everyone else. Traders with zero 30-day volume automatically receive a score of 0.
  </Accordion>

  <Accordion title="How often does auto copy trading poll for new trades?">
    The auto copy trading engine checks each watched trader's positions **every 10 seconds**. When a new position is detected, the engine opens the same trade on your account immediately using your Agent Key. When a trader closes or partially reduces a position, the engine mirrors that change proportionally on your account.
  </Accordion>

  <Accordion title="Can I copy-trade without an Agent Key?">
    Yes. The **Open Trade** button in the trader detail drawer lets you manually copy any open position from any trader on the AlphaBoard. You can set your own margin, leverage, stop loss, take profit, and order type (market or limit), and the order is signed by your connected wallet directly.

    Manual copy trading does not require an Agent Key. Only the fully automated **auto copy trading** feature requires one.
  </Accordion>

  <Accordion title="What exchanges does the arbitrage scanner compare?">
    The arbitrage scanner compares funding rates across four exchanges simultaneously:

    * **Pacifica** (the primary exchange)
    * **dYdX**
    * **HyperLiquid**
    * **Aster**

    For each market available on multiple exchanges, the scanner shows the funding spread per 8-hour period, an annualized APR, and which exchange to go long and which to go short to capture the spread delta-neutrally.
  </Accordion>

  <Accordion title="How current is the market data?">
    Mark prices, funding rates, open interest, and 24-hour volume update approximately every **30 seconds**. Liquidation events are delivered in near-real time as they occur. Order book data refreshes each time you open a market detail panel.
  </Accordion>
</AccordionGroup>