eldorado.com APIeldorado.com ↗
Access Eldorado.gg game listings, seller profiles, buyer reviews, and offer details for in-game currency and accounts via 10 structured API endpoints.
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'
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 objects with gameId, gameName, category, seoAlias, trendingRatio, popularGameSortOrder",
"trending_games": "array of game objects sorted by trendingRatio descending"
},
"sample": {
"data": {
"popular_games": [
{
"gameId": "137",
"category": "TopUp",
"gameName": "Honkai: Star Rail",
"seoAlias": "honkai-star-rail-top-up",
"isPopularGame": true,
"menuGameTitle": "Honkai: Star Rail Oneiric Shards",
"trendingRatio": 0.104,
"popularGameSortOrder": 1
}
],
"trending_games": [
{
"gameId": "400",
"category": "Account",
"gameName": "Neverness to Everness",
"seoAlias": "neverness-to-everness-accounts",
"menuGameTitle": "Neverness to Everness",
"trendingRatio": 31.6
}
]
},
"status": "success"
}
}About the eldorado.com API
The Eldorado.gg API exposes 10 endpoints covering in-game currency listings, account offers, seller profiles, and buyer reviews from the Eldorado.gg peer-to-peer marketplace. Use get_currency_listings to pull paginated seller offers filtered by region, server, and faction, or get_account_offer_detail to retrieve full offer metadata including price, delivery time estimates, and similar listings. Response fields span offer pricing, trade environment hierarchies, and seller feedback scores.
Game Discovery and Search
The get_homepage_featured endpoint returns up to 20 popular and trending games, sorted by popularGameSortOrder and trendingRatio respectively — useful for tracking which titles are most active on the marketplace at any given time. search_listings accepts a query string matched against gameName, title, and synonymNames, returning up to 50 results. Because the same gameId can appear across different categories (Currency, Account, TopUp), search results may contain duplicate game entries differentiated by category.
Listings and Offer Details
get_currency_listings and get_account_listings both return paginated offer arrays containing offer, user, userOrderInfo, and deliveryTime objects. Currency listings support three optional trade environment filters — te0 (Region), te1 (Server/Realm), and te2 (Faction) — whose valid values are discoverable via get_game_page. Currency pages return 150 results per page; account pages return 24. get_account_offer_detail takes an offer UUID and returns the full offer object including offerTitle, description, pricePerUnit, tradeEnvironmentValues, attributes, and a similarOffers array. Note that this endpoint only supports Account and CustomItem offers — 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 (percentage positive), positiveCount, negativeCount, isEligibleForWarranty, and disputedAccountOrderRatio. Seller IDs are string-formatted, supporting both Auth0 and Google OAuth formats. get_seller_reviews returns 5 reviews per page using cursor-based pagination; the nextPageCursor field from each response is passed as the cursor parameter for the next page. Reviews can be filtered by category (Currency, Account, CustomItem, TopUp).
Trade Environment and Filter Discovery
get_game_page is the entry point for understanding a game's available filters before querying listings. It returns tradeEnvironments as a nested structure (e.g., Region → Server → Faction for Currency games, or a flat Device list for Account games), alongside attributeFilters and unitSystem. The category parameter is required and accepts values including Currency, Account, CustomItem, TopUp, RequestedBoosting, and GiftCard.
- Track real-time pricing for in-game currency across regions and servers using
get_currency_listingswithte0/te1/te2filters - Build a seller vetting tool combining
get_seller_profilefeedback scores with paginatedget_seller_reviewsdata - Monitor trending and popular games on the marketplace using
trendingRatioandpopularGameSortOrderfromget_homepage_featured - Aggregate account listing inventory by game using
get_account_listingswith a knowngame_id - Surface similar competing offers alongside a target listing using the
similarOffersarray fromget_account_offer_detail - Discover valid region/server/faction filter values for a game before querying listings via
get_game_pagetradeEnvironments - Cross-reference seller dispute ratios with review sentiment using
disputedAccountOrderRatioand buyer review text fields
| 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 | 250 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?+
What trade environment filters does `get_currency_listings` support, and where do valid values come from?+
get_currency_listings accepts three optional filters: te0 (typically Region, e.g. 'EU' or 'NA'), te1 (Server/Realm), and te2 (Faction). Valid values for each filter are specific to the game being queried. Call get_game_page with the relevant game_id and category 'Currency' first — its tradeEnvironments array contains the nested hierarchy of valid filter values.Can I retrieve reviews for Currency offer transactions, not just Account offers?+
get_seller_reviews accepts a category parameter that can be set to 'Currency', 'Account', 'CustomItem', or 'TopUp'. If the seller has no reviews in the specified category, the results array returns empty. Filtering by category is optional — omitting it returns reviews across all categories.Does the API expose buyer identities or full usernames in reviews?+
get_seller_reviews include only a maskedUsername field for the buyer — full usernames are not exposed. The API covers seller-side data including feedback scores, dispute ratios, and review text. You can fork this API on Parse and revise it to surface additional buyer-side fields if they become accessible.Does the API cover boosting services or gift card listings, not just Currency and Account categories?+
get_game_page endpoint accepts 'RequestedBoosting' and 'GiftCard' as valid category values and returns trade environments and attribute filters for those categories. However, there are no dedicated listing endpoints for boosting or gift card offers — only get_currency_listings and get_account_listings are available for paginated offer results. You can fork this API on Parse and revise it to add listing endpoints for those additional categories.