getpnl.app
ИНСТРУКЦИЯ / ОБОЗРЕВАТЕЛИ

История кошельков.

Баланс кошелька PnL читает по адресу, без ключей. Для цены входа и реализованного PnL нужна ещё история переводов, а её отдают обозреватели блоков. В некоторых сетях обозреватель закрыт для приложений, и тогда вы сами выбираете, как её читать. Выбор появился в версии 1.3.2.

ЗАЧЕМ01

Что даёт история.

По истории переводов PnL строит лоты: приход монеты - покупка по цене на дату, уход - продажа самых старых лотов (FIFO). Из лотов получаются средняя цена входа и реализованный PnL по кошельку.

Без истории баланс и стоимость видны как обычно, а вход считается с момента, когда приложение впервые увидело монеты. Его можно задать и вручную, в кошельке.

ВЫБОР02

Polygon, Arbitrum и Base: три способа.

Публичные обозреватели Blockscout этих сетей с осени 2026 года пускают только браузеры, а запросы приложений отклоняют. PnL всё равно спрашивает их первыми: если защиту снимут, история заработает сама. Пока она стоит, нужен один из способов:

  • «Через сервер PnL» - вводить ничего не нужно. Приложение отправляет на сервер PnL адрес кошелька и сеть, сервер спрашивает историю своими ключами и возвращает ответ (подробнее - ниже).
  • «Свой ключ» - бесплатный ключ Etherscan, Blockscout или Alchemy; какой ключ подходит к какой сети - в таблице ниже. Запросы идут с телефона прямо к сервису, мимо серверов PnL.
  • «Не загружать историю» - баланс виден, а вход считается с момента добавления адреса.

Пока вы ничего не выбрали, через сервер PnL ничего не уходит. Если свой ключ уже введён, PnL берёт его и не спрашивает.

В ПРИЛОЖЕНИИ03

Где выбрать и где поменять.

  • Когда история не читается, на карточке кошелька появляется строка, например «История Polygon не читается: обозреватель закрыт для приложений», и кнопка «Выбрать способ». Окно выбора можно закрыть без ответа: строка останется, выбрать можно позже.
  • Поменять выбор и ввести ключи: «Портфель» → «Кошельки» → «История кошельков» или «Настройки» → «Данные» → «История кошельков».
  • В режиме «Только на телефоне» вариант «Через сервер PnL» недоступен, остальные работают. Ваш выбор при этом не стирается: выключите режим, и всё вернётся как было.
  • На Mac и на устройствах без проверки App Attest сервер PnL для истории недоступен: там приложение покажет «На этом устройстве - только свой ключ».
СЕТИ04

Какой ключ для какой сети.

СетьБез ключаСвой бесплатный ключЧерез сервер PnL
Ethereumдане нуженне нужен
Polygonнет*Etherscan или Alchemyда (Alchemy)
Arbitrumнет*Blockscout, Etherscan или Alchemyда (Blockscout)
Baseнет*только Alchemyда (Alchemy)
BNB Chainбаланс; история токенов - встроенным ключом MegaNodeMegaNode, если встроенного ключа нетнет
Avalanche C-Chainдане нуженне нужен

* Публичный Blockscout сейчас закрыт для приложений; если его откроют, ключ не понадобится.

  • Один ключ на все три сети - Alchemy. Base бесплатно отдаёт только он.
  • Бесплатный ключ Blockscout отдаёт Arbitrum, а Polygon и Base - только на платном тарифе.
  • Бесплатный ключ Etherscan отдаёт Polygon и Arbitrum, а Base, BNB Chain и Avalanche - только на платном тарифе.
  • В Arbitrum Alchemy не отдаёт внутренние переводы (монеты, пришедшие из контракта), поэтому для Arbitrum лучше Blockscout или Etherscan.
  • Переводы самой монеты BNB (не токенов) читает только платный Etherscan.
СЕРВЕР PNL05

Через сервер PnL.

Вводить ничего не нужно: ключи - у сервера, лимит общий на всех.

  • Arbitrum сервер читает у Blockscout.
  • Polygon и Base - у Alchemy: бесплатный Blockscout эти сети не отдаёт.
  • Что сервер видит и что хранит - в карточке «Что видит сервер» ниже.
ALCHEMY06

Ключ Alchemy - по шагам.

