FA3-Datafetch/legacy/DOC/API手册/ifind_manual.txt
2026-01-03 18:27:19 +08:00

7200 lines
68 KiB
Plaintext
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

iFinD HTTP API 用户手册
版本
时间
更新说明
1.0
2021-12-29
初版发布
2.0
2024-03-29
迭代版本
2.1
2025-08-25
说明修正
目录
一、TOKEN获取与使用
1、refresh_token说明
2、access_token说明
1、获取当前有效的access_token
2、获取一个新的access_token
3、使用access_token向同花顺服务器取数
二、各函数URL及formData生成逻辑
1、基础数据
2、日期序列
3、历史行情
4、高频序列
5、实时行情
6、日内快照
7、经济数据库(EDB)
8、专题报表函数
9、组合管理
(1组合新建
(2组合导入
1). 模板导入
2).文件导入
3).状态查询
(3)现金存取
(4)普通交易
(5)交易流水
(6)组合监控
(7)持仓分析
(8)绩效指标
(9)风险指标
10、智能选股
11、基金实时估值(分钟)
12、基金实时估值(日)
13、日期查询函数
14、日期偏移函数
15、数据量查询
16、错误信息查询
17、证券代码证券简称转同花顺代码
18、公告查询
三、错误说明
四、适用范围
1 / 43
五、版本管理
iFinD HTTP API是对过去各语言SDK形式的一个补充用户可以以API形式直接向同花顺服务器发送HTTP请求运行环境不
再需要下载SDK从而使用户摆脱设备、语言、环境的限制。
一、TOKEN获取与使用
接口鉴权方案分为长期的refresh_token和短期的access_token。
1、refresh_token说明
作用refresh_token只用来请求当前有效的access_token或者获取一个新access_token。
有效期refresh_token与获取时账号到期日一致如账号有续期或者权限变更需要更新refresh_token来更新权限。
获取方式refresh_token可以通过Windows接口包中超级命令客户端"工具-refresh_token查询/更新"或者网页版本超级命令账号信息查看或者更新。
注意refresh_token更新后所有环境过去的refresh_token、access_token均会失效更refresh_token相当于更改HTTP接口
的账号密码。
2、access_token说明
作用access_token用来直接向同花顺服务器请求数据。
有效期access_token会在初次生成的七天后失效。
注意单个access_token最多支持绑定20个IP。
1、获取当前有效的access_token
请求参数
项目
传参说明
URL
https://quantapi.51ifind.com/api/v1/get_access_token
requestMethod
POST/GET
requestHeaders
{"Content-Type":"application/json","refresh_token":user_refresh_token}
refresh_token放BODY也可
2、获取一个新的access_token
获取一个新的access_token会造成所有旧的access_token失效
请求参数
项目
传参说明
URL
https://quantapi.51ifind.com/api/v1/update_access_token
requestMethod
POST/GET
requestHeaders
{"Content-Type":"application/json","refresh_token":user_refresh_token}
示例——使用python请求当前有效的access_token
2 / 43
import requests
import json
getAccessTokenUrl = 'https://quantapi.51ifind.com/api/v1/get_access_token '
refreshToken ='eyJzaWduX3RpbWUiOiIyMDIxLTEyduX3RpbWUiO iIyMjI1In0=.eyJ1aWQiO
iIxMDYxMDUwMDMifQ==.F4CBBBC230969B0F220F9D6ECB666A230969B0F220FFBBCDA4156A3B78A1BB896'
getAccessTokenHeader = {"Content-Type":"application/json","refresh_token":refreshtoken}
getAccessTokenResponse=requests.post(url=getAccessTokenUrl,headers=getAccessTokenHeader)
accessToken = json.loads(getAccessTokenResponse.content)['data']['access_token'] print(accessToken)
3、使用access_token向同花顺服务器取数
使用超级命令协助获取协议
基础函数、日期序列函数、EDB函数、专题报表函数的指标与科目过多很难把所有内容都集中在文档中目前还是推荐用
户使用Windows SDK接口包中的超级命令终端或者网页版本超级命令协助获取协议。
协议说明
requestMethod需要为POST
requestHeaders需要包含{"Content-Type":"application/json","access_token":user_access_token}
各函数的formData或者requestURL见下方协议或者使用超级命令生成
请求参数需要统一处理为urlencode请求参数压缩支持Accept-Encoding: gzip,deflate
返回内容统一为unicode编码
示例——以Python请求300033实时行情为例
# -*- coding: utf-8 -*import requests
th sUrl = 'https://quantapi.51ifind.com/api/v1/real_time_quotation'
accessToken = '12fe737bc2014f39f195a2b7b03e3b11ec63b66b'
thsHeaders = {"Content-Type":"application/json","access_token":accessToken}
thsPara = {"codes":"300033.SZ","indicators":"open,high,low,latest"}
thsResponse = requests.post(url=thsUrl,json=thsPara,headers=thsHeaders)
print(thsResponse.content)
二、各函数URL及formData生成逻辑
1、基础数据
URL
https://quantapi.51ifind.com/api/v1/basic_data_service
formData
3 / 43
key
是否
必须
value
示例
codes
半角逗号分隔的所有代码
"codes":"300033.SZ,600030.SH"
indipara
各个指标及其相关参数indicator代表指标英文名indiparams代表
该指标的用户层的参数otherparams代表用户无需知晓但传输给服
务端所需的其他参数。otherparams中sys用来标记服务端所需的
name中为True的参数。推荐使用超级命令生成。
见下方代码块
示例
para =
{
"codes": "300033.SZ,600030.SH",
"indipara": [{
"indicator": "ths_roe_stock",
"indiparams": ["20241231"]
}, {
"indicator": "ths_roe_avg_by_ths_stock",
"indiparams": ["20241231"]
}]
}
该示例表示提取同花顺和中信证券在2024年年报的净资产收益率ROE;净资产收益率ROE(平均,同花顺计算)
输出:
字段
字段名称
字段描述
errorcode
错误 ID
代码运行错误码errorcode =0表示代码运行正常。若为其他则需查找错误原因
errmsg
错误信息
若 errorcode返回非空此处会返回具体的错误信息
tables
结构体
返回内容包括thscode、table具体的数据内容
datatype
指标格式
返回获取数据的指标格式
inputParams
输入参数
返回输入的参数
perf
处理时间
返回请求命令整体耗时ms
dataVol
数据量
返回当前命令消耗的数据量
2、日期序列
URL
https://quantapi.51ifind.com/api/v1/date_sequence
formData
key
是否
必须
value
示例
codes
半角逗号分隔的所有代码
"codes":"300033.SZ,600030.SH"
functionpara
key-value格式。所有key均取默认时functionpara省略。
见下方说明
startdate
开始日期,支持"YYYYMMDD""YYYY-MM-DD""YYYY/MM/DD"三
种日期格式
"startdate":"2018-01-01"
enddate
结束日期,支持"YYYYMMDD""YYYY-MM-DD""YYYY/MM/DD"三
种日期格式
"enddate":"2018-01-01"
4 / 43
key
是否
必须
value
示例
indipara
各个指标及其相关参数indicator代表指标英文名indiparams
代表该指标的用户层的参数otherparams代表用户无需知晓但
传输给服务端所需的其他参数。otherparams中sys用来标记服务
端所需的name中为True的参数。推荐使用Windows超级命令生
成。
见下方代码块
functionpara说明
名称
keys
value说明
省略时逻辑
时间周期
Interval
D-日 W-周 M-月 Q-季 S-半年 Y-年
D-日
日期类型
Days
Tradedays-交易日 Alldays-日历日
Tradedays-交易日
非交易间隔处理
Fill
Previous-沿用之前数据 Blank-空值
Previous-沿用之前数据
示例
para =
{
"codes": "300033.SZ,600030.SH",
"startdate": "20230101",
"enddate": "20241231",
"functionpara": {
"Days": "Alldays",
"Fill": "Blank",
"Interval": "Y"
},
"indipara": [{
"indicator": "ths_total_equity_atoopc_stock",
"indiparams": ["", "100"]
}, {
"indicator": "ths_regular_report_actual_dd_stock",
"indiparams": [""]
}]
}
该示例表示提取同花顺和中信证券在2023-24年年报的归属于母公司所有者权益合计;定期报告实际披露日期
输出:
字段
字段名称
字段描述
errorcode
错误 ID
代码运行错误码errorcode =0表示代码运行正常。若为其他则需查找错误原因
errmsg
错误信息
若 errorcode返回非空此处会返回具体的错误信息
tables
结构体
返回内容包括thscode、table具体的数据内容
datatype
指标格式
返回获取数据的指标格式
inputParams
输入参数
返回输入的参数
perf
处理时间
返回请求命令整体耗时ms
dataVol
数据量
返回当前命令消耗的数据量
3、历史行情
URL
5 / 43
https://quantapi.51ifind.com/api/v1/cmd_history_quotation
formData
key
是否必
value
示例
codes
半角逗号分隔的所有代码
"codes":"300033.SZ,600030.SH"
indicators
半角逗号分隔的所有指标
"indicators":"preClose,open"
functionpara
key-value格式。所有key均取默认时functionpara省略。
见下方说明
startdate
开始日期,支持"YYYYMMDD""YYYY-MMDD""YYYY/MM/DD"三种日期格式
"startdate":"2018-01-01"
enddate
结束日期,支持"YYYYMMDD""YYYY-MMDD""YYYY/MM/DD"三种日期格式
"enddate":"2018-01-01"
indicators参数说明
指标名
指标说明
preClose
前收盘价
open
开盘价
high
最高价
low
最低价
close
收盘价
avgPrice
均价
change
涨跌
changeRatio
涨跌幅
volume
成交量
amount
成交额
turnoverRatio
换手率
transactionAmount
成交笔数
totalShares
总股本
totalCapital
总市值
floatSharesOfAShares
A股流通股本
floatSharesOfBShares
B股流通股本
floatCapitalOfAShares
A股流通市值
floatCapitalOfBShares
B股流通市值
pe_ttm
市盈率TTM
pe
PE市盈率
pb
PB市净率
ps
PS市销率
pcf
PCF市现率
ths_trading_status_stock
交易状态
ths_up_and_down_status_stock
涨跌停状态
ths_af_stock
复权因子
ths_vol_after_trading_stock
盘后成交量
ths_trans_num_after_trading_stock
盘后成交笔数
ths_amt_after_trading_stock
盘后成交额
指标备注
6 / 43
指标名
指标说明
指标备注
ths_vaild_turnover_stock
有效换手率
netAssetValue
单位净值
基金专用
adjustedNAV
复权单位净值
基金专用
accumulatedNAV
累计单位净值
基金专用
premium
贴水
基金专用
premiumRatio
贴水率
基金专用
estimatedPosition
估算仓位
基金专用
floatCapital
流通市值
指数专用
pe_ttm_index
PE(TTM)
指数专用
pb_mrq
PB(MRQ)
指数专用
pe_indexPublisher
PE(指数发布方)
指数专用
yieldMaturity
到期收益率
债券专用
remainingTerm
剩余期限
债券专用
maxwellDuration
麦氏久期
债券专用
modifiedDuration
修正久期
债券专用
convexity
凸性
债券专用
close_2330
收盘价2330
外汇交易中心专用
openInterest
持仓量
期权专用
positionChange
持仓变动
期权专用
preSettlement
前结算价
期货专用
settlement
结算价
期货专用
change_settlement
涨跌(结算价)
期货专用
chg_settlement
涨跌幅(结算价)
期货专用
openInterest
持仓量
期货专用
positionChange
持仓变动
期货专用
amplitude
振幅
期货专用
functionpara参数说明
名称
keys
value说明
省略时逻辑
时间周
Interval
D-日 W-周 M-月 Q-季 S-半年 Y-年 同抽样周期二选一,返回周期汇总统计值
D-日
抽样周
SampleInterval
D-日 W-周 M-月 Q-季 S-半年 Y-年 同时间周期二选一,返回周期最后一个交
易日日频数据
D-日
复权方
CPS
1-不复权 2-前复权(分红再投) 3-后复权(分红再投) 4-全流通前复权
(分红再投) 5-全流通后复权(分红再投) 6-前复权(现金分红) 7-后复
权(现金分红)
1-不复权
报价类
PriceType
1-全价 2-净价 仅债券生效
1-全价
非交易
间隔处
Fill
Previous-沿用之前数据 Blank-空值 具体数值-自定义数值 Omit-缺省值
Previous-沿用
之前数据
设定复
权基点
BaseDate
复权基点日期,"YYYY-MM-DD"
后复权按上市
日,前复权按
最新日
货币
Currency
MHB-美元 GHB-港元 RMB-人民币 YSHB-原始货币
YSHB-原始货
7 / 43
示例
para =
{
"codes": "300033.SZ,600030.SH",
"indicators": "open,close,volume",
"startdate": "2024-08-25",
"enddate": "2025-08-25",
"functionpara": {
"Interval": "W",
"CPS": "3",
"Currency": "RMB",
"Fill": "Blank"
}
}
该示例表示提取同花顺和中信证券在20240825-20250825年周频率的开盘价、收盘价、成交量 后复权分红再投数据
输出:
字段
字段名称
字段描述
errorcode
错误 ID
代码运行错误码errorcode =0表示代码运行正常。若为其他则需查找错误原因
errmsg
错误信息
若 errorcode返回非空此处会返回具体的错误信息
tables
结构体
返回内容包括thscode、table具体的数据内容
datatype
指标格式
返回获取数据的指标格式
inputParams
输入参数
返回输入的参数
perf
处理时间
返回请求命令整体耗时ms
dataVol
数据量
返回当前命令消耗的数据量
4、高频序列
URL
https://quantapi.51ifind.com/api/v1/high_frequency
formData
key
是否
必须
value
示例
codes
半角逗号分隔的所有代码
"codes":"300033.SZ,600030.SH"
indicators
半角逗号分隔所有指标
"indicators":"open,high"
functionpara
key-value格式。所有key均取默认时functionpara省略。技术
指标额外在calculate生成生成规则见下文。
见下方代码块
starttime
开始日期,支持"YYYYMMDD HH:mm:ss""YYYY-MM-DD
HH:mm:ss""YYYY/MM/DD HH:mm:ss"三种时间格式
"starttime":"2018-01-01
09:15:00"
endtime
结束日期,支持"YYYYMMDD HH:mm:ss""YYYY-MM-DD
HH:mm:ss""YYYY/MM/DD HH:mm:ss"三种日期格式
"endtime":"2018-01-01
15:15:00"
indicators参数说明
指标名
指标说明
指标备注
open
开盘价
通用
8 / 43
指标名
指标说明
指标备注
high
最高价
通用
low
最低价
通用
close
收盘价
通用
avgPrice
均价
通用
volume
成交量
通用
amount
成交额
通用
change
涨跌
通用
changeRatio
涨跌幅
通用
turnoverRatio
换手率
通用
sellVolume
内盘
通用
buyVolume
外盘
通用
changeRatio_accumulated
涨跌幅(累计)
股票,仅支持当天
BBI
BBI多空指数
股票
DDI
DDI方向标准离差指数
股票
DMA
DMA平均线差
股票
MA
MA简单移动平均
股票
EXPMA
EXPMA指数平均数
股票
MACD
MACD指数平滑异同平均
股票
MTM
MTM动力指标
股票
PRICEOSC
PRICEOSC价格振荡指标
股票
TRIX
TRIX三重指数平滑平均
股票
BIAS
BIAS乖离率
股票
CCI
CCI顺势指标
股票
DBCD
DBCD异同离差乖离率
股票
DPO
DPO区间震荡线
股票
KDJ
KDJ随机指标
股票
LWR
LWR威廉指标
股票
ROC
ROC变动速率
股票
RSI
RSI相对强弱指标
股票
SI
SI摆动指标
股票
SRDM
SRDM动向速度比率
股票
VROC
VROC量变动速率
股票
VRSI
VRSI量相对强弱
股票
WR
WR威廉指标
股票
ARBR
ARBR人气意愿指标
股票
CR
CR能量指标
股票
PSY
PSY心理指标
股票
VR
VR成交量比率
股票
WAD
WAD威廉聚散指标
股票
MFI
MFI资金流向指标
股票
OBV
OBV能量潮
股票
PVT
PVT量价趋势指标
股票
WVAD
WVAD威廉变异离散量
股票
9 / 43
指标名
指标说明
指标备注
BBIBOLL
BBIBOLL多空布林线
股票
BOLL
BOLL布林线
股票
CDP
CDP逆势操作
股票
ENV
ENV指标
股票
MIKE
MIKE麦克指标
股票
LB
量比
股票
VMA
VMA量简单移动平均
股票
VMACD
VMACD量指数平滑异同平均
股票
VOSC
VOSC成交量震荡
股票
TAPI
TAPI加权指数成交值
股票
VSTD
VSTD成交量标准差
股票
ADTM
ADTM动态买卖气指标
股票
MI
MI动量指标
股票
MICD
MICD异同离差动力指数
股票
RC
RC变化率指数
股票
RCCD
RCCD异同离差变化率指数
股票
SRMI
SRMI(MI修正指标)
股票
DPTB
DPTB大盘同步指标
股票
JDQS
JDQS阶段强势指标
股票
JDRS
JDRS阶段弱势指标
股票
ZDZB
ZDZB筑底指标
股票
ATR
ATR真实波幅
股票
MASS
MASS梅丝线
股票
STD
STD标准差
股票
VHF
VHF纵横指标
股票
CVLT
CVLT佳庆离散指标
股票
large_amt_timeline
主力净流入金额(分时)
股票
active_buy_large_volume
主动买入特大单量
股票,同花顺指数
active_sell_large_volume
主动卖出特大单量
股票,同花顺指数
active_buy_main_volume
主动买入大单量
股票,同花顺指数
active_sell_main_volume
主动卖出大单量
股票,同花顺指数
active_buy_middle_volume
主动买入中单量
股票,同花顺指数
active_sell_middle_volume
主动卖出中单量
股票,同花顺指数
possitive_buy_large_volume
被动买入特大单量
股票,同花顺指数
possitive_sell_large_volume
被动卖出特大单量
股票,同花顺指数
possitive_buy_main_volume
被动买入大单量
股票,同花顺指数
possitive_sell_main_volume
被动卖出大单量
股票,同花顺指数
possitive_buy_middle_volume
被动买入中单量
股票,同花顺指数
possitive_sell_middle_volume
被动卖出中单量
股票,同花顺指数
active_buy_large_amount
主动买入特大单金额
股票,同花顺指数
active_sell_large_amount
主动卖出特大单金额
股票,同花顺指数
active_buy_main_amount
主动买入大单金额
股票,同花顺指数
active_sell_main_amount
主动卖出大单金额
股票,同花顺指数
10 / 43
指标名
指标说明
指标备注
possitive_buy_large_amount
被动买入特大单金额
股票,同花顺指数
possitive_sell_large_amount
被动卖出特大单金额
股票,同花顺指数
possitive_buy_main_amount
被动买入大单金额
股票,同花顺指数
possitive_sell_main_amount
被动卖出大单金额
股票,同花顺指数
active_buy_middle_amount
主动买入中单金额
股票,同花顺指数
active_sell_middle_amount
主动卖出中单金额
股票,同花顺指数
possitive_buy_middle_amount
被动买入中单金额
股票,同花顺指数
possitive_sell_middle_amount
被动卖出中单金额
股票,同花顺指数
openInterest
持仓量
期权,期货
changeRatio_periodical
涨跌幅(阶段)
期权专用
技术指标规则说明
选择技术指标时需同时在functionpara的calculate字段以indicators为key以半角逗号拼接各个参数字符串为value。为下
列特殊的参数额外使用下列英文名,其他的沿用下拉框英文值。
indicators参数说明
指标名
指标说明
指标备注
BBI
BBI多空指数
{周期1},{周期2},{周期3},{周期4}
DDI
DDI方向标准离差指数
{周期1},{周期2},{平滑因子},{周期3},{DDI or ADDI or AD}
DMA
DMA平均线差
{短周期},{长周期},{周期},{DDD or AMA}
MA
MA简单移动平均
{周期}
EXPMA
EXPMA指数平均数
{周期}
MACD
MACD指数平滑异同平均
{短周期},{长周期},{周期},{DIFF or DEA or MACD}
MTM
MTM动力指标
{间隔周期},{周期},{MTM or MTMMA}
PRICEOSC
PRICEOSC价格振荡指标
{短周期},{长周期}
TRIX
TRIX三重指数平滑平均
{周期1},{周期2},{TRIX or TRMA}
BIAS
BIAS乖离率
{周期}
CCI
CCI顺势指标
{周期}
DBCD
DBCD异同离差乖离率
{周期1},{周期2},{周期3},{DBCD or MM}
DPO
DPO区间震荡线
{周期1},{周期2},{DPO or MADPO}
KDJ
KDJ随机指标
{周期},{周期1},{周期2},{K or D or J}
LWR
LWR威廉指标
{周期},{周期1},{周期2},{LWR1 or LWR2}
ROC
ROC变动速率
{间隔周期},{周期},{ROC or ROCMA}
RSI
RSI相对强弱指标
{周期}
SI
SI摆动指标
SRDM
SRDM动向速度比率
{周期},{SRDM or ASRDM}
VROC
VROC量变动速率
{周期}
VRSI
VRSI量相对强弱
{周期}
WR
WR威廉指标
{周期}
ARBR
ARBR人气意愿指标
{周期},{AR or BR}
CR
CR能量指标
{周期}
PSY
PSY心理指标
{周期1},{周期2},{PSY or MAPSY}
VR
VR成交量比率
{周期}
11 / 43
指标名
指标说明
指标备注
WAD
WAD威廉聚散指标
{周期},{WAD or MAWAD}
MFI
MFI资金流向指标
{周期}
OBV
OBV能量潮
{OBV or OBV_XZ}
PVT
PVT量价趋势指标
WVAD
WVAD威廉变异离散量
{周期1},{周期2},{WVAD or MAWVAD}
BBIBOLL
BBIBOLL多空布林线
{周期},{宽带},{BBIBOLL or UPR or DWN}
BOLL
BOLL布林线
{周期},{宽带},{MID or UPPER or LOWER}
CDP
CDP逆势操作
{CDP or AH or AL or NH or NL}
ENV
ENV指标
{周期},{UPPER or LOWER}
MIKE
MIKE麦克指标
{周期},{WR or MR or SR or WS or MS or SS}
LB
量比
{周期}
VMA
VMA量简单移动平均
{周期}
VMACD
VMACD量指数平滑异同平均
{短周期},{长周期},{周期},{DIFF or DEA or MACD}
VOSC
VOSC成交量震荡
{短周期},{长周期}
TAPI
TAPI加权指数成交值
{周期},{TAPI or MATAPI}
VSTD
VSTD成交量标准差
{周期}
ADTM
ADTM动态买卖气指标
{周期},{周期1},{ADTM or MAADTM}
MI
MI动量指标
{周期},{A or MI}
MICD
MICD异同离差动力指数
{周期},{周期1},{周期2},{DIF or MICD}
RC
RC变化率指数
{周期}
RCCD
RCCD异同离差变化率指数
{周期},{周期1},{周期2},{DIF or RCCD}
SRMI
SRMI(MI修正指标)
{周期}
DPTB
DPTB大盘同步指标
{周期},{000001 or 000010 or 399001 or 000300}
JDQS
JDQS阶段强势指标
{周期},{000001 or 000010 or 399001 or 000300}
JDRS
JDRS阶段弱势指标
{周期},{000001 or 000010 or 399001 or 000300}
ZDZB
ZDZB筑底指标
{周期},{周期1},{周期2},{B or D}
ATR
ATR真实波幅
{周期},{TR or ATR}
MASS
MASS梅丝线
{周期1},{周期2}
STD
STD标准差
{周期}
VHF
VHF纵横指标
{周期}
CVLT
CVLT佳庆离散指标
{周期}
functionpara控件说明
名称
keys
value说明
设置
时间
区间开始
时间
Limitstart
限定每个交易日数据的开始时间
设置
时间
区间结束
时间
Limitend
限定每个交易日数据的截止时间
时间
周期
Interval
1-1分钟 3-3分钟 5-5分钟 10-10分钟 15-15分钟 30-30分钟 60-60分钟
省略时逻辑
12 / 43
1-1分钟
名称
keys
value说明
省略时逻辑
非交
易间
隔处
Fill
Previous-沿用之前数据 Blank-空值 具体数值-自定义数值 Original-不处理
Original-不
处理
分红
再投
复权
方式
CPS
后复权(分红方案计算)-backward1 前复权(交易所价格计算)-forward3 后复权
(交易所价格计算)-backward3 全流通前复权(分红方案计算)-forward2 全流通
后复权(分红方案计算)-backward2 全流通前复权(交易所价格计算)-forward4
全流通后复权(交易所价格计算)-backward4 不复权-no
no-不复权
时间
戳格
Timeformat
BeiJingTime-北京时间 LocalTime-当地时间
BeiJingTime北京时间
设定
复权
基点
BaseDate
复权基点日期,"YYYY-MM-DD"
后复权按上
市日,前复
权按最新日
示例
para =
{
"codes": "300033.SZ,600030.SH",
"indicators": "open,high,SI,MACD,DPTB,OBV,KDJ",
"starttime": "2018-01-01 09:15:00",
"endtime": "2018-01-01 09:50:00",
"functionpara":
{
"Interval": "1",
"Fill":
"Original",
"calculate": {
"SI": ""
"MACD":
"12,26,9,MACD",
"DPTB": "7,000001",
"OBV": "OBV_XZ",
"KDJ": "9,3,3,K",
}
}
}
输出:
字段
字段名称
字段描述
errorcode
错误 ID
代码运行错误码errorcode =0表示代码运行正常。若为其他则需查找错误原因
errmsg
错误信息
若 errorcode返回非空此处会返回具体的错误信息
tables
结构体
返回内容包括thscode、table具体的数据内容
datatype
指标格式
返回获取数据的指标格式
inputParams
输入参数
返回输入的参数
perf
处理时间
返回请求命令整体耗时ms
dataVol
数据量
返回当前命令消耗的数据量
5、实时行情
URL
https://quantapi.51ifind.com/api/v1/real_time_quotation
13 / 43
formData
key
是否
必须
value
示例
codes
半角逗号分隔的所有代码
"codes":"300033.SZ,600030.SH"
indicators
半角逗号分隔的所有指标
"indicators":"open,high"
functionpara
key-value格式。仅包含债券报价方式pricetype控件失效
时,不生成,否则生成。
见下方代码块
indicators参数说明
指标名
指标说明
指标备注
tradeDate
交易日期
通用
tradeTime
交易时间
通用
preClose
前收盘价
通用
open
开盘价
通用
high
最高价
通用
low
最低价
通用
latest
最新价
通用
latestAmount
现额
通用
latestVolume
现量
通用
avgPrice
均价
通用
change
涨跌
通用
changeRatio
涨跌幅
通用
upperLimit
涨停价
通用
downLimit
跌停价
通用
amount
成交额
通用
volume
成交量
通用
turnoverRatio
换手率
通用
sellVolume
内盘
通用
buyVolume
外盘
通用
totalBidVol
委买十档总量
股票
totalAskVol
委卖十档总量
股票
totalShares
总股本
股票
totalCapital
总市值
股票
pb
市净率
股票
riseDayCount
连涨天数
股票
suspensionFlag
停牌标志
股票
tradeStatus
交易状态
股票
chg_1min
1分钟涨跌幅
股票
chg_3min
3分钟涨跌幅
股票
chg_5min
5分钟涨跌幅
股票
chg_5d
5日涨跌幅
股票
chg_10d
10日涨跌幅
股票
chg_20d
20日涨跌幅
股票
chg_60d
60日涨跌幅
股票
14 / 43
指标名
指标说明
指标备注
chg_120d
120日涨跌幅
股票
chg_250d
250日涨跌幅
股票
chg_year
年初至今涨跌幅
股票
mv
流通市值
股票
vol_ratio
量比
股票
committee
委比
股票
commission_diff
委差
股票
pe_ttm
市盈率TTM
股票
pbr_lf
市净率LF
股票
swing
振幅
股票
lastest_price
最新成交价
股票
af_backward
后复权因子(分红方案计算)
股票
bid10
买10价
股票
bid9
买9价
股票
bid8
买8价
股票
bid7
买7价
股票
bid6
买6价
股票
bid5
买5价
股票
bid4
买4价
股票
bid3
买3价
股票
bid2
买2价
股票
bid1
买1价
股票
ask1
卖1价
股票
ask2
卖2价
股票
ask3
卖3价
股票
ask4
卖4价
股票
ask5
卖5价
股票
ask6
卖6价
股票
ask7
卖7价
股票
ask8
卖8价
股票
ask9
卖9价
股票
ask10
卖10价
股票
bidSize10
买10量
股票
bidSize9
买9量
股票
bidSize8
买8量
股票
bidSize7
买7量
股票
bidSize6
买6量
股票
bidSize5
买5量
股票
bidSize4
买4量
股票
bidSize3
买3量
股票
bidSize2
买2量
股票
bidSize1
买1量
股票
askSize1
卖1量
股票
15 / 43
指标名
指标说明
指标备注
askSize2
卖2量
股票
askSize3
卖3量
股票
askSize4
卖4量
股票
askSize5
卖5量
股票
askSize6
卖6量
股票
askSize7
卖7量
股票
askSize8
卖8量
股票
askSize9
卖9量
股票
askSize10
卖10量
股票
avgBuyPrice
均买价
股票
avgSellPrice
均卖价
股票
totalBuyVolume
总买量
股票
totalSellVolume
总卖量
股票
transClassification
成交分类
股票
transTimes
成交次数
股票
mainInflow
主力流入金额
股票
mainOutflow
主力流出金额
股票
mainNetInflow
主力净流入金额
股票
retailInflow
散户流入金额
股票
retailOutflow
散户流出金额
股票
retailNetInflow
散户净流入金额
股票
largeInflow
超大单流入金额
股票
largeOutflow
超大单流出金额
股票
largeNetInflow
超大单净流入金额
股票
bigInflow
大单流入金额
股票
bigOutflow
大单流出金额
股票
bigNetInflow
大单净流入金额
股票
middleInflow
中单流入金额
股票
middleOutflow
中单流出金额
股票
middleNetInflow
中单净流入金额
股票
smallInflow
小单流入金额
股票
smallOutflow
小单流出金额
股票
smallNetInflow
小单净流入金额
股票
activeBuyLargeAmt
主动买入特大单金额
股票
activeSellLargeAmt
主动卖出特大单金额
股票
activeBuyMainAmt
主动买入大单金额
股票
activeSellMainAmt
主动卖出大单金额
股票
activeBuyMiddleAmt
主动买入中单金额
股票
activeSellMiddleAmt
主动卖出中单金额
股票
activeBuySmallAmt
主动买入小单金额
股票
activeSellSmallAmt
主动卖出小单金额
股票
possitiveBuyLargeAmt
被动买入特大单金额
股票
possitiveSellLargeAmt
被动卖出特大单金额
股票
16 / 43
指标名
指标说明
指标备注
possitiveBuyMainAmt
被动买入大单金额
股票
possitiveSellMainAmt
被动卖出大单金额
股票
possitiveBuyMiddleAmt
被动买入中单金额
股票
possitiveSellMiddleAmt
被动卖出中单金额
股票
possitiveBuySmallAmt
被动买入小单金额
股票
possitiveSellSmallAmt
被动卖出小单金额
股票
activeBuyLargeVol
主动买入特大单量
股票
activeSellLargeVol
主动卖出特大单量
股票
activeBuyMainVol
主动买入大单量
股票
activeSellMainVol
主动卖出大单量
股票
activeBuyMiddleVol
主动买入中单量
股票
activeSellMiddleVol
主动卖出中单量
股票
activeBuySmallVol
主动买入小单量
股票
activeSellSmallVol
主动卖出小单量
股票
possitiveBuyLargeVol
被动买入特大单量
股票
possitiveSellLargeVol
被动卖出特大单量
股票
possitiveBuyMainVol
被动买入大单量
股票
possitiveSellMainVol
被动卖出大单量
股票
possitiveBuyMiddleVol
被动买入中单量
股票
possitiveSellMiddleVol
被动卖出中单量
股票
possitiveBuySmallVol
被动买入小单量
股票
possitiveSellSmallVol
被动卖出小单量
股票
activebuy_volume
主买总量
股票
activesell_volume
主卖总量
股票
activebuy_amt
主买总额
股票
activesell_amt
主卖总额
股票
post_lastest
盘后最新成交价
股票
post_latestVolume
盘后现量
股票
post_volume
盘后成交量
股票
post_amt
盘后成交额
股票
post_dealnum
盘后成交笔数
股票
priceDiff
买卖价差
港股专用
sharesPerHand
每手股数
港股专用
expiryDate
到期日
港股专用
tradeStatus
交易状态
港股专用
iopv
IOPV (净值估值)
基金专用
premium
折价
基金专用
riseCount
上涨家数
指数专用
fallCount
下跌家数
指数专用
upLimitCount
涨停家数
指数专用
downLimitCount
跌停家数
指数专用
suspensionCount
停牌家数
指数专用
pure_bond_value_cb
纯债价值
指数专用
17 / 43
指标名
指标说明
指标备注
surplus_term
剩余期限(天)
指数专用
dealDirection
成交方向
期货期权专用
dealtype
成交性质
期货期权专用
impliedVolatility
隐含波动率
期权专用
historyVolatility
历史波动率
期权专用
delta
Delta
期权专用
gamma
Gamma
期权专用
vega
Vega
期权专用
theta
Theta
期权专用
rho
Rho
期权专用
pre_open_interest
前持仓量
期权专用
pre_implied_volatility
前隐含波动率
期权专用
volume_pcr_total
成交量pcr (品种)
期权专用
volume_pcr_month
成交量pcr (同月)
期权专用
示例
para = {
"codes": "300033.SZ,600000.SH",
"indicators":
"open,high",
}
输出:
字段
字段名称
字段描述
errorcode
错误 ID
代码运行错误码errorcode =0表示代码运行正常。若为其他则需查找错误原因
errmsg
错误信息
若 errorcode返回非空此处会返回具体的错误信息
tables
结构体
返回内容包括thscode、table具体的数据内容
datatype
指标格式
返回获取数据的指标格式
inputParams
输入参数
返回输入的参数
perf
处理时间
返回请求命令整体耗时ms
dataVol
数据量
返回当前命令消耗的数据量
6、日内快照
URL
https://quantapi.51ifind.com/api/v1/snap_shot
formData
key
是否
必须
value
示例
codes
半角逗号分隔的所有代码
"codes":"300033.SZ,600030.SH"
indicators
半角逗号分隔的所有指标
"indicators":"open,high"
starttime
开始日期,支持"YYYYMMDD HH:mm:ss""YYYY-MM-DD
HH:mm:ss""YYYY/MM/DD HH:mm:ss"三种时间格式
"starttime":"2018-01-01
09:15:00"
18 / 43
key
是否
必须
value
示例
endtime
结束日期,支持"YYYYMMDD HH:mm:ss""YYYY-MM-DD
HH:mm:ss""YYYY/MM/DD HH:mm:ss"三种日期格式
"endtime":"2018-01-01
15:15:00"
indicators参数说明
指标名
指标说明
指标备注
tradeDate
交易日期
股票
tradeTime
交易时间
股票
preClose
前收盘价
股票
open
开盘价
股票
high
最高价
股票
low
最低价
股票
latest
现价
股票
amt
成交额
股票
vol
成交量
股票
amount
累计成交额
股票
volume
累计成交量
股票
tradeNum
成交次数
股票
bid10
买10价
股票
bid9
买9价
股票
bid8
买8价
股票
bid7
买7价
股票
bid6
买6价
股票
bid5
买5价
股票
bid4
买4价
股票
bid3
买3价
股票
bid2
买2价
股票
bid1
买1价
股票
ask1
卖1价
股票
ask2
卖2价
股票
ask3
卖3价
股票
ask4
卖4价
股票
ask5
卖5价
股票
ask6
卖6价
股票
ask7
卖7价
股票
ask8
卖8价
股票
ask9
卖9价
股票
ask10
卖10价
股票
bidSize10
买10量
股票
bidSize9
买9量
股票
bidSize8
买8量
股票
bidSize7
买7量
股票
bidSize6
买6量
股票
19 / 43
指标名
指标说明
指标备注
bidSize5
买5量
股票
bidSize4
买4量
股票
bidSize3
买3量
股票
bidSize2
买2量
股票
bidSize1
买1量
股票
askSize1
卖1量
股票
askSize2
卖2量
股票
askSize3
卖3量
股票
askSize4
卖4量
股票
askSize5
卖5量
股票
askSize6
卖6量
股票
askSize7
卖7量
股票
askSize8
卖8量
股票
askSize9
卖9量
股票
askSize10
卖10量
股票
avgBuyPrice
均买价
股票
avgSellPrice
均卖价
股票
totalBuyVolume
总买量
股票
totalSellVolume
总卖量
股票
dealDirection
成交方向(仅当日有效)
股票、期货、期权
dealtype
成交性质(仅当日有效)
期货、期权
示例
para = {
"codes": "300033.SZ,600030.SH",
"indicators": "open,high",
"starttime": "2025-08-25 09:30:00",
"endtime": "2025-08-25 15:00:00"
}
输出:
字段
字段名称
字段描述
errorcode
错误 ID
代码运行错误码errorcode =0表示代码运行正常。若为其他则需查找错误原因
errmsg
错误信息
若 errorcode返回非空此处会返回具体的错误信息
tables
结构体
返回内容包括thscode、table具体的数据内容
datatype
指标格式
返回获取数据的指标格式
inputParams
输入参数
返回输入的参数
perf
处理时间
返回请求命令整体耗时ms
dataVol
数据量
返回当前命令消耗的数据量
7、经济数据库(EDB)
URL
20 / 43
https://quantapi.51ifind.com/api/v1/edb_service
formData
key
是否
必须
value
示例
indicators
半角逗号分隔的所有指标,宏观指标过多,推荐使用
Windows超级命令生成。
"indicators":"M001620326,M002822183"
functionpara
key-value格式,省略时不进行更新时间筛选。两个时间
控件更新起始时间startrtime和更新结束时间
endrtime不勾选时省略
见下方代码块
startdate
开始日期,支持"YYYYMMDD""YYYY-MMDD""YYYY/MM/DD"三种时间格式
"startdate":"2018-01-01"
enddate
结束日期,支持"YYYYMMDD""YYYY-MMDD""YYYY/MM/DD"三种日期格式
"enddate":"2018-01-01"
示例
para = {
"indicators": "M001620326,M002822183",
"startdate":
"enddate":
"2018-01-01",
"2018-01-01",
"functionpara":
{
"startrtime": "2018-01-01 09:15:00",
"end rtime": "2018-01-01 10:15:00",
}
}
输出:
字段
字段名称
字段描述
errorcode
错误 ID
代码运行错误码errorcode =0表示代码运行正常。若为其他则需查找错误原因
errmsg
错误信息
若 errorcode返回非空此处会返回具体的错误信息
tables
结构体
返回内容包括 ID、time 等
datatype
指标格式
返回获取数据的指标格式
inputParams
输入参数
返回输入的参数
perf
处理时间
返回请求命令整体耗时ms
dataVol
数据量
返回当前命令消耗的数据量
8、专题报表函数
URL
https://quantapi.51ifind.com/api/v1/data_pool
formData
报表过多,推荐使用超级命令查看生成命令。
key
是否必
reportname
value
示例
"reportname":"p03341"
21 / 43
key
是否必
value
示例
functionpara
key-value的参数key按照过去的指
标名称
见下方代码块
outputpara
半角逗号分隔的Y/N来控制是否显示
该字段
"outputpara":"date:Y,thscode:Y,security_name:Y,weight:Y"
示例
para = {
"reportname": "p03341",
"functionpara":
{
"sdate": "20210421",
"edate": "20211119",
"xmzt": "全部",
"jcsslx": "全部",
"jys": "全部"
},
"outputpara": "p03341_f001:Y,p03341_f002:Y"
}
提取REITs项目一览 报表函数数据对应报表编码p03341
输出:
字段
字段名称
字段描述
errorcode
错误 ID
代码运行错误码errorcode =0表示代码运行正常。若为其他则需查找错误原因
errmsg
错误信息
若 errorcode返回非空此处会返回具体的错误信息
tables
结构体
返回内容包括p03341_f001、p03341_f002具体的数据内容
datatype
指标格式
报表函数暂为空,忽略
inputParams
输入参数
报表函数暂为空,忽略
outParams
输出指标
返回报表指标与中文名称,如:'p03291_f002': '同花顺代码'
descrs
输出信息
如:'name': 'p03291_f001', 'type': 'DT_DATE', 'attrs': []
perf
处理时间
返回请求命令整体耗时ms
dataVol
数据量
返回当前命令消耗的数据量
9、组合管理
(1组合新建
URL
https://quantapi.51ifind.com/api/v1/portfolio_manage
formData
名称
key
是否必须
value
功能名称
func
"func":"newportf"
组合名称
name
"name":"股债策略组合"
所属分组
group
"group": 11580
22 / 43
示例
名称
key
是否必须
value
示例
业绩基准,基准代码和
名称
performbm
否,默认
填充沪深
300
键值对
"performbm": {"code": "000300.SH",
"name": "沪深300"}
跌价基准,基准代码、
基准名称、基准类型
supbm
否,省略
时为空
键值对
"supbm": {"code":"000001.SH", "name":
"上证指数", "benchmarkType": "1"}
交易日
tday
否,默认
国内交易
枚举值国内交易所、港
股、美股、国内银行间
"tday":"国内交易所"
基准货币
currency
否,默认
人民币
枚举值CND、HKD、
USD
"currency":"CNY"
融资利率%
finacrate
否,默认
为空
"finacrate":"7.5"
融券利率%
secrate
否,默认
为空
"secrate":"5.5"
组合说明
info
否,默认
为空
"info":"股票与债券结合的策略组合"
示例
para={
"func": "newportf",
"name": "股债联动",
"group": 11580,
"performbm": {
"code": "000300.SH",
"name": "沪深300"
},
"supbm":
{
"code": "",
"name": "",
},
"tday": "国内交易所",
"curency": "CNY",
"finacrate": "",
"secrate": "",
"info": "股票与债券结合的策略组合"
}
(2组合导入
1). 模板导入
通过读取组合文件的内容,进行上传完成组合导入。
URL
https://quantapi.51ifind.com/api/v1/portfolio_manage
formData
名称
key
是否必须
value
示例
功能名称
func
importf
"func": "importf"
组合名称
name
"name": "股债策略组合"
23 / 43
名称
key
是否必须
组合ID
portfid
组合内容
content
value
示例
"portfid": 161390
二维表
示例
para
= {
"func": "importf",
"name": "股债策略组合",
"portfid": 161390,
"content": [
[
"交易日期",
"证券代码",
"业务类型",
"数量",
"价格",
"成交金额",
"费用",
"证券类型"
],
[
"2020-03-30",
"CNY",
"现金存入",
"",
"",
10000000,
"",
""
],
[
"2020-04-01",
"600000.SH",
"买入",
100,
10.09,
1009,
5.225,
"A股"
],
]
}
2).文件导入
通过文件对象的形式提交,来实现组合导入。
URL
https://quantapi.51ifind.com/api/v1/portfolio_manage
名称
key
是否必须
value
示例
功能名称
func
fileimport
"func": "fileimport"
24 / 43
名称
key
是否必须
value
组合名称
name
"name": "股债策略组合"
组合ID
portfid
"portfid": 161390
组合文件
file
示例
文件对象
file:{本地文件}
示例
para = {
"func": "fileimport",
"name": "股债策略组合"
"portid": 161930,
"file": "股债策略组合内容.xlsx"
}
#file_object为待导入组合的文件对象
files = {
"file": ("股债策略组合内容.xlsx", open("C:\demo\股债策略组合内容.xlsx",'rb))
}
3).状态查询
适用于大文件导入、导入历史持仓计算量较大的组合导入时,查询导入状态。
URL
https://quantapi.51ifind.com/api/v1/portfolio_manage
formData
名称
key
是否必须
value
示例
功能名称
func
fileimport
"func": "query_commit"
组合ID
portfid
组合文件
jobid
"portfid": 161390
"jobid":21
文件导入后返回
示例
para
=
{
"func": "query_commit",
"portid": 161930,
"jobid": 21
}
(3)现金存取
URL
https://quantapi.51ifind.com/api/v1/portfolio_manage
formData
名称
key
是否必须
value
示例
功能名称
func
cashacs
"func": "cashacs"
25 / 43
名称
key
是否必须
value
组合名称
name
"name": "股债策略组合"
组合ID
portfid
"portfid": 161390
功能参数
functionpara
"functionpara": {"acesscls": "101", "amount": "10000"}
示例
functionpara说明
名称
key
value
省略时
存取类型
acesscls
存入-不计入收益101取出-不计入收益102
不能省略
现金数额
amount
不能省略
示例
para
=
{
"func": "cashacs",
"name": "bldptf5",
"portfid": 161390,
"functionpara": {
"acesscls":"101",
"amount":"10000"
}
}
(4)普通交易
URL
https://quantapi.51ifind.com/api/v1/portfolio_manage
formData
名称
key
是否必须
value
示例
功能名称
func
deal
"func": "deal"
组合名称
name
"name": "股债策略组合"
组合ID
portfid
"portfid": 161390
功能参数
functionpara
functionpara说明
名称
key
value
行情代码
thscode
交易方向
direct
标的名称
codeName
不能省略
交易市场
marketCode
不能省略
标的类型
securityType
不能省略
成交价格
price
不能省略
成交数量
volume
不能省略
结算货币
currency
不能省略
费用
fee
不能省略
省略时
不能省略
买入: buy卖出 sell
不能省略
26 / 43
名称
key
value
费率
feep
不能省略
汇率
rate
不能省略
分红方式
bonus
省略时
适用基金现金分红1红利再投资2
示例
para
=
{
"func": "deal",
"name": "股债策略组合",
"portfid": 161390,
"functionpara": {
"thscode": "300033",
"direct": "buy",
"codeName": "同花顺",
"marketCode": "212100",
"securityType": "001001",
"price": 78.7,
"volume": 100,
"currency": "CNY",
"fee": "0",
"feep": 0,
"rate": "1.00",
"bonus": ""
}
}
(5)交易流水
目前支持最大时间区间为7天
URL
https://quantapi.51ifind.com/api/v1/portfolio_manage
formData
名称
key
是否必须
value
示例
功能名称
func
query_exchange_records
"func": "query_exchange_records"
组合名称
name
"name": "股债策略组合"
组合ID
portfid
"portfid": 161390
指标
indicators
"indicators": "date,code,name,dealPrice"
开始时间
startdate
"startdate": "2022-10-18"
结束时间
enddate
"enddate": "2022-10-20"
功能参数
functionpara
"functionpara": {"keyword": ""}
indicators说明
指标名称
英文名称
交易日期
date
证券代码
code
备注
27 / 43
指标名称
英文名称
备注
证券简称
name
成交价格
dealPrice
成交数量
dealNumber
发生金额
realPrice
业务名称
businessName
手续费
serviceCharge
证券类型
type
币种
currency
汇率
exchangeRate
市场
marketName
备注信息
importType
functionpara说明
名称
key
value
关键字
keyword
省略时
默认为空
示例
para = {
"func": "query_exchange_records",
"name": "股债策略组合",
"portfid": 161390,
"indicators": "date,code,name,deal Price,dealNumber,real Price,businessName,serviceCharge,type,currenc
y,exchangeRate,marketName,importType",
"startdate": "2022-10-18",
"enddate": "2022-10-20",
"functionpara": {
"keyword": "
}
}
(6)组合监控
URL
https://quantapi.51ifind.com/api/v1/portfolio_manage
formData
名称
key
是否必须
value
示例
功能名称
func
query_overview
"func": "query_overview"
组合名称
name
"name": "股债策略组合"
组合ID
portfid
"portfid": 161390
指标
indicators
indicators说明
指标名称
英文名称
备注
28 / 43
指标名称
英文名称
备注
资产分类
category
证券代码
thscode
证券简称
stockName
最新价格
newPrice
涨跌
increase
涨跌幅
increseRate
持仓数量
number
持仓市值
marketValue
最新权重
weight
当日盈亏
todayProfit
浮动盈亏
floatProfit
浮动盈亏率
floatProfitRate
累计盈亏
totalProfit
累计盈亏率
totalProfitRate
分红派息
interestIncome
已实现盈利
realizedProfit
成本价格
positionPrice
持仓成本
positionCost
保本价格
breakevenPrice
手续费
serviceCharge
币种
moneyType
汇率
currentPrice
更新时间
updateTime
示例
para
=
{
"func": "query_overview",
"name": "股债策略组合",
"portfid": 161390,
"indicators": "category,th scode,stockName,newPrice,increase,increaseRate,number,marketValue,weight,t
odayProfit,floatProfit,floatProfitRate,total Profit,total ProfitRate,interestIncome,real i zed
Profit,positionPrice,positionCost,breakevenPrice,serviceCharge,moneyType,currentPr ices,updateTime"
}
(7)持仓分析
URL
https://quantapi.51ifind.com/api/v1/portfolio_manage
formData
名称
key
是否必须
value
示例
功能名称
func
query_positions
"func": "query_positions"
组合名称
name
"name": "股债策略组合"
29 / 43
名称
key
是否必须
组合ID
portfid
指标
indicators
功能参数
functionpara
value
示例
"portfid": 161390
"functionpara": {"penetrate": "false"}
indicators说明
指标名称
英文名称
备注
证券类型
categoryName
证券名称
securityName
证券代码
thsCode
权重
weight
持仓市值
marketPrice
持仓成本
cost
浮动盈亏
wavepl
累计收益
cumpl
收盘价
price
涨跌幅
increaseRate
持仓数量
amount
持仓成本价
costPrice
functionpara说明
名称
key
value
省略时
是否穿透
penetrate
不穿透: false穿透 true
不能省略
示例
para = {
"func": "query_positions",
"name": "股债策略组合",
"portfid": 161390,
"indicators": "categoryName,securityName,th sCode,weight,marketPrice,cost,wavepl,cumpl,price,increase
Rate,
amount,
costPrice ",
"date": "2022-10-19",
"functionpara": {
"penetrate": "false"
}
}
(8)绩效指标
URL
https://quantapi.51ifind.com/api/v1/portfolio_manage
formData
30 / 43
名称
key
是否必须
value
示例
功能名称
func
query_perform
"func": "cashacs"
组合名称
name
"name": "股债策略组合"
组合ID
portfid
"portfid": 161390
日期
date
适用于当日实时,"date": "2020-06-02"
开始日期
startdate
开始日期适用于区间"startdate": "2020-06-02"
结束日期
enddate
开始日期适用于区间"enddate": "2020-06-02"
业绩基准
performbm
"performbm": "000300"
功能参数
functionpara
"functionpara": {"pfclass": "utnv", "cycle": "day"}
functionpara说明
名称
key
value
省略时
业绩类型
pfclass
业绩表现: perform 净资产: nasset 组合净值: utnv
不能省略
周期
cycle
当日实时:rquota 日:day 周:week 月:month 半年:halfYear 年:year
不能省略
示例
para = {
"func": "query_perform",
"name": "股债策略组合",
"portfid": 161390,
"performbm": "000300",
"startdate": "2020-06-02",
"enddate": "2022-10-20",
"functionpara": {
"pf class": "utnv",
"cycle": "day"
}
}
(9)风险指标
URL
https://quantapi.51ifind.com/api/v1/portfolio_manage
formData
名称
key
是否必须
value
示例
功能名称
func
query_risk_profits
"func": "query_risk_profits"
组合名称
name
"name": "股债策略组合"
组合ID
portfid
"portfid": 161390
指标
indicators
"indicators": ["alpha,yield,annual_yield,sharpe_ratio"]
开始日期
startdate
"startdate": "2021-10-19"
结束日期
enddate
"enddate": "2022-10-19"
功能参数
functionpara
"functionpara": {"cycle": "day", "benchmark": "000300"}
indicators说明
31 / 43
指标名称
英文名称
ALPHA
ALPHA
累计收益
yield
年化收益
annual_yield
夏普比率
sharpe_ratio
信息比率
information_ratio
索提诺比率
sortino_ratio
詹森阿尔法
jensen_alpha
特雷诺比率
treynor_ratio
胜率
win_ratio
正收益期数
positiveMonth
BETA
beta
年化波动率
annual_volatility
跟踪误差
tracking_error
下行风险
downside_risk
在险价值
value_at_risk
最大回撤
max_drawdown
最大回撤形成期
maxdrawdownRepairNum
最大回撤修复期
maxdownNum
连续下跌最大幅度
max_cont_decline
R-square
rSquare
备注
functionpara说明
名称
key
value
省略时
数据频率
cycle
日:day;周:week;月:month;季:season;年:year
不能省略
计算基准
benchmark
不能省略
示例
para
=
{
"func": "query_risk_profits",
"name": "股债策略组合",
"portfid": 161390,
"indicators": ["alpha,yield,annual_yield,sharpe_ratio"],
"startdate": "2021-10-19",
"enddate": "2022-10-19",
"functionpara": {
"cycle": "day",
"benchmark": "000300"
}
}
10、智能选股
URL
https://quantapi.51ifind.com/api/v1/smart_stock_picking
32 / 43
formData
key
是否必须
value
示例
searchstring
搜索关键词
"searchstring":"个股热度"
searchtype
搜索类别
"searchtype":"stock"
示例
para = {
"search string": "个股热度",
"searchtype": "stock"
}
输出:
字段
字段名称
字段描述
errorcode
错误 ID
代码运行错误码errorcode =0表示代码运行正常。若为其他则需查找错误原因
errmsg
错误信息
若 errorcode返回非空此处会返回具体的错误信息
tables
结构体
返回内容包括 ID、time 等
datatype
指标格式
返回获取数据的指标格式
inputParams
输入参数
返回输入的参数
perf
处理时间
返回请求命令整体耗时ms
dataVol
数据量
返回当前命令消耗的数据量
11、基金实时估值(分钟)
URL
https://quantapi.51ifind.com/api/v1/fund_valuation
formData
key
是否
必须
value
示例
codes
半角逗号分隔的所有代码
"codes":"000001.OF,000003.OF"
functionpara
key-value的参数
见下方表格
outputpara
半角逗号分隔的Y/N来控制
是否显示该字段
"changeRatioValuation:Y,realTimeValuation:Y,Deviation30TDays:Y"
functionpara参数说明
名称
keys
value说明
省略时逻辑
仅返回最新估值
onlyLastest
1-仅返回最新估值 0-返回时间区间估值
不能省略
开始时间
beginTime
仅返回最新估值可省略
结束时间
endTime
仅返回最新估值可省略
outputpara说明
字段名称
字段中文
changeRatioValuation
估值涨跌幅
realTimeValuation
基金实时估值
33 / 43
字段名称
字段中文
Deviation30TDays
30交易日估算平均偏差%
rank
请求基金最新估值涨跌幅排名
示例
para = {
"codes": "000001.OF,000003.OF",
"functionpara": {
"onlyLastest": "0",
"beginTime": "2021-08-24 09:15:00",
"endTime": "2021-08-24 15:15:00"
},
"outputpara": "date:Y,th scode:Y,security_name:Y,weight:Y"
}
输出:
属性
字段名称
字段描述
errorcode
错误 ID
代码运行错误码errorcode =0表示代码运行正常。若为其他则需查找错误原因
errmsg
错误信息
若 errorcode返回非空此处会返回具体的错误信息
perf
处理时间
返回请求命令整体耗时ms
dataVol
数据量
返回当前命令消耗的数据量
datatype
指标格式
返回获取数据的指标格式
tables
结构体
包括基金实时估值、估值涨跌幅、30日平均偏差等
inputParams
输入参数
基金实时估值函数暂为空,忽略
12、基金实时估值(日)
URL
https://quantapi.51ifind.com/api/v1/final_fund_valuation
formData
key
是否必
value
示例
codes
半角逗号分隔的所有代码
"codes":"000001.OF,000003.OF"
functionpara
key-value的参数包括开始日期 beginDate
止日期endDate
见下方示例
outputpara
半角逗号分隔的Y/N来控制是否显示该字段
"finalValuation:Y,netAssetValue:Y,deviation:Y"
outputpara说明
字段名称
字段中文
finalValuation
日最终估值
netAssetValue
日实际净值
deviation
估值相对净值偏差率(%
示例
34 / 43
para = {
"codes": "000001.OF;000003.OF",
"functionpara": {
"beginDate": "2021-06-01",
"endDate": "2021-09-02"
},
"finalValuation:Y,netAssetValue:Y,deviation:Y"
}
13、日期查询函数
URL
https://quantapi.51ifind.com/api/v1/get_trade_dates
formData
key
是否必
value
示例
marketcode
见下方说明
"marketcode":"212001"
functionpara
key-value的参数
见下方代码块
startdate
开始日期,支持"YYYYMMDD""YYYY-MM-DD""YYYY/MM/DD"三种时
间格式
"startdate":"2018-0101"
enddate
结束日期,支持"YYYYMMDD""YYYY-MM-DD""YYYY/MM/DD"三种日
期格式
"enddate":"2018-0101"
marketcode说明
交易所代码
交易所名称
212001
上交所
212100
深交所
212200
港交所
212020001
中国金融期货交易所
212020002
上海黄金交易所
212020003
郑州商品交易所
212020004
大连商品交易所
212004
银行间债券市场
212005
代办转让市场
212020006
伦敦金属交易所(LME)
212020007
纽约商业期货交易所(NYMEX)
212020008
上海期货交易所
212020010
纽约商品交易所(COMEX)
212020011
纽约期货交易所(NYBOT)
212020012
芝加哥商品交易所(CBOT)
212020013
洲际交易所(ICE)
212020014
马来西亚衍生品交易所
212020015
芝加哥商业交易所(CME)
212010
美国纽约证券交易所
35 / 43
交易所代码
交易所名称
212011
美国NASDAQ证券交易所
212049
美国证券交易所
212050
NYSE Arca
212012
英国伦敦证券交易所
212013
新加坡证券交易所
212014
荷兰阿姆斯特丹证券交易所
212015
挪威奥斯陆证券交易所
212016
澳大利亚证券交易所
212017
法国巴黎证券交易所
212018
比利时布鲁塞尔证券交易所
212020016
天津贵金属交易所
212024
德国法兰克福证券交易所
212025
日本东京证券交易所
212026
加拿大多伦多证券交易所
212027
韩国证券交易所
212029
马来西亚吉隆坡证券交易所
212031
马德里证券交易所
212033
墨西哥证券交易所
212035
瑞士证券交易所
212036
巴西圣保罗证券期货交易所
212037
瑞典斯德哥尔摩证券交易所
212039
台湾证券交易所
212040
泰国证券交易所
212041
奥地利维也纳证券交易所
212045
意大利米兰证券交易所
212047
印度尼西亚证券交易所
212051
美国IEX证券交易所
212053
新西兰证券交易所
212055
美国OTC市场
212061
菲律宾证券交易所
212062
孟买证券交易所
212063
布宜诺斯艾利斯证券交易所
212203
特拉维夫证券交易所
212205
莫斯科证券交易所
212210
BATS交易所
functionpara说明
对应字段
字段类
是否可省
命令生成示例说明
函数模式
字符串
不可
查询区间日期 "mode":"1" 查询区间日期数目 "mode":"2"
日期类型
字符串
不可
交易日 "dateType":"0" 日历日 "dateType":"1"
日期格式
字符串
不可
YYYY-MM-DD "dateFormat":"0" YYYY/MM/DD "dateFormat":"1" YYYYMMDD
"dateFormat":"2"
36 / 43
对应字段
字段类
是否可省
命令生成示例说明
时间周期
字符串
不可
日 "period":"D" 周 "period":"W" 月 "period":"M" 季 "period":"Q" 半年 "period":"S"
年 "period":"Y"
时间周期偏
字符串
不可
时间周期正数第1日 "periodnum":"1" 时间周期倒数第1日 "periodnum":"-1"
示例
para = {
"marketcode": "212001",
"functionpara": {
"mode": "1",
"dateType": "0",
"period": "D",
"dateFormat": "0"
},
"startdate": "2025-09-10",
"enddate": "2025-09-10"
}
14、日期偏移函数
URL
https://quantapi.51ifind.com/api/v1/get_trade_dates
formData
key
是否必
value
示例
marketcode
见日期查询函数说明
"marketcode":"212001"
functionpara
key-value的参数
见下方代码块
startdate
基准日期,支持"YYYYMMDD""YYYY-MM-DD""YYYY/MM/DD"三种时
间格式
"startdate":"2018-0101"
functionpara说明
对应字段
字段
类型
是否可
省略
省略时
逻辑
日期类型
字符
不可
交易日 "dateType":"0" 日历日 "dateType":"1"
日期格式
字符
不可
YYYY-MM-DD "dateFormat":"0" YYYY/MM/DD "dateFormat":"1"
YYYYMMDD "dateFormat":"2"
前推后退
字符
不可
前推 "offset":"-5" 后推 "offset":"5"
时间周期
字符
不可
日 "period":"D" 周 "period":"W" 月 "period":"M" 季 "period":"Q" 半年
"period":"S" 年 "period":"Y"
时间周期内
偏移
字符
输出选项
字符
不可
默认
命令生成示例说明
默认 省略 时间周期正数第1日 "periodnum":"1" 时间周期倒数第1日
"periodnum":"-1"
所有日期 "output":"sequencedate" 单个日期 "output":"singledate"
示例
37 / 43
para = {
"marketcode": "212001",
"functionpara": {
"dateType": "0",
"period": "D",
"offset": "-1",
"dateFormat": "0",
"output": "sequencedate"
},
"startdate": "2025-09-10"
}
15、数据量查询
无需参数仅需要传入token访问url即可
URL
https://quantapi.51ifind.com/api/v1/get_data_volume
示例
Headers = {
"Content-Type": "application/json",
"access_token": "xxxxxxxxxx"
}
16、错误信息查询
URL
https://quantapi.51ifind.com/api/v1/get_error_message
示例
para
=
{
"errorcode": -1
}
17、证券代码证券简称转同花顺代码
URL
https://quantapi.51ifind.com/api/v1/get_thscode
formData
key
是否必须
value
示例
seccode/secname
行情代码/简称
"seccode":"000001"
mode
seccode/secname
"mode":"seccode"
38 / 43
key
是否必须
value
示例
sectype
证券类型
"sectype":"001"
market
市场
"market":"212001"
tradestatus
012
"tradestatus":"0"
isexact
01
"isexact":"1"
示例
para
=
{
"seccode": "300033",
"functionpara": {
"mode": "seccode",
"sectype": "",
"market": "",
"tradestatus": "0",
"isexact": "0"
}
}
18、公告查询
URL
https://quantapi.51ifind.com/api/v1/report_query
formData
key
是否
必须
value
示例
codes
半角逗号分隔的所有代码如参数内容为空下面functionpara
中mode参数板块必填
"codes":"300033.SZ,600030.SH"
functionpara
key-value格式。所有key均取默认时functionpara省略。
见下方说明
outputpara
输出指标
见下方说明
functionpara说明
名称
keys
value说明
是否可
省略
示例
提取方式
mode
allAStock-全部A股allBond-全部债券 等按照证券
板块全部代码提取
"mode":"allAStock"
公告类型
reportType
903-全部901002004-上市公告书 等
reportType:901
公告开始
日期
beginrDate
根据公告开始日期筛选
"beginrDate": "2024-09-10"
公告截止
日期
endrDate
根据公告截止日期筛选
"endrDate": "2025-09-10"
发布开始
时间
begincTime
根据发布时间筛选
"begincTime":"2023-09-10
19:50:36"
发布截止
时间
endcTime
根据发布时间筛选
"endcTime":"2025-09-10
20:50:36"
开始seq
beginSeq
根据seq筛选
"beginSeq":"4569556291"
截止seq
endSeq
根据seq筛选
"endSeq":"4679626676"
39 / 43
名称
keys
value说明
是否可
省略
示例
标题关键
keyWord
根据公告标题关键词筛选
"keyWord":"半年度报告"
outputpara说明
名称
value说明
公告日期
reportDate
证券代码
thscode
证券简称
secName
发布时间
ctime
公告标题
reportTitle
公告链接
pdfURL
唯一标号
seq
注意用户可以通过查询到的pdfURL下载公告文件。
示例
para =
{
"codes": "300033.SZ,600000.SH",
"functionpara": {
"reportType": "901"
},
"beginrDate": "2024-09-10",
"endrDate": "2025-09-10",
"outputpara": "reportDate:Y,thscode:Y,secName:Y,ctime:Y,reportTitle:Y,pdfURL:Y,seq:Y"
}
输出:
字段
字段名称
字段描述
errorcode
错误 ID
代码运行错误码errorcode =0表示代码运行正常。若为其他则需查找错误原因
errmsg
错误信息
若 errorcode返回非空此处会返回具体的错误信息
tables
结构体
返回内容包括thscode、reportDate等outputpara选择返回的指标
datatype
指标格式
返回获取数据的指标格式,目前本函数返回为空
inputParams
输入参数
返回输入的参数,目前本函数返回为空
perf
处理时间
返回请求命令整体耗时ms
dataVol
数据量
返回当前命令消耗的数据量
三、错误说明
错误
错误信息
错误提示
-1010
your account has been loggout out.
token已失效
-1000
datasvr error!
数据服务器错误
-1001
gwsvr error!
网关服务器错误
-1002
timeout!
超时
40 / 43
错误
错误信息
错误提示
-1003
access-token can not be empty!
数据服务器错误
-1004
datasvrhq error!
传值不能为空
-1005
auth user error!
用户验证错误
-1201
failed,please change your input condition.
查询失败
-1202
there are errors in your parameters,please have a check.
参数错误
-1203
parsing failed.
解析失败
-1300
Not legal User
token无效
-1301
Refresh_Token is expired or illegal
refresh_token无效
-1302
Access_Token is expired or ilegal
Access_Token无效
-1303
Device exceed limit
access_token绑定超过20个IP
-1305
Exceeded the maximum number of token acquistions for the day
每天请求token次数超过限制
-4001
no data.
数据为空
-4100
please log in first!
请先登录iFind
-4101
database execution error
数据库执行错误
-4102
server internal error.
服务端请求超时
-4103
unreasonable request! your account has been locked. please contact the saler
to unlock
超时请求过多,账号被锁
-4201
the data server is incorrect
数据服务器取值错误
-4203
request format is wrong
请求格式错误
-4204
wrong time format
错误的时间格式
-4205
the start time can not be greater than the end time
开始时间不能大于结束时间
-4206
include the wrong thscode
含有错误的同花顺代码
-4207
sorry,currently we do not support bonds of this market.
用户参数错误:不支持银行间债
-4208
sorry, currently we just support kinds of securities of SSE, SZSE and CFFEX.
目前仅支持上交所深交所
-4209
sorry, the startDate and endDate of Shopshot command should be the same,
please have a check.
起始、结束日期要求同一天
-4210
error happen with input parameters, please have a check.
输入参数错误
-4211
sorry, there is no trading date in the date range, please have a check
时间区间内无交易日
-4212
sorry, the input endDate is earlier than the listDates of the input security codes
时间区间内股票未上市
-4230
you currently do not have permission for real-time Us stock market quotes
没有美股实时行情权限
-4213
sorry, startDate can't later than endDate in the command, please have a check
开始日期大于截止日期
-4301
sorry, your usage of basic data has exceeded 5 million this week.
对不起,这周基础数据提取已
经超过500万条
-4302
sorry, your usage of quote data has exceeded 150 million this week.
对不起,这周报价数据提取已
经超过1亿5千万条
-4303
sorry, your usage of EDB data has exceeded 5 million this week.
对不起这周EDB数据提取已
经超过500万条
-4317
sorry, your usage of data has exceeded 1w this week.
对不起,您本周数据量已超过
1万
-4318
sorry, your usage of data has exceeded this month.
对不起,本月使用量已经超限
-4320
sorry, your account must use the corresponding.
抱歉,您的账户必须使用对应
客户端
-4321
sorry, the free Acount can support requiring 10W data at most, please modify
your input params!
免费账号单次提取限制10万
41 / 43
错误
错误信息
错误提示
-4304
sorry, the HighFrequeceSequence command can support requiring 200W data
at most, please modify your input params
单条命令请求数据量过大
-4305
sorry, the BasicData command can support requiring 20W data at most,
please modify your input params
单条命令请求数据量过大
-4306
sorry, the Snapshot command can support requiring 200W data at most,
please modify your input params
单条命令请求数据量过大
-4319
sorry, the free Acount can support requiring 5W data at most, please modify
your input params
免费用户单条命令请求数据量
过大
-4321
sorry, the free Acount can support requiring 10W data at most, please modify
your input params
免费用户单条命令请求数据量
过大
-4322
sorry, the free Acount can support requiring 1W data at most, please modify
your input params
免费用户单条命令请求数据量
过大
-4307
data extraction is overrun.
数据提取量超限
-4308
the range between startDate and endDate must be smaller than 1 month.
Please check your input parameters.
请求区间不能超过一个月
-4309
sorry, trial account can get 1 year data for authority limited, so as to acquire
more data, please transfer it to formal account
超出时间限制
-4310
sorry, trial account can get 1 month data for authority limited, so as to acquire
more data, please transfer it to formal account
超出时间限制
-4311
sorry, trial account can get 5 year data for authority limited, so as to acquire
more data, please transfer it to formal account
超出时间限制
-4312
sorry, the HistoryQuotes command can support requiring 200W data at most,
please modify your input params
超出200W限制
-4313
sorry,the interval should be smaller than 3 years,please change your startDate
or endDate.
对不起,开始时间与结束时间
间隔不能超过3年
-4314
sorry,the interval should be smaller than 6 months,please change your
startDate or endDate.
对不起,开始时间与结束时间
间隔不能超过6个月
-4315
sorry,the interval should be smaller than 3 months,please change your
startDate or endDate.
对不起,开始时间与结束时间
间隔不能超过3个月
-4316
sorry,the interval should be smaller than 1 year,please change your startDate
or endDate.
对不起,开始时间与结束时间
间隔不能超过1年
-4400
sorry, we just support 600 requests per minute.
对不起,我们每分钟最多支持
600条数据请求
-5001
sorry,data server parameter error.
请求远程服务器参数错误
-5002
sorry,data server is busy now.
查询失败
-5003
sorry,does not support the stock box selection calculation.
不支持该股权查询
-5004
sorry,data process waiting timeout.
等待超时
-5005
sorry, data calculation error.
计算错误
-5006
sorry,data process query failed.
查询失败
-5007
sorry,data process Waiting for calculation.
等待计算
-5008
sorry,data process calculating.
正在计算
-5009
sorry,must complete the last instruction request.
必须完成上一次计算请求
-5010
sorry,only supports single code incoming.
仅支持单代码传入
-5100
Sorry,account type is not supported.
抱歉,您的账户类型不支持
-5101
Please confirm,you have not used the amount of date for the month.
请确认,您尚未使用本月的数
据量
-5102
Sorry,you have exceeded the maximum number of cleaes.
抱歉,您已超过最大清零次数
42 / 43
错误
错误信息
错误提示
-5103
Sorry,Do not allow accounts to operate in unbound mac code environments.
抱歉,不允许账户在非绑定
mac代码环境中运行
-5104
Sorry,this mac code has been bound .
抱歉该机器的mac已被绑定
-5000
please enter a reasonable expected dividend growth rate
请输入合理的预期红利增长率
数值
四、适用范围
本接口规范适用于同花顺数据接口与服务商端接口
同花顺公司保留本接口最终解释权利
五、版本管理
版本信息体现在各函数的url中新版本版本号逐渐向上累加旧版本在有用户使用情况下保持不变
43 / 43