本软件是基于股票行情接口（SMAPI）开发的全功能演示例程，面向股票行情分析、量化策略开发、金融数据系统搭建等场景，基于通达信服务器、腾讯爬虫、新浪爬虫等多源数据渠道封装，提供股票行情数据的订阅、查询、采集、缓存及格式转换等全流程功能，可获取股票代码表、动态行情、分时数据、分笔数据、K线数据、财务数据等全品类股票相关数据，同时支持指数与股票数据的统一管理，将指数和股票统一定义为商品，实现两类数据的标准化处理与调用，接口消息通过异步通信线程进行通知，保障数据获取的实时性与高效性。

一、功能与特点

1. 多数据源灵活适配与连接管理

支持通达信服务器、腾讯爬虫、新浪爬虫、本地通达信、本地缓存文件多数据源的灵活调用，不同数据类型可匹配最优数据源，保障数据获取的稳定性与多样性；自动维护与服务端的连接状态，针对通达信服务器接口支持多线程调用，适配高并发数据获取场景，腾讯、新浪爬虫接口则禁止多线程调用，避免接口异常；接口消息通过异步通信线程进行通知，开发者可通过接口传递的线程消息，实时掌握接口运行状态和获取数据。

2. 全品类行情数据采集与处理

可采集股票/指数的动态行情、分时数据、分笔（Tick切片）数据、历史K线数据、财务数据、除权数据、F10个股资料、盘口分析数据等全品类数据，覆盖股票分析全维度需求；基于原始数据实现周期转换，支持五分钟/日K线数据转换为其他周期K线、一分钟K线数据转换为分时数据，无需开发者手动计算，提升开发效率；对分笔Tick数据、分时数据、K线数据进行标准化处理，返回统一格式的数组变量地址，降低后续数据解析难度；支持腾讯盘口分析数据的专属采集，可获取实时买卖盘大单、小单数据，满足盘口深度分析需求。

3. 多模式行情订阅与查询

支持股票与指数的动态行情异步订阅（仅支持通达信服务器数据源），行情数据由服务端主动推送，满足实时行情监控需求；提供动态行情同步精准查询、简单行情快速查询、全部商品行情批量查询三种查询模式，适配不同精度的行情获取需求；支持全品类数据的本地缓存查询，基于本地通达信或缓存文件实现数据快速读取，降低网络依赖，提升查询效率；同时兼容沪市A股、深市A股、北证A股等多市场，股票标识采用“市场标识+股票代码”格式（SH=沪市、SZ=深市、BJ=北证），接口自动识别可交易商品（股票）与非交易商品（指数）。

4. 全方位数据缓存与本地存储

支持全部商品行情缓存的累加更新，实现行情数据的本地持久化，保障断网场景下的本地数据可用；针对财务数据、除权数据、F10资料、股票代码表等静态/半静态数据，支持本地缓存文件的读取与更新，减少重复的网络请求；本地通达信可作为核心本地数据源，支持K线、分时等数据的本地调取，实现多源数据的互补复用；可自定义缓存路径与缓存更新策略，确保本地缓存路径具备写入权限，避免缓存更新失败。

5. 股票基础信息与F10资料管理

支持上证、深证股票代码表的自动更新，保障商品代码的时效性；提供股票基本信息查询能力，可获取扩展拼音代码、是否T0等核心属性，满足股票基础信息检索需求；实现F10个股资料的分类/全部查询与本地缓存，支持股票基本资料文本数据的快速读取，无需反复请求远程数据源，提升查询效率。

6. 接口状态监控与异常处理

通过异步通信线程接收#接口消息_文本通知，实时监控接口的运行状态、数据获取结果、异常信息；支持自定义行情服务器地址（TCP协议），提供连接/断开服务器控制，方便开发者监控接口运行状态，排查连接问题；内置数据获取异常兜底机制，本地缓存/本地通达信优先级高于远程数据源，优先从本地调取数据，提升数据获取成功率。

二、行情接口模块（StockMarketApi_EC）

本例程核心依赖StockMarketApi_EC（股票行情数据接口SMAPI）易模块，由永轩软件开发，是连接股票SMAPI行情系统与上层应用的核心中间件，封装了多数据源对接、全品类数据处理、异步通信等核心能力，为易语言开发者提供低门槛、高性能的行情快速接入能力。

1. 模块核心特性

- 多数据源一体化封装 ：完整封装通达信服务器、腾讯、新浪等多数据源的对接逻辑，覆盖数据源连接、数据采集、格式标准化等全流程，无需开发者单独对接不同数据源的原生接口，大幅降低开发门槛；严格区分不同数据源的调用规范，规避多线程使用风险。

- 全品类数据兼容 ：全面支持动态行情、分时、分笔、K线、财务、除权、F10资料、盘口分析等全品类股票数据，同时支持指数与股票数据的统一管理，接口对两类商品提供标准化处理与调用，无需额外区分类型。

- 异步通信与实时性保障 ：内置异步通信线程，接口运行消息、数据状态消息通过#接口消息_文本推送，开发者可通过指针到文本函数获取消息内容，实时掌握接口运行状态，保障实时行情数据的高效推送。

- 智能缓存与本地复用 ：内置多类型数据缓存机制，支持动态行情累加缓存、静态数据本地持久化，本地缓存/本地通达信优先级高于远程数据源，可自定义缓存周期与路径，降低网络依赖，提升数据查询效率。

- 稳定可靠且适配性强 ：经过实盘环境验证，严格遵循SMAPI接口核心约定，支持多线程（通达信服务器专属）、高并发行情推送，适配股票交易日的行情接收需求；内置数据标准化处理逻辑，返回统一格式的数组变量地址，降低数据解析难度。

2. 模块核心能力

