Skip to content
jiuhuang

安装

环境要求

  • Python 3.10+

安装方式

使用 uv（推荐）

Terminal window
uv add jiuhuang-pysdk
# 或者
uv pip install -U jiuhuang-pysdk

使用 pip

Terminal window
pip install -U jiuhuang-pysdk

初始化配置

方式一：使用环境变量（推荐）

设置环境变量 API_URL 和 API_KEY, 推荐通过dotenv配合.env文件来设置环境变量:

.env文件

API_URL='https://data.jiuhuang.xyz'
API_KEY ='你的API KEY'

官网免费申请API KEY: 入口

from dotenv import load_dotenv
from jiuhuang.data import JiuhuangData


load_dotenv() # 加载环境变量


jh = JiuhuangData()  # 自动读取环境变量

方式二：直接传入参数

from jiuhuang.data import JiuhuangData


jh = JiuhuangData(api_url="https://data.jiuhuang.xyz", api_key="你的API KEY")

验证安装

安装完成后，可以通过以下方式验证：

from jiuhuang.data import JiuhuangData, DataTypes


jh = JiuhuangData()


# 测试获取数据
data = jh.get_data(
    DataTypes.STOCK_ZH_A_HIST_QFQ,
    start="2025-01-01",
    end="2025-01-10",
    symbol="000001",
)


print(data.head())

下一步