Подходит для Polygon, Base и Arbitrum, Base бесплатно читает только он. Бесплатно, карта не нужна.

  1. Откройте dashboard.alchemy.com и зарегистрируйтесь: почта или Google.
  2. Нажмите «Create App» и назовите приложение как угодно, например PnL.
  3. Включите сети - без этого шага ключ не работает. В приложении откройте раздел Endpoints слева (может называться Networks), найдите Polygon PoS («Polygon Mainnet»), Base («Base Mainnet») и Arbitrum («Arbitrum Mainnet») и у каждой нажмите «Enable». По умолчанию включён только Ethereum, и на остальные сети ключ отвечает «… is not enabled for this app» - на месте многоточия имя сети, например MATIC_MAINNET.
  4. Скопируйте API Key (вверху справа, кнопка «Copy») и вставьте в PnL: «Портфель» → «Кошельки» → «История кошельков» → «Ключ Alchemy» → «Сохранить и прочитать историю».

Бесплатный план: 30 млн единиц в месяц. Одному человеку с несколькими кошельками этого хватает с огромным запасом.

BLOCKSCOUT07

Ключ Blockscout - по шагам.

Бесплатный ключ подходит для Arbitrum. Polygon и Base Blockscout отдаёт только на платном тарифе - для них берите ключ Alchemy. Карта не нужна.

  1. Откройте dev.blockscout.com и войдите: почта, Google или GitHub.
  2. Откройте раздел Keys и нажмите «Create API Key».
  3. Сразу скопируйте ключ: он начинается с proapi_ и показывается один раз.
  4. Вставьте его в PnL: «Портфель» → «Кошельки» → «История кошельков» → «Ключ Blockscout» → «Сохранить и прочитать историю».

Бесплатный план: 100 000 кредитов в сутки, один запрос - 20 кредитов, это около 5 000 запросов, и до 5 запросов в секунду.

ETHERSCAN08

Ключ Etherscan - по шагам.

Бесплатный ключ подходит для Polygon и Arbitrum. Base, BNB Chain и Avalanche Etherscan отдаёт только на платном тарифе, поэтому для Base берите ключ Alchemy.

  1. Зарегистрируйтесь на etherscan.io/register и подтвердите почту по письму.
  2. Войдите и откройте etherscan.io/myapikey (меню профиля → API Keys).
  3. Нажмите «Add», назовите ключ, например PnL, и создайте его.
  4. Скопируйте строку API Key и вставьте в PnL: «Портфель» → «Кошельки» → «История кошельков» → «Ключ Etherscan» → «Сохранить и прочитать историю».

Бесплатный план: до 3 запросов в секунду и 100 000 в сутки.

BNB CHAIN09

Ключ MegaNode - по шагам.

Историю токенов BNB Chain читает ключ MegaNode (NodeReal), и в приложение уже встроен общий ключ: если на экране «История BNB Chain» написано «Работает встроенный ключ приложения - вводить ничего не нужно», делать ничего не надо. Свой бесплатный ключ нужен, только если встроенного нет:

  1. Откройте dashboard.nodereal.io и зарегистрируйтесь: почта и пароль, карта не нужна.
  2. Нажмите «Create App» (или «App Store» → «BNB Smart Chain Mainnet»).
  3. В карточке приложения скопируйте API Key - строку из букв и цифр.
  4. Вставьте её в PnL: «История кошельков» → «История BNB Chain» → «Ключ MegaNode (NodeReal)» → «Сохранить и прочитать историю». Лоты и средняя цена входа построятся сами.

MegaNode отдаёт историю только токенов: переводы самой BNB читает лишь платный Etherscan. Вход по BNB можно задать лотом вручную.

ЛИМИТЫ10

Лимиты и что будет, если они кончатся.

  • Свой ключ - лимит ваш личный: у Alchemy 30 млн единиц в месяц, у Blockscout около 5 000 запросов в сутки, у Etherscan 100 000.
  • У сервера PnL общий дневной лимит на всех и отдельные - на каждое устройство и на каждый IP-адрес. Когда он исчерпан, на карточке кошелька появится «Сервер PnL исчерпал дневной лимит - можно подключить свой ключ». Лимит обновляется в начале суток по Гринвичу (00:00 UTC), а свой ключ работает сразу.
  • Уже прочитанная история не пропадает, если обозреватель или сервер отказал: лоты и цена входа остаются, новые переводы подтянутся при следующем обновлении.
ЕСЛИ НЕ РАБОТАЕТ11

Частые причины.

  • «История 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, старые модели). Выберите «Свой ключ».
  • Не помогло - напишите о проблеме прямо из приложения.
ПРИВАТНОСТЬ12

Что видит сервер.

В режиме «Через сервер 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-ключ и правила безопасности · Не подключается? Частые ошибки · Как сообщить о проблеме