https://github.com/kzon94/eve-marketer-v2
🚀 Data extraction tool for the EVE Online ESI API. Generates a clean and structured CSV file with price history and trends, and provides visual insights through interactive graphs.
https://github.com/kzon94/eve-marketer-v2
api-server chart-library colab-notebook esi-api eve-online jupiter-notebook market-data python scraper
Last synced: 6 months ago
JSON representation
🚀 Data extraction tool for the EVE Online ESI API. Generates a clean and structured CSV file with price history and trends, and provides visual insights through interactive graphs.
- Host: GitHub
- URL: https://github.com/kzon94/eve-marketer-v2
- Owner: kzon94
- License: mit
- Created: 2025-03-28T13:59:49.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-03-28T15:22:01.000Z (7 months ago)
- Last Synced: 2025-03-28T15:22:22.879Z (7 months ago)
- Topics: api-server, chart-library, colab-notebook, esi-api, eve-online, jupiter-notebook, market-data, python, scraper
- Language: Jupyter Notebook
- Homepage:
- Size: 396 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🚀 EVE Marketer v2
**Advanced Market Analysis Tool for EVE Online**
*Built for Google Colab. Designed for industrialists and traders.*
---
## 📈 Project Goal
EVE Marketer v2 is a Python-based tool designed for use in **Google Colab**. It allows capsuleers to:
- 🔎 Query **market prices** in **Jita 4-4**
- 📊 Analyze **historical buy trends** over the past **7 and 31 days**
- 📉 Calculate **percentage price changes**
- 🧮 Compare profitability of selling raw materials vs. manufacturing
> 🧪 **Note:** Jita 4-4 is currently used as the default trade hub for testing, as it's my primary buying/selling location.
> ⚙️ Future versions will support **Amarr, Dodixie, Rens, Hek**, and other hubs.
---
## 🧩 How It Works
1. **Input**
Upload the file [`materials_id_classified.csv`](https://github.com/kzon94/eve-marketer-v2), which includes:
- `type_id` — EVE Online's item ID
- `name` — Item name
- `material_type` — Category (Ore, Gas, Ice...)
- `tier` — Tier classification (T1–T7)
> 🧠 **Data source**: Special thanks to [Adam4EVE.eu](https://www.adam4eve.eu/info_types.php) — a fantastic resource whose data helped build the base classification list.
2. **API Query**
The script calls the **ESI API** to retrieve:
- Current buy/sell prices at Jita 4-4
- Max historical buy prices (7d & 31d)
- % price change over time
3. **Output**
Generates a ready-to-use CSV file:
```
mining_market_jita_v3.csv
```
- Uses `;` as the delimiter and `,` as the decimal symbol
- Compatible with Excel, Google Sheets, and other spreadsheet tools
---
## 📊 Market Visualizer
Once the CSV is generated, you can run the **graph generator notebook** to visualize the data:
- 📉 **Bar chart**: Current buy prices by tier/material type
- 📈 **Logarithmic line chart**: Price evolution over time (31d, 7d, Now)
*Still working on logarithmic chart :(*
📸 Both graphs are exported as **one downloadable image** automatically.
---
## ⚙️ Setup & Requirements
Designed to run entirely in **Google Colab**. No local setup required.
Install `jedi` to enable smart notebook functionality:
```python
!pip install jedi
```
> ⚠️ Yes, just **jedi**.
> You don't need the whole Jedi Council to analyze the market.
---
## 🧠 Features
- ✅ Jita 4-4 market scraping (buy & sell)
- ✅ Historical max buy (7d, 31d)
- ✅ Price delta calculation
- ✅ Multithreaded queries
- ✅ Comma-based decimals for Excel compatibility
- ✅ Colab-ready graphing tool
- ✅ Auto-download of CSV and graph image
---
## 🔮 Next Goals
- 🔁 Support **all major trade hubs**
- 💰 PI production profitability calculator
- ⚙️ ESI authentication for increased API limits
- 📦 Manufacturing cost analysis
---
## 🛡 Disclaimer
**This project is not affiliated with CCP Games.**
It’s a personal tool for data-driven market decisions.
MIT License © [kzon94](https://github.com/kzon94)
---
💬 *Fly safe. Mine rich. Sell smart.*