指数分页列表 - 分页、排序、筛选

指数分页列表 - 分页、排序、筛选

1. 接口描述

2. 请求参数

说明：所有参数均为可选项。不传 order_by 且不传 ob 时默认按 change_rate desc 排序；不传分页时返回满足条件的全部指数。

filter 取值说明（表达式语法，对应代码 crates/​dom/​src/​core/​filter.rs）：

• 基本形式：字段 操作符 值。字段为 Index 的字段名（与 order_by、masks 一致，如 change_rate、name、latest、symkey）。
• 比较操作符：=、!=、>、>=、<、<=。
• 其它操作符：~ 子串包含（左为字段、右为字符串）；: 包含（具体以实现为准）。
• 逻辑组合：AND、OR、NOT，可用括号 () 分组。例：(change_rate >= 0 AND change_rate <= 0.05) OR name ~ "上证"。
• 值：null、true、false、数字、双引号字符串（内部双引号用 \" 转义）。
• Base64：整段表达式做 Base64 编码后以 _B64: 开头传入。

示例：change_rate != null、latest > 3000、name ~ "上证"。

3. 响应说明

返回分页后的指数列表及总数，与代码 ListIndicesReply 一致。列表中每项为单只指数对象（结构同单只指数详情）；不传 masks 时每只指数返回全部字段，传 masks 时仅返回指定字段。

{
    "total_size": 500,
    "indices": [
        { "name": "上证指数", "symkey": "000001.XSHG", "latest": 3252.30, "change_rate": 0.0020 },
        { "name": "深证成指", "symkey": "399001.XSHE", "latest": 10580.50, "change_rate": -0.0015 }
    ]
}

根字段

单条结构（indices 元素，对应 Index）

以下为部分常用字段；完整字段见代码 Index，点位类保留 4 位小数。

4. 用法

通过主目录 run.py 调用（参数均可选）：

python <RUN_PY> index-list-paginated
python <RUN_PY> index-list-paginated --order_by "change_rate desc" --page_size 20 --page_no 1
python <RUN_PY> index-list-paginated --order_by "name asc" --masks name,symkey,latest,change_rate --page_size 50
python <RUN_PY> index-list-paginated --filter "change_rate >= 0 AND change_rate <= 0.05"

或在子 skill 目录下执行：python scripts/​handler.py 加上上述参数。脚本输出 JSON，请求头已内置 X-Client-Name: ft-claw。

5. 请求示例

GET https://market.ft.tech/​app/​api/​v2/​indices?order_by=change_rate%20desc&page_size=20&page_no=1

完整请求示例（curl）

curl -X GET 'https://market.ft.tech/​app/​api/​v2/​indices?order_by=change_rate%20desc&page_size=20&page_no=1' \
  -H 'X-Client-Name: ft-claw' \
  -H 'Content-Type: application/​json'

6. 注意事项

• 涨跌幅等比率字段可能为小数形式，展示时按需乘以 100 转为百分比
• 不传 page_size/page_no 时返回全部满足条件的指数，数据量大时注意响应体积
• 完整字段以代码 Index 为准