Path of Exile API
Official vendor OpenAPI document · agent-readySocial MediaSocial Listeningoauth210 EndpointsREST
For Agents
Read Path of Exile leagues, ladders, PvP matches, and public stash tabs, and read an authenticated account's profile, characters, and stash tabs. Authenticates with OAuth2 using the authorization code flow.
Use for: List the current Path of Exile leagues, Get the ladder for a specific league, Look up a PvP match by id, Read the public stash tabs
Not supported: Does not handle in-game purchases, account management, or writing to a character. Use for reading Path of Exile league, ladder, character, and public stash data only.
The Path of Exile API reads public game data and authenticated account data for the online action RPG, so an application can look up leagues, ladders, characters, and public stash tabs. You can list the current and past leagues and read a league's ladder, retrieve PvP matches and their details, and read the public stash tab stream that players use for trading. With an authenticated account you can read the account's profile, its characters, and its stash tabs for a given league.
Install Jentic One Beta
Connect the Path of Exile API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Path of Exile API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fpathofexile.com%2Fpath-of-exile" | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fpathofexile.com%2Fpath-of-exile" | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with Path of Exile API.
Read the list of active and past leagues
Retrieve a league's ladder rankings
Look up PvP matches and their details
Read the public stash tab stream used for trading
Read an authenticated account's profile and characters
Read an account's stash tabs for a league
Use Cases
Patterns agents use Path of Exile API for, with concrete tasks.
★ Agent-Driven Ladder and League Lookups
An AI agent connected through Jentic reads the active leagues and a league's ladder so a player can ask about standings in plain language and get an answer. The agent lists the leagues first to resolve the one the player means, then reads its ladder.
Find the current challenge league and return the top ten characters on its ladder
Character and Account Insights
With an authenticated account, an application reads the account's profile and characters so a companion tool can show a player's builds and progress. The tool reads the character list and then a named character's details to summarise its skills and level.
List my characters and return the level and class of my highest-level one
Public Stash Trading Data
A trading tool reads the public stash tab stream to track items players have listed, so it can surface prices and availability. It pages through the stream to keep a view of the current market for an item.
Read the latest public stash tabs and list any entries offering the item I am watching
Key Endpoints
10 endpoints — the path of exile api reads public game data and authenticated account data for the online action rpg, so an application can look up leagues, ladders, characters, and public stash tabs.
METHOD
PATH
DESCRIPTION
GET
/league
List leagues
GET
/league/{id}/ladder
Get league ladder
GET
/pvp-match
List PvP matches
GET
/public-stash-tabs
Get public stash tabs
GET
/account/profile
Get account profile
GET
/character
List characters
GET
/league
List leagues
GET
/league/{id}/ladder
Get league ladder
GET
/pvp-match
List PvP matches
GET
/public-stash-tabs
Get public stash tabs
GET
/account/profile
Get account profile
GET
/character
List characters
Why Jentic?
What agents get from Jentic-routed access to this vendor.
Setup
Wiring the Path of Exile API by hand means running the OAuth2 authorization code flow, refreshing the token, and learning how leagues scope ladders, characters, and stashes. Through Jentic you install once, import Path of Exile from the API Directory, authorize once, and your agent calls it.
Permission scoping
You choose which operations your agent may call, so you can allow the public reads like leagues and ladders while leaving account and stash operations out. Because the league id sits in the URL path, a rule can pin the agent to one league's data, and every call it makes is logged.
Credential isolation
Your Path of Exile OAuth token is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
Intent-based discovery
Agents search Jentic by intent such as 'get a league ladder' or 'list my characters', and Jentic returns the matching Path of Exile operation with its input schema so the agent calls the right endpoint without reading the reference docs.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using Path of Exile API through Jentic.
Is there a Path of Exile MCP server?
You don't need an MCP server to give your agent the Path of Exile API. Jentic connects it directly from the API Directory: import it, authorize once, and your agent can read leagues, ladders, and characters straight away, with no extra server to run and no tool definitions to load into the agent's context.
Can I limit what my agent is allowed to do with the Path of Exile API?
Yes. You choose which operations your agent may call, so you can allow reading leagues and ladders while leaving account profile and stash operations out. Because the league id sits in the URL path, a rule can also limit the agent to one league's data, and every call it makes is logged.
What authentication does the Path of Exile API use?
The Path of Exile API authenticates with OAuth2 using the authorization code flow per its OpenAPI spec, and requests carry the resulting access token. Through Jentic the token is stored encrypted by your own instance and added to each request at call time, so it never appears in the agent's prompt or logs.
Can I read a player's characters with the Path of Exile API?
Yes. With an authenticated account the API reads the account's profile and its characters, and it can return a named character's details. It also reads the account's stash tabs for a league, so an agent can summarise a player's builds and holdings.
What are the rate limits for the Path of Exile API?
The OpenAPI spec does not specify rate limits for the Path of Exile API. For current limits and developer terms, see the Path of Exile developer documentation at https://www.pathofexile.com/developer/docs.
How do I read Path of Exile data through Jentic?
Import the Path of Exile API from the Jentic API Directory, then have your agent issue a request such as 'get the ladder for the current league'. Jentic matches the intent to the right read operation and returns its input schema so the agent builds the correct request, with your authorization handled at call time.
GET STARTED