技能介绍

解决的问题

金融数据开发者和分析师常面临一个多市场、多维度的实时数据获取难题。你需要快速从不同交易所拉取A股、港股、美股、外汇、期货的行情，进行板块与指数的穿透式分析，并基于复杂的财务与技术指标进行选股。传统的数据源接口分散，数据格式不一，且难以处理高频的分钟K线、盘口深度与竞价异动数据。

技能如何工作

straightflush 技能通过封装底层 API，提供了一套统一且强大的数据访问层。其核心工作流程如下：

代码解析与市场识别：首先通过 search_symbols 工具，将用户输入的股票名称、行业名或模糊代码，解析为精确的、带市场前缀的 THSCODE（如 USHA 代表上海A股）。该技能能智能处理单只A股自动选择或多只股票待选等复杂情况。

多市场行情获取：提供 market_data_cn、market_data_hk、market_data_us 等方法，用于批量获取实时行情。关键在于，它支持通过 query_key 参数选择不同粒度的数据集（如 “基础数据”、“扩展2” 或 “汇总”），但调用时必须保证市场同质（如不能混合上海和深圳A股）。

板块与指数深度分析：技能支持完整的板块分析链条：

通过 ths_industry() 和 ths_concept() 获取板块列表。
使用 market_data_block 查看板块整体行情。
调用 block_constituents 获取板块成分股，从而完成从宏观到微观的穿透。
对于指数，直接使用 market_data_index 并传入如 USHI000001 这样的标准代码。

高级选股与查询：整合了问财（iWencai）自然语言查询接口。你可以通过 wencai_nlp 方法，直接用中文描述选股条件（例如 “连续3年ROE大于15%，非ST”），技能会返回符合条件的股票列表及相关数据字段。

高频与实时数据处理：对于盘中分析场景，技能提供了获取分钟K线（klines）、分时数据（intraday_data）、五档盘口（depth）和大单流向（big_order_flow）的方法。此外，call_auction_anomaly 能扫描集合竞价期间的异动股。所有K线周期参数必须严格使用 “5m” 格式。

适用边界与注意点

该技能主要为需要深度金融数据分析和自动化交易策略开发的场景设计。

异步环境限制：THS 调用为同步阻塞式，在 FastAPI 或 asyncio 等异步框架中使用时，必须将其放入线程池执行，以避免阻塞主线程。
数据权限与限流：游客账户可能对部分专业或实时数据有访问限制。进行批量数据拉取时，建议在调用间添加 time.sleep(0.5) 以防止触发限流。
与基础行情技能的分工：对于仅需获取单只A股基础日K线或资金流向的简单场景，ths-financial-data 技能可能更轻量。而本技能更专注于多市场盘中数据、深度分析、板块指数和复杂选股。
参数严格性：调用时必须注意市场代码分组（沪深不能混用）、K线周期格式（如 “5m” 而非 “5min”）以及 count 与 start/end 参数的互斥性。

截图预览

使用场景

在A股交易时段，盘中需要实时监控股票分时走势、盘口深度与大单流向，以捕捉异常波动机会。
撰写行业研究报告时，需要快速获取申万行业板块的涨跌幅、成分股及领涨龙头，进行横向对比。
构建日内量化交易模型，需要高频获取指定股票的5分钟K线、均线和成交量，用于实时策略回测。
周末复盘时，使用问财自然语言组合复杂条件（如‘ROE连续增长且MACD金叉’），快速筛选下周潜力股池。

适合人员

私募基金研究员：需要实时监控市场异动与资金流向，为盘中交易决策提供数据支持。
个人量化开发者：专注于A股日内策略，需要稳定、高频地获取分钟K线与盘口深度数据。
券商行业分析师：撰写板块研究报告时，需要穿透性地获取行业指数行情与成分股表现。
传统股票投资顾问：需要通过问财快速将客户模糊的投资逻辑（如‘低估值蓝筹’）转化为具体的股票列表。

同花顺