Poe Ninja API#

查询 Path of Exile 游戏内物品实时市场价格，通过 poe.ninja API 获取数据。

快速开始#

基础 API 端点#

所有 API 端点基于 https://poe.ninja/api/data/

两种数据类型：

• currencyoverview - 通货类（Currency、Fragment）
• itemoverview - 物品类（其余所有类型）

必需参数：

• league - 联盟名称（如 Settlers、 Standard、 Hardcore）
• type - 物品类型

物品类型列表#

通货类（currencyoverview）#

类型说明Currency通货（Chaos、Divine、Mirror 等）Fragment碎片（Sacrifice at Dusk 等）

物品类（itemoverview）#

类型说明Oil油（Golden Oil 等）Incubator孵化器Scarab圣甲虫Fossil化石Resonator共振器Essence精髓DivinationCard预言卡SkillGem技能宝石BaseType基底类型HelmetEnchant头盔附魔UniqueMap传奇地图Map地图UniqueJewel传奇珠宝UniqueFlask传奇药水UniqueWeapon传奇武器UniqueArmour传奇护甲UniqueAccessory传奇饰品Beast野兽Vial小瓶DeliriumOrb谵妄球Omen征兆UniqueRelic传奇遗物ClusterJewel集群珠宝BlightedMap凋零地图BlightRavagedMap凋零掠夺地图Invitation邀请函Memory记忆Coffin棺材AllflameEmber全燃余烬

API 调用示例#

查询通货价格#

text

GET https://poe.ninja/api/data/currencyoverview?league=Settlers&type=Currency

查询传奇武器价格#

text

GET https://poe.ninja/api/data/itemoverview?league=Settlers&type=UniqueWeapon

查询预言卡价格#

text

GET https://poe.ninja/api/data/itemoverview?league=Settlers&type=DivinationCard

响应数据结构#

Currency 响应#

json

{
  "lines": [
    {
      "currencyTypeName": "Mirror of Kalandra",
      "chaosEquivalent": 143915.04,
      "pay": { "value": 0.0000070301 },
      "receive": { "value": 146900 },
      "paySparkLine": { "totalChange": 42.25 },
      "receiveSparkLine": { "totalChange": -3.92 },
      "detailsId": "mirror-of-kalandra"
    }
  ],
  "currencyDetails": [
    {
      "id": 22,
      "name": "Mirror of Kalandra",
      "tradeId": "mirror",
      "icon": "https://..."
    }
  ]
}

关键字段：

• chaosEquivalent - Chaos 等值价格
• pay.value - 购买时需要的货币数量
• receive.value - 出售时获得的货币数量
• totalChange - 价格变化百分比

Item 响应#

json

{
  "lines": [
    {
      "id": 22607,
      "name": "Golden Oil",
      "baseType": "Golden Oil",
      "chaosValue": 59,
      "exaltedValue": 2.42,
      "divineValue": 0.23,
      "sparkline": { "totalChange": -1.67 },
      "detailsId": "golden-oil",
      "listingCount": 1997
    }
  ]
}

关键字段：

• chaosValue - Chaos 价格
• exaltedValue - Exalted 价格
• divineValue - Divine 价格
• sparkline.totalChange - 价格变化趋势
• listingCount - 在售数量

使用脚本#

脚本列表#

脚本说明get_currency.py获取通货价格get_item.py获取物品价格search_item.py搜索特定物品

常用查询#

查询 Divine Orb 价格#

使用 get_currency.py 查询：

bash

python scripts/get_currency.py --league Settlers --search "divine"

查询特定传奇装备#

使用 get_item.py 查询：

bash

python scripts/get_item.py --league Settlers --type UniqueWeapon --search "Starforge"

获取价格趋势#

响应中的 sparkline 字段包含价格趋势数据， totalChange 表示变化百分比。

注意事项#

1. 联盟名称 - 每个新赛季联盟名称不同，需要使用当前联盟名称
2. 价格更新 - poe.ninja 数据每小时更新一次
3. 低置信度数据 - lowConfidenceSparkline 表示交易量低，价格可能不准确
4. 图标链接 - 响应中的 icon 字段提供物品图标 URL

资源文件#

references/#

• api_reference.md - 完整 API 文档和响应示例

scripts/#

• get_currency.py - 查询通货价格
• get_item.py - 查询物品价格
• search_item.py - 搜索物品