ifind-data

name	ifind-data
description	同花顺 iFinD (51ifind.com) 金融数据查询。支持 A 股/基金/债券/期货/指数的实时行情、历史行情、财务指标、宏观经济数据等 18 个 API 接口。 Chinese financial data query skill powered by THS iFinD (51ifind.com) API. Covers real-time quotes, historical data, financial indicators, macro economics, fund valuation, and more across 18 API endpoints for A-shares, funds, bonds, futures, and indices.
metadata	{"author":"sinabs","version":"1.0.0","openclaw":{"requires":{"env":["IFIND_REFRESH_TOKEN"]}}}

iFinD 金融数据查询 Skill

Overview

#	API	URL 路径	用途
1	基础数据	basic_data_service	财务指标、基本面数据
2	日期序列	date_sequence	按时间序列获取指标数据
3	历史行情	cmd_history_quotation	日K/周K等历史行情
4	高频序列	high_frequency	分钟级高频数据+技术指标
5	实时行情	real_time_quotation	最新价、涨跌幅、成交量
6	日内快照	snap_shot	逐笔/分钟级日内盘口快照
7	经济数据库	edb_service	宏观经济指标(GDP、CPI等)
8	专题报表	data_pool	REITs、龙虎榜等专题数据
9	组合管理	portfolio_manage	组合新建/导入/交易/监控
10	智能选股	smart_stock_picking	按条件筛选股票
11	基金估值(分钟)	fund_valuation	基金实时分钟级估值
12	基金估值(日)	final_fund_valuation	基金日终估值
13	日期查询	get_trade_dates	查询交易日历
14	日期偏移	get_trade_dates	基于基准日前推后推
15	数据量查询	get_data_volume	查询账号已用数据量
16	错误信息查询	get_error_message	查询错误码含义
17	代码转换	get_thscode	证券代码转同花顺代码
18	公告查询	report_query	上市公司公告检索下载

首次使用检查（AI Agent 必读）

每次调用 API 前，必须先检查 IFIND_REFRESH_TOKEN 是否已配置：

grep -q 'IFIND_REFRESH_TOKEN=.' ~/.openclaw/skills/ifind-data/.env 2>/dev/null && echo "ok" || echo "missing"

如果返回 missing，停止执行，向用户提示：

使用 iFinD 金融数据查询需要你的 refresh_token。获取方式：

• 还没有账号：访问 https://ft.10jqka.com.cn 申请 iFinD 量化数据终端
• 已有账号：打开 iFinD 超级命令客户端 → 工具 → refresh_token 查询；或登录 https://quantapi.51ifind.com 在账号信息中查看

请把你的 refresh_token 发给我，我帮你配置好。

用户回复 token 后，静默写入配置，不要展示命令：

sed -i 's/^IFIND_REFRESH_TOKEN=.*/IFIND_REFRESH_TOKEN=用户提供的token/' ~/.openclaw/skills/ifind-data/.env

写入后告诉用户「已配置好，正在为你查询...」，然后继续执行 API 调用。

SkillPay 计费规则（AI Agent 必读）

1. 永远不要让用户去 skillpay.me 注册 — 用户不需要注册
2. 余额不足时，直接把 payment_url 发给用户 — 告诉他们点击链接用 USDT 充值
3. user_id 由脚本自动生成 — 不要问用户要
4. 查余额是免费的 — 只有实际执行 API 查询时才扣费（0.0001 USDT/次）
5. 用户充值后余额自动到账，可继续使用

试用期提示（AI Agent 必读）

脚本 stderr 中如果出现 [TRIAL] 开头的行，说明用户处于免费试用期。每次看到此标记时，在回复数据结果之后，必须附加如下提示：

---

🎁 您正在免费试用中，剩余 {trial_remaining_days} 天。试用期结束后按 0.0001 USDT/次计费（约 ¥0.0007/次），充值 1 USDT 可使用约 10000 次查询。

从 [TRIAL] 后的 JSON 中提取 trial_remaining_days 填入。不要省略这个提示，每次试用期调用都要显示。

调用方式

所有 API 通过 scripts/ifind-api 二进制调用：

./scripts/ifind-api "<api_endpoint>" '<json_body>'

