getpnl.app
GUIDE / EXPLORERS

Wallet history.

PnL reads a wallet's balance by address, with no keys. For the entry price and realized PnL it also needs the transfer history, which comes from block explorers. On some networks the explorer is closed to apps, and then you choose how to read it. The choice arrived in version 1.3.2.

WHY01

What the history gives you.

PnL builds lots from the transfer history: coins coming in are a buy at that date's price, coins going out sell the oldest lots first (FIFO). The lots give you the average entry price and realized PnL for the wallet.

Without the history, the balance and value show as usual, and the entry counts from the moment the app first saw the coins. You can also set it manually in the wallet.

CHOICE02

Polygon, Arbitrum and Base: three options.

Since autumn 2026 the public Blockscout explorers for these networks only let browsers in and turn app requests away. PnL still asks them first: if the protection is lifted, history will just start working. Until then, you need one of these options:

  • Via the PnL server - nothing to enter. The app sends the wallet address and network to the PnL server, the server asks for the history with its own keys and returns the answer (more below).
  • Your key - a free Etherscan, Blockscout or Alchemy key; which key covers which network is in the table below. Requests go from your phone straight to the service, bypassing PnL servers.
  • Don’t load history - the balance is shown, and the entry counts from when you added the address.

Until you choose, nothing goes through the PnL server. If you've already entered your own key, PnL uses it and doesn't ask.

IN THE APP03

Where to choose and where to change it.

  • When history can't be read, the wallet card shows a line such as “Polygon history can’t be read: the explorer is closed to apps” and a Choose a way button. You can close the choice without answering: the line stays, and you can choose later.
  • To change your choice or enter keys: Portfolio → Wallets → Wallet history, or Settings → Data → Wallet history.
  • In Phone only mode, Via the PnL server is unavailable; the other options work. Your choice isn't erased: turn the mode off and everything is back as it was.
  • On a Mac and on devices without App Attest, the PnL server isn't available for history: the app shows “On this device - your own key only”.
NETWORKS04

Which key for which network.

NetworkNo keyYour own free keyVia the PnL server
Ethereumyesnot needednot needed
Polygonno*Etherscan or Alchemyyes (Alchemy)
Arbitrumno*Blockscout, Etherscan or Alchemyyes (Blockscout)
Baseno*Alchemy onlyyes (Alchemy)
BNB Chainbalance; token history with the built-in MegaNode keyMegaNode, if there's no built-in keyno
Avalanche C-Chainyesnot needednot needed

* The public Blockscout is closed to apps right now; if it reopens, no key will be needed.

  • One key for all three networks: Alchemy. It's the only free key that covers Base.
  • A free Blockscout key covers Arbitrum; Polygon and Base only on a paid plan.
  • A free Etherscan key covers Polygon and Arbitrum; Base, BNB Chain and Avalanche only on a paid plan.
  • On Arbitrum, Alchemy doesn't return internal transfers (coins sent out of a contract), so Blockscout or Etherscan is the better key for Arbitrum.
  • Transfers of BNB itself (not tokens) can only be read with a paid Etherscan plan.
PNL SERVER05

Via the PnL server.

Nothing to enter: the server holds the keys, and the limit is shared by everyone.

  • Arbitrum: the server reads it from Blockscout.
  • Polygon and Base: from Alchemy, because free Blockscout doesn't serve these networks.
  • What the server sees and keeps is in the What the server sees card below.
ALCHEMY06

Alchemy key, step by step.

Works for Polygon, Base and Arbitrum; it's the only free key for Base. Free, no card needed.

  1. Open dashboard.alchemy.com and sign up with email or Google.
  2. Tap Create App and give it any name, for example PnL.
  3. Turn the networks on - the key won't work without this step. In the app, open Endpoints on the left (it may be called Networks), find Polygon PoS (Polygon Mainnet), Base (Base Mainnet) and Arbitrum (Arbitrum Mainnet) and tap Enable on each. Only Ethereum is on by default, and on other networks the key answers “… is not enabled for this app”, with the network name in place of the dots, for example MATIC_MAINNET.
  4. Copy the API Key (top right, Copy button) and paste it into PnL: Portfolio → Wallets → Wallet history → Alchemy key → Save and read history.

Free plan: 30 million compute units a month. That's far more than one person with several wallets needs.

BLOCKSCOUT07

Blockscout key, step by step.

A free key covers Arbitrum. Blockscout serves Polygon and Base only on a paid plan, so use an Alchemy key for those. No card needed.

  1. Open dev.blockscout.com and sign in with email, Google or GitHub.
  2. Open the Keys section and tap Create API Key.
  3. Copy the key right away: it starts with proapi_ and is shown only once.
  4. Paste it into PnL: Portfolio → Wallets → Wallet history → Blockscout key → Save and read history.

Free plan: 100,000 credits a day at 20 credits per request, about 5,000 requests, and up to 5 requests per second.

