Skip to content

Latest commit

 

History

10 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Open Gacha Codes

Open Gacha Codes is an API service that collects active redemption codes for supported gacha games from multiple independent sources.

It normalizes and deduplicates codes, combines reward information, excludes unsupported regional codes, and stores canonical results for API consumers.

Routes

The public deployment is mounted at https://api.ennead.cc/codes, so every route below is reachable with or without that prefix: GET /codes/games and GET /games are equivalent.

GET /games

Returns all supported games.

[
  {
    "slug": "genshin",
    "name": "Genshin Impact"
  },
  {
    "slug": "starrail",
    "name": "Honkai: Star Rail"
  },
  {
    "slug": "zenless",
    "name": "Zenless Zone Zero"
  },
  {
    "slug": "endfield",
    "name": "Arknights: Endfield"
  },
  {
    "slug": "wuwa",
    "name": "Wuthering Waves"
  },
  {
    "slug": "nte",
    "name": "Neverness to Everness"
  }
]

GET /{slug}

Returns active redemption codes for a supported game using a slug returned by GET /games, for example https://api.ennead.cc/codes/zenless.

[
  {
    "code": "ZENLESSGIFT",
    "rewards": [
      "Polychrome x50",
      "Official Investigator Log x2",
      "W-Engine Power Supply x3",
      "Bangboo Algorithm Module x1"
    ]
  }
]

A supported game with no active codes returns an empty array:

[]

Error Responses

Errors use a consistent response structure. For example, an unknown game returns HTTP 404 with:

{
  "statusCode": 404,
  "error": {
    "message": "game not found"
  }
}

Because any single-segment path is read as a game slug, unrecognized paths such as /health also return game not found. Other possible error statuses include 405 for unsupported HTTP methods and 500 for internal server errors.

Request a Game

If you would like another game added to the tracker, feel free to open an issue. When possible, include links to reliable sources that publish the game's active redemption codes, such as an official website, community wiki, or regularly maintained guide.

Releases

Packages

Used by

Contributors

Languages