- 多数据源连接与状态管理（通达信/腾讯/新浪/本地通达信/本地缓存）

- 动态行情异步订阅与同步查询（仅通达信服务器）、多模式行情批量查询

- 全品类数据采集、标准化处理与周期转换（K线转分时、多周期K线转换）

- 本地缓存管理（缓存更新、读取、过期处理）与通达信数据无缝对接

- 股票代码表、商品行情缓存更新、F10资料与财务数据查询及本地缓存

- 异步消息通知与接口状态监控、异常信息反馈

- 自绘数据列表框控件（高速显示行情、分笔、分时、K线数据等）

三、开发语言说明

本软件完全基于易语言开发，核心逻辑、界面交互、接口调用均采用易语言实现，同时依赖StockMarketApi_EC易模块完成SMAPI接口的全功能调用，严格遵循SMAPI接口核心约定与使用规范。

- 优势 ：易语言全中文可视化开发环境，语法简单易懂，适合国内开发者快速上手股票行情软件开发；模块封装了复杂的多数据源对接、异步通信、数据标准化处理逻辑，开发者无需掌握C++等底层语言，即可快速搭建股票行情分析系统、量化策略工具、金融数据平台。

- 兼容性 ：支持易语言5.x及以上全版本，适配Windows全系列操作系统（Win7/Win10/Win11），无需额外安装依赖组件，开箱即用；可直接对接本地通达信软件，无需复杂配置，降低环境搭建成本。

- 缺陷： 易语言开发的软件可能会出现病毒误报，您在使用易语言编写软件时可能会因此受到困扰，从而需要向杀毒软件公司提交材料以避免误报的产生。

四、使用例程的基本步骤

步骤1：环境准备

1. 安装易语言开发环境（5.x及以上版本），确保易语言正常运行；

2. 解压例程安装包，将SStockMarketApi_EC模块导入易语言（程序→模块引用表→添加模块），确保模块加载成功；

3. 配置基础参数：设置本地通达信安装路径、本地缓存文件路径，确认多数据源调用权限；初始化异步通信线程，开启#接口消息_文本的消息通知机制，配置指针到文本函数的调用方式，预加载本地基础数据（股票代码表、F10资料等）。如不需本地数据源，可跳过本地路径配置，但需确认远程数据源可正常访问。

步骤2：服务器连接

1. 在组合框_行情服务器中选择目标行情服务器地址，为确保您的行情服务器可用，你可以在本地通达信目录下找到文件connect.cfg，用记事本打开并复制[HQHOST]节内容到接口配置文件StockMarket.ini对应的节替换；

2. 点击「连接服务器」，等待服务器连接成功（按钮状态变为「断开服务器」），通过异步消息通知确认当前交易日、接口版本显示正常，排查连接异常。

步骤3：行情订阅与实时数据获取

1. 切换至「股票行情」标签页，在输入框填写需要订阅的股票/指数代码（多商品用英文逗号分隔，如SH600026,SZ000002,BJ831010），需严格使用“市场标识+代码”格式；

2. 确认订阅数据源为通达信服务器（仅该数据源支持订阅功能），尽量在订阅行情之前，连接到服务器；

3. 点击「订阅行情」，即可通过异步消息接收实时动态行情数据，同时在行情列表中查看订阅商品的最新行情（含最新价、涨跌幅、买卖盘口等核心信息）；推送的动态行情数据使用后需要执行内存释放操作，避免内存泄漏。

步骤4：多类型数据查询与缓存

1. 切换至「数据查询」标签页，选择目标数据类型（K线、分时、分笔、财务、F10资料等），匹配对应数据源（如盘口分析仅支持腾讯数据源，分笔数据仅支持通达信服务器/本地缓存）；

2. 输入查询条件（股票代码、时间周期、查询日期等），配置缓存模式，点击「查询数据」，接口将从指定数据源采集数据并完成标准化处理，返回数组变量地址，可在列表中查看数据详情；

3. 若开启本地缓存，查询到的数据将自动写入本地缓存文件，后续查询可优先从本地调取，提升效率；切换至「缓存管理」标签页，可查看、更新或清理本地缓存数据。

步骤5：数据处理与周期转换

1. 切换至「K线数据」标签页，选择目标数据类型（如五分钟K线转日K、一分钟K线转分时），输入原始数据对应的股票代码与时间范围；

2. 点击「开始转换」，接口将自动完成数据周期转换，生成标准化数据并返回数组变量地址，可直接用于行情图表绘制或量化策略开发；

3. 转换完成后，可选择将转换后的数据保存至本地缓存，供后续重复使用。

步骤6：数据验证与二次开发

1. 测试多数据源连接、行情订阅、数据查询、缓存更新、周期转换等功能，验证数据完整性与准确性（可与通达信软件、新浪行情平台对比）；通过异步消息查看接口运行状态，排查异常问题；

2. 基于例程源码进行二次开发，可直接调用StockMarketApi_EC模块的接口命令，严格遵循SMAPI内存管理、数据源使用等规范，快速开发专属股票行情分析系统、量化策略工具、金融数据对接平台。

五、补充说明

- 本例程为演示版本，如需使用接口全部功能，需认证授权、技术支持服务等，可通过官方QQ：77766508、官网：www.yx10000.com 联系。

- 例程完整开源核心逻辑，开发者可直接参考源码学习股票行情接口（SMAPI）开发、多数据源对接、异步通信、数据缓存与处理等技术，快速掌握股票软件开发全流程。

- 核心使用约定：动态行情接口调用后必须手动释放内存；腾讯、新浪爬虫接口禁止多线程调用；不同数据类型需匹配对应数据源，调用前请确认数据源兼容性；本地缓存路径需具备写入权限，静态/半静态数据建议定期更新以保障时效性。