Оригинальный заголовок: «Точное вычисление PnL на Polymarket: почему ваши расчёты могут быть полностью ошибочными»
Автор оригинала: Leo, аналитик по криптовалютам

Я полгода занимаюсь автоматической торговлей на Polymarket, и самая большая ошибка, которую я совершил, — это не сбой стратегии, а то, что я неправильно посчитал, сколько именно заработал или потерял.

Это не из-за моей некомпетентности. Само вычисление PnL в PM — это минное поле. Официальный API даёт неверные цифры, сторонние аналитические сайты показывают неправильные рейтинги. Вы пишете скрипт для подсчёта? Скорее всего, тоже ошибаетесь.

Насколько большие расхождения? Третье место в рейтинге, kch123, по ошибочной методике посчитал убыток в 3,5 миллиона долларов, а фактическая прибыль — 11,4 миллиона долларов. Это не просто несколько процентов — даже знак прибыли и убытка перепутан.

В этой статье я подробно разберу каждую ошибку, которую я совершил. Трейдерам, разработчикам инструментов, следящим за рейтингами — рано или поздно столкнутся.

Ошибка 1: cashPnl не включает уже закрытую прибыль

Самый очевидный способ: взять API /positions, сложить поля cashPnl (наличные прибыль и убытки).

На практике проверка трёх адресов из топ-15 показала:

swisstony: сумма cashPnl +$35 000, реальный рейтинг +$5,6 миллиона, разница в 158 раз

kch123: сумма cashPnl —$3,52 миллиона, реальный рейтинг +$11,4 миллиона, знак перепутан

gmanas: сумма cashPnl —$2,64 миллиона, реальный рейтинг +$5,02 миллиона, знак перепутан

Три адреса, два случая, когда знак прибыли и убытка был просто перепутан.

Причина: API /positions возвращает cashPnl без учёта уже закрытых/выкупленных реализованных PnL. Если позиция выиграла и была автоматически выкуплена в USDC, она исчезает из ответа API. Остаются только незакрытые позиции — зачастую с убытками.

Вы думаете, что считаете всю прибыль и убытки? На самом деле — только незакрытые части.

Ошибка 2: поле makerPnl не совпадает с денежными потоками на блокчейне

В JSONL с данными о сделках есть поле makerPnl (прибыль/убыток маркетмейкера), по названию — для подсчёта PnL. Не верьте.

Я заметил, что сумма makerPnl по сценарию не совпадает с результатами учёта денежных потоков на блокчейне — разница в порядке величины. Конкретное соотношение зависит от ситуации, но направление одинаковое: внутренняя логика makerPnl не совпадает с реальными USDC-движениями.

Независимо от размера расхождения: не используйте это поле для подсчёта PnL.

Ошибка 3: нельзя считать по txHash отдельно для устранения дублирующих записей

Это самое противоречивое.

Один и тот же txHash (хеш транзакции) может встречаться несколько раз. Обычно — реакция: дубли, нужно удалять.

Но так делать нельзя. В CLOB Polymarket (он же on-chain order book) в одной транзакции могут быть выполнены несколько ордеров маркетмейкеров, и все эти записи — реальные отдельные сделки.

Раньше я удалял дубли по txHash + активу, и из-за этого недосчитался 133 долларов на стороне BUY. Проверка на Polygon показала: один txHash действительно содержит несколько отдельных USDC Transfer событий, каждое — реальная сделка.

Вывод: нельзя удалять дубли только по txHash. Для подсчёта PnL нужно просто суммировать исходные данные /activity.

Ошибка 4: лимит по offset при пагинации

При использовании API /activity для пагинации через offset — при превышении 3000 записей возникает ошибка 400. В документации об этом не написано.

Все три проверенных адреса подтвердили: запрос GET /activity?offset=3100 возвращает HTTP 400 с сообщением, что превышен лимит — max historical activity offset of 3000 exceeded. У крупных игроков часто более 10 000 сделок, 3000 — недостаточно.

Использование параметра end (указание времени последней записи предыдущей страницы минус 1) в качестве курсора не имеет ограничений.

Ошибка 5: различия в методиках подсчёта PnL в рейтинге

После подсчёта PnL одного адреса и сравнения с рейтингом — есть расхождения.

В большинстве случаев разница не превышает $10 (из-за колебаний стоимости позиций). Но если разница заметно больше, возможные причины: разные окна агрегации в рейтинге, задержки обновления кеша или привязка нескольких прокси-кошельков к одному аккаунту.

На практике, результаты по cash flow очень точно совпадают с API lb-api.polymarket.com/profit?window=all&address=X. Если есть большие расхождения — сначала проверьте, не пропущена ли страница (ошибка 4), не использовались ли неправильные поля (ошибки 1-2).

Правильный подход

После экспериментов я пришёл к выводу, что самый надёжный способ — использовать Data API для подсчёта денежных потоков. Без предварительных вычислений, просто исходя из исходных сделок.

Формула:

PnL = SUM(TRADE, где side=SELL) + SUM(REDEEM) + SUM(MERGE) + SUM(MAKER_REBATE) + SUM(REWARD) - SUM(TRADE, где side=BUY) - SUM(SPLIT) + рыночная стоимость позиций

· TRADE BUY: покупка токена за USDC (расход)

· TRADE SELL: продажа токена и получение USDC (доход)

· REDEEM: выкуп выигранной позиции за USDC (доход)

· SPLIT: создание токена из USDC (расход)

· MERGE: объединение токенов обратно в USDC (доход)

· MAKER_REBATE: вознаграждение маркетмейкера (доход)

· REWARD: награды/аирдропы (доход)

· Источник данных:

GET /activity?user=