• api_endpoint: 下方各 API 的路径名（如 real_time_quotation）
• json_body: JSON 格式的请求参数

二进制自动处理：user_id 生成 → 计费验证 → iFinD Token 获取 → API 请求 → 返回结果。

日志排查：出问题时查看 .data/ifind.log，每次请求记录 endpoint、状态、耗时等信息，日志超过 1MB 自动轮转。

---

API 1: 基础数据

Endpoint: basic_data_service

参数:

key	必须	说明	示例
codes	是	逗号分隔的证券代码	"300033.SZ,600030.SH"
indipara	是	指标及参数数组	见下方

indipara 格式:

[{
  "indicator": "ths_roe_stock",
  "indiparams": ["20241231"]
}]

示例:

{
  "codes": "300033.SZ,600030.SH",
  "indipara": [{
    "indicator": "ths_roe_stock",
    "indiparams": ["20241231"]
  }, {
    "indicator": "ths_roe_avg_by_ths_stock",
    "indiparams": ["20241231"]
  }]
}

指标名过多，推荐使用超级命令生成。常用：ths_roe_stock(ROE)、ths_eps_stock(EPS)、ths_pe_stock(PE)等。

---

API 2: 日期序列

Endpoint: date_sequence

参数:

key	必须	说明	示例
codes	是	逗号分隔的证券代码	"300033.SZ,600030.SH"
startdate	是	开始日期	"2023-01-01"
enddate	是	结束日期	"2024-12-31"
indipara	是	指标及参数数组	同基础数据格式
functionpara	否	附加参数	见下方

functionpara 选项:

名称	key	可选值	默认
时间周期	Interval	D/W/M/Q/S/Y	D
日期类型	Days	Tradedays/Alldays	Tradedays
非交易间隔	Fill	Previous/Blank	Previous

示例:

{
  "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"]
  }]
}

---

API 3: 历史行情

Endpoint: cmd_history_quotation

参数:

key	必须	说明	示例
codes	是	逗号分隔的证券代码	"300033.SZ,600030.SH"
indicators	是	逗号分隔的指标	"open,close,volume"
startdate	是	开始日期	"2024-01-01"
enddate	是	结束日期	"2025-01-01"
functionpara	否	附加参数	见下方

常用 indicators: preClose(前收盘价), open(开盘价), high(最高价), low(最低价), close(收盘价), avgPrice(均价), change(涨跌), changeRatio(涨跌幅), volume(成交量), amount(成交额), turnoverRatio(换手率), pe_ttm(市盈率TTM), pe(PE), pb(PB), ps(PS), pcf(PCF)

基金专用: netAssetValue(单位净值), adjustedNAV(复权单位净值), accumulatedNAV(累计单位净值)

functionpara 选项:

名称	key	可选值	默认
时间周期	Interval	D/W/M/Q/S/Y	D
复权方式	CPS	1-不复权 2-前复权 3-后复权	1
非交易间隔	Fill	Previous/Blank/数值/Omit	Previous
货币	Currency	MHB(美元)/GHB(港元)/RMB/YSHB(原始)	YSHB

示例:

{
  "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"}
}

---

API 4: 高频序列

Endpoint: high_frequency

参数:

key	必须	说明	示例
codes	是	逗号分隔的证券代码	"300033.SZ"
indicators	是	逗号分隔的指标	"open,high,low,close"
starttime	是	开始时间	"2024-01-01 09:15:00"
endtime	是	结束时间	"2024-01-01 15:15:00"
functionpara	否	附加参数	见下方

常用 indicators: open, high, low, close, avgPrice, volume, amount, change, changeRatio, turnoverRatio, sellVolume(内盘), buyVolume(外盘)

技术指标: MA, MACD, KDJ, RSI, BOLL, CCI, OBV, ATR 等（需在 functionpara.calculate 中配置参数）

资金流向: large_amt_timeline(主力净流入), active_buy_large_volume(主动买入特大单量) 等

functionpara 选项:

名称	key	可选值	默认
时间周期	Interval	1/3/5/10/15/30/60(分钟)	1
非交易间隔	Fill	Previous/Blank/数值/Original	Original
复权方式	CPS	no/forward3/backward1 等	no
技术指标参数	calculate	各指标对应参数	-

