API的数据来源为Warframe Market,经由开发者进行了二次包装。
请求路由前缀
/wfa/wm
游戏平台切换
经修改,现在平台设置将写在查询参数中,比如获取PS4平台的希图斯信息可以这样写:
https://data.richasy.cn/wfa/basic/cetusStatus?platform=ps4
平台可选值参照游戏平台可选值,不写的话默认为PC。
查询代码
item
指的是条目的查询代码,而不是条目的名字,WM支持的条目名称与查询代码的对照表请参见词库内的WF_Sale
表
查询订单
请求地址 | 请求方式 | 请求类型 | 返回数据 |
---|---|---|---|
/orders/{item} | GET | 无 | JSON |
查询参数
pageSize
: 一页最多容纳的条目数page
: 页码type
: 订单类型,可选值为sell
或buy
status
: 用户状态(可多选),可选值为ingame
,online
和offline
rank
: Mod最低强化等级(如果搜的是Mod的话)minPrice
:最低价格maxPrice
: 最高价格
请求表示:在PC平台搜索名为ash_prime_set
的条目,要求订单状态为sell
,且用户状态为ingame
或online
,订单最低价格20pl,最高价格90pl的订单,将结果分页,每一页放10个条目,并返回第一页的结果。
返回结构
{
"items": [
{
"quantity": 2,
"creation_date": "2020-02-14T12:52:28+08:00",
"visible": true,
"user": {
"ingame_name": "SkilledBR",
"last_seen": "2020-02-14T12:55:06.997+08:00",
"reputation_bonus": 0,
"reputation": 1,
"region": "en",
"avatar": "user/avatar/5cb4bb9d4532a6053f2c646e.png?a5f23edf6b5613e125f9d19290e3f5df",
"status": "ingame",
"id": "5cb4bb9d4532a6053f2c646e"
},
"last_update": "2020-02-14T12:52:28+08:00",
"platinum": 75.0,
"order_type": "sell",
"region": "en",
"platform": "pc",
"id": "5e46278c5a828100780d5fa0",
"mod_rank": null,
"item": null
},
//...
],
"hasMore": true,
"page": 1,
"itemsCount": 10,
"totalCount": 11
}
数据说明
hasMore
:是否有更多的数据page
:当前页码itemsCount
:当前传回的数据条目个数totalCount
:查询到的符合搜索条件的条目总数
提醒
如果不想使用分页的查询方式,可以不传入page
和pageSize
查询参数,API会传回所有符合搜索条件的数据,回传的结构就只是一个订单数组(即上述结构的items
部分)
查询相关物品
请求地址 | 请求方式 | 请求类型 | 返回数据 |
---|---|---|---|
/itemset/{item} | GET | 无 | JSON |
返回结构
[
{
"tags": [
"blueprint",
"prime",
"warframe"
],
"ducats": 45,
"icon": "icons/en/ash_prime_blueprint.9f3f82bee82a9741531857cf76eb6594.png",
"icon_format": "port",
"trading_tax": 4000,
"thumb": "icons/en/thumbs/ash_prime_blueprint.9f3f82bee82a9741531857cf76eb6594.128x128.png",
"en": {
"item_name": "Ash Prime Blueprint",
"description": "<p>Release Date: July 7, 2015</p><p>Ash Prime is the primed variant of the Ash Warframe featuring more powerful stats, possessing a higher shield capacity, armor and sprint speed, as well as an additional polarity.</p>",
"wiki_link": "http://warframe.wikia.com/wiki/Ash/Prime",
"drop": [
{
"name": "Lith S3 Uncommon",
"link": null
},
//...
]
},
"mastery_level": 0,
"id": "559daa9fe779897b3263c2c7",
"url_name": "ash_prime_blueprint",
"set_root": false,
"sub_icon": "sub_icons/blueprint_128x128.png",
"rarity": null
},
//...
]
数据说明
这个API主要用于查询搜索条目的相关条目。比如我搜索ash_prime_set
,会回传包括蓝图,机体等在内的部件信息。这些信息就是条目的描述,不包含订单信息。
最新订单
请求地址 | 请求方式 | 请求类型 | 返回数据 |
---|---|---|---|
/recent | GET | 无 | JSON |
查询参数
type
: 订单类型,可选值为sell
,buy
,all
返回结构
[
{
"quantity": 1,
"creation_date": "2020-02-14T16:46:26.709+08:00",
"visible": true,
"user": {
"ingame_name": "GinoBear",
"last_seen": null,
"reputation_bonus": 0,
"reputation": 0,
"region": "zh",
"avatar": null,
"status": "ingame",
"id": "5e463ffcebde7c0055e7f5fb"
},
"last_update": "2020-02-14T16:46:26.709+08:00",
"platinum": 25.0,
"order_type": "sell",
"region": "zh",
"platform": "pc",
"id": "5e465e62f34415006eec870a",
"mod_rank": null,
"item": {
"tags": [
"blueprint",
"melee"
],
"ducats": 0,
"icon": "icons/en/Silva_&_Aegis_Prime_Set.d226bbe86d3eccd8c751958dba46a4f6.png",
"icon_format": null,
"trading_tax": 0,
"thumb": "icons/en/thumbs/Silva_&_Aegis_Prime_Set.d226bbe86d3eccd8c751958dba46a4f6.128x128.png",
"en": {
"item_name": "Silva & Aegis Prime Guard",
"description": null,
"wiki_link": null,
"drop": null
},
"mastery_level": 0,
"id": "592dd262011e88f094afec88",
"url_name": "silva_and_aegis_prime_guard",
"set_root": false,
"sub_icon": "sub_icons/guard_128x128.png",
"rarity": null
}
},
//...
]
数据说明
通过该API获得的数据在条目中会包含item
信息,里面提供了该订单的目标物品的信息。
如果将订单类型设置为all
,回传的数据结构会有变化:
{
"sell":[],
"buy":[]
}
统计数据
请求地址 | 请求方式 | 请求类型 | 返回数据 |
---|---|---|---|
/statistics/{item} | GET | 无 | JSON |
查询参数
type
: 数据来源类型,可选值为live
,closed
,all
。live表示目前在售的订单,closed表示隐藏或删除的订单,建议选择live
,不传的话默认为all
返回结构
{
"_48hours": [
{
"datetime": "2020-02-12T17:00:00+08:00",
"volume": 150,
"min_price": 40.0,
"max_price": 65.0,
"open_price": 0.0,
"closed_price": 0.0,
"avg_price": 52.5,
"wa_price": 51.353,
"median": 51.0,
"donch_top": 0.0,
"donch_bot": 0.0,
"id": "5e43cd2bdf14870022333a14",
"moving_avg": 77.9,
"order_type": "buy"
},
//...
],
"_90days": [
{
"datetime": "2019-11-17T08:00:00+08:00",
"volume": 252,
"min_price": 40.0,
"max_price": 102.0,
"open_price": 0.0,
"closed_price": 0.0,
"avg_price": 71.0,
"wa_price": 71.306,
"median": 80.0,
"donch_top": 0.0,
"donch_bot": 0.0,
"id": "5dd1e2eb9262e60022ba9a28",
"moving_avg": 115.9,
"order_type": "buy"
},
]
}
数据说明
如果将订单类型设置为all
,回传的数据结构会有变化:
{
"live":[],
"closed":[]
}
用户数据
请求地址 | 请求方式 | 请求类型 | 返回数据 |
---|---|---|---|
/profile/{name} | GET | 无 | JSON |
:::tip
name
指的是用户的游戏名,不可为空
:::
返回结构
{
"profile": {
"own_profile": false,
"ingame_name": "xxx",
"status": "offline",
"last_seen": "2020-02-14T17:29:08+08:00",
"reputation": 4,
"background": null,
"avatar": "user/avatar/5de19ce492f5e002c3fccc03.png?cac93edbaec6327315ce1ac564d5f8aa",
"platform": "pc",
"region": "en",
"banned": false,
"id": "5de19ce492f5e002c3fccc03",
"about": ""
},
"sell":[
// 结构请参考最新订单的条目结构
],
"buy":[]
}
数据说明
avatar
是用户头像,没设置的话会为null
,about
是用户的说明,是html文本。
杜卡德散件行情
请求地址 | 请求方式 | 请求类型 | 返回数据 |
---|---|---|---|
/ducats | GET | 无 | JSON |
返回结构
{
"previous_hour": [
{
"datetime": "2020-06-24T05:00:00.000+00:00",
"position_change_month": 0,
"position_change_week": 11,
"position_change_day": 8,
"plat_worth": 58.995,
"volume": 19,
"ducats_per_platinum": 15.0,
"ducats_per_platinum_wa": 14.49,
"ducats": 45,
"item": "5d93ca127ea27b0a87566f7c",
"median": 3.0,
"wa_price": 3.1,
"id": "5ef2ec9523fc73002455dc46"
},
...
],
"previous_day": [
{
// 同上
}
]
}
数据说明
对照 https://warframe.market/tools/ducats 查看数据含义。
id仅表示该条目的标识符,item才表示当前对应的条目ID。条目ID需搭配词库中的WF_Sale
词库使用.