{"id":26468768,"url":"https://github.com/xelvanta/anndromeda-royaleapi","last_synced_at":"2026-04-11T06:40:07.384Z","repository":{"id":277345217,"uuid":"887857431","full_name":"Xelvanta/Anndromeda-RoyaleAPI","owner":"Xelvanta","description":"RoyaleAPI is a Quart + Puppeteer API to fetch Royale High item names and their community values from Traderie, returning results in JSON format.","archived":false,"fork":false,"pushed_at":"2025-03-19T04:27:35.000Z","size":190,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-19T04:28:46.279Z","etag":null,"topics":["api","javascript","json","nodejs","puppeteer","python","quart","roblox"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Xelvanta.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-11-13T12:05:23.000Z","updated_at":"2025-03-19T04:27:39.000Z","dependencies_parsed_at":"2025-03-19T04:25:48.048Z","dependency_job_id":"bedc961b-a519-4302-b80b-0da63deddb60","html_url":"https://github.com/Xelvanta/Anndromeda-RoyaleAPI","commit_stats":null,"previous_names":["xelvanta/anndromeda-royaleapi"],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Xelvanta%2FAnndromeda-RoyaleAPI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Xelvanta%2FAnndromeda-RoyaleAPI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Xelvanta%2FAnndromeda-RoyaleAPI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Xelvanta%2FAnndromeda-RoyaleAPI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Xelvanta","download_url":"https://codeload.github.com/Xelvanta/Anndromeda-RoyaleAPI/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244470242,"owners_count":20457906,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","javascript","json","nodejs","puppeteer","python","quart","roblox"],"created_at":"2025-03-19T16:57:40.901Z","updated_at":"2026-04-11T06:40:07.361Z","avatar_url":"https://github.com/Xelvanta.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🚀 Anndromeda RoyaleAPI\n\n\u003e [!WARNING]\n\u003e As of **Monday, February 9, 2026 8:11 a.m. UTC**, historical price records are **no longer being automatically tracked by this repository**.  \n\u003e If you have the technial knowledge and hosting infrastructure, please feel free to clone the repository and use your own GitHub token and repository\n\u003e to track the value of items using the `Value Tracker` workflow.\n\n![License](https://img.shields.io/github/license/Xelvanta/Anndromeda-RoyaleAPI?label=License\\\u0026color=orange)\n![Puppeteer Version](https://img.shields.io/github/package-json/dependency-version/Xelvanta/Anndromeda-RoyaleAPI/puppeteer?label=Puppeteer)\n![Release](https://img.shields.io/github/v/release/Xelvanta/Anndromeda-RoyaleAPI?include_prereleases\\\u0026label=Release\\\u0026color=green)\n[![Python](https://img.shields.io/badge/Python-3776AB?logo=python\u0026logoColor=fff)](#)\n[![JavaScript](https://img.shields.io/badge/JavaScript-F7DF1E?logo=javascript\u0026logoColor=000)](#)\n[![Node.js](https://img.shields.io/badge/Node.js-6DA55F?logo=node.js\u0026logoColor=white)](#)\n[![Express.js](https://img.shields.io/badge/Express.js-%23404d59.svg?logo=express\u0026logoColor=%2361DAFB)](#)\n[![Docker](https://img.shields.io/badge/Docker-2496ED?logo=docker\u0026logoColor=fff)](#)\n\n**Anndromeda RoyaleAPI**, also known as Royale High API or RHAPI, is a powerful **Quart + Puppeteer API** designed to fetch the names of items from the popular Roblox game **Royale High** and their associated community values from **Traderie**. The API returns results in **JSON format**, making it easy to integrate and use for various applications or analysis.\n\nThis API was created to interact with the **Traderie** website, a platform where the Royale High community buys and sells in-game items. With the API, you can easily access the most up-to-date information on item names and their community values, providing the necessary data for further processing or for custom interfaces.\n\n---\n\n## 📦 Features\n\n* **Item Fetching**: Real-time retrieval of items and values.\n* **Targeted Queries**: Fetch specific items by the item's `id`.\n* **JSON Output**: Easy parsing in Python, JS, Power Query, etc.\n* **Bulk Retrieval**: Optimize performance for full item lists.\n* **Integration Ready**: Works with Excel, Google Sheets, Power BI, or custom apps.\n\n---\n\n## 🧪 Supported Platforms\n\n* **Developed on:** Windows 11\n* **Compatible:** Linux, macOS\n* **Requirements:** Python 3.x, Node.js, Google Chrome\n\n---\n\n## ⚙️ Requirements\n\n### System Requirements\n\n* **Python 3.x** \u0026 **pip**\n* **Node.js** \u0026 **npm**\n* **Google Chrome** (required by Puppeteer)\n\n### Core Dependencies\n\n* **Python:** `quart`, `quart-cors`\n* **Node:** `puppeteer`\n\n\u003e See [requirements.txt](requirements.txt) and [package.json](package.json) for details.\n\n---\n\n## 🚀 Installation\n\nPre-made guides for deploying on a PaaS: [Render](docs/7-beta/deploying_on_render.md) | [Northflank](docs/7-beta/deploying_on_northflank.md)\n\n### Via Docker\n\nYou can run RoyaleAPI via Docker using the [Dockerfile](Dockerfile):\n```\ndocker build -t royaleapi:v1 .\ndocker run -d -p \u003cHOST-PORT\u003e:5000 --name royaleapi-deploy royaleapi:v1\n```\n\nIf you wish, you may also want to create a volume using `docker volume create` to persist the SQLite-generated index files across containers.\n\nOR locally, without Docker, using the following steps:\n\n### Locally (without Docker)\n\n#### 1. Clone Repository\n\n```bash\ngit clone https://github.com/Xelvanta/Anndromeda-RoyaleAPI\ncd Anndromeda-RoyaleAPI\n```\n\n#### 2. Optional: Python Virtual Environment\n\n```powershell\npy -3.13 -m venv venv\nvenv\\Scripts\\activate\n```\n\n#### 3. Install Node Dependencies\n\n```bash\nnpm ci\n```\n\n#### 4. Install Python Dependencies\n\n```bash\npip install -r requirements.txt\n```\n\n#### 5. Run the API\n\n```bash\npython app.py\n```\n\nThe default [config.json](config.json) settings bind to 127.0.0.1:5000 (or 0.0.0.0:{PORT} if PORT is in environment variables).  \nIt is highly advised to set API_KEY as an environment variable; otherwise the one from [config.json](config.json) will be used.\n\n* **Access endpoints:** `/items`, `/item?id=\u003cID\u003e`, `/health`, or `/node/restart`\n* **Documentation:** See [API_DOCUMENTATION.md](docs/7-beta/API_DOCUMENTATION.md)\n\n---\n\n## ⚠️ Common Issues\n\n* **Node.js not recognized:** Ensure Node.js is installed and in your PATH.\n* **Puppeteer Chrome error:** Make sure Google Chrome is installed.\n* **Dependencies missing:** Ensure `pip install -r requirements.txt` or `npm ci` completed successfully.\n* **Windows PATH for Node.js:** Add Node.js folder to system PATH.\n* **PowerShell Execution Policy:** `Set-ExecutionPolicy RemoteSigned -Scope CurrentUser`\n\n---\n\n## 💡 Contributing\n\nFork, contribute, and submit PRs. See [CONTRIBUTING.md](CONTRIBUTING.md).\n\n---\n\n## 📝 License\n\nGPL-3.0. See [LICENSE](LICENSE).\n\n---\n\n## 📬 Contact\n\n**Anndromeda / Xelvanta Group Systems**  \nEmail: [Xelvanta@proton.me](mailto:Xelvanta@proton.me)  \nGitHub: [https://github.com/Xelvanta](https://github.com/Xelvanta)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxelvanta%2Fanndromeda-royaleapi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxelvanta%2Fanndromeda-royaleapi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxelvanta%2Fanndromeda-royaleapi/lists"}