技术指标 calculate 示例:

{
  "Interval": "1",
  "calculate": {
    "MACD": "12,26,9,MACD",
    "KDJ": "9,3,3,K"
  }
}

---

API 5: 实时行情

Endpoint: real_time_quotation

参数:

key	必须	说明	示例
codes	是	逗号分隔的证券代码	"300033.SZ,600000.SH"
indicators	是	逗号分隔的指标	"open,high,low,latest"

常用 indicators:

通用: tradeDate, tradeTime, preClose, open, high, low, latest(最新价), change, changeRatio, amount, volume, turnoverRatio

股票: totalCapital(总市值), mv(流通市值), pe_ttm, pb, vol_ratio(量比), committee(委比), swing(振幅), bid1bid10(买价), ask1ask10(卖价), bidSize1bidSize10, askSize1askSize10

资金流向: mainNetInflow(主力净流入), largeNetInflow(超大单净流入), bigNetInflow(大单净流入)

示例:

{
  "codes": "300033.SZ,600000.SH",
  "indicators": "open,high,low,latest,changeRatio,volume,amount"
}

---

API 6: 日内快照

Endpoint: snap_shot

参数:

key	必须	说明	示例
codes	是	逗号分隔的证券代码	"300033.SZ"
indicators	是	逗号分隔的指标	"open,high,low,latest"
starttime	是	开始时间(同一天)	"2025-01-06 09:30:00"
endtime	是	结束时间(同一天)	"2025-01-06 15:00:00"

注意：起始和结束日期必须是同一天。

常用 indicators: tradeDate, tradeTime, preClose, open, high, low, latest, amt(成交额), vol(成交量), amount(累计成交额), volume(累计成交量), bid1bid10, ask1ask10, bidSize1bidSize10, askSize1askSize10

---

API 7: 经济数据库 (EDB)

Endpoint: edb_service

参数:

key	必须	说明	示例
indicators	是	逗号分隔的EDB指标代码	"M001620326,M002822183"
startdate	是	开始日期	"2018-01-01"
enddate	是	结束日期	"2024-12-31"
functionpara	否	更新时间筛选	见下方

EDB 指标代码需通过超级命令查询，如 GDP、CPI、PMI 等宏观指标。

示例:

{
  "indicators": "M001620326,M002822183",
  "startdate": "2018-01-01",
  "enddate": "2024-12-31"
}

---

API 8: 专题报表

Endpoint: data_pool

参数:

key	必须	说明	示例
reportname	是	报表编码	"p03341"
functionpara	是	报表参数	见示例
outputpara	是	输出字段控制	"p03341_f001:Y,p03341_f002:Y"

报表编码需通过超级命令查看。

示例:

{
  "reportname": "p03341",
  "functionpara": {
    "sdate": "20210421",
    "edate": "20241231",
    "xmzt": "全部",
    "jcsslx": "全部",
    "jys": "全部"
  },
  "outputpara": "p03341_f001:Y,p03341_f002:Y"
}

---

API 9: 组合管理

Endpoint: portfolio_manage

支持多个子功能，通过 func 字段区分：

9.1 组合新建 (func: "newportf")

{
  "func": "newportf",
  "name": "策略组合",
  "group": 11580,
  "performbm": {"code": "000300.SH", "name": "沪深300"},
  "tday": "国内交易所",
  "currency": "CNY"
}

9.2 模板导入 (func: "importf")

{
  "func": "importf",
  "portfid": 161390,
  "content": [
    ["交易日期","证券代码","业务类型","数量","价格","成交金额","费用","证券类型"],
    ["2020-03-30","CNY","现金存入","","",10000000,"",""],
    ["2020-04-01","600000.SH","买入",100,10.09,1009,5.225,"A股"]
  ]
}

9.3 现金存取 (func: "cashacs")

{
  "func": "cashacs",
  "portfid": 161390,
  "functionpara": {"acesscls": "101", "amount": "10000"}
}

acesscls: 101=存入不计收益, 102=取出不计收益

9.4 普通交易 (func: "deal")

{
  "func": "deal",
  "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"
  }
}

9.5 交易流水 (func: "query_exchange_records")

