# Splatoon 3 API > Splatoon 3 live game data as an API, powered by the community project splatoon3.ink. Get the current and upcoming battle rotations for every mode — Turf War (Regular Battle), Anarchy Battle Series and Open, and X Battle — each with the rule (Splat Zones, Tower Control, Rainmaker, Clam Blitz) and the two stages in rotation; the Salmon Run co-op schedules with the stage, the four supplied weapons and the boss; the SplatNet (Gesotown) gear shop with the pickup-brand gear and the daily limited gear including price, brand, primary ability and slots; and the current and upcoming Splatfests for each region (US, EU, JP, AP) with their teams. Ideal for Splatoon companion apps, Discord bots, rotation widgets, stream overlays and community tools. Times are ISO 8601 UTC. Unofficial — data via splatoon3.ink, not affiliated with or endorsed by Nintendo. ## Authentication All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys. ```bash curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/splatoon-api/..." ``` ## Pricing - **Free** (Free) — 1,500 calls/Mo, 2 req/s - **Starter** ($4/Mo) — 40,000 calls/Mo, 10 req/s - **Pro** ($10/Mo) — 180,000 calls/Mo, 25 req/s - **Mega** ($30/Mo) — 700,000 calls/Mo, 60 req/s ## Endpoints ### Battles #### `GET /v1/schedules` — Battle rotations for a mode **Parameters:** - `mode` (query, optional, string) — regular|bankara-open|bankara-challenge|x Example: `regular` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/splatoon-api/v1/schedules?mode=regular" ``` **Response:** ```json { "data": { "mode": "regular", "count": 12, "current": { "end": "2026-06-01T10:00:00Z", "rule": "Turf War", "start": "2026-06-01T08:00:00Z", "stages": [ { "id": "VnNTdGFnZS0xNg==", "name": "Wahoo World", "image": "https://splatoon3.ink/assets/splatnet/v3/stage_img/icon/low_resolution/61ea801fa4ed32360dcaf83986222ded46a72dbf56194acc6d0cf4659a92ba85_1.png" }, { "id": "VnNTdGFnZS0yNA==", "name": "Lemuria Hub", "image": "https://splatoon3.ink/assets/splatnet/v3/stage_img/icon/low_resolution/2ba481293efc554ac217f21b6d56dd08f9d66e72b286f20714abd5ef1520f47a_1.png" } ] }, "schedules": [ { "end": "2026-06-01T10:00:00Z", "rule": "Turf War", "start": "2026-06-01T08:00:00Z", "stages": [ { "id": "VnNTdGFnZS0xNg==", "name": "Wahoo World", "image": "https://splatoon3.ink/assets/splatnet/v3/stage_img/icon/low_resolution/61ea801fa4ed32360dcaf83986222ded46a72dbf56194acc6d0cf4659a92ba85_1.png" }, { "id": "VnNTdGFnZS0yNA==", "name": "Lemuria Hub", …(truncated, see openapi.json for full schema) ``` ### Salmon Run #### `GET /v1/salmonrun` — Salmon Run co-op schedules **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/splatoon-api/v1/salmonrun" ``` **Response:** ```json { "data": { "count": 5, "current": { "end": "2026-06-02T16:00:00Z", "boss": "Megalodontia", "stage": "Salmonid Smokeyard", "start": "2026-06-01T00:00:00Z", "weapons": [ "Slosher", "Dynamo Roller", "Splash-o-matic", "Wellstring V" ], "king_salmonid": "Megalodontia" }, "schedules": [ { "end": "2026-06-02T16:00:00Z", "boss": "Megalodontia", "stage": "Salmonid Smokeyard", "start": "2026-06-01T00:00:00Z", "weapons": [ "Slosher", "Dynamo Roller", "Splash-o-matic", "Wellstring V" ], "king_salmonid": "Megalodontia" }, { "end": "2026-06-04T08:00:00Z", "boss": "Cohozuna", "stage": "Spawning Grounds", "start": "2026-06-02T16:00:00Z", "weapons": [ "Mint Decavitator", "Bloblobber", "Carbon Roller", "E-liter 4K" ], "king_salmonid": "Cohozuna" }, { "end": "2026-06-06T00:00:00Z", "boss": "Horrorboros", "stage": "Gone Fission Hyd …(truncated, see openapi.json for full schema) ``` ### Gear #### `GET /v1/gear` — The SplatNet gear shop **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/splatoon-api/v1/gear" ``` **Response:** ```json { "data": { "pickup_gear": [ { "name": "Annaki Beret", "type": "HeadGear", "brand": "Annaki", "price": 17250, "slots": 3, "sale_end": "2026-06-02T00:00:00Z", "primary_ability": "Ink Recovery Up" }, { "name": "Annaki Red Cuff", "type": "ClothingGear", "brand": "Annaki", "price": 9600, "slots": 2, "sale_end": "2026-06-02T00:00:00Z", "primary_ability": "Run Speed Up" }, { "name": "Annaki Tigers", "type": "ShoesGear", "brand": "Annaki", "price": 14985, "slots": 3, "sale_end": "2026-06-02T00:00:00Z", "primary_ability": "Intensify Action" } ], "limited_gear": [ { "name": "Deepsea Leather Boots", "type": "ShoesGear", "brand": "Rockenberg", "price": 18000, "slots": 3, "sale_end": "2026-06-01T12:00:00Z", "primary_ability": "Object Shredder" }, { "name": "Whale-Knit Sweater", "type": "ClothingGear", "brand": "Splash Mob", "price": 14475, …(truncated, see openapi.json for full schema) ``` ### Splatfest #### `GET /v1/splatfest` — Splatfests by region **Parameters:** - `region` (query, optional, string) — US|EU|JP|AP Example: `EU` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/splatoon-api/v1/splatfest?region=EU" ``` **Response:** ```json { "data": { "count": 10, "active": null, "region": "EU", "festivals": [ { "id": "RmVzdC1FVTpKVUVBLTAwMTA2", "end": "2026-04-13T00:00:00Z", "start": "2026-04-11T00:00:00Z", "state": "CLOSED", "teams": [ { "name": "Baby Chicks", "color": "rgba(162,204,65)" }, { "name": "Li'l Bunnies", "color": "rgba(235,117,156)" }, { "name": "Bear Cubs", "color": "rgba(81,209,200)" } ], "title": "It's spring! A time for fuzzy fluffiness!" }, { "id": "RmVzdC1FVTpKVUVBLTAwMTA1", "end": "2026-01-12T00:00:00Z", "start": "2026-01-10T00:00:00Z", "state": "CLOSED", "teams": [ { "name": "Friends", "color": "rgba(61,98,199)" }, { "name": "Family", "color": "rgba(179,132,23)" }, { "name": "Solo", "color": "rgba(239,219,171)" } …(truncated, see openapi.json for full schema) ``` ### Meta #### `GET /v1/meta` — Usage notes **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/splatoon-api/v1/meta" ``` **Response:** ```json { "data": { "note": "Splatoon 3 live game data. /v1/schedules?mode=regular = the current and upcoming battle rotations for a mode (regular = Turf War, bankara-open & bankara-challenge = Anarchy, x = X Battle) with the rule and stages; /v1/salmonrun = the Salmon Run co-op schedules (stage, the four supplied weapons, boss); /v1/gear = the SplatNet (Gesotown) gear shop — the pickup-brand gear and the daily limited gear with price, brand, primary ability and slots; /v1/splatfest?region=EU = the current and upcoming Splatfests for a region (US, EU, JP, AP) with teams. Times are ISO 8601 UTC. Unofficial; data via splatoon3.ink, a community project (not affiliated with Nintendo).", "source": "splatoon3.ink (Splatoon 3 live data)", "endpoints": [ "/v1/schedules", "/v1/salmonrun", "/v1/gear", "/v1/splatfest", "/v1/meta" ] }, "meta": { "timestamp": "2026-06-01T08:13:40.333Z", "request_id": "10096285-aba5-4b29-9433-a75925ab8ad3" }, "status": "ok", "message": "Meta retrieved", "success": true } ``` --- Marketplace page: https://www.oanor.com/api/splatoon-api OpenAPI spec: https://www.oanor.com/api/splatoon-api/openapi.json