Eldorado APIeldorado.gg ↗
Access Eldorado.gg game currency listings, seller offers, and average prices across multiple games via 2 structured API endpoints.
What is the Eldorado API?
The Eldorado.gg API exposes 2 endpoints for querying the Eldorado.gg game currency marketplace, covering game discovery and live seller offer data. Use list_currency_games to retrieve every game that has in-game currency listed for sale, then pass a game_id to get_currency_offers to get ranked seller offers, per-unit USD prices, stock levels, and a computed average price across the top N sellers.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/37b2dbc9-0e32-46bc-9e47-8a6ccf8232f5/list_currency_games' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace eldorado-gg-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Eldorado.gg currency marketplace — find game currencies and compare seller prices."""
from parse_apis.eldorado_gg_api import Eldorado, Sort, GameNotFound
client = Eldorado()
# List available currency games, take a few popular ones
for game in client.currency_games.list(limit=5):
print(game.game_name, "-", game.currency_title, "(popular:", game.is_popular, ")")
# Drill into OSRS Gold offers — get top sellers sorted by recommendation
osrs = client.currencygame(game_id="10")
offer_set = osrs.offers.get(top_n=6, sort=Sort.RECOMMENDED)
print(f"\nOSRS Gold: {offer_set.total_sellers} sellers, avg ${offer_set.average_price_usd}/M")
for seller in offer_set.sellers:
print(f" {seller.seller_username}: ${seller.price_per_unit_usd} | stock: {seller.quantity_in_stock}")
# Handle a game that might not exist
try:
bad = client.currencygame(game_id="99999")
bad.offers.get()
except GameNotFound as exc:
print(f"\nGame not found: {exc.game_id}")
print("\nexercised: currency_games.list / currencygame / offers.get / Sort enum / GameNotFound")
Lists all games that have in-game currency available for sale on Eldorado.gg. Returns game IDs, names, currency titles, and SEO aliases. Use the game_id from results to query offers via get_currency_offers.
No input parameters required.
{
"type": "object",
"fields": {
"games": "array of game currency entries with game_id, game_name, currency_title, seo_alias, is_popular",
"total": "integer count of available currency games"
},
"sample": {
"data": {
"games": [
{
"game_id": "0",
"game_name": "World of Warcraft",
"seo_alias": "buy-wow-gold",
"is_popular": true,
"currency_title": "Gold"
},
{
"game_id": "10",
"game_name": "OSRS",
"seo_alias": "osrs-gold",
"is_popular": true,
"currency_title": "Gold"
}
],
"total": 73
},
"status": "success"
}
}About the Eldorado API
Endpoint Overview
The API has two endpoints. list_currency_games takes no parameters and returns an array of all games with active currency listings on Eldorado.gg. Each entry in the games array includes a numeric game_id, a human-readable game_name, the currency_title (what the in-game currency is called), a seo_alias for reference, and an is_popular flag. The response also includes a total count of available currency games.
Seller Offer Data
get_currency_offers accepts a required game_id string (e.g. '10' for Old School RuneScape or '0' for World of Warcraft), an optional top_n integer to control how many top sellers are returned, and an optional sort parameter to change offer ordering. The response includes a sellers array where each entry contains the seller's username, verification status, price per unit in USD, and stock quantity. The endpoint also returns total_sellers (the full count of sellers for that currency) and average_price_usd, computed across the returned sellers.
Price Unit System
The price_unit_system field in get_currency_offers clarifies what quantity the per-unit price applies to. For example, a value of Unit1000000 means prices are quoted per 1 million units of in-game currency, which is the standard for high-volume currencies like OSRS gold. This is important context when comparing offers or building price-tracking tools.
Coverage and Scope
The API covers game currency listings only — the categories of data available are game metadata from list_currency_games and seller offer snapshots from get_currency_offers. It does not expose game item listings, account sales, boosting services, or other marketplace categories that Eldorado.gg offers beyond currency trading.
The Eldorado API is a managed, monitored endpoint for eldorado.gg — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when eldorado.gg changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official eldorado.gg API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Track real-time OSRS gold prices by polling
get_currency_offerswith game_id '10' and monitoringaverage_price_usdover time. - Build a cross-game currency price comparison dashboard using
list_currency_gamesto enumerate all available games and their currency titles. - Alert users when a verified seller's offer for a specific game drops below a target price per unit.
- Compute price spread between top sellers by comparing individual entries in the
sellersarray againstaverage_price_usd. - Discover which games have active currency markets by filtering
list_currency_gamesresults on theis_popularflag. - Monitor total seller count changes for a game over time using the
total_sellersfield as a liquidity indicator.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Eldorado.gg have an official developer API?+
What does the `price_unit_system` field in `get_currency_offers` mean?+
Unit1000000 means each seller's price is per 1 million units of in-game currency. You need this field to correctly interpret and compare prices across games where currency volumes differ significantly.Does the API return seller reviews, reputation scores, or trade history?+
Can I retrieve offers for item listings or account sales, not just currency?+
list_currency_games and get_currency_offers. Eldorado.gg also hosts item and account marketplaces, but those are not covered. You can fork this API on Parse and revise it to add endpoints for those marketplace categories.How many sellers does `get_currency_offers` return by default, and can I get all of them?+
top_n parameter. The response includes a total_sellers field showing the full count of sellers for that game's currency, but pagination or retrieval beyond the specified top_n is not currently supported. You can fork this API on Parse and revise it to add pagination support.