查询全球主要指数日线行情;不传日期时分别返回每个指数当前已入库的最新交易日。
POST
/apiapiname:global_index生产专线(默认)深圳
http://sz.numcat.net:8866/api上海http://sh.numcat.net:8866/api公网备用https://numcat.net/api请求参数
| 参数 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
apiname | string(global_index) | 必选 | global_index | 固定接口名称,用于选择对应的数据能力。 |
apikey | string | 必选 | — | 猫爪数据 API Key。网页在线调试会为已登录用户自动注入,其他调用请从控制台获取。 |
fields | string|null | 可选 | tradedate,symbol,name,open,high,low,close,pre_close,change,pct_chg,swing,vol,amount | 需要返回的字段列表,多个字段使用英文逗号分隔;可选字段见下方返回字段表。 |
params | object | 可选 | {"symbols":"XIN9,SPX","tradedate":"20260807"} | 查询条件对象;具体参数、格式和互斥关系见下方 params 参数表。 |
params 参数
| 参数 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
symbols | string|array<string> | 可选 | XIN9,SPX | 一个或多个全球指数代码,支持单个代码、英文逗号分隔字符串或数组。 |
tradedate | string | 可选 | 20260724 | 单日查询日期,格式:YYYYMMDD;不能与 startdate/enddate 同时传。不传任何日期参数时默认最新交易日。 |
startdate | string | 可选 | 20260701 | 区间开始日期,格式:YYYYMMDD;只传 startdate 时查询该日至最新交易日,不能与 tradedate 同时传。 |
enddate | string | 可选 | 20260724 | 区间结束日期,格式:YYYYMMDD;只传 enddate 时按单日查询该日期,不能与 tradedate 同时传;startdate 晚于 enddate 时返回参数错误。 |
recentdays | integer | 可选 | 5 | 最近 N 个交易日覆盖的日期区间。不能与 tradedate/startdate/enddate 同时传。 |
tradedate_offset | integer | 可选 | -1 | 相对最新交易日的单日偏移,0 表示最新交易日,-1 表示上一交易日。 |
filters | array<object> | 可选 | [{"field":"pct_chg","op":"gt","value":0}] | 字段筛选条件数组;每项包含 field、op、value,也支持使用 operator 与 conditions 组合 AND/OR 条件。 |
order_by | string | 可选 | pct_chg | 排序字段;必须是本接口支持的返回字段。 |
order_dir | string(asc / desc) | 可选 | desc | 排序方向。 |
limit | integer | 可选 | 6000 | 返回条数,最大 6000。 |
offset | integer | 可选 | 0 | 结果偏移量。 |
fields 返回字段
字段顺序与接口样例保持一致| 字段 | 类型 | 名称 | 示例值 | 描述 |
|---|---|---|---|---|
tradedate | string | 交易日期 | 20260807 | 日期格式:YYYYMMDD。 |
symbol | string | 全球指数代码 | XIN9 | 全球指数的公开查询代码。 |
name | string | 全球指数名称 | 富时中国A50 | 当前包括:富时中国A50、恒生指数、恒生科技指数、恒生AH股H指数、道琼斯工业指数、标普500指数、纳斯达克综合指数、富时100指数、法国CAC40指数、德国DAX指数、日经225指数、韩国综合指数、澳大利亚标普200指数、印度SENSEX指数、巴西IBOVESPA指数、俄罗斯RTS指数、台湾加权指数、马来西亚综合指数、加拿大S&P/TSX指数、STOXX欧洲50指数、罗素2000指数、纳斯达克100指数、恒生中国企业指数、新加坡海峡时报指数、泰国SET指数、印尼雅加达综合指数、荷兰AEX指数、瑞士SMI指数、西班牙IBEX35指数、意大利FTSE MIB指数、墨西哥S&P/BMV IPC指数、越南胡志明指数、菲律宾综合指数、新西兰50指数、韩国KOSPI200指数、英国富时250指数、葡萄牙PSI20指数、标普500波动率指数、MSCI全球指数、印度Nifty50指数、费城半导体指数、土耳其BIST100指数、沙特TASI指数、以色列TA35指数。 |
open | number|null | 开盘点位 | 14964.53 | 当日开盘点位。 |
high | number|null | 最高点位 | 15139.24 | 当日最高点位。 |
low | number|null | 最低点位 | 14964.53 | 当日最低点位。 |
close | number|null | 收盘点位 | 15080.37 | 当日收盘点位。 |
pre_close | number|null | 昨收点位 | 14964.53 | 上一交易日收盘点位。 |
change | number|null | 涨跌点位 | 115.84 | 收盘点位与昨收点位之差。 |
pct_chg | number|null | 涨跌幅(%) | 0.7741 | 收盘点位相对昨收点位的涨跌幅。 |
swing | number|null | 振幅(%) | 1.1675 | 当日最高点位与最低点位相对昨收点位的波动幅度。 |
vol | number|null | 成交量 | — | 指数成交量;数据源未提供时返回 null。 |
amount | number|null | 成交额 | — | 指数成交额;数据源未提供时返回 null。 |
请求与响应样例
固定样例
{
"apiname": "global_index",
"apikey": "YOUR_API_KEY",
"params": {
"symbols": "XIN9,SPX",
"tradedate": "20260807"
},
"fields": "tradedate,symbol,name,open,high,low,close,pre_close,change,pct_chg,swing,vol,amount"
}{
"code": 200,
"message": "success",
"data": {
"fields": [
"tradedate",
"symbol",
"name",
"open",
"high",
"low",
"close",
"pre_close",
"change",
"pct_chg",
"swing",
"vol",
"amount"
],
"items": [
[
"20260807",
"XIN9",
"富时中国A50",
14964.53,
15139.24,
14964.53,
15080.37,
14964.53,
115.84,
0.7741,
1.1675,
null,
null
]
]
}
}