企业微信

万得财经API数据获取概述

万得（Wind）作为国内领先的金融数据提供商，其API接口为投资者、量化交易者和金融机构提供了丰富的数据源。通过万得API，用户可以获取沪深行情、期货行情、财务数据、宏观数据等多维度金融信息，实现自动化数据获取和量化策略开发。

万得API主要通过Wind终端提供的接口实现数据交互，支持多种编程语言和开发环境。其中Python环境下的WindPy库是最常用的数据获取方式，能够满足大部分量化交易和数据分析需求。

环境配置与前期准备

在开始使用万得API之前，需要完成以下准备工作。首先需要拥有万得终端账号，万得数据服务需要付费订阅，个人投资者和机构用户需要通过官方渠道购买相应的数据服务权限。获取账号后，需要在本地安装Wind终端软件，这是使用API接口的基础条件。

如何获取万得财经API数据

Python环境的配置相对简单。确保已安装Python 3.6及以上版本，推荐使用Anaconda发行版以获得更好的包管理体验。安装完成后，通过pip命令安装WindPy库：


pip install WindPy

部分用户可能需要额外安装Visual C++ Redistributable运行库，这是WindPy正常运行的系统依赖。安装完成后，可以在Python环境中导入WindPy库进行测试：


from WindPy import w

print(w.isconnected())

数据连接与认证

与万得API建立连接是获取数据的第一步。WindPy库使用w.start()函数初始化连接，该函数会尝试连接本地安装的Wind终端。


from WindPy import w

# 启动Wind API连接

err = w.start()

if err.ErrorCode != 0:

    print(f"连接失败: {err.ErrorMsg}")

else:

    print("Wind API连接成功")

w.start()函数支持多种参数配置。waittime参数用于设置等待超时时间，单位为秒，默认值为30秒。对于网络环境较慢的用户，可以适当增加该参数值。qrycnt参数用于设置内部缓存的查询记录数，默认值为1000。

连接成功后，w.isconnected()函数可以用于检查当前连接状态。在长时间运行的任务中，定期检查连接状态是良好的编程习惯，可以避免因连接断开导致的数据获取失败。

股票数据获取方法

获取股票行情数据是万得API最常用的功能之一。通过w.wsd()函数可以获取指定股票的日线、周线、月线等历史行情数据。


from WindPy import w

import pandas as pd

# 获取股票日线数据

stock_code = "000001.SZ"  # 平安银行

start_date = "20230101"

end_date = "20231231"

# 查询日线行情数据

data = w.wsd(stock_code, "open,high,low,close,volume,amount", 

             start_date, end_date, "")

# 转换为DataFrame格式

df = pd.DataFrame(data.Data, index=data.Fields).T

df['trade_time'] = data.Times

print(df.head())

w.wsd()函数的第一个参数为股票代码，万得使用交易所代码加股票代码的格式，"000001.SZ"表示深圳证券交易所的平安银行，"600000.SH"表示上海证券交易所的浦发银行。第二个参数为数据字段，使用逗号分隔多个字段。常用的股票行情字段包括：open（开盘价）、high（最高价）、low（最低价）、close（收盘价）、volume（成交量）、amount（成交额）、pre_close（前收盘价）、change（涨跌幅）等。

对于实时行情数据，可以使用w.wsi()函数获取分钟级或更高频率的行情数据：


# 获取股票分钟线数据

minute_data = w.wsi(stock_code, "open,high,low,close,volume",

                    "2023-12-01 09:30:00", "2023-12-01 15:00:00", "")

期货数据获取方法

万得API同样支持丰富的期货数据获取功能，包括国内四大期货交易所的期货合约行情、持仓数据、仓单数据等。


# 获取期货日线数据

future_code = "IF.CF"  # 沪深300股指期货

future_data = w.wsd(future_code, "open,high,low,close,volume,oi",

                    "20230101", "20231231", "priceadj=CP")

future_df = pd.DataFrame(future_data.Data, 

                        index=future_data.Fields).T

print(future_df.head())

期货合约代码采用交易所代码加合约代码的格式。IF代表中证500股指期货，IH代表上证50股指期货，IC代表中证500股指期货，商品期货如CU代表铜期货、AU代表黄金期货等。后缀CF表示连续合约，MM表示主力连续合约。

对于期货的持仓数据和市场深度数据，可以使用w.wsd()函数查询相应的字段：


# 获取期货持仓数据

position_data = w.wsd(future_code, "oi,long_holding,short_holding",

                     "20230101", "20231231", "")

批量数据获取技巧

在实际应用中，经常需要同时获取多只股票或多个期货合约的数据。万得API支持批量查询，可以显著提高数据获取效率。


# 批量获取多只股票数据

stock_list = "000001.SZ,000002.SZ,600000.SH,600036.SH"

batch_data = w.wsd(stock_list, "close,volume", 

                   "20230101", "20231231", "priceadj=CP")

# 整理数据格式

for i in range(len(batch_data.Codes)):

    single_stock = pd.DataFrame(batch_data.Data[i], 

                                columns=batch_data.Fields)

    single_stock['code'] = batch_data.Codes[i]

    single_stock['date'] = batch_data.Times

    print(f"股票 {batch_data.Codes[i]} 数据:")

    print(single_stock.head())

使用批量查询时，将多个股票代码用逗号分隔即可。万得API的批量查询功能非常强大，理论上支持一次性查询上千个标的的数据。但在实际使用中，建议分批次查询以避免请求超时。

数据质量与常见问题

获取万得API数据时，需要注意数据质量的验证。首先检查返回数据的完整性，err.ErrorCode为0表示查询成功，非0值表示查询失败，需要根据错误码排查问题。


# 数据获取错误处理

result = w.wsd(stock_code, "close", "20230101", "20231231", "")

if result.ErrorCode != 0:

    print(f"数据获取失败，错误码: {result.ErrorCode}")

    print(f"错误信息: {result.ErrorMsg}")

else:

    print("数据获取成功")

常见的数据获取问题包括：网络连接不稳定导致请求超时、合约代码错误导致查询失败、数据权限不足无法获取某些字段等。对于权限问题，需要确认所购买的数据服务包含相应的数据权限。

数据应用与策略开发

获取到万得API数据后，可以广泛应用于量化策略回测、风险管理和投资分析等领域。结合pandas、numpy等数据处理库，可以快速完成数据清洗和特征工程。


# 计算股票技术指标

import pandas as pd

import numpy as np

# 假设已获取收盘价数据

prices = df['close'].values

# 计算简单移动平均线

df['MA5'] = df['close'].rolling(window=5).mean()

df['MA20'] = df['close'].rolling(window=20).mean()

# 计算收益率

df['returns'] = df['close'].pct_change()

print(df[['close', 'MA5', 'MA20', 'returns']].tail(10))

万得API的数据接口为量化投资提供了坚实的数据基础。通过熟练掌握API的使用方法，投资者可以构建自己的数据Pipeline，实现投资研究的自动化和系统化。持续学习和实践是掌握万得API的关键，建议读者在实际项目中不断探索和应用所学的知识。