Table of contents

• Usage
• Specific item
• Invalid item
• Minions
• Internal error
• Additional information
  • Credits
• Demo

Usage

To use the API you need to send a GET request to https://minionah.com/api/craftcost The API will return a JSON object with the raw craft cost of every item in the game:

Specific item

If you need a specific item, you can send a GET request to https://minionah.com/api/craftcost/{item}

Replace {item} with the internal item name, you can find a list of all the internal item names at DarthGigi/MinionAH-NotEnoughUpdates-REPO/recipes/recipes.json.

The API will return a JSON object with the raw craft cost of the specified item:

With a status code of 200, and a status message of OK.

Invalid item

If you provide an invalid item name, the API will return the following JSON object:

With a status code of 404, and a status message of Item not found.

Minions

If you want to get a list of the raw craft cost of every minion, you can provide minions as the {item} value.

The API will return the following JSON object:

Internal error

If an internal error occurs, the API will return the following JSON object:

With a status code of 500, and a status message of Internal Server Error.

Additional information

Additional information about the responses:

• All responses have the Content-Type header set to application/json.
• The API is rate-limited to 60 requests per minute.

Additional information about the API:

• The API tries to take as many items into calculation as possible, the prices are retrieved from either the bazaar or the NPC sell price if it is not available on the bazaar. If the item is not available on the bazaar or the NPC sell price, the API will return 0 as the price.
  • Even though the API tries to take as many items into calculation as possible, it is not possible to take every item into calculation due to different factors (like some not having a price, not obtainable, etc). So the prices might not be 100% accurate.
• The API used for the Bazaar prices is Hypixel. Every time a request is made to the API, the API will request Hypixel to get the latest Bazaar prices. This means that the API will always have the latest Bazaar prices.
• Not all items have a recipe to craft or are sold by an NPC. For example, the Snow and Flower Minions can't be obtained by crafting or purchasing via an NPC, some items are only purchasable with Bits. In cases like these where calculating the price is not possible, the API will return 0 as the price.
• As always, the code is open-source and available at github.com/DarthGigi/MinionAH.

Credits

We'd like to massively thank BigOofinator for helping us with the calculation code

Demo

You can try out the API here: