ToolsGambling
TG
/rtp / api

Бесплатный публичный API

JSON-эндпоинты к базе RTP слотов. В первой версии авторизация не нужна. Лимит: 1 000 запросов в сутки с одного IP. Тариф Pro с ключами и квотой в десять раз больше появится вместе с оплатой.

Для кого это

  • Редакторы / авторы проверяют RTP в статьях. Запроси /api/rtp/[slug] со слагом вроде gates-of-olympus и поставь в материале ссылку на источник.
  • Разработчики строят инструменты для обзоров казино, движки сравнения и аналитические панели. Для массовых выборок бери /api/rtp/list с фильтром и постраничным выводом.
  • Дата-журналисты следят за тем, что делают провайдеры. Соедини эндпоинты реестра с /api/rtp/history, и получится временной ряд изменений RTP.

Все ответы приходят в JSON. CORS открыт (*). Данные под лицензией CC-BY 4.0: пользуйся свободно, только указывай авторство.

Все ответы приходят в JSON. Ключ для нулевой версии не нужен. CORS открыт (*). Запускай curl https://toolsgambling.com/api/rtp/list откуда угодно, без настройки и регистрации.

GET /api/rtp/list

Поиск по реестру с фильтрами, сортировкой и постраничным выводом.

Параметры запроса
qПроизвольный текст. Ищет по названию, слагу и провайдеру.
providerФильтр по ключу провайдера (напр. pragmatic-play).
game_typeslot · scratchcard · table · instant · bingo · keno
has_variants1 — только мультивариантные слоты.
sortname (по умолч.) · provider · rtp_desc · rtp_asc · variants_desc · recent
limit1–200, по умолч. 50
offsetСмещение выдачи, по умолч. 0
Пример
curl 'https://toolsgambling.com/api/rtp/list?provider=playngo&has_variants=1&limit=5'
▸ Как выглядит ответ (нажми, чтобы раскрыть)
{
  "meta": {
    "data_version": "1.0.0",
    "frozen_at": "2026-05-08T...",
    "total": 3646,
    "filtered": 391,
    "has_more": true,
    "query": { ... }
  },
  "facets": {
    "providers": [{ "provider": "...", "display": "...", "count": 620 }],
    "game_types": [{ "game_type": "slot", "count": 3561 }]
  },
  "items": [{
    "canonical_slug": "moon-princess",
    "canonical_name": "Moon Princess",
    "provider": "playngo",
    "provider_display": "Play'n GO",
    "stated_rtp": 96.5,
    "rtp_variants": [84.5, 87.5, 91.49, 94.51, 96.5],
    "rtp_min": 84.5,
    "rtp_max": 96.5,
    "variants_count": 5,
    "volatility": null,
    "max_win": null,
    "release_year": 2017,
    "game_type": "slot",
    "last_verified": "2026-05-08T...",
    "snapshot_id": "sha256:...",
    "source_url": "https://www.playngo.com/games/moon-princess",
    "badges": ["verified_rtp", "variants_tracked"],
    ...
  }]
}

GET /api/rtp/[slug]

Один канонический слот вместе с данными провайдера и расчётными полями.

Пример
curl 'https://toolsgambling.com/api/rtp/gates-of-olympus'
Ответ 404

Если слага в реестре нет, эндпоинт отдаёт HTTP 404 с телом {"statusCode": 404, "statusMessage": "slot not found in registry"}.

GET /widget/rtp/[slug]

Готовый виджет для встраивания. Отдаёт HTML, а не JSON.

<iframe src="https://toolsgambling.com/widget/rtp/gates-of-olympus"
        width="100%" height="220" frameborder="0" loading="lazy">
</iframe>
<p>RTP data by <a href="https://toolsgambling.com/rtp" rel="dofollow noopener">ToolsGambling RTP Calculator</a></p>

dark

hex (none убирает рамку), radius=0

Кэширование и лимиты

  • /api/rtp/list — кэш 5 минут на edge
  • /api/rtp/[slug] — кэш 1 час на edge
  • /widget/rtp/[slug] — кэш 1 час
Заголовки rate-limit в ответе
X-RateLimit-LimitОбщий лимит за период (сейчас 1 000)
X-RateLimit-RemainingСколько запросов осталось в текущих сутках
X-RateLimit-ResetUnix-секунды момента сброса счётчика

Превысишь лимит, и придёт HTTP 429 и JSON с временем сброса. Без лимита работают /api/rtp/provider/[provider], /api/rtp/history и /api/widget/rtp/[slug].

В коде из /rtp есть параметр ?v=. Он подсказывает CDN партнёра сбросить кэш; старые коды при этом продолжают работать, а сам роут виджета параметр не читает.

Нужно больше 1 000 в день?

Ключи раннего доступа мы выдаём вручную и под понятную задачу: партнёрские сайты, внутренние инструменты компаний отрасли, исследования и журналистские проекты.

Напиши на hello&#64;toolsgambling.com и коротко расскажи: hello@toolsgambling.com

  • твой сайт или компания
  • что делаешь и зачем нужна квота побольше
  • ожидаемый объём запросов (в день)

Формы самозаписи нет, автоматически ключи не выдаются. Отвечаем за несколько рабочих дней. White-label без атрибуции и личный кабинет с ключами выйдут вместе с тарифом Pro.