HEYQUANT / DOCUMENTATION

核心概念与约定

区分数据集、查询、导出，以及演示与服务返回。

数据集与可见性

数据集是服务提供的一组研究数据。公开目录帮助理解用途；list_datasets() 用来发现当前账户可见的内容。公开目录不等于账户权限清单。

查询与导出

查询通过 POST /query 提交 SQL，返回解析后的 JSON。SQL 的可用范围由服务端限制，客户端不提供 SQL 解析器或执行器。

导出通过 POST /exports 提交数据集、标的、日期与格式。SDK 默认格式为 parquet，公开产品方向包含 Parquet 与 CSV。任务完成与下载地址的获取流程尚未在公开客户端中定义。

数据语义

公开示例使用 600519.SH 作为标的筛选条件，使用 trade_date 和 close 字段。这不构成完整的代码规范、交易日历、复权口径或字段类型契约。

演示与真实数据

官网的 DEMO 序列完全合成。图表、表格、代码视图与 CSV 下载使用同一组八条记录；这不是 API 返回结构，也不表示真实行情。