ClawHub

poe1 item search_for poe.ninja API

Lifestyle
游戏

Path of Exile 市场价格查询工具。通过 poe.ninja API 获取游戏物品实时价格数据。适用场景：(1) 查询通货汇率（Chaos/Divine/Mirror 等）(2) 查询装备、技能宝石、地图等物品价格 (3) 查询预言卡、圣甲虫、精髓等消耗品价格 (4) 获取价格趋势数据 (5) 跨联盟价格对比。支持所有物品类型的实时行情查询。

Install

openclaw skills install @qpooqp777/poe1

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 调用示例

查询通货价格

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

查询传奇武器价格

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

查询预言卡价格

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

响应数据结构

Currency 响应

{
  "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 响应

{
  "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 查询：

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

查询特定传奇装备

使用 get_item.py 查询：

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 - 搜索物品
More in Lifestyle