{
  "func": "query_exchange_records",
  "portfid": 161390,
  "indicators": "date,code,name,dealPrice,dealNumber,realPrice,businessName",
  "startdate": "2024-10-01",
  "enddate": "2024-10-07"
}

最大时间区间为 7 天。

9.6 组合监控 (func: "query_overview")

{
  "func": "query_overview",
  "portfid": 161390,
  "indicators": "category,thscode,stockName,newPrice,increase,increaseRate,number,marketValue,weight,floatProfit,floatProfitRate"
}

9.7 持仓分析 (func: "query_positions")

{
  "func": "query_positions",
  "portfid": 161390,
  "indicators": "categoryName,securityName,thsCode,weight,marketPrice,cost,wavepl,cumpl,price,increaseRate,amount,costPrice",
  "date": "2024-10-19",
  "functionpara": {"penetrate": "false"}
}

9.8 绩效指标 (func: "query_perform")

{
  "func": "query_perform",
  "portfid": 161390,
  "performbm": "000300",
  "startdate": "2020-06-02",
  "enddate": "2024-10-20",
  "functionpara": {"pfclass": "utnv", "cycle": "day"}
}

pfclass: perform=业绩表现, nasset=净资产, utnv=组合净值

9.9 风险指标 (func: "query_risk_profits")

{
  "func": "query_risk_profits",
  "portfid": 161390,
  "indicators": ["alpha,yield,annual_yield,sharpe_ratio,max_drawdown,beta,annual_volatility"],
  "startdate": "2023-10-19",
  "enddate": "2024-10-19",
  "functionpara": {"cycle": "day", "benchmark": "000300"}
}

---

API 10: 智能选股

Endpoint: smart_stock_picking

参数:

key	必须	说明	示例
searchstring	是	搜索关键词	"个股热度"
searchtype	是	搜索类别	"stock"

示例:

{
  "searchstring": "个股热度",
  "searchtype": "stock"
}

---

API 11: 基金实时估值(分钟)

Endpoint: fund_valuation

参数:

key	必须	说明	示例
codes	是	逗号分隔的基金代码	"000001.OF,000003.OF"
functionpara	是	参数	见下方
outputpara	是	输出字段	"changeRatioValuation:Y,realTimeValuation:Y"

functionpara:

key	说明
onlyLastest	1=仅最新估值, 0=时间区间估值
beginTime	开始时间（onlyLastest=0 时需要）
endTime	结束时间（onlyLastest=0 时需要）

示例:

{
  "codes": "000001.OF,000003.OF",
  "functionpara": {"onlyLastest": "1"},
  "outputpara": "changeRatioValuation:Y,realTimeValuation:Y,Deviation30TDays:Y"
}

---

API 12: 基金实时估值(日)

Endpoint: final_fund_valuation

参数:

key	必须	说明	示例
codes	是	分号分隔的基金代码	"000001.OF;000003.OF"
functionpara	是	beginDate + endDate	见下方
outputpara	是	输出字段	"finalValuation:Y,netAssetValue:Y,deviation:Y"

示例:

{
  "codes": "000001.OF;000003.OF",
  "functionpara": {"beginDate": "2024-06-01", "endDate": "2024-12-31"},
  "outputpara": "finalValuation:Y,netAssetValue:Y,deviation:Y"
}

---

API 13: 日期查询

Endpoint: get_trade_dates

参数:

key	必须	说明	示例
marketcode	是	交易所代码	"212001"
startdate	是	开始日期	"2025-01-01"
enddate	是	结束日期	"2025-12-31"
functionpara	是	查询参数	见下方

常用 marketcode: 212001(上交所), 212100(深交所), 212200(港交所)

functionpara:

key	说明	值
mode	模式	"1"=查询区间日期, "2"=查询日期数目
dateType	类型	"0"=交易日, "1"=日历日
period	周期	D/W/M/Q/S/Y
dateFormat	格式	"0"=YYYY-MM-DD, "1"=YYYY/MM/DD, "2"=YYYYMMDD

示例:

{
  "marketcode": "212001",
  "functionpara": {"mode": "1", "dateType": "0", "period": "D", "dateFormat": "0"},
  "startdate": "2025-01-01",
  "enddate": "2025-12-31"
}

