EconOMatic is an API service designed to give easy access to economy related data for WoW Classic WOTLK.
EconOMatic combines information about the game's economy into one easy-to-use API. It's great for players interested in the market or for professional gold traders. The API can also be plugged into your own projects to build custom tools and applications. This API makes it easy for players to understand the game's economy, make smart trading decisions, and plan their gold farming strategies. It gives all of this information in a simple and clear way, making it accessible for everyone.
EconOMatic API has a bunch of useful features. Let's take a look at some of them:
-
You can get a list of available servers for WoW Classic WOTLK, including their names, regions, and other important details.
-
You can also get information about the items in the game, like their IDs, names, descriptions, and rarity.
-
Get population stats for each server, including the player count and faction distribution. This can help you choose the right server and get a sense of the game's demographics. Population information is provided by WarcraftTavern.
-
Stay updated with the current gold prices for each server. This feature tells you when gold prices go up or down, which can help you buy low and sell high or decide which server is better to sell gold on. Gold prices are fetched from G2G.
-
Get detailed auction house information for a specific server. See how much different items are selling for and how much supply there is. This can help you spot good deals and stay ahead of the market. Auction House information is provided by NexusHub.
-
Get recommendations on the best servers to farm on based on the items you're planning to farm. The recommendations take into account population, item prices, and gold prices.
-
This feature provides a list of the best deals for items on a specific server. It helps you identify items that you can buy at a low price and sell at a higher price. The discount percentage is calculated based on the difference between market value and minimum buyout price.
-
You can customize and filter the data to get exactly the information you want. Look for specific types of items, price ranges, server regions, and more.
-
You can integrate the API into your own projects and applications. This allows you to take full advantage of all the features and build custom tools that suit your needs.
The EconOMatic application can be set up in multiple ways. Here are the two most common ways to run the service:
Before you begin, ensure you have a running local PostgreSQL database, and JDK 17+ installed. Database could be running within a Docker container or installed on your machine. Next, set up the environment variables. Defaults are provided, but you can adjust according to your needs:
DB_URL- Link to your database. Default:jdbc:postgresql://localhost:5432/economaticDB_USERNAME- Username for your database. Default:postgresDB_PASS- Password for your database. Default:passPORT- Port to run application on. Default:8080
Navigate to the code directory and run:
DB_URL=your_value \
DB_USERNAME=your_value \
DB_PASS=your_value \
PORT=your_value \
./gradlew bootRunReplace your_value with your values.
Alternatively, utilize the Docker compose file provided. Before proceeding, please ensure that Docker is installed on your system. In the code directory, use:
docker compose up -dWhen you want to stop the application:
docker compose downDocker helps in managing the application without the need for manual setup.
Before you start, ensure the EconOMatic application is running on your machine. You have two straightforward options to interact with the EconOMatic API:
- Using Postman: This offers a user-friendly visual interface. A ready-to-use Postman collection is available,
which covers all the endpoints. This way, you can immediately start interacting and experimenting with the API after
setting it up. Follow these steps:
- Download the Postman collection using the following link: EconOMatic Postman Collection.
- Import this collection into your Postman application. If you're uncertain about this step, Postman provides a comprehensive guide available here.
- Sending requests directly from your browser: Another method is to send the requests directly from your browser. Enter the URL with the specific endpoint you're interested in. For a complete list of available endpoints and their usage, refer to the API Reference section. Either way, you will find EconOMatic API a helpful tool in understanding WoW Classic WOTLK's economy, planning your gold farming strategies, and making smart trading decisions.
Comprehensive documentation for each API endpoint is accessible through the Swagger UI, located at http://localhost:8080/swagger-ui/index.html. If app is running on a port other than the default 8080, make sure to update the URL accordingly.
Before attempting to access the Swagger UI, please ensure that the application is running as expected on your machine.
Below are additional environmental variables that can be configured to adjust the application’s functionality:
GOLD_PRICE_DEFAULT_WEIGHTDefault weight for gold price recommendation calculations. Default:1ITEM_PRICE_DEFAULT_WEIGHTDefault weight for item price recommendation calculations. Default:1POPULATION_DEFAULT_WEIGHT: Default weight for population recommendation calculations. Default:0.1MIN_ALLOWED_POPULATIONMinimum allowed population when calculating recommendation scores for servers. Default:1000UPDATE_ON_STARTUPDefines whether to update gold price, item price, and population data on startup. Useful to avoid redundant fetching of data when the application is restarted frequently. Default:truePOPULATION_UPDATE_RATE: Frequency to update population data in days. Default:1ITEM_PRICE_UPDATE_RATE: Frequency to update item price data in hours. Default3GOLD_PRICE_UPDATE_RATEFrequency to update gold price data in minutes. Default:60
When setting up the application, ensure these are considered and adjusted according to your use case. To keep the defaults, no action is needed.
Submit a pull request