Skip to content
ModeAlert

Developers

ModeAlert API

Read-only REST API for normalized game event and mode status across 15+ games — URF/Arena rotations, season passes, item shops, platform status, and more, in one consistent shape instead of building a scraper per game.

Access

Free and self-serve — sign in to ModeAlert and generate a key from Dashboard → Settings. No approval wait, up to 5 keys per account. Building something bigger, or want a higher limit? Email support@modealert.app.

Authentication

Pass your key as a bearer token on every request:

curl https://www.modealert.app/api/v1/events \
  -H "Authorization: Bearer mdlrt_live_..."

300 requests / hour per key. Requests over the limit return 429.

Endpoints

GET/api/v1/games

Every supported game — id, slug, name, logo, color.

GET/api/v1/events

Current events. Filter with ?game=<slug>&category=<PLAYABLE|SEASON_PASS|ROTATION_MILESTONE|COSMETIC_SHOP|PLATFORM_STATUS>&status=<LIVE|UPCOMING|TRACKING|ENDED>&limitedTime=<true|false>. Paginate with ?limit=&offset=.

GET/api/v1/events/:slug

A single event's current status.

GET/api/v1/events/:slug/history

Every recorded LIVE/TRACKING window for this event (or its full recurring series, when one exists).

GET/api/v1/events/:slug/statistics

Appearance count, average duration, first/last seen — computed from history.

Example

curl "https://www.modealert.app/api/v1/events?game=league-of-legends&limitedTime=true" \
  -H "Authorization: Bearer mdlrt_live_..."