Только чтение. В APP_MODE=mints старые API полного режима отключены. Gonka опрашивается только для исходных операций моста и связанных адресов.
amount_raw — точная целая строка nWGNK, amount — десятичная строка (9 знаков). ts — Unix UTC; time_local — ISO со смещением, timezone = Asia/Nicosia. Дневные агрегаты учитывают летнее/зимнее время.
coverage содержит реальные обработанные интервалы, блок создания контракта и финальный блок. Предварительные события не входят в итоги по умолчанию.
daily содержит общий raw (nWGNK), quote_raw (микро-USDT) и раздельные bought_raw/sold_raw, buy_quote_raw/sale_quote_raw, buys_count/sales_count. Покупки + продажи равны общему объёму дня. Все суммы — точные целые строки, не float. Агрегаты учитывают всю отфильтрованную историю до limit/offset; price_raw — взвешенная цена дня в USDT за 1 WGNK, 12 знаков.
side=all объединяет покупки и продажи, сохраняя раздельные summary.sold/bought, sale_quote/buy_quote и средние цены по каждой стороне. kind_asc/kind_desc сортирует по стороне сделки. summary.volume/quote и average_price при side=all — общий валовой оборот и взвешенная цена всех исполнений, не прибыль и не сальдо.
Минтеры содержат first_mint_ts, last_mint_ts и mint_count: первая/последняя подтверждённая чеканка и количество выпусков до блока snapshot. Эти данные не зависят от торговых фильтров.
Объёмы и балансы показаны без дробной части. Все цены — USDT за 1 WGNK, с точкой и округлением до 6 десятичных знаков; ненулевая цена ниже точности отображения обозначается «< 0.000001». API price остаётся USDT за 1 WGNK с точностью до 12 знаков. Торговля самим GNK в этой ленте не отслеживается.
/api/mints/flows?side=sell, side=buy — покупки. minimum — минимальный объём одного Swap в целых WGNK, от 0 до 1 000 000 000 000, включительно; по умолчанию 0. Порог применяется ко всей истории до сортировки и пагинации, а также к торговым итогам и графику. minimum, hours и q независимы от порога ленты моста. Полный адрес требует подтверждённого оттока/притока WGNK у инициатора receipt; остальные hex-запросы ищут хеши транзакций.
sort: time, actor, amount, quote, price, pool, tx с суффиксом _asc или _desc; по умолчанию time_desc. Параметры limit/offset применяются после сортировки. Цена сравнивается как точное отношение целых чисел.
trades — выбранная сторона обменов, summary.volume — её оборот. Поле sales для совместимости содержит только продажи, при side=buy оно пустое. sold и bought не смешивают стороны. Все торговые агрегаты включают все адреса двух проверенных пулов, не только получателей чеканки.
minters — отдельный отчёт по адресам, получавшим WGNK при выпуске, и их продажам за всю историю. Он не зависит от minimum/side/hours/q. Продажи могут включать впоследствии купленные токены: индивидуальные партии не отслеживаются.
ready=false означает отсутствие сверенного снимка, а не нулевые показатели. snapshot задаёт единый финальный блок и сверку totalSupply / balanceOf с полной историей.
Цена продажи = USDT на выходе / WGNK на входе пула; цена покупки = USDT на входе / WGNK на выходе. Цены API округлены вниз до 12 знаков, без газа и возможных комиссий маршрутизатора. Оборот повторяемый, не доля уникальной эмиссии. Переводы и ликвидность не считаются покупками/продажами. Другие DEX, CEX и OTC не покрыты.
outside_holders в /api/mints/flows — распределение текущего баланса вне отслеживаемых пулов, независимо от minimum/side/hours/q/limit/offset. Инвесторы: bought_raw / (bought_raw + sold_raw) > 90%; продавцы: sold_raw / (bought_raw + sold_raw) > 90%; трейдеры: остальные адреса с подтверждённой торговлей, включая ровно 90/10. unclassified — нет подтверждённого положительного торгового объёма. Только положительные текущие балансы и сделки initiator_net двух пулов за всю финальную историю. Мост, переводы и LP не являются сделками. Категории условные; адрес не равен человеку.
outside_holders.total_raw — знаменатель долей владения, сумма текущих WGNK вне двух пулов. groups содержит id, balance_raw/balance, addresses и holders; каждый holder содержит address, balance_raw/balance, bought_raw/bought и sold_raw/sold. Балансы категорий и их списков точно сходятся с total_raw, адрес встречается в одной категории. Списки по умолчанию отсортированы по убыванию баланса. Денежные суммы в *_raw — целочисленные строки, порог проверяется точным целочисленным сравнением; проценты интерфейса не влияют на категорию. При отсутствии или расхождении сверенного баланса ready=false, total_raw=null — не 0. RPC дополнительно не вызывается.
/api/mints/address/{address}?sort=time_desc — полный Ethereum-адрес, все подтверждённые покупки и продажи одним ответом без пагинации. Поддерживает те же торговые сортировки. address_balance содержит amount/amount_raw, height, ts и source=verified_transfer_ledger. Баланс вычисляется по всем финальным событиям чеканки, сжиганий и переводов до блока snapshot, независимо от торговых фильтров; тот же блок ограничивает список сделок. Неподтверждённый баланс — null, не 0. В /api/mints/flows баланс также доступен при q, равном полному адресу.
/api/mints/trades возвращает только строки таблицы и поля total, offset, limit, has_more. Обязательны through — snapshot.height из ответа /api/mints/flows, и as_of — now из того же ответа. Параметры minimum, hours, q, side, sort должны совпадать с выбранной лентой. Снимок и граница периода сохраняются при листании, даже если индексатор уже получил новые блоки. limit: 1–200, offset: 0–5 000 000. Недоступный или ещё не проверенный снимок даёт ready=false. Запрос читает только сохранённые сделки, не обращается к RPC и не пересчитывает распределение балансов, графики или минтеров.
/api/mints/bridge?minimum=0 — явные WGNKMinted и WGNKBurned без повторного ERC-20 Transfer. Поддерживает minimum, hours, q, sort (time, kind, recipient, amount, tx, status с _asc/_desc), limit/offset. Только финальные события до сверенного snapshot, без предварительных сжиганий. address — минтер или адрес сжигания в зависимости от kind. На сайте по умолчанию minimum=0: видны все объёмы. Фильтр «Объём от» меняет minimum только для ленты моста и её CSV; итоговые карточки и график чеканки сохраняют всю историю.
Для чеканки minter_totals содержит minted_raw и sold_raw — целочисленные строки nWGNK, minted и sold — точные десятичные строки WGNK, sales_count — число подтверждённых исполнений продаж. Это вся история адреса до snapshot, без влияния фильтров и пагинации ленты. Продажи учитывают только initiator_net в отслеживаемых пулах и могут превышать чеканку: купленные и полученные переводом токены не отделяются от сминченных. У сжиганий minter_totals=null.
CSV всей ленты содержит точные суммы и тип операции; сжигание в Ethereum не подтверждает завершение обратного перевода в GNK.
/api/mints/provenance, необязательный address=полный Ethereum-адрес. Возвращает total, verified, pending, sources и links. Связи проверяются по финальному выпуску WGNK, BLS request ID, эпохе, сумме, получателю и успешному переводу GNK в эскроу исходного блока. Не доказывает общего владельца или добычу GNK.
Для обратного направления burns содержит total, verified, pending, items и links: все финальные сжигания адреса, включая адреса без чеканки. Статус completed и gnk_address появляются только при однозначном совпадении финального WGNKBurned с BRIDGE_COMPLETED в состоянии моста Gonka по Ethereum-блоку, индексу транзакции, контракту и точной сумме. evidence_url ведёт к записи проверки. verification=gonka_bridge_state; gnk_tx_hash и gnk_ts остаются null — транзакция выплаты отдельно не установлена. eth_ts — время сжигания. Остальные операции имеют status=unverified, а не фиктивное зачисление.
sources объединяет отправителей чеканки и получателей подтверждённых возвратов. mints / amount_raw / amount по-прежнему относятся только к GNK → WGNK, burns / burned_raw / burned — только к WGNK → GNK. Верхние total / verified / pending / links сохранены для чеканки. История и баланс Gonka доступны также для адресов, связанных только с возвратами. Все API только читают базу.
/api/mints/gonka/{address}?sort=time_desc — все сохранённые входящие GNK одним ответом, только для связанных с мостом адресов. sort: time, amount, sender, kind, tx с _asc/_desc. items: amount_raw (ngonka, 9 знаков), amount, src, source_label, ts, height, tx_hash, event_index, message_index, kind. Это отдельные события, не сводные суммы транзакций. Получение через CoinReceived не дублирует Transfer.
history.exhausted — конец доступной адресной ленты GonkaLabs, не независимое доказательство полноты сети. full_chain_verified=false: неиндексированные внутренние получатели и автоматические выплаты в событиях блока могут отсутствовать. source и coverage_note указывают границы. amount — сумма загруженных поступлений, не доход, баланс или доказанное происхождение проданных WGNK. Ошибки сохраняют ранее загруженные строки и курсор. API только читает кэш, не запускает внешний поиск.
address_balance — отдельный текущий банковский баланс GNK: address, amount_raw (ngonka), amount, height из заголовка Cosmos RPC, checked_at, scope=bank_balance. Средства в отдельных модулях вестинга и залога не включены. Баланс обновляется адресно примерно раз в минуту и хранится в SQLite. При сбое последний снимок остаётся, balance_status.error сообщает об ошибке; если успешного снимка не было — address_balance=null, не ноль. Сумма входящих переводов amount не является балансом.
/api/mints/leaders — вся доступная финальная история двух пулов. buyers и sellers содержат все ранжированные адреса: rank (по убыванию WGNK), address, volume_raw / volume, quote_raw / quote, average_price (USDT за 1 WGNK), swaps, transactions, first_ts, last_ts. summary.buy / sell — итоги адресов рейтинга; excluded.buy / sell — объём, USDT и исполнения без подтверждённой привязки. summary=null при ready=false, не нулевой оборот. Финальный snapshot, coverage и status указывают свежесть и полноту данных.
Критерий initiator_net совпадает с историей адреса: направление чистого потока WGNK у инициатора за всю транзакцию. Это не точная трассировка отдельного исполнения, не установление личности и не прибыль. Неопределённые сделки остаются в общем торговом обороте, но не попадают в рейтинг адресов. API читает имеющуюся базу и не запускает дополнительную индексацию.