获取单件饰品图表数据 - CSQAQ 数据开放API

🥇 获取单件饰品的多平台、各周期的图表数据（包括BUFF、悠悠有品、Steam平台的出售价、求购价、短租租金、长租租金、短租收益率、长租收益率、在售数量、求购数量、在租数量、日成交量、租赁过户价）

该接口需用饰品good_id进行请求，good_id获取接口为获取饰品的ID信息

📢注意：该接口请求周期超3个月时，接口返回数据会自动调整数据的粒度，如需查询全量的完整数据，请使用获取单件饰品全量图表数据接口

请求参数

Header 参数

ApiToken

string

必需

用户请求令牌（请自行申请）

默认值:

Body 参数application/json

good_id

integer

饰品good_id

必需

key

enum<string>

待查询的数据类型

必需

----------以下不限platform----------
sell_price 出售价
buy_price 求购价
sell_num 在售数量
buy_num 求购数量

----------以下仅限platform=2--------
lease_num 在租数量
short_lease_price 短租租金
long_lease_price 长租租金
lease_annual 短租收益率
long_lease_annual 长租收益率
transfer_price 租赁过户价

----------以下仅限platform=3--------
turnover_number 日成交量

枚举值:

sell_pricebuy_priceshort_lease_pricelong_lease_pricelease_annuallong_lease_annualsell_numbuy_numlease_numturnover_numbertransfer_price

platform

enum<integer>

对应平台

必需

1-BUFF 2-悠悠有品 3-Steam

枚举值:

123

period

enum<integer>

查询周期

必需

7 - 近7天
15 - 近15天
30 - 近1个月
90 - 近3个月
180 - 近6个月
365 - 近1年
1095 - 近3年

枚举值:

71530901803651095

style

enum<string>

款式

必需

默认为all_style
当 platform=1 查询多普勒系列时，允许传
Phase1 P1系列
Phase2 P2系列
Phase3 P3系列
Phase4 P4系列
Sapphire 蓝宝石
Ruby 红宝石
Black Pearl 黑珍珠
Emerald 绿宝石

枚举值:

all_stylePhase1Phase2Phase3Phase4SapphireRubyBlack PearlEmerald

示例

{
    "good_id": "7310",
    "key": "sell_price",
    "platform": 1,
    "period": "1095",
    "style": "all_style"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

code

integer

响应状态码

必需

msg

string

响应信息

必需

data

object

响应数据

必需

timestamp

array[integer]

数据时间戳列表

必需

num_data

array [oneOf]

在售数量列表

必需

仅key为sell_price时会和main_data返回

main_data

array [oneOf]

数据结果列表

必需

示例

{
    "code": 200,
    "msg": "Success",
    "data": {
        "timestamp": [
            1718726899000,
            1718813206000,
            1718899881000,
            1718986249000,
            1719072245000,
            1719158565000,
            1719246055000,
            1719332716000,
            1719418558000,
            1719504254000
        ],
        "num_data": [
            1222,
            1227,
            1231,
            1222,
            1230,
            1223,
            1203,
            1151,
            1156
        ],
        "main_data": [
            8350.0,
            8350.0,
            8349.5,
            8399.0,
            8398.5,
            8399.5,
            8399.0,
            8500.0,
            8550.0
        ]
    }
}

🟠422Validation Error