Eldorado APIeldorado.com ↗
Access Eldorado.gg game account and currency listings, seller profiles, reviews, and offer details via a structured API with 10 endpoints.
What is the Eldorado API?
The Eldorado.gg API covers 10 endpoints that expose game account listings, in-game currency offers, seller profiles, and buyer reviews from Eldorado.gg. The get_currency_listings endpoint returns up to 150 paginated seller offers per page with region, server, and faction filters, while get_account_offer_detail delivers full offer descriptions, pricing, delivery time, and a set of similar offers — all in structured JSON.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/4085eceb-c0c6-4f76-92ed-b8a29679870a/get_homepage_featured' \ -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-com-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.
"""Eldorado.gg Marketplace — search games, browse offers, check seller reputation."""
from parse_apis.Eldorado_gg_Marketplace_API import (
Eldorado, ReviewCategory, GameCategory, OfferNotFound
)
client = Eldorado()
# Search for games matching a keyword — limit caps total items fetched
for game in client.games.search(query="world of warcraft", limit=3):
print(game.game_name, game.category, game.game_id)
# List all currency games available on the marketplace
for game in client.games.list_currency(limit=3):
print(game.game_name, game.menu_game_title)
# Construct a game by ID and browse its currency offers
wow = client.game(game_id="0")
listing = wow.currency_listings(te0="NA", limit=1).first()
if listing:
print(listing.offer.price_per_unit.amount, listing.offer.quantity)
print(listing.seller.username, listing.seller_stats.feedback_score)
# Browse account listings for Fortnite
fortnite = client.game(game_id="16")
account = fortnite.account_listings(limit=1).first()
if account:
print(account.offer.offer_title, account.offer.price_per_unit.amount)
# Seller reviews — filter by category using the enum
seller = client.seller(id="auth0|60c56ad815589d0069348b4b")
for review in seller.reviews(category=ReviewCategory.CURRENCY, limit=3):
print(review.order_review.feedback_rating, review.buyer.masked_username)
# Typed error handling — get_offer raises OfferNotFound for missing IDs
try:
detail = client.games.get_offer(offer_id="00000000-0000-0000-0000-000000000000")
print(detail.offer.offer_title)
except OfferNotFound as exc:
print(f"Offer missing: {exc.offer_id}")
print("exercised: games.search / games.list_currency / game.currency_listings / game.account_listings / seller.reviews / games.get_offer")
Returns trending games and popular offers from the Eldorado.gg homepage. Popular games are sorted by popularGameSortOrder, trending games by trendingRatio descending. Up to 20 results per category.
No input parameters required.
{
"type": "object",
"fields": {
"popular_games": "array of game summary objects sorted by popularGameSortOrder",
"trending_games": "array of game summary objects sorted by trendingRatio descending"
},
"sample": {
"data": {
"popular_games": [
{
"title": "Items",
"gameId": "259",
"category": "CustomItem",
"gameName": "Steal a Brainrot",
"imageAlt": "steal a brainrot brainrots",
"seoAlias": "steal-a-brainrot-brainrots",
"gameGroup": "Roblox",
"isHighRisk": false,
"createdDate": "2025-06-19T06:38:39.7206464Z",
"legacyUrlId": null,
"synonymNames": [
"Steal a Brainrot"
],
"isPopularGame": true,
"menuGameTitle": "Steal a Brainrot",
"isPopularGameV2": true,
"isSingleOfferGame": false,
"popularGameSortOrder": 1,
"popularGameSortOrderV2": 1
}
],
"trending_games": []
},
"status": "success"
}
}About the Eldorado API
Game Discovery and Search
The get_homepage_featured endpoint returns two sorted arrays: popular games ranked by popularGameSortOrder and trending games ranked by trendingRatio descending, with up to 20 entries per category. To find a specific game, search_listings accepts a query string and matches against gameName, title, and synonymNames, returning up to 50 results. Each result includes a gameId, category, and seoAlias that feed into the listing and game-page endpoints. Note that the same gameId can appear multiple times across categories such as Currency, Account, and TopUp.
Listings and Offer Detail
get_currency_listings and get_account_listings both return paginated seller offers. Currency listings support up to three trade environment filters — te0 (typically Region), te1 (Server/Realm), and te2 (Faction) — with a page size of 150. Account listings use a simpler page size of 24. Available filter values for te0, te1, and te2 come from get_game_page, which exposes a nested tradeEnvironments structure and attributeFilters for each game-category combination. The get_account_offer_detail endpoint accepts an offer UUID and returns the full offer object (including offerTitle, description, pricePerUnit, and attributes), seller user info, deliveryTime, and a similarOffers array. This endpoint only works for Account and CustomItem category offer IDs; passing a Currency offer ID returns a not-found error.
Seller Profiles and Reviews
get_seller_profile returns a seller's aggregate reputation data: ratingCount, feedbackScore, positiveCount, negativeCount, isEligibleForWarranty, and disputedAccountOrderRatio. Seller user IDs are returned in listing results and follow formats like auth0|... or google-oauth2|.... get_seller_reviews provides paginated buyer reviews at 5 per page, filterable by category (Currency, Account, CustomItem, TopUp). Pagination uses a cursor model — the nextPageCursor field from one response feeds into the cursor parameter of the next request.
Game Page Metadata
get_game_page requires both a game_id and a category and returns the full filter surface for that combination: nested tradeEnvironments for hierarchical Region→Server→Faction filters (relevant for Currency games) or flat device filters (relevant for Account games), plus a unitSystem and attributeFilters array. It is the recommended first call when building a filtered query against get_currency_listings.
The Eldorado API is a managed, monitored endpoint for eldorado.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when eldorado.com 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.com 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?+
- Monitor in-game currency price trends across regions and servers for a specific game using
get_currency_listingswithte0/te1filters. - Build a seller reputation dashboard by combining
get_seller_profilefeedback scores with paginatedget_seller_reviewsdata. - Aggregate account offer inventory for a game like Fortnite or GTA 5 using
get_account_listingswithgame_idpagination. - Surface trending and popular games on Eldorado.gg using the
popular_gamesandtrending_gamesarrays fromget_homepage_featured. - Look up full offer details including description, attributes, and similar listings using
get_account_offer_detailwith a UUID offer ID. - Discover valid region and server filter values for a currency game before querying listings using
get_game_pagetradeEnvironments. - Search across game categories by keyword to map game names to their
gameIdandseoAliasvalues for downstream queries.
| 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 public developer API?+
How do I find the right filter values for `te0`, `te1`, and `te2` in `get_currency_listings`?+
get_game_page with the target game_id and category set to 'Currency'. The response includes a tradeEnvironments array with nested childTradeEnvironments, which maps to the Region, Server/Realm, and Faction hierarchy used by te0, te1, and te2 respectively.Does `get_account_offer_detail` work for Currency offer IDs?+
get_currency_listings, but detailed single-offer views for Currency are not currently exposed. You can fork this API on Parse and revise it to add that endpoint.Does the API expose order history, transaction data, or active trade status for buyers?+
Are Boosting or GiftCard listings accessible, or only Currency and Account categories?+
get_game_page endpoint accepts 'RequestedBoosting' and 'GiftCard' as valid category values and will return trade environment and attribute filter metadata for those categories. However, dedicated listing endpoints analogous to get_currency_listings and get_account_listings are not currently included for Boosting or GiftCard. You can fork this API on Parse and revise it to add paginated listing endpoints for those categories.