История кошельков.
Баланс кошелька PnL читает по адресу, без ключей. Для цены входа и реализованного PnL нужна ещё история переводов, а её отдают обозреватели блоков. В некоторых сетях обозреватель закрыт для приложений, и тогда вы сами выбираете, как её читать. Выбор появился в версии 1.3.2.
Что даёт история.
По истории переводов PnL строит лоты: приход монеты - покупка по цене на дату, уход - продажа самых старых лотов (FIFO). Из лотов получаются средняя цена входа и реализованный PnL по кошельку.
Без истории баланс и стоимость видны как обычно, а вход считается с момента, когда приложение впервые увидело монеты. Его можно задать и вручную, в кошельке.
Polygon, Arbitrum и Base: три способа.
Публичные обозреватели Blockscout этих сетей с осени 2026 года пускают только браузеры, а запросы приложений отклоняют. PnL всё равно спрашивает их первыми: если защиту снимут, история заработает сама. Пока она стоит, нужен один из способов:
- «Через сервер PnL» - вводить ничего не нужно. Приложение отправляет на сервер PnL адрес кошелька и сеть, сервер спрашивает историю своими ключами и возвращает ответ (подробнее - ниже).
- «Свой ключ» - бесплатный ключ Etherscan, Blockscout или Alchemy; какой ключ подходит к какой сети - в таблице ниже. Запросы идут с телефона прямо к сервису, мимо серверов PnL.
- «Не загружать историю» - баланс виден, а вход считается с момента добавления адреса.
Пока вы ничего не выбрали, через сервер PnL ничего не уходит. Если свой ключ уже введён, PnL берёт его и не спрашивает.
Где выбрать и где поменять.
- Когда история не читается, на карточке кошелька появляется строка, например «История Polygon не читается: обозреватель закрыт для приложений», и кнопка «Выбрать способ». Окно выбора можно закрыть без ответа: строка останется, выбрать можно позже.
- Поменять выбор и ввести ключи: «Портфель» → «Кошельки» → «История кошельков» или «Настройки» → «Данные» → «История кошельков».
- В режиме «Только на телефоне» вариант «Через сервер PnL» недоступен, остальные работают. Ваш выбор при этом не стирается: выключите режим, и всё вернётся как было.
- На Mac и на устройствах без проверки App Attest сервер PnL для истории недоступен: там приложение покажет «На этом устройстве - только свой ключ».
Какой ключ для какой сети.
| Сеть | Без ключа | Свой бесплатный ключ | Через сервер PnL |
|---|---|---|---|
| Ethereum | да | не нужен | не нужен |
| Polygon | нет* | Etherscan или Alchemy | да (Alchemy) |
| Arbitrum | нет* | Blockscout, Etherscan или Alchemy | да (Blockscout) |
| Base | нет* | только Alchemy | да (Alchemy) |
| BNB Chain | баланс; история токенов - встроенным ключом MegaNode | MegaNode, если встроенного ключа нет | нет |
| Avalanche C-Chain | да | не нужен | не нужен |
* Публичный Blockscout сейчас закрыт для приложений; если его откроют, ключ не понадобится.
- Один ключ на все три сети - Alchemy. Base бесплатно отдаёт только он.
- Бесплатный ключ Blockscout отдаёт Arbitrum, а Polygon и Base - только на платном тарифе.
- Бесплатный ключ Etherscan отдаёт Polygon и Arbitrum, а Base, BNB Chain и Avalanche - только на платном тарифе.
- В Arbitrum Alchemy не отдаёт внутренние переводы (монеты, пришедшие из контракта), поэтому для Arbitrum лучше Blockscout или Etherscan.
- Переводы самой монеты BNB (не токенов) читает только платный Etherscan.
Через сервер PnL.
Вводить ничего не нужно: ключи - у сервера, лимит общий на всех.
- Arbitrum сервер читает у Blockscout.
- Polygon и Base - у Alchemy: бесплатный Blockscout эти сети не отдаёт.
- Что сервер видит и что хранит - в карточке «Что видит сервер» ниже.
Ключ Alchemy - по шагам.
Подходит для Polygon, Base и Arbitrum, Base бесплатно читает только он. Бесплатно, карта не нужна.
- Откройте dashboard.alchemy.com и зарегистрируйтесь: почта или Google.
- Нажмите «Create App» и назовите приложение как угодно, например PnL.
- Включите сети - без этого шага ключ не работает. В приложении откройте раздел Endpoints слева (может называться Networks), найдите Polygon PoS («Polygon Mainnet»), Base («Base Mainnet») и Arbitrum («Arbitrum Mainnet») и у каждой нажмите «Enable». По умолчанию включён только Ethereum, и на остальные сети ключ отвечает «… is not enabled for this app» - на месте многоточия имя сети, например MATIC_MAINNET.
- Скопируйте API Key (вверху справа, кнопка «Copy») и вставьте в PnL: «Портфель» → «Кошельки» → «История кошельков» → «Ключ Alchemy» → «Сохранить и прочитать историю».
Бесплатный план: 30 млн единиц в месяц. Одному человеку с несколькими кошельками этого хватает с огромным запасом.
Ключ Blockscout - по шагам.
Бесплатный ключ подходит для Arbitrum. Polygon и Base Blockscout отдаёт только на платном тарифе - для них берите ключ Alchemy. Карта не нужна.
- Откройте dev.blockscout.com и войдите: почта, Google или GitHub.
- Откройте раздел Keys и нажмите «Create API Key».
- Сразу скопируйте ключ: он начинается с proapi_ и показывается один раз.
- Вставьте его в PnL: «Портфель» → «Кошельки» → «История кошельков» → «Ключ Blockscout» → «Сохранить и прочитать историю».
Бесплатный план: 100 000 кредитов в сутки, один запрос - 20 кредитов, это около 5 000 запросов, и до 5 запросов в секунду.
Ключ Etherscan - по шагам.
Бесплатный ключ подходит для Polygon и Arbitrum. Base, BNB Chain и Avalanche Etherscan отдаёт только на платном тарифе, поэтому для Base берите ключ Alchemy.
- Зарегистрируйтесь на etherscan.io/register и подтвердите почту по письму.
- Войдите и откройте etherscan.io/myapikey (меню профиля → API Keys).
- Нажмите «Add», назовите ключ, например PnL, и создайте его.
- Скопируйте строку API Key и вставьте в PnL: «Портфель» → «Кошельки» → «История кошельков» → «Ключ Etherscan» → «Сохранить и прочитать историю».
Бесплатный план: до 3 запросов в секунду и 100 000 в сутки.
Ключ MegaNode - по шагам.
Историю токенов BNB Chain читает ключ MegaNode (NodeReal), и в приложение уже встроен общий ключ: если на экране «История BNB Chain» написано «Работает встроенный ключ приложения - вводить ничего не нужно», делать ничего не надо. Свой бесплатный ключ нужен, только если встроенного нет:
- Откройте dashboard.nodereal.io и зарегистрируйтесь: почта и пароль, карта не нужна.
- Нажмите «Create App» (или «App Store» → «BNB Smart Chain Mainnet»).
- В карточке приложения скопируйте API Key - строку из букв и цифр.
- Вставьте её в PnL: «История кошельков» → «История BNB Chain» → «Ключ MegaNode (NodeReal)» → «Сохранить и прочитать историю». Лоты и средняя цена входа построятся сами.
MegaNode отдаёт историю только токенов: переводы самой BNB читает лишь платный Etherscan. Вход по BNB можно задать лотом вручную.
Лимиты и что будет, если они кончатся.
- Свой ключ - лимит ваш личный: у Alchemy 30 млн единиц в месяц, у Blockscout около 5 000 запросов в сутки, у Etherscan 100 000.
- У сервера PnL общий дневной лимит на всех и отдельные - на каждое устройство и на каждый IP-адрес. Когда он исчерпан, на карточке кошелька появится «Сервер PnL исчерпал дневной лимит - можно подключить свой ключ». Лимит обновляется в начале суток по Гринвичу (00:00 UTC), а свой ключ работает сразу.
- Уже прочитанная история не пропадает, если обозреватель или сервер отказал: лоты и цена входа остаются, новые переводы подтянутся при следующем обновлении.
Частые причины.
- «История Base не читается: обозреватель закрыт для приложений» - способ ещё не выбран или свой ключ к этой сети не подходит: Base бесплатно читает только ключ Alchemy. Нажмите «Выбрать способ».
- Ключ Alchemy добавлен, а «История Polygon не читается…» (или Base, Arbitrum) - в кабинете Alchemy не включена эта сеть. Откройте своё приложение на dashboard.alchemy.com → Endpoints и нажмите «Enable» у Polygon, Base и Arbitrum. Сам Alchemy в этом случае отвечает «… is not enabled for this app» (например, «MATIC_MAINNET is not enabled for this app») - так видно, если открыть адрес ключа в браузере.
- Ключ Blockscout добавлен, а «История Polygon не читается…» или Base - бесплатный ключ Blockscout эти сети не отдаёт, приложение тогда переходит к следующему способу. Для Polygon и Base добавьте ключ Alchemy. Сам Blockscout в этом случае отвечает 402 «Featured chain … requires one of the following plans».
- Ключ Etherscan добавлен, а «История Base не читается…» - бесплатный ключ Etherscan Base не отдаёт (как и BNB Chain и Avalanche). Для Base добавьте ключ Alchemy.
- Ключ Blockscout не принят - он скопирован не целиком. Ключ начинается с proapi_, без пробелов по краям. Потерянный ключ не восстановить: создайте новый в разделе Keys.
- «Через сервер PnL» недоступен - включён режим «Только на телефоне» или устройство не поддерживает проверку App Attest (Mac, старые модели). Выберите «Свой ключ».
- Не помогло - напишите о проблеме прямо из приложения.
Что видит сервер.
В режиме «Через сервер PnL» сервер feedback.getpnl.app получает адрес кошелька, сеть и вид запроса, передаёт их Blockscout (Arbitrum) или Alchemy (Polygon, Base) и возвращает ответ. Отдельно адрес нигде не записывается: ни в журналы, ни в базу. Ответ (в нём есть адрес) сервер держит в кэше до 10 минут, чтобы повторное обновление не тратило общий лимит. Найти ответ можно только тем же запросом: ключ кэша - отпечаток запроса с секретным ключом сервера, а не сам адрес. Справочник токенов - символ и число знаков после запятой по контракту - хранится до 7 дней: это сведения о токене, а не о вас. Для лимитов сервер ведёт суточные счётчики без адресов: под отпечатком ключа проверки устройства, под отпечатком IP-адреса (с секретным ключом сервера, каждый день новым) и общий. Они удаляются через 2 дня. Запрос подтверждается пропуском бесплатного плана (App Attest) настоящего приложения, а связь пропуска с адресом сервер не записывает. Blockscout и Alchemy видят адрес и запрос, но не IP вашего телефона, только IP сервера.
Со своим ключом запросы идут с телефона прямо к Etherscan, Blockscout или Alchemy: сервис видит адрес и IP телефона, сервер PnL не видит ничего. Ключ хранится в Keychain устройства (и в Связке ключей iCloud, если она включена) и уходит только своему сервису. Подробно - в политике конфиденциальности.
Что такое API-ключ и правила безопасности · Не подключается? Частые ошибки · Как сообщить о проблеме