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.

If something is not working as expected, find the relevant issue below and follow the steps to resolve it.
Try the following in order:
  1. Refresh the page — a stale session state can prevent the wallet modal from opening correctly.
  2. Unlock your browser extension — Phantom, Solflare, and Backpack all require the extension to be unlocked before they respond to connection requests. Click the extension icon in your browser toolbar and enter your password if prompted.
  3. Try the Privy embedded option — if your extension wallet is unresponsive, select the Privy option in the connect modal. Privy creates or imports a wallet entirely in-app with no extension dependency.
  4. Check for extension conflicts — multiple wallet extensions active at the same time can intercept each other’s provider injections. Try disabling all but one wallet extension and refreshing.
  5. Try a different browser — if the issue persists, test in a clean browser profile without other extensions installed.
Order failures usually have one of three causes:
  • Insufficient USDC balance — check your Available Balance on the Portfolio page. Your wallet must have enough USDC to cover the required margin for the order size you are attempting.
  • Builder Code approval not completed — every wallet must sign a one-time Builder Code approval before its first order. If the approval prompt appeared but you dismissed it, the next order attempt will show the prompt again. Complete it before retrying.
  • Position size below the market minimum — each Pacifica market has a minimum order size defined in its market configuration. Open the Risk Manager and verify that your position size in tokens is at or above the minimum for the market you are trading.
If none of the above apply, check the PacificaLens Orders tab in Portfolio for the specific error message logged against the failed order.
Work through this checklist:
  1. Verify your Agent Key is set — open the copy-trading panel, find the Agent Key input, and confirm a key is pasted there. Without an Agent Key, the auto-copy engine cannot sign orders.
  2. Check your watched traders list — auto copy trading only activates for traders you have starred and added to the Watching tab. Confirm the trader you want to copy appears there.
  3. Confirm the copy open toggle is enabled — in the copy configuration panel, the Copy Open and Copy Close toggles can be switched independently. Make sure Copy Open is turned on.
  4. Check your size and leverage settings — if your configured minimum trade size is larger than the position the trader is opening, the engine will skip that trade. Adjust your size settings to match the trader’s typical position sizes.
  5. Check the PacificaLens Orders tab — failed auto-copy attempts appear in the order log with a Failed status and an error message that can help pinpoint the issue.
The AI Assistant requires a connected wallet and is not available in guest mode. This is by design — the assistant injects live account context into queries, which requires an authenticated session.To use the AI Assistant, connect a wallet from the header. If you only need market data, funding rates, or general DeFi questions, you can browse the Market Overview and Analytics sections as a guest without the AI feature.
If browser notifications are not appearing when a price alert triggers, check the following:
  1. Confirm the toggle is on — the Notifications toggle in the price alerts panel must show Notifications On. If it shows Notifications Off, click it and accept the browser permission prompt.
  2. Check browser permission — open your browser settings, navigate to Site Settings → Notifications, and find pacificalens.xyz. If permission is set to Blocked, change it to Allow and then reload the page.
  3. Check OS-level notification settings — on macOS and Windows, the operating system can suppress browser notifications globally. Confirm that your browser is allowed to send notifications in your OS notification preferences.
  4. Confirm the alert is still active — triggered alerts are moved to the Triggered section and will not fire again unless you re-enable them. Check that your alert is in the Active section and its row toggle is on.
Prices, funding rates, and open interest refresh automatically approximately every 30 seconds. If data looks frozen:
  1. Wait a full refresh cycle — the 30-second interval means data can appear up to 30 seconds old at any moment. This is normal.
  2. Hard refresh the page — press Ctrl+Shift+R (Windows/Linux) or Cmd+Shift+R (macOS) to bypass the browser cache and force a fresh load.
  3. Check your network connection — if the refresh spinner in the Portfolio page spins indefinitely, your connection to the Pacifica API may have been interrupted. Check your internet connection and try again.
Journal entries are stored in your browser’s local storage and are not synced to any server or account. Entries can disappear if:
  • You cleared your browser history, cookies, or site data
  • You switched to a different browser or browser profile
  • You opened Pacifica Lens in a private or incognito window (those sessions do not persist browser data)
There is no way to recover deleted local storage data. Going forward, consider exporting important journal notes manually if you need a backup. Entries are keyed per wallet address, so switching wallets will display a different (empty) journal for the new wallet.
When you use the Open Trade button to manually copy a trader’s position, Pacifica Lens shows the trader’s entry price, the current mark price, and the price drift — the percentage difference between the two.A large drift means significant time has passed since the trader opened the position, and the market has moved. Executing at the current mark price means your entry will be meaningfully different from the trader’s original entry, which can affect your risk/reward profile and liquidation price.Before proceeding:
  • Review whether the original trade thesis still applies at the current mark price.
  • Adjust your stop loss, take profit, and margin accordingly.
  • Consider setting a limit order at a more favorable price rather than taking the market price immediately.
There is no hard block on executing a trade with price drift — the warning is informational and the final decision is yours.