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

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

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

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

请求参数

Header 参数

ApiToken

string

必需

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

默认值:

Body 参数application/json

good_id

integer

饰品good_id

必需

key

enum<string>

待查询的数据类型

必需

sell_price 出售价
buy_price 求购价
short_lease_price 短租租金
long_lease_price 长租租金
lease_annual 短租收益率
long_lease_annual 长租收益率
sell_num 在售数量
buy_num 求购数量
lease_num 在租数量
turnover_number 日成交量
transfer_price 租赁过户价

枚举值:

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
当为多普勒系列时，允许传
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,
      8350,
      8349.5,
      8399,
      8398.5,
      8399.5,
      8399,
      8500,
      8550
    ]
  }
}

🟠422Validation Error