星耀数智金融数据skill

概述

概述

AmazingData是中国银河证券提供的金融数据接口包，拥有丰富的数据内容，包括股票、债券、基金、期货、期权、港股通等行情数据，以及公司财务、股东股本等基本面数据。通过API方式提供金融数据服务，以帮助用户简洁、轻量的使用相关数据。

快速上手

• 安装python运行环境(推荐python3.8/3.9/3.10/3.11/3.12/3.13/3.14环境)，并安装AmazingData依赖包。

从 https://gitee.com/cgs2026/xysz/releases 下载 tgw 和 AmazingData 的 wheel 文件并安装。

pip install tgw>=1.0.8.7
pip install AmazingData>=1.1.15

• 联系开户营业部申请账号、密码。
• 参加2026年中国银河证券星耀数智AI模拟交易大赛，可获取星耀数智账号；
• 报名时间：10.29 — 11.20
• 比赛时间：11.02 — 11.27
• 报名链接，请关注微信公众号“中国银河证券星耀数智”
• 设置环境变量：

# Windows CMD
set AD_USERNAME=your_username
set AD_PASSWORD=your_password
set AD_HOST=101.230.159.235
set AD_PORT=8600

# Windows PowerShell
$env:AD_USERNAME="your_username"
$env:AD_PASSWORD="your_password"
$env:AD_HOST="101.230.159.235"
$env:AD_PORT="8600"

• 配置登录信息并初始化。

import os
import AmazingData as ad

ad.login(
    username=os.environ['AD_USERNAME'],
    password=os.environ['AD_PASSWORD'],
    host=os.environ['AD_HOST'],
    port=int(os.environ['AD_PORT'])
)

• 查询AmazingData接口文档，找到对应的接口。
• 根据接口文档，使用python代码获取数据。

参数格式说明

• 日期：8位整型格式，如 20241231
• 股票代码：交易所代码格式（如 000.SZ, 600.SH）
• 返回格式：pandas DataFrame 或 dict（key为代码，value为DataFrame）

数据接口调用模式

AmazingData有三个核心数据对象：

数据缓存方案

支持两种数据获取方式（二选一，不可混用）：

方案1：本地缓存（推荐，速度快）

• 参数：local_path（绝对路径） + is_local（True/False）
• is_local=True：优先从本地取数据；本地无数据时从服务端获取并缓存
• is_local=False：从服务端获取数据并更新本地缓存
• 文件格式：HDF5，建议本地存储空间500GB以上

方案2：指定日期范围（不缓存）

• 参数：begin_date + end_date
• 仅从服务器获取数据，不本地缓存

python脚本示例

• [股票数据获取示例](scripts/stock_data_example.py)
• [ETF数据获取示例](scripts/etf_data_example.py)
• [可转债数据获取示例](scripts/convertible_bond_data_example.py)
• [期权数据获取示例](scripts/option_data_example.py)

数据接口列表

数据类型代码

详见 [附录](references/appendix.md)

security_type（沪深北）

• EXTRA_STOCK_A: A股（上交所、深交所、北交所）
• EXTRA_STOCK_A_SH_SZ: 沪深A股
• SH_A / SZ_A / BJ_A: 单市场A股
• EXTRA_ETF: ETF基金
• EXTRA_KZZ: 可转债
• EXTRA_INDEX_A: 指数（沪深北）
• EXTRA_HKT: 港股通
• EXTRA_GLRA: 逆回购

security_type（期货）

• ZJ_FUTURE: 中金所期货
• EXTRA_FUTURE: 所有期货

security_type（期权）

• EXTRA_ETF_OP: ETF期权（上交所、深交所）

周期类型 Period

• Period.min1.value ~ Period.min120.value: 分钟线
• Period.day.value: 日线
• Period.week.value: 周线
• Period.month.value: 月线
• Period.season.value: 季度线
• Period.year.value: 年线

使用示例

获取股票代码列表

import os
import AmazingData as ad

ad.login(
    username=os.environ['AMAZINGDATA_USER'],
    password=os.environ['AMAZINGDATA_PASSWORD'],
    host=os.environ['AMAZINGDATA_HOST'],
    port=int(os.environ['AMAZINGDATA_PORT'])
)
base_data = ad.BaseData()
code_list = base_data.get_code_list(security_type='EXTRA_STOCK_A')

注意事项

1. 所有数据接口调用前必须先通过环境变量配置认证信息，然后调用ad.login()登录
2. 必须设置环境变量 AD_USERNAME、AD_PASSWORD、AD_HOST、AD_PORT
3. 账号、密码需联系开户营业部申请
4. MarketData实例化时必须传入交易日历：ad.MarketData(base_data.get_calendar())
5. 支持本地数据缓存（local_path + is_local）和指定日期范围（begin_date + end_date）两种模式，二选一
6. 股票数据最早可追溯至2013年，期货数据至2010年，期权数据至2015年
7. AmazingData限制单点登录，所以同一时间只能有一个AmazingData的登录链接

Python环境要求

• Python版本: 3.8-3.14
• 操作系统: Linux/Windows
• 依赖包: tgw>=1.0.8.7, AmazingData>=1.1.15