Contracts
Old: chuanhsing#2097 2026-09-06 13:42:10
New: chuanhsing#2097 2026-09-12 07:50:13
| Old | New | Differences | |
|---|---|---|---|
| 1 | - | # | |
| 1 | + | # Contracts | |
| 2 | 2 | ||
| 3 | - | ||
| 3 | + | Contracts are an item class used to perform Heists. They were introduced in the Heist league, but have been incorporated into the base game content afterwards. They can be taken to Adiyah, the Wayfinder at The Rogue Harbour to open a portal to the contract area. | |
| 4 | 4 | ||
| 5 | - | ||
| 5 | + | Contracts can be found as random drops, and can also be purchased from Whakano, the Barber in The Rogue Harbour. Smuggler's Caches randomly found in zones have an increased chance to drop unique Contracts and are the only way to obtain Quest Contracts. | |
| 6 | 6 | ||
| 7 | - | ||
| 7 | + | Contracts have an Area Level, which determines the monster level (and thus the difficulty of the monsters in the area), and the dropped item level. The highest Area Level is 83, wherein chests can occasionally drop Influenced items as well. [[Ventor's Gamble]] does not have any effect on drops received from Heist chests, neither does any IR/IQ (Item Rarity/Item Quantity) mod on an item. Only [[Thief's Trinket]]s and Brooches have an effect on Heist chests, see Optimal Gear for more info. | |
| 8 | 8 | ||
| 9 | - | ||
| 9 | + | Like Maps, Contracts can be converted into Normal, Magic or Rare rarities. Magic and Rare varieties have a higher Item Quantity and Item Rarity trait at the cost of more negative mods. Affixes can be added (and removed) as well, increasing the difficulty but also increasing the amount of item drops and decreasing the alert level raised (i.e. when opened, caches advance the meter less per opening, and therefore more caches can be opened overall before the alarm is triggered). Players can re-roll mods using [[Orb of Alteration]] for Magic contracts, and [[Orb of Scouring]]/[[Orb of Alchemy]] (or [[Chaos Orb]]) for Rare contracts. Players can also run a 2-3 mods version of the contract by upgrading a magic contract to rare by using [[Regal Orb]]. | |
| 10 | 10 | ||
| 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 | - | ``` | |
| 61 | - | ||
| 62 | - | Response: | |
| 63 | - | ||
| 64 | - | ``` | |
| 65 | - | { | |
| 66 | - | "id":"OQMzdqQUE", | |
| 67 | - | "complexity":11, | |
| 68 | - | "result":[ | |
| 69 | - | "c66708d98d350298186753096dbe9bed7dedbcd6d02d740e32b161c0c5d0c49d", | |
| 70 | - | "b56bcae791c0ecad463fafed58722fcbf6fd6c501066fb80700289d8507acd3c", | |
| 71 | - | "62e432ab385a23c62f05484061be15d557b66bc4cff42e549e90031f0ceb0723", | |
| 72 | - | ... | |
| 73 | - | ], | |
| 74 | - | "total":258 | |
| 75 | - | } | |
| 76 | - | ``` | |
| 77 | - | ||
| 78 | - | ## Fetch items | |
| 79 | - | ||
| 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 | - | ``` | |
| 89 | - | ||
| 90 | - | * [Item Format Schema](https://www.pathofexile.com/developer/docs/reference#type-Item) | |
| 91 | - | ||
| 92 | - | ## Reversing PoE trade site URLs to get JSON request data | |
| 93 | - | ||
| 94 | - | encode queries as a gzip-compressed base64-url-encoded stream | |
| 11 | + | Although possible, it is not worthwhile to use an [[Exalted Orb]] on rare contracts, or to apply a [[Vaal Orb]], for reasons of economic viability and the fact that contracts do not have their own corrupted implicit(s), respectively. |