常见问题
关于数据、许可、接入与配额的常见问题。
数据从哪里来?
来自运营者自己的扫描客户端,不包含任何第三方价格库。每一行挂单都能追溯到一次扫描;档案中已删除角色名、公会名与账号 ID。
下载数据集和 MCP 有什么区别?
下载给你完整的 Forever Beta 档案(DuckDB),适合批量分析与复现;MCP 让 Agent 按需点查,返回结果带 as_of、sample_size 与 confidence,适合直接放进对话。
数据多久更新一次?
运营者每天扫描 1–2 次。数据集按版本发布,指针原子切换;MCP 会把超过 24 小时的返回标记为 stale=true,不假装实时。
免费数据包含什么?
一个 ZIP 压缩包,解压后是 DuckDB 2.0 单文件:2,769,615 行挂单、17 天、5 个市场、4,044 个 item id,共七张数据表与 dataset_meta。data card、许可与查询示例见数据文档。
可以商用吗?
免费数据采用 CC BY-NC 4.0:允许非商业分享与改编,禁止转售,也禁止用来构建竞争性价格 API;商业使用需要单独书面许可,可邮件联系。
超过 Free 的 100 次 / 天会怎样?
返回 HTTP 429 与 Retry-After,响应体是 JSON-RPC error;额度按 Key 持久化,重启服务不会重置。Pro 于 11/6 起提供 10,000 次 / 月。
Key 丢了能找回吗?
不能。服务端只保存 Key 的 SHA-256,无法还原明文;请重新提交申请。
为什么算分位数要排除 summary 行?
summary 是「一个 (item, price) 的浏览聚合」,不是一条挂单,只有最低价、没有 buyout;算中位数 / p25 / p75 时必须加 WHERE quote_type = 'listing'。
数据里有玩家信息吗?
没有。档案不导出 owner、ownerName、bidderFullName、账号 ID 和公会名;源数据中 17 行带 owner 值,也未进入档案。
你们做价格预测吗?
不做。我们提供扫描观测与统计口径,不提供投资建议;Beta 档案是历史切片,不代表正式服价格。