HEYQUANT / DOCUMENTATION

导出与下载

创建导出请求，并使用已取得的下载地址保存文件。

创建导出

create_export(dataset, *, symbols, start_date, end_date, format="parquet") 向 POST /exports 发送以下参数，返回服务端 JSON。

参数	客户端类型	说明
`dataset`	`str`	数据集标识符
`symbols`	`list[str]`	标的列表
`start_date` / `end_date`	`str`	日期字符串；日期边界语义未公开
`format`	`str`	默认 `parquet`；客户端不校验枚举

import os
from heyquant import HeyQuantClient

with HeyQuantClient(
    base_url=os.environ["HEYQUANT_BASE_URL"],
    api_key=os.environ["HEYQUANT_API_KEY"],
) as client:
    job = client.create_export(
        "bars_stock_daily",
        symbols=["600519.SH"],
        start_date="2026-01-05",
        end_date="2026-01-14",
        format="parquet",
    )
    print(job)

获取下载地址

当前公开 SDK 没有任务轮询或提取下载地址的接口。不要假定任务创建响应中存在 download_url 字段；应通过服务已提供的有效流程取得可信地址。

保存文件

client.download(download_url, destination) 以流式 GET 下载到路径或已打开的二进制文件对象，返回 None。以下代码在已配置的 client 上调用。

# 使用你从服务取得的可信下载地址
client.download(download_url, "result.parquet")

路径方式以写入模式打开，会覆盖同名文件。下载失败可能留下部分文件，请确认下载成功后再用于分析。下载复用客户端连接，只使用可信服务地址。