{"openapi":"3.1.0","info":{"title":"Splatoon 3 API","version":"1.0.0","description":"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.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/splatoon-api","description":"oanor gateway"}],"tags":[{"name":"Battles"},{"name":"Salmon Run"},{"name":"Gear"},{"name":"Splatfest"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/schedules":{"get":{"operationId":"get_v1_schedules","tags":["Battles"],"summary":"Battle rotations for a mode","description":"","parameters":[{"name":"mode","in":"query","required":false,"description":"regular|bankara-open|bankara-challenge|x","schema":{"type":"string"},"example":"regular"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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","image":"https://splatoon3.ink/assets/splatnet/v3/stage_img/icon/low_resolution/2ba481293efc554ac217f21b6d56dd08f9d66e72b286f20714abd5ef1520f47a_1.png"}]},{"end":"2026-06-01T12:00:00Z","rule":"Turf War","start":"2026-06-01T10:00:00Z","stages":[{"id":"VnNTdGFnZS0y","name":"Eeltail Alley","image":"https://splatoon3.ink/assets/splatnet/v3/stage_img/icon/low_resolution/898e1ae6c737a9d44552c7c81f9b710676492681525c514eadc68a6780aa52af_1.png"},{"id":"VnNTdGFnZS0xMA==","name":"Hammerhead Bridge","image":"https://splatoon3.ink/assets/splatnet/v3/stage_img/icon/low_resolution/1db8ab338b64b464df50e7f9e270e59423ff8caac6f09679a24f1b7acf3a82f3_1.png"}]},{"end":"2026-06-01T14:00:00Z","rule":"Turf War","start":"2026-06-01T12:00:00Z","stages":[{"id":"VnNTdGFnZS0z","name":"Hagglefish Market","image":"https://splatoon3.ink/assets/splatnet/v3/stage_img/icon/low_resolution/8dc2f16d39c630bab40cead5b2485ca3559e829d0d3de0c2232c7a62fefb5fa9_1.png"},{"id":"VnNTdGFnZS0xMw==","name":"Inkblot Art Academy","image":"https://splatoon3.ink/assets/splatnet/v3/stage_img/icon/low_resolution/40aba8b36a9439e2d670fde5b3478819ea8a94f9e503b9d783248a5716786f35_1.png"}]},{"end":"2026-06-01T16:00:00Z","rule":"Turf War","start":"2026-06-01T14:00:00Z","stages":[{"id":"VnNTdGFnZS03","name":"Brinewater Springs","image":"https://splatoon3.ink/assets/splatnet/v3/stage_img/icon/low_resolution/cd84d711b47a424334569ac20f33f8e0ab6a652dc07854dcd36508a0081e9034_1.png"},{"id":"VnNTdGFnZS0xOQ==","name":"Crableg Capital","image":"https://splatoon3.ink/assets/splatnet/v3/stage_img/icon/low_resolution/4e0e9e2046aff1d635e23946d9f0a461486d2aab349079e551037e426ac82c7a_1.png"}]},{"end":"2026-06-01T18:00:00Z","rule":"Turf War","start":"2026-06-01T16:00:00Z","stages":[{"id":"VnNTdGFnZS0xNw==","name":"Humpback Pump Track","image":"https://splatoon3.ink/assets/splatnet/v3/stage_img/icon/low_resolution/7b3cf118bd9f45d141cd6db0ee75b06e697fa83945c7fe1e6f8483de6a591f5f_1.png"},{"id":"VnNTdGFnZS0yMQ==","name":"Robo ROM-en","image":"https://splatoon3.ink/assets/splatnet/v3/stage_img/icon/low_resolution/692365fa7e56cf19cfa403a8546e69cf60fd9ca2171bde66cdaa53dc0e736ac9_1.png"}]},{"end":"2026-06-01T20:00:00Z","rule":"Turf War","start":"2026-06-01T18:00:00Z","stages":[{"id":"VnNTdGFnZS02","name":"Mincemeat Metalworks","image":"https://splatoon3.ink/assets/splatnet/v3/stage_img/icon/low_resolution/de1f212e9ff0648f36cd3b8e0917ef36b3bd51445159297dcb948f34a09f2f05_1.png"},{"id":"VnNTdGFnZS0yMw==","name":"Marlin Airport","image":"https://splatoon3.ink/assets/splatnet/v3/stage_img/icon/low_resolution/21ea0549b3d29de56ec20affef8866297929d0defb82a27cd199c9d8dade508c_1.png"}]},{"end":"2026-06-01T22:00:00Z","rule":"Turf War","start":"2026-06-01T20:00:00Z","stages":[{"id":"VnNTdGFnZS0xNQ==","name":"MakoMart","image":"https://splatoon3.ink/assets/splatnet/v3/stage_img/icon/low_resolution/a8ba96c3dbd015b7bc6ea4fa067245c4e9aee62b6696cb41e02d35139dd21fe7_1.png"},{"id":"VnNTdGFnZS0xOA==","name":"Manta Maria","image":"https://splatoon3.ink/assets/splatnet/v3/stage_img/icon/low_resolution/0b7fd997781e03eb9d5bf1875ed070f698afc654f4fe929452c65aa26c0a35fd_1.png"}]},{"end":"2026-06-02T00:00:00Z","rule":"Turf War","start":"2026-06-01T22:00:00Z","stages":[{"id":"VnNTdGFnZS01","name":"Um'ami Ruins","image":"https://splatoon3.ink/assets/splatnet/v3/stage_img/icon/low_resolution/f14c2a64e49d243679fc0884af91e1a07dc65600f9b90aefe92d7790dcffb191_1.png"},{"id":"VnNTdGFnZS0xMg==","name":"Mahi-Mahi Resort","image":"https://splatoon3.ink/assets/splatnet/v3/stage_img/icon/low_resolution/8273118c1ffe1bf6fe031c7d8c9795dab52632c9b76e8e9f01f644ac5ae0ccc0_1.png"}]},{"end":"2026-06-02T02:00:00Z","rule":"Turf War","start":"2026-06-02T00:00:00Z","stages":[{"id":"VnNTdGFnZS0z","name":"Hagglefish Market","image":"https://splatoon3.ink/assets/splatnet/v3/stage_img/icon/low_resolution/8dc2f16d39c630bab40cead5b2485ca3559e829d0d3de0c2232c7a62fefb5fa9_1.png"},{"id":"VnNTdGFnZS0yNg==","name":"Urchin Underpass","image":"https://splatoon3.ink/assets/splatnet/v3/stage_img/icon/low_resolution/249c981fdd888e79ada712ddf899bddbead508d71043af3ff96c90a7b5959c73_1.png"}]},{"end":"2026-06-02T04:00:00Z","rule":"Turf War","start":"2026-06-02T02:00:00Z","stages":[{"id":"VnNTdGFnZS0xOQ==","name":"Crableg Capital","image":"https://splatoon3.ink/assets/splatnet/v3/stage_img/icon/low_resolution/4e0e9e2046aff1d635e23946d9f0a461486d2aab349079e551037e426ac82c7a_1.png"},{"id":"VnNTdGFnZS0yMQ==","name":"Robo ROM-en","image":"https://splatoon3.ink/assets/splatnet/v3/stage_img/icon/low_resolution/692365fa7e56cf19cfa403a8546e69cf60fd9ca2171bde66cdaa53dc0e736ac9_1.png"}]},{"end":"2026-06-02T06:00:00Z","rule":"Turf War","start":"2026-06-02T04:00:00Z","stages":[{"id":"VnNTdGFnZS05","name":"Flounder Heights","image":"https://splatoon3.ink/assets/splatnet/v3/stage_img/icon/low_resolution/488017f3ce712fca9fb37d61fe306343054449bb2d2bb1751d95f54a98564cae_1.png"},{"id":"VnNTdGFnZS0xMQ==","name":"Museum d'Alfonsino","image":"https://splatoon3.ink/assets/splatnet/v3/stage_img/icon/low_resolution/b9d8cfa186d197a27e075600a107c99d9e21646d116730f0843e0fff0aaba7dd_1.png"}]},{"end":"2026-06-02T08:00:00Z","rule":"Turf War","start":"2026-06-02T06:00:00Z","stages":[{"id":"VnNTdGFnZS02","name":"Mincemeat Metalworks","image":"https://splatoon3.ink/assets/splatnet/v3/stage_img/icon/low_resolution/de1f212e9ff0648f36cd3b8e0917ef36b3bd51445159297dcb948f34a09f2f05_1.png"},{"id":"VnNTdGFnZS0xNQ==","name":"MakoMart","image":"https://splatoon3.ink/assets/splatnet/v3/stage_img/icon/low_resolution/a8ba96c3dbd015b7bc6ea4fa067245c4e9aee62b6696cb41e02d35139dd21fe7_1.png"}]}]},"meta":{"timestamp":"2026-06-01T08:13:39.451Z","request_id":"2b7844ec-81a6-4652-843b-a5d8b42c4b32"},"status":"ok","message":"Schedules retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/salmonrun":{"get":{"operationId":"get_v1_salmonrun","tags":["Salmon Run"],"summary":"Salmon Run co-op schedules","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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 Hydroplant","start":"2026-06-04T08:00:00Z","weapons":["Octobrush","Clash Blaster","Splat Brella","Classic Squiffer"],"king_salmonid":"Horrorboros"},{"end":"2026-06-07T16:00:00Z","boss":"Megalodontia","stage":"Bonerattle Arena","start":"2026-06-06T00:00:00Z","weapons":["Undercover Brella","Aerospray MG","Douser Dualies FF","Rapid Blaster"],"king_salmonid":"Megalodontia"},{"end":"2026-06-09T08:00:00Z","boss":"Cohozuna","stage":"Jammin' Salmon Junction","start":"2026-06-07T16:00:00Z","weapons":["Mini Splatling","L-3 Nozzlenose","Splattershot Nova","Goo Tuber"],"king_salmonid":"Cohozuna"}]},"meta":{"timestamp":"2026-06-01T08:13:39.677Z","request_id":"295ef2c2-d45a-4e9d-b0a4-36a09b76e00e"},"status":"ok","message":"Salmon Run retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/gear":{"get":{"operationId":"get_v1_gear","tags":["Gear"],"summary":"The SplatNet gear shop","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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,"slots":3,"sale_end":"2026-06-01T16:00:00Z","primary_ability":"Ninja Squid"},{"name":"Ink-Black Paddle Jack","type":"ClothingGear","brand":"Toni Kensa","price":14850,"slots":3,"sale_end":"2026-06-01T20:00:00Z","primary_ability":"Respawn Punisher"},{"name":"Reel Sweat","type":"ClothingGear","brand":"Zekko","price":2250,"slots":1,"sale_end":"2026-06-02T00:00:00Z","primary_ability":"Quick Respawn"},{"name":"Punk Yellows","type":"ShoesGear","brand":"Rockenberg","price":6000,"slots":2,"sale_end":"2026-06-02T04:00:00Z","primary_ability":"Ink Saver (Sub)"},{"name":"Short Knit Layers","type":"ClothingGear","brand":"Toni Kensa","price":14775,"slots":3,"sale_end":"2026-06-02T08:00:00Z","primary_ability":"Thermal Ink"}],"pickup_brand":"Annaki"},"meta":{"timestamp":"2026-06-01T08:13:39.861Z","request_id":"7828c08c-f9a4-49dd-8db3-db72d866cfc1"},"status":"ok","message":"Gear retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/splatfest":{"get":{"operationId":"get_v1_splatfest","tags":["Splatfest"],"summary":"Splatfests by region","description":"","parameters":[{"name":"region","in":"query","required":false,"description":"US|EU|JP|AP","schema":{"type":"string"},"example":"EU"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":10,"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)"}],"title":"Who do you spend the holidays with?"},{"id":"RmVzdC1FVTpKVUVBLTAwMTA0","end":"2025-10-27T00:00:00Z","start":"2025-10-25T00:00:00Z","state":"CLOSED","teams":[{"name":"Zombie","color":"rgba(12,163,75)"},{"name":"Skeleton","color":"rgba(176,79,35)"},{"name":"Ghost","color":"rgba(150,73,150)"}],"title":"Which would be the best friend?"},{"id":"RmVzdC1FVTpKVUVBLTAwMTAz","end":"2025-07-14T00:00:00Z","start":"2025-07-12T00:00:00Z","state":"CLOSED","teams":[{"name":"Land","color":"rgba(233,238,57)"},{"name":"Sea","color":"rgba(49,178,233)"},{"name":"Air","color":"rgba(219,50,231)"}],"title":"Which would you rather travel by?"},{"id":"RmVzdC1FVTpKVUVBLTAwMTAy","end":"2025-04-14T00:00:00Z","start":"2025-04-12T00:00:00Z","state":"CLOSED","teams":[{"name":"Morning","color":"rgba(162,204,65)"},{"name":"Afternoon","color":"rgba(229,113,151)"},{"name":"Night","color":"rgba(82,206,197)"}],"title":"When do you get things done?"},{"id":"RmVzdC1FVTpKVUVBLTAwMjAw","end":"2025-02-10T00:00:00Z","start":"2025-02-08T00:00:00Z","state":"CLOSED","teams":[{"name":"Dark Chocolate","color":"rgba(98,31,235)"},{"name":"Milk Chocolate","color":"rgba(153,89,53)"},{"name":"White Chocolate","color":"rgba(214,191,143)"}],"title":"What's your favorite chocolate?"},{"id":"RmVzdC1FVTpKVUVBLTAwMTAx","end":"2025-01-13T00:00:00Z","start":"2025-01-11T00:00:00Z","state":"CLOSED","teams":[{"name":"Money","color":"rgba(61,98,199)"},{"name":"Experiences","color":"rgba(179,132,23)"},{"name":"Presents","color":"rgba(239,219,171)"}],"title":"What would make you happiest?"},{"id":"RmVzdC1FVTpKVUVBLTAwMTAw","end":"2024-10-28T00:00:00Z","start":"2024-10-26T00:00:00Z","state":"CLOSED","teams":[{"name":"Wizard","color":"rgba(12,163,75)"},{"name":"Knight","color":"rgba(176,79,35)"},{"name":"Ninja","color":"rgba(150,73,150)"}],"title":"What would you be in a fantasy world?"},{"id":"RmVzdC1FVTpKVUVBLTAwMDE5","end":"2024-09-16T00:00:00Z","start":"2024-09-13T00:00:00Z","state":"CLOSED","teams":[{"name":"Past","color":"rgba(247,52,101)"},{"name":"Present","color":"rgba(119,51,255)"},{"name":"Future","color":"rgba(164,255,66)"}],"title":"Which is the most important to you?"},{"id":"RmVzdC1FVTpKVUVBLTAwMDE4","end":"2024-08-12T00:00:00Z","start":"2024-08-10T00:00:00Z","state":"CLOSED","teams":[{"name":"Bread","color":"rgba(171,51,22)"},{"name":"Rice","color":"rgba(183,169,138)"},{"name":"Pasta","color":"rgba(67,176,48)"}],"title":"Which could you eat every day?"}]},"meta":{"timestamp":"2026-06-01T08:13:40.259Z","request_id":"a73bad6e-dbe4-45c4-a0c9-f376e0b4d68d"},"status":"ok","message":"Splatfests retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Usage notes","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":1500,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":390,"monthly_call_quota":40000,"rps_limit":10,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":990,"monthly_call_quota":180000,"rps_limit":25,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":2950,"monthly_call_quota":700000,"rps_limit":60,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/splatoon-api"}