ifind-data

iFinD 金融数据查询 Skill

Overview

首次使用检查（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

参数:

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

参数:

functionpara 选项:

示例:

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

参数:

常用 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 选项:

示例:

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

参数:

常用 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 选项:

技术指标 calculate 示例:

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

---

API 5: 实时行情

Endpoint: real_time_quotation

参数:

常用 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

参数:

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

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

---

API 7: 经济数据库 (EDB)

Endpoint: edb_service

参数:

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

示例:

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

---

API 8: 专题报表

Endpoint: data_pool

参数:

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

示例:

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

参数:

示例:

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

---

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

Endpoint: fund_valuation

参数:

functionpara:

示例:

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

---

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

Endpoint: final_fund_valuation

参数:

示例:

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

参数:

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

functionpara:

示例:

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

参数:

functionpara:

示例:

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

参数:

functionpara:

示例:

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

---

API 18: 公告查询

Endpoint: report_query

参数:

functionpara 可选项:

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，通用字段：

---

常见错误码

完整错误码请参考 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）→ 余额自动到账
• 充值后可立即继续使用，无需等待