API%3ATrade

Old: chuanhsing#2097 2025-08-02 11:45:51

New: chuanhsing#2097 2025-09-07 17:12:48

OldNewDifferences
1-# Mercenaries
1+# Official Trade Search
22
3-Veterans have journeyed to Wraeclast from the lawless cities of Trarthus. They're ready to offer their sinister services, but not for free. A Mercenary can be found in each area, each with their own personalities, as well as individual builds, skills, and items.
3+For query options, you can use Chrome, Press F12 into dev tool, choose Network tab, and enable Fetch/XHR filter.
44
5-Upon meeting a Mercenary, as per Trarthan tradition, they will challenge you to a duel to test your strength. Inspect these Mercenaries before the duel to make an informed choice. If you decide to duel them you may choose a reward for your victory: Hire them, take one of their items, or exile them.
5+![](https://i.imgur.com/W9NNKW4.png)
66
7-Only one Mercenary can accompany you at a time, but you can have up to three total in your service. Having varied options is useful, as there may be situations where you need specific backup, like a difficult boss fight!
7+**NOTE: Use POESESSID for better rate limiting.**
88
9-You can replace the items equipped to active Mercenaries, or those in reserve, with ones of your choosing. Mercenaries don't level up like Exile's do, so you should keep an eye out for more powerful Mercenaries as you progress through the Campaign and Endgame.
9+## Fetch league endpoint and get id, item_ids
1010
11-* Mercs count as half a player for the purposes of drops and mob difficulty. Jonathan mentions 9-player difficulty and loot, but says there are some differences to the way that that works now (!). If you have a bad build, merc could carry you; if you have a very good build, then at worst merc gives you more loot. There’s a floor on either side that’s gonna be beneficial to every player.
12-* If you defeat a merc a pick currency as reward from their “currency pouch”, you actually get all the currency they have, not just one item.
13-* There are about 30 different merc archetypes (striker, chaos mage, curses, auras, etc), also a lot of new different NPC skills. They don’t level up or have a passive tree, so you don’t have to micromanage anything other than equipment. No upkeep gold cost.
14-* Mercs don’t count as minions for the purposes of stuff affecting minions, but they do get the damage reduction from some aoe boss attacks the same way minions do.
15-* Mercs automatically heal to full life when out of combat.
16-* You can bring mercs anywhere in the game, including pinnacle bosses.
11+Endpoint: `https://www.pathofexile.com/api/trade/search/Settlers`, POST JSON to or GET ?q=JSON
12+Request:
13+```
14+{
15+ "query":{
16+ "status":{
17+ "option":"online"
18+ },
19+ "stats":[
20+ {
21+ "type":"and",
22+ "filters":[
23+ {
24+ "id":"explicit.stat_3299347043",
25+ "value":{
26+ "min":100
27+ },
28+ "disabled":false
29+ }
30+ ]
31+ }
32+ ],
33+ "filters":{
34+ "type_filters":{
35+ "filters":{
36+ "category":{
37+ "option":"accessory.belt"
38+ },
39+ "rarity":{
40+ "option":"rare"
41+ }
42+ }
43+ },
44+ "misc_filters":{
45+ "filters":{
46+ "ilvl":{
47+ "min":85
48+ },
49+ "corrupted":{
50+ "option":"false"
51+ }
52+ }
53+ }
54+ }
55+ },
56+ "sort":{
57+ "price":"asc"
58+ }
59+}
60+```
1761
18-[[include:Infamous_Modifiers]]
62+Response:
1963
20-[[include:Trarthus_Gems]]
64+```
65+{
66+ "id":"OQMzdqQUE",
67+ "complexity":11,
68+ "result":[
69+ "c66708d98d350298186753096dbe9bed7dedbcd6d02d740e32b161c0c5d0c49d",
70+ "b56bcae791c0ecad463fafed58722fcbf6fd6c501066fb80700289d8507acd3c",
71+ "62e432ab385a23c62f05484061be15d557b66bc4cff42e549e90031f0ceb0723",
72+ ...
73+ ],
74+ "total":258
75+}
76+```
2177
22-## Drops
78+## Fetch items
2379
24-* [[Azadi Crest]]
25-* [[Binds of Bloody Vengeance]]
26-* [[Hand of Heresy]]
27-* [[Scornflux]]
28-* [[Howlcrack]]
80+GET the items by endpoint `https://www.pathofexile.com/api/trade/fetch/` and the items are separated with `,`.
81+Request Format:
82+```
83+https://www.pathofexile.com/api/trade/fetch/{item_id1},{item_id2}?query={id}
84+```
85+Example Request:
86+```
87+https://www.pathofexile.com/api/trade/fetch/c66708d98d350298186753096dbe9bed7dedbcd6d02d740e32b161c0c5d0c49d?query=OQMzdqQUE
88+```
2989
30-## Equipments
90+* [Item Format Schema](https://www.pathofexile.com/developer/docs/reference#type-Item)
3191
32-* [[Kingmaker]]
33-* [[Dying Breath]]
34-* [[Victario's Charity]]
35-* [[Brinerot Flag]]
36-* [[Crown of the Tyrant]]
37-* [[Leer Cast]]
38-* [[Garb of the Ephemeral]]
39-* [[Saqawal's Nest]]
40-* [[Doppelgänger Guise]]
41-* [[Ralakesh's Impatience]]
42-* [[Legacy of Fury]]
43-* [[Perquil's Toe]]
44-* [[Shaper's Seed]]
92+## Reversing PoE trade site URLs to get JSON request data
4593
46-## FAQ
47-
48-##### How does equipping Mercenaries with items work? Can any Mercenary be equipped with any item?
49-Each Mercenary is associated with Attributes. Mercenaries will generate with gear that matches the Attributes they are associated with, and will only be able to be equipped with new Armour gear that matches their Attributes in the following way:
50-
51-For Mercenaries with a single Attribute, any Armour gear that requires that Attribute is valid. For Mercenaries with multiple Attributes, any Armour gear that requires an Attribute not associated with that Mercenary is invalid.
52-
53-As an example: A Strength Mercenary will be equippable with gear requiring just Strength, Strength + Dexterity or Strength + Intelligence. A Dexterity/Intelligence Mercenary will be equippable with gear requiring just Dexterity, just Intelligence or Dexterity + Intelligence.
54-
55-Mercenaries do not need to meet attribute requirements outside of the above rule. Mercenaries need to be within 70% of level requirements of an item to equip it.
56-
57-Mercenaries also have preferred weapon types, and will not equip weapons that do not match their preferred types. Generally, they are going to prefer weapons that they can actually use their skills with.
58-
59-##### Will Map modifiers affect rewards from Mercenaries?
60-Increased Quantity on a Map Area from Map Modifiers will increase the chances that you find an Infamous Mercenary in that area.
61-
62-##### Are Link skills able to target allied Mercenaries?
63-Yes, you can link to an allied Mercenary. Just make sure they don’t die on you.
64-
65-##### Can Gold appear as a reward in a Mercenary's pouch?
66-No.
67-
68-##### Can Mercenaries be renamed?
69-No.
70-
71-##### Can Mercenaries use items with influenced trigger skills (like Shaper weapons with Cast on Crit)?
72-Short answer - No.
73-
74-Longer answer - Mercenary Skills are not socketed into gear in the way that player skills are. They are inherent to the Mercenary rather than being the result of a socketed gem, so in the case of something like a Cast on Crit weapon, it would be hard to determine what skill should even be triggered - or indeed, do the triggering.
75-
76-##### Will Mercenaries be tradable with other players?
77-Mercenaries are not tradeable.
78-
79-##### Are Mercenaries account bound or character bound?
80-Account bound.
81-
82-##### Can I immediately use a high level Mercenary I've previously recruited when levelling a new character?
83-No. If you are 20+ levels lower than a Mercenary, they will not follow you. You are not worth their time.
84-
85-##### Do Mercenaries get passive skills from gear, such as the anointed notables on amulets or keystones from Uniques?
86-Anointed passive skills will work. Keystones from Uniques also will work.
87-
88-##### Will the Trarthan gems also appear in the Divine Font at the end of the Labyrinth, or are they only available from Mercenaries?
89-Trarthan Gems are only available from Mercenaries (starting in level 68+ areas), and each individual Gem is only available from a specific variety of Mercenary.
94+for https://www.pathofexile.com/trade/search/Settlers/NK6Ec5 , You can resolve it to JSON request with these https://www.pathofexile.com/api/trade/search/Settlers/NK6Ec5