poe.ninja APIpoe.ninja ↗
Access Path of Exile economy and build data from poe.ninja. Get item prices, currency exchange rates, divination cards, market trends, and class statistics.
curl -X GET 'https://api.parse.bot/scraper/d24b0bde-6a4c-44a4-82b3-3eb42f9e3d0c/get_item_prices?league=Mirage&category=UniqueWeapon' \ -H 'X-API-Key: $PARSE_API_KEY'
Retrieve current prices of Path of Exile items from poe.ninja. Returns items with chaos and divine orb valuations for a given league and item category.
| Param | Type | Description |
|---|---|---|
| league | string | League name. Active economy leagues include Mirage, Hardcore Mirage, Standard, Hardcore. Defaults to the current active league. |
| category | string | Item category. Accepted values include UniqueWeapon, UniqueArmour, UniqueAccessory, UniqueFlask, UniqueJewel, SkillGem, Map, DivinationCard, and others supported by poe.ninja. |
{
"type": "object",
"fields": {
"items": "array of item objects with name, price (chaos), divine_price, base_type, links, item_class",
"league": "string — league name used for the query",
"category": "string — item category used for the query"
},
"sample": {
"data": {
"items": [
{
"name": "Foulborn Reefbane",
"links": null,
"price": 441363,
"currency": "Chaos Orb",
"base_type": "Fishing Rod",
"item_class": 3,
"divine_price": 1144
}
],
"league": "Mirage",
"category": "UniqueWeapon"
},
"status": "success"
}
}About the poe.ninja API
The poe.ninja API exposes 5 endpoints covering Path of Exile economic and build data across active leagues. get_item_prices returns chaos and divine orb valuations for categories like UniqueWeapon and SkillGem. get_currency_prices delivers buy/sell rates and chaos equivalents for all tracked currencies. get_build_classes_and_dps surfaces class popularity percentages and top skills per class.
Item and Currency Pricing
The get_item_prices endpoint accepts a league parameter (e.g. Mirage, Hardcore Mirage, Standard, Hardcore) and a category parameter (UniqueWeapon, UniqueArmour, UniqueAccessory, UniqueFlask, UniqueJewel, and others). Each item object in the response includes name, base_type, item_class, links, a chaos price, and a divine_price. The get_currency_prices endpoint returns all tracked currencies for a given league with chaos_equivalent, receive_price, and pay_price fields — useful for building exchange-rate calculators or trade tools.
Divination Cards and Market Trends
get_divination_cards returns card-specific data including stack_size, chaos_value, divine_value, and art_filename for every tracked card in the specified league. get_market_trends adds time-series context: each trend object includes a sparkline (array of recent price points) and a low_confidence_sparkline, covering categories from Currency to DivinationCard to UniqueArmour. This makes it straightforward to detect price movements without maintaining your own historical data.
Build Statistics
get_build_classes_and_dps returns per-class statistics for a given league, including class_name, popularity_percentage, and a top_skills array of skill-name/percentage pairs. Supported leagues for build data include Mirage, Hardcore Mirage, SSF Mirage, and Standard. The endpoint also returns a note field with any informational caveats about data availability for the queried league.
League Scope
All endpoints default to the current active league when no league parameter is provided. League names map to the current Path of Exile challenge leagues and their variants. Passing an unrecognized or expired league name may return empty results, so using one of the documented active league strings is recommended.
- Build a currency exchange dashboard showing live chaos-equivalent rates and buy/sell spreads per league
- Track unique item floor prices in chaos and divine orbs to identify arbitrage opportunities
- Monitor divination card values to evaluate farming strategy profitability across stack sizes
- Plot sparkline price history from get_market_trends to visualize item or currency volatility
- Analyze class and skill popularity from get_build_classes_and_dps to follow meta shifts across leagues
- Power a trade helper that surfaces current item prices filtered by category and league
- Generate league-start reports comparing divination card and unique item valuations at league launch
| 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 poe.ninja have an official developer API?+
What does get_market_trends return that get_item_prices does not?+
sparkline and low_confidence_sparkline fields — arrays of recent price points that show directional price movement over time. get_item_prices returns only the current chaos and divine valuations without historical context. If you need to detect whether an item is rising or falling in value, get_market_trends is the relevant endpoint.