ETHERSCAN08

Etherscan key, step by step.

A free key covers Polygon and Arbitrum. Etherscan serves Base, BNB Chain and Avalanche only on a paid plan, so use an Alchemy key for Base.

  1. Sign up at etherscan.io/register and confirm your email from the message you get.
  2. Log in and open etherscan.io/myapikey (profile menu → API Keys).
  3. Tap Add, name the key, for example PnL, and create it.
  4. Copy the API Key and paste it into PnL: Portfolio → Wallets → Wallet history → Etherscan key → Save and read history.

Free plan: up to 3 requests per second and 100,000 a day.

BNB CHAIN09

MegaNode key, step by step.

BNB Chain token history is read with a MegaNode (NodeReal) key, and the app already has a shared one built in: if the BNB Chain history screen says “The app's built-in key is active - nothing to enter”, there's nothing to do. You only need your own free key if there's no built-in one:

  1. Open dashboard.nodereal.io and sign up with email and password; no card needed.
  2. Tap Create App (or App Store → BNB Smart Chain Mainnet).
  3. Copy the API Key from the app card: a string of letters and digits.
  4. Paste it into PnL: Wallet history → BNB Chain history → MegaNode (NodeReal) key → Save and read history. Lots and the average entry price build themselves.

MegaNode returns token history only: transfers of BNB itself can be read only with a paid Etherscan plan. You can set the BNB entry with a manual lot.

LIMITS10

Limits, and what happens when they run out.

  • Your own key has your personal limit: 30 million compute units a month on Alchemy, about 5,000 requests a day on Blockscout, 100,000 on Etherscan.
  • The PnL server has a shared daily limit for everyone and separate ones for each device and each IP address. When it runs out, the wallet card shows “The PnL server has used up its daily limit - you can add your own key”. The limit resets at the start of the day in UTC (00:00 UTC), and your own key works right away.
  • History that's already been read doesn't disappear when an explorer or the server refuses: lots and entry prices stay, and new transfers arrive with the next refresh.
IF IT DOESN'T WORK11

Common causes.

  • “Base history can’t be read: the explorer is closed to apps” - no option chosen yet, or your key doesn't cover this network: only an Alchemy key reads Base for free. Tap Choose a way.
  • You added an Alchemy key, but “Polygon history can’t be read…” (or Base, Arbitrum) - that network isn't turned on in your Alchemy dashboard. Open your app at dashboard.alchemy.com → Endpoints and tap Enable on Polygon, Base and Arbitrum. Alchemy itself then answers “… is not enabled for this app” (for example, “MATIC_MAINNET is not enabled for this app”) - you'll see it if you open the key's URL in a browser.
  • You added a Blockscout key, but “Polygon history can’t be read…” or Base - a free Blockscout key doesn't serve these networks, and the app moves on to the next option. Add an Alchemy key for Polygon and Base. Blockscout itself then answers 402 “Featured chain … requires one of the following plans”.
  • You added an Etherscan key, but “Base history can’t be read…” - a free Etherscan key doesn't serve Base (nor BNB Chain and Avalanche). Add an Alchemy key for Base.
  • The Blockscout key isn't accepted - it wasn't copied in full. The key starts with proapi_, with no spaces at the ends. A lost key can't be recovered: create a new one in the Keys section.
  • Via the PnL server is unavailable - Phone only mode is on, or the device doesn't support the App Attest check (a Mac, older models). Choose Your key.
  • Still stuck? Report the problem right from the app.
PRIVACY12

What the server sees.

With Via the PnL server, feedback.getpnl.app receives the wallet address, the network and the kind of request, passes them to Blockscout (Arbitrum) or Alchemy (Polygon, Base) and returns the answer. The address isn't recorded anywhere on its own: not in logs, not in a database. The answer (which contains the address) stays in the server cache for up to 10 minutes so that a repeated refresh doesn't use up the shared limit. It can be found only by the same request: the cache key is a fingerprint of the request made with the server's secret key, not the address itself. A token reference - a token's symbol and decimals by its contract - is kept for up to 7 days: it describes the token, not you. For the limits, the server keeps daily counters without addresses: under a fingerprint of the device-check key, under a fingerprint of the IP address (made with the server's secret key, new every day) and in total. They are deleted after 2 days. Each request is confirmed with the free plan pass (App Attest) of the genuine app, and the server doesn't record any link between the pass and the address. Blockscout and Alchemy see the address and the request, but not your phone's IP, only the server's.

With your own key, requests go from your phone straight to Etherscan, Blockscout or Alchemy: the service sees the address and your phone's IP, and the PnL server sees nothing. The key is stored in the device Keychain (and in iCloud Keychain, if it's on) and goes only to its own service. Details are in the Privacy Policy.

What an API key is, and safety rules · Won't connect? Common errors · How to report a problem