poe1 item search_for poe.ninja API OpenClaw Skill
Path of Exile 市场价格查询工具。通过 poe.ninja API 获取游戏物品实时价格数据。适用场景：(1) 查询通货汇率（Chaos/Divine/Mirror 等）(2) 查询装备、技能宝石、地图等物品价格 (3) 查询预言卡、圣甲虫、精髓等消耗品价格 (4) 获取价格趋势数据 (5) 跨联盟价...
Installation
clawhub install poe1
Requires npm i -g clawhub
53
Downloads
0
Stars
0
current installs
0 all-time
1
Versions
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 表示变化百分比。
注意事项
- 联盟名称 - 每个新赛季联盟名称不同，需要使用当前联盟名称
- 价格更新 - poe.ninja 数据每小时更新一次
- 低置信度数据 -
lowConfidenceSparkline表示交易量低，价格可能不准确 - 图标链接 - 响应中的
icon字段提供物品图标 URL
资源文件
references/
api_reference.md- 完整 API 文档和响应示例
scripts/
get_currency.py- 查询通货价格get_item.py- 查询物品价格search_item.py- 搜索物品
Statistics
Author
qpooqp777
@qpooqp777
Latest Changes
v1.0.0 · Mar 25, 2026
poe-ninja-api 1.0.0 - 初始发布，支持通过 poe.ninja API 查询 Path of Exile 游戏内物品实时市场价格 - 支持通货、装备、技能宝石、地图等多种物品类型的价格获取 - 提供基础 API 文档及联盟和物品类型用法说明 - 包含常用 Python 查询脚本及参数示例 - 详细说明响应结构和关键字段，适合新手快速集成
Quick Install
clawhub install poe1 Related Skills
Other popular skills you might find useful.
Made in Europe Chat with 100+ AI Models in one App.
Use Claude, ChatGPT, Gemini alongside with EU-Hosted Models like Deepseek, GLM-5, Kimi K2.5 and many more.