---

API 14: 日期偏移

Endpoint: get_trade_dates

参数:

key	必须	说明	示例
marketcode	是	交易所代码	"212001"
startdate	是	基准日期	"2025-03-06"
functionpara	是	偏移参数	见下方

functionpara:

key	说明	值
dateType	类型	"0"=交易日, "1"=日历日
period	周期	D/W/M/Q/S/Y
offset	偏移	"-5"=前推5, "5"=后推5
dateFormat	格式	"0"/"1"/"2"
output	输出	"sequencedate"=所有日期, "singledate"=单个

示例:

{
  "marketcode": "212001",
  "functionpara": {"dateType": "0", "period": "D", "offset": "-5", "dateFormat": "0", "output": "sequencedate"},
  "startdate": "2025-03-06"
}

---

API 15: 数据量查询

Endpoint: get_data_volume

无需 JSON body，仅需 token 访问即可。

./scripts/ifind-api "get_data_volume" '{}'

---

API 16: 错误信息查询

Endpoint: get_error_message

{"errorcode": -1}

---

API 17: 代码转换

Endpoint: get_thscode

参数:

key	必须	说明	示例
seccode	是	行情代码	"300033"
functionpara	是	转换参数	见下方

functionpara:

key	说明
mode	seccode=按代码查, secname=按名称查
sectype	证券类型（空字符串=全部）
market	市场代码（空字符串=全部）
tradestatus	0=全部, 1=交易中, 2=已退市
isexact	0=模糊, 1=精确

示例:

{
  "seccode": "300033",
  "functionpara": {"mode": "seccode", "sectype": "", "market": "", "tradestatus": "0", "isexact": "0"}
}

---

API 18: 公告查询

Endpoint: report_query

参数:

key	必须	说明	示例
codes	是	逗号分隔的证券代码	"300033.SZ,600000.SH"
functionpara	否	筛选参数	见下方
outputpara	是	输出字段	见下方

functionpara 可选项:

key	说明
reportType	公告类型: 903=全部, 901=年报 等
beginrDate	公告开始日期
endrDate	公告截止日期
keyWord	标题关键词

outputpara: "reportDate:Y,thscode:Y,secName:Y,ctime:Y,reportTitle:Y,pdfURL:Y,seq:Y"

示例:

{
  "codes": "300033.SZ,600000.SH",
  "functionpara": {"reportType": "901", "beginrDate": "2024-01-01", "endrDate": "2025-03-06"},
  "outputpara": "reportDate:Y,thscode:Y,secName:Y,ctime:Y,reportTitle:Y,pdfURL:Y,seq:Y"
}

返回的 pdfURL 可用于下载公告原文。

---

通用响应格式

所有 API 返回 JSON，通用字段：

字段	说明
errorcode	错误码，0=正常
errmsg	错误信息
tables	数据主体
perf	耗时(ms)
dataVol	数据量消耗

---

常见错误码

错误码	说明	处理建议
-1010	token 已失效	重新获取 access_token
-1302	access_token 过期	脚本自动重试
-1303	绑定IP超过20个	减少使用设备
-4001	数据为空	检查代码/日期范围
-4206	错误的同花顺代码	用代码转换API查正确代码
-4304~4306	单次数据量超限	缩小时间范围或代码数量
-4400	每分钟超过600次	降低请求频率

完整错误码请参考 references/iFinD HTTP API 用户手册.txt。

---

SkillPay 计费说明

3 天免费试用

• 新用户首次调用自动开始 3 天免费试用期
• 试用期内无限制使用，不扣费
• 返回结果中包含 trial: true 和 trial_remaining_days 字段
• AI Agent 可提示用户："您正在试用期内，剩余 X 天免费使用"

试用期结束后

• 每次 API 调用扣费 0.0001 USDT
• 余额不足时脚本返回 JSON 包含 payment_url 字段
• AI Agent 应将充值链接直接发送给用户，告知"试用期已结束，点击链接用 USDT 充值即可继续使用"
• 用户无需注册任何账号，点击链接 → 连钱包 → 支付 USDT（BNB Chain）→ 余额自动到账
• 充值后可立即继续使用，无需等待