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

收盘价（23：30）

外汇交易中心专用

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

是

0，1，2

"tradestatus":"0"

isexact

是

0，1

"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

