# 欢迎
## 欢迎来到Infoway API文档
Infoway 提供全面的 API 套件，涵盖 REST 与 Websocket 接口，充分满足机构级客户的核心需求。我们的 API 解决方案具备高度可扩展性，支持客户便捷获取实时行情数据；同时，其优异的兼容性可实现与客户现有系统及应用的轻松集成，显著简化业务流程。
## 什么是Infoway API
Infoway API专注于提供全球金融市场的实时行情数据，目前已覆盖美股、港股、A 股、商品期货、外汇、加密货币等多类品种，专为交易所、开发者、量化团队、金融科技公司及专业机构量身打造。
## 主要特点
* 全球市场覆盖：包含外汇、股票（含A股、港股、美股）、商品期货及加密货币等全球主流金融交易品种，提供实时数据与历史数据的全面支持。
* 多语言开发支持：配备多编程语言客户端库，助力开发者快速完成接入与集成，提升开发效率。
* 灵活高效接入：支持 WebSocket 与 REST API 双模式接入，保障数据传输的低延迟与高可靠性。
* 数据服务高可靠：依托权威数据源与稳定服务架构，确保数据的准确性、完整性与服务连续性。
* 定制化解决方案：针对专业机构及金融科技公司的个性化需求，提供定制化服务与专属解决方案，精准满足多样化业务场景。
## 适用对象
* 开发者：专注于构建交易分析工具与市场趋势研判工具的开发者群体。
* 量化团队：致力于量化交易策略研发与算法开发的专业团队。
* 金融科技公司：提供金融科技解决方案及配套服务的企业机构。
* 专业机构：对精准、及时的金融市场数据有持续需求的专业型机构。
## 使用场景
* 构建交易分析工具：依托全面数据支持，搭建交易分析工具，助力市场趋势的深度剖析与精准预测。
* 开发量化交易策略：基于实时与历史数据，开展量化交易策略及算法的研发与优化工作。
* 提供金融科技服务：作为金融科技企业，可依托数据能力提供金融数据服务及解决方案，为客户打造定制化金融科技产品。
* 为专业机构提供数据支持：为专业机构供给实时与历史数据，辅助其高效开展市场研究并支撑决策制定。
# A股实时行情接口
Infoway API的A股实时行情接口提供全面的A股市场数据，涵盖沪深两大交易所的5000只股票，帮助用户实时监控市场动态，做出及时决策。
## 1. 获取A股股票清单
Infoway API支持查询A股总计5000只股票。您可以通过以下两种方式获取股票清单：
* **下载清单文件**：登录您的账户后台，在底部找到文件下载链接。
* **通过HTTP接口查询**：如需通过接口获取股票清单，请参考[GET查询产品列表](/rest-api/basic-info/get-symbol-list)。
{% hint style="info" %}
股票清单将定期更新，新增新上市的股票，并移除已退市的股票。为了确保获取最新的市场信息，建议您定期查看清单。
{% endhint %}
## 2. 查询方式
我们为不同需求的用户提供两种高效的查询方式：
| 查询方式 | 适用场景 |
| ----------- | ------------------------------------------------------------------ |
| HTTP接口 | 适用于定期或批量查询的用户，支持灵活的查询请求。通过HTTP接口，您可以查询A股上市公司的基础信息、历史行情、实时K线、盘口等数据。 |
| WebSocket订阅 | 适合用于获取快速更新的实时行情数据，确保您获取最低延迟的行情推送。 |
{% hint style="info" %}
HTTP或者WebSocket均对查询频率有限制，详细限制说明请见[此页面](/getting-started/api-limitation)。
{% endhint %}
## 3. 支持的数据类型
Infoway A股实时行情接口提供以下几种数据查询服务：
### 3.1 获取A股实时K线数据
提供实时的A股股票K线数据，包括开盘、最高、最低、收盘价格、成交量、成交额、涨跌幅、涨跌额，帮助用户捕捉市场走势。详细了解如何获取K线，请前往
* [HTTP请求K线](/rest-api/http-endpoints/get-candles)
* [WebSocket订阅K线](/websocket-api/subscribe-and-unsubscribe/candles-subscribe)。
实时K线返回示例如下：
```
{
"s": "002594.SZ", //产品代码
"respList": [
{
"t": "1751958000", //秒时间戳（UTC+8）
"h": "326.880", //最高价
"o": "326.880", //开盘价
"l": "326.880", //最低价
"c": "326.880", //收盘价
"v": "1410", //成交量
"vw": "460900.80", //成交额
"pc": "0.00%", //涨跌幅
"pca": "0.000" //涨跌额
}
]
}
```
### 3.2 **A股实时成交明细**
查询A股上市公司的最新成交明细，确保获取市场的最新交易信息。详细接入方法请前往：
* [GET实时成交明细](/rest-api/http-endpoints/get-trade)
* [WebSocket订阅成交明细](/websocket-api/subscribe-and-unsubscribe/trade-subscribe)
实时成交明细返回示例如下：
```
{
"s": "002594.SZ", //产品代码
"t": 1751958000999, //毫秒时间戳(UTC+8)
"p": "326.88", //交易价格
"v": "1410", //成交量
"vw": "460900.80", //成交额
"td": 1 //交易方向 1：BUY 2：SELL 0：默认值
}
```
### 3.3 A股**五档盘口数据**
实时提供五档买卖盘数据，帮助用户了解市场深度和流动性。详细接入步骤请前往：
* [GET查询盘口数据](/rest-api/http-endpoints/get-depth)
* [WebSocket订阅盘口数据](/websocket-api/subscribe-and-unsubscribe/depth-subscribe)
A股五档盘口返回示例如下：
```
{
"s": "002594.SZ", //产品代码
"t": 1751958003335, //毫秒时间戳(UTC+8)
"a": [ //买盘
[
"326.89", //买一价
"326.90", //买二价
"326.91", //买三价
"326.92", //买四价
"326.93" //买五价
],
[
"8", //买一量
"30", //买二量
"10", //买三量
"1", //买四量
"22" //买五量
]
],
"b": [ //卖盘
[
"326.88", //卖一价
"326.87", //卖二价
"326.86", //卖三价
"326.85", //卖四价
"326.84" //卖五价
],
[
"1452", //卖一量
"77", //卖二量
"188", //卖三量
"37", //卖四量
"21" //卖五量
]
]
}
```
### 3.4 **A股股票基础信息**
查询A股上市公司的基础信息，包括公司名称、股票代码、上市日期等。详细了解接入步骤，请前往[这个页面](/rest-api/basic-info/get-symbol-basic-info)。
股票基础信息返回示例如下：
```
{
"symbol": "002594.SZ",
"market": "CN",
"name_cn": "比亚迪",
"name_en": "BYD",
"name_hk": "比亞迪",
"exchange": "SZSE",
"currency": "CNY",
"lot_size": 100,
"total_shares": 5494665855,
"circulating_shares": 1811265855,
"hk_shares": 0,
"eps": "7.326077155969296",
"eps_ttm": "8.1607397398326417",
"bps": "39.7406007503253353",
"dividend_yield": "1.6401803563357903",
"stock_derivatives": "",
"board": "SZMainConnect"
}
```
### 3.5 **A股市场交易日、交易时间**
查询A股市场的交易日和交易时间，包括开盘时间、收盘时间等，以确保用户了解每个交易日的市场活动周期。查询方法：
* [查询交易时间](/rest-api/basic-info/get-market-trading-hours)
* [查询交易日](/rest-api/basic-info/get-market-trading-days)
交易时间返回示例如下：
```
{
"market": "CN",
"remark": "A 股市场",
"trade_schedules": [
{
"begin_time": "09:30:00",
"end_time": "11:30:00",
"type": "NormalTrade"
},
{
"begin_time": "13:00:00",
"end_time": "14:57:00",
"type": "NormalTrade"
}
]
}
```
交易日返回示例：
```
{
"trade_days": [
"20250102",
"20250103",
"20250106",
"20250107",
"20250108",
"20250109",
"20250110",
"20250113",
"20250114",
"20250115"
],
"half_trade_days": []
}
```
# 港股实时行情接口
Infoway API的港股实时行情接口提供全面的港股市场数据，涵盖超过4000只香港上市公司的实时股票行情，帮助用户实时监控市场动态，做出及时决策。
## 1. 获取港股股票清单
Infoway API支持查询港股总计超过4000只股票。您可以通过以下两种方式获取股票清单：
* **下载清单文件**：登录您的账户后台，在底部找到文件下载链接。
* **通过HTTP接口查询**：如需通过接口获取股票清单，请参考[GET查询产品列表](/rest-api/basic-info/get-symbol-list)。
{% hint style="info" %}
股票清单将定期更新，新增新上市的股票，并移除已退市的股票。为了确保获取最新的市场信息，建议您定期查看清单。
{% endhint %}
## 2. 查询方式
我们为不同需求的用户提供两种高效的查询方式：
| 查询方式 | 适用场景 |
| ----------- | ------------------------------------------------------------------ |
| HTTP接口 | 适用于定期或批量查询的用户，支持灵活的查询请求。通过HTTP接口，您可以查询A股上市公司的基础信息、历史行情、实时K线、盘口等数据。 |
| WebSocket订阅 | 适合用于获取快速更新的实时行情数据，确保您获取最低延迟的行情推送。 |
{% hint style="info" %}
HTTP或者WebSocket均对查询频率有限制，详细限制说明请见[此页面](/getting-started/api-limitation)。
{% endhint %}
## 3. 支持的数据类型
Infoway 港股实时行情接口提供以下几种数据查询服务：
### 3.1 获取港股实时K线数据
提供实时的港股股票K线数据，包括开盘、最高、最低、收盘价格、成交量、成交额、涨跌幅、涨跌额，帮助用户捕捉市场走势。详细了解如何获取K线，请前往
* [HTTP请求K线](/rest-api/http-endpoints/get-candles)
* [WebSocket订阅K线](/websocket-api/subscribe-and-unsubscribe/candles-subscribe)。
实时K线返回示例如下：
```
{
"s": "00005.HK", //产品代码
"respList": [
{
"t": "1752825540", //秒时间戳（UTC+8）
"h": "98.250", //最高价
"o": "98.200", //开盘价
"l": "98.150", //最低价
"c": "98.150", //收盘价
"v": "44000", //成交量
"vw": "4320240.000", //成交额
"pc": "-0.05%", //涨跌幅
"pca": "-0.050" //涨跌额
}
]
}
```
### 3.2 港**股实时成交明细**
查询港股上市公司的最新成交明细，确保获取市场的最新交易信息。详细接入方法请前往：
* [GET实时成交明细](/rest-api/http-endpoints/get-trade)
* [WebSocket订阅成交明细](/websocket-api/subscribe-and-unsubscribe/trade-subscribe)
实时成交明细返回示例如下：
```
{
"s": "00005.HK", //产品代码
"t": 1752826113546, //毫秒时间戳(UTC+8)
"p": "98.150", //交易价格
"v": "956000", //成交量
"vw": "93831400.000", //成交额
"td": 0 //交易方向 1：BUY 2：SELL 0：默认值
}
```
### 3.3 港股十档**盘口数据**
Infoway API提供港股十档盘口查询，帮助用户了解市场深度和流动性。详细接入步骤请前往：
* [GET查询盘口数据](/rest-api/http-endpoints/get-depth)
* [WebSocket订阅盘口数据](/websocket-api/subscribe-and-unsubscribe/depth-subscribe)
港股十档档盘口返回示例如下：
```
{
"s": "00005.HK", //产品代码
"t": 1752826121043, //毫秒时间戳(UTC+8)
"a": [ //买盘
[
"98.150", //买一价
"98.200", //买二价
"98.250", //买三价
"98.300", //买四价
"98.350", //买五价
"98.400", //买六价
"98.450", //买七价
"98.500", //买八价
"98.550", //买九价
"98.600" //买十价
],
[
"13200", //买一量
"46400", //买二量
"58800", //买三量
"220800", //买四量
"221600", //买五量
"545200", //买六量
"162000", //买七量
"987600", //买八量
"230400", //买九量
"495200" //买十量
]
],
"b": [ //卖盘
[
"98.100", //卖一价
"98.050", //卖二价
"98.000", //卖三价
"97.950", //卖四价
"97.900", //卖五价
"97.850", //卖六价
"97.800", //卖七价
"97.750", //卖八价
"97.700", //卖九价
"97.650" //卖十价
],
[
"128800", //卖一量
"112000", //卖二量
"178000", //卖三量
"126400", //卖四量
"223600", //卖五量
"83200", //卖六量
"194800", //卖七量
"69600", //卖八量
"80400", //卖九量
"198000" //卖十量
]
]
}
```
### 3.4 港**股股票基础信息**
查询港股上市公司的基础信息，包括公司名称、股票代码、上市日期等。详细了解接入步骤，请前往[这个页面](/rest-api/basic-info/get-symbol-basic-info)。
股票基础信息返回示例如下：
```
{
"symbol": "00005.HK",
"market": "HK",
"name_cn": "汇丰控股",
"name_en": "HSBC HOLDINGS",
"name_hk": "滙豐控股",
"exchange": "SEHK",
"currency": "HKD",
"lot_size": 400,
"total_shares": 17448265603,
"circulating_shares": 17448265603,
"hk_shares": 17448265603,
"eps": "10.1970581721392237",
"eps_ttm": "8.7684842825409303",
"bps": "85.076501878960384",
"dividend_yield": "5.2748074391180753",
"stock_derivatives": "Warrant",
"board": "HKEquity"
}
```
### 3.5 港**股市场交易日和交易时间**
查询港股市场的交易日、交易时间，包括开盘时间、收盘时间等，以确保用户了解每个交易日的市场活动周期。查询方法：
* [查询交易时间](/rest-api/basic-info/get-market-trading-hours)
* [查询交易日](/rest-api/basic-info/get-market-trading-days)
交易时间返回示例：
```
{
"market": "HK",
"remark": "港股市场",
"trade_schedules": [
{
"begin_time": "09:30:00",
"end_time": "12:00:00",
"type": "NormalTrade"
},
{
"begin_time": "13:00:00",
"end_time": "16:00:00",
"type": "NormalTrade"
}
]
}
```
交易日返回示例：
```
{
"trade_days": [
"20250102",
"20250103",
"20250106",
"20250107",
"20250108",
"20250109",
"20250110",
"20250113",
"20250114",
"20250115"
],
"half_trade_days": []
}
```
# 美股实时行情接口
Infoway API美股实时行情接口提供全面的美股市场数据，涵盖超过1万只美股的实时行情（包含各类指数），帮助用户实时监控市场动态，做出及时决策。
## 1. 获取美股股票清单
Infoway API支持查询美股总计超过1万只股票。您可以通过以下两种方式获取股票清单：
* **下载清单文件**：登录您的账户后台，在底部找到文件下载链接。
* **通过HTTP接口查询**：如需通过接口获取股票清单，请参考[GET查询产品列表](/rest-api/basic-info/get-symbol-list)。
{% hint style="info" %}
股票清单将定期更新，新增新上市的股票，并移除已退市的股票。为了确保获取最新的市场信息，建议您定期查看清单。
{% endhint %}
## 2. 查询方式
我们为不同需求的用户提供两种高效的查询方式：
| 查询方式 | 适用场景 |
| ----------- | ------------------------------------------------------------------ |
| HTTP接口 | 适用于定期或批量查询的用户，支持灵活的查询请求。通过HTTP接口，您可以查询A股上市公司的基础信息、历史行情、实时K线、盘口等数据。 |
| WebSocket订阅 | 适合用于获取快速更新的实时行情数据，确保您获取最低延迟的行情推送。 |
{% hint style="info" %}
HTTP或者WebSocket均对查询频率有限制，详细限制说明请见[此页面](/getting-started/api-limitation)。
{% endhint %}
## 3. 支持的数据类型
Infoway 美股实时行情接口提供以下几种数据查询服务：
### 3.1 获取美股实时K线数据
提供实时的美股股票K线数据，包括开盘、最高、最低、收盘价格、成交量、成交额、涨跌幅、涨跌额，帮助用户捕捉市场走势。详细了解如何获取K线，请前往
* [HTTP请求K线](/rest-api/http-endpoints/get-candles)
* [WebSocket订阅K线](/websocket-api/subscribe-and-unsubscribe/candles-subscribe)。
美股实时K线返回示例如下：
{
"s": "AMZN.US", //产品代码
"respList": [
{
"t": "1752868800", //秒时间戳（UTC+8）
"h": "226.200", //最高价
"o": "226.120", //开盘价
"l": "226.110", //最低价
"c": "226.110", //收盘价
"v": "2284098", //成交量
"vw": "516502787.475", //成交额
"pc": "0.00%", //涨跌幅
"pca": "-0.010" //涨跌额
}
]
}
### 3.2 美**股实时成交明细**
查询美股上市公司的最新成交明细，确保获取市场的最新交易信息。详细接入方法请前往：
* [GET实时成交明细](/rest-api/http-endpoints/get-trade)
* [WebSocket订阅成交明细](/websocket-api/subscribe-and-unsubscribe/trade-subscribe)
实时成交明细返回示例如下：
```
{
"s": "AMZN.US", //产品代码
"t": 1752883185720, //毫秒时间戳(UTC+8)
"p": "225.975", //交易价格
"v": "1", //成交量
"vw": "225.975", //成交额
"td": 0 //交易方向 1：BUY 2：SELL 0：默认值
}
```
### 3.3 美股**盘口数据**
Infoway API提供美股买卖盘口查询，帮助用户了解市场深度和流动性。详细接入步骤请前往：
* [GET查询盘口数据](/rest-api/http-endpoints/get-depth)
* [WebSocket订阅盘口数据](/websocket-api/subscribe-and-unsubscribe/depth-subscribe)
美股盘口返回示例如下：
```
{
"s": "AMZN.US", //产品代码
"t": 1753109345315, //毫秒时间戳(UTC+8)
"a": [ //买盘
[
"227.900" //买一价
],
[
"10" //买一量
]
],
"b": [ //卖盘
[
"227.890" //卖一价
],
[
"375" //卖一量
]
]
}
```
### 3.4 美**股股票基础信息**
查询美股上市公司的基础信息，包括公司名称、股票代码、上市日期等。详细了解接入步骤，请前往[这个页面](/rest-api/basic-info/get-symbol-basic-info)。
股票基础信息返回示例如下：
```
{
"symbol": "AMZN.US",
"market": "US",
"name_cn": "亚马逊",
"name_en": "Amazon.com, Inc.",
"name_hk": "亞馬遜",
"exchange": "NASD",
"currency": "USD",
"lot_size": 1,
"total_shares": 10616352407,
"circulating_shares": 9585066132,
"hk_shares": 0,
"eps": "5.5808245363948382",
"eps_ttm": "6.2115496426549624",
"bps": "28.8109313136895758",
"dividend_yield": "0",
"stock_derivatives": "Option",
"board": "Unknown"
}
```
### 3.5 美**股市场交易日和交易时间**
查询美股市场的交易日和交易时间，以确保用户了解每个交易日的市场活动周期。查询方法：
* [查询交易时间](/rest-api/basic-info/get-market-trading-hours)
* [查询交易日](/rest-api/basic-info/get-market-trading-days)
美股交易时间返回示例：
```
{
"market": "US",
"remark": "美股市场",
"trade_schedules": [
{
"begin_time": "04:00:00",
"end_time": "09:30:00",
"type": "PreTrade"
},
{
"begin_time": "09:30:00",
"end_time": "16:00:00",
"type": "NormalTrade"
},
{
"begin_time": "16:00:00",
"end_time": "20:00:00",
"type": "PostTrade"
}
]
}
```
美股交易日返回示例：
```
{
"trade_days": [
"20250102",
"20250103",
"20250106",
"20250107",
"20250108",
"20250110",
"20250113",
"20250114",
"20250115"
]
}
```
# 外汇实时行情接口
Infoway外汇实时行情接口提供超过40种主流货币对的行情数据，可查询实时和历史K线、买卖盘口等数据。
## 1. 获取外汇货币对清单
Infoway外汇API支持查询40组主流货币对。您可以通过以下两种方式获取货币对清单：
* **下载清单文件**：登录您的账户后台，在底部找到文件下载链接。
* **通过HTTP接口查询**：如需通过接口获取外汇清单，请参考[GET查询产品列表](/rest-api/basic-info/get-symbol-list)。
## 2. 查询方式
我们为不同需求的用户提供两种高效的外汇行情查询方式：
| 查询方式 | 适用场景 |
| ----------- | ------------------------------------------------------------------ |
| HTTP接口 | 适用于定期或批量查询的用户，支持灵活的查询请求。通过HTTP接口，您可以查询A股上市公司的基础信息、历史行情、实时K线、盘口等数据。 |
| WebSocket订阅 | 适合用于获取快速更新的实时行情数据，确保您获取最低延迟的行情推送。 |
{% hint style="info" %}
HTTP或者WebSocket均对查询频率有限制，详细限制说明请见[此页面](/getting-started/api-limitation)。
{% endhint %}
## 3. 支持的数据类型
Infoway外汇实时行情接口提供以下几种数据查询服务：
### 3.1 获取外汇实时K线数据
提供实时的外汇K线数据，包括开盘、最高、最低、收盘价格、成交量、成交额、涨跌幅、涨跌额，帮助用户捕捉市场走势。详细了解如何获取K线，请前往
* [HTTP请求K线](/rest-api/http-endpoints/get-candles)
* [WebSocket订阅K线](/websocket-api/subscribe-and-unsubscribe/candles-subscribe)。
以下是USDGBP的实时K线返回示例：
{
"s": "USDGBP", //产品代码
"respList": [
{
"t": "1752872400", //秒时间戳（UTC+8）
"h": "0.74578", //最高价
"o": "0.74527", //开盘价
"l": "0.74503", //最低价
"c": "0.74503", //收盘价
"v": "45.0", //成交量
"vw": "33.530460", //成交额
"pc": "-0.09%", //涨跌幅
"pca": "-0.00065" //涨跌额
}
]
}
### 3.2 外汇**实时成交明细**
查询外汇最新成交明细，确保获取市场的最新交易信息。详细接入方法请前往：
* [GET实时成交明细](/rest-api/http-endpoints/get-trade)
* [WebSocket订阅成交明细](/websocket-api/subscribe-and-unsubscribe/trade-subscribe)
实时成交明细返回示例如下：
```
{
"s": "USDGBP", //产品代码
"t": 1752875078529, //毫秒时间戳(UTC+8)
"p": "0.74503", //交易价格
"v": "1.0", //成交量
"vw": "0.745030", //成交额
"td": 0 //交易方向 1：BUY 2：SELL 0：默认值
}
```
### 3.3 外汇买卖**盘口数据**
Infoway API提供外汇买卖盘口查询，帮助用户了解市场深度和流动性。详细接入步骤请前往：
* [GET查询盘口数据](/rest-api/http-endpoints/get-depth)
* [WebSocket订阅盘口数据](/websocket-api/subscribe-and-unsubscribe/depth-subscribe)
外汇盘口返回示例如下：
```
{
"s": "USDGBP", //产品代码
"t": 1752932303508, //毫秒时间戳(UTC+8)
"a": [
[
"0.74507" //买一价
],
[
"1" //买一量
]
],
"b": [
[
"0.74503" //卖一价
],
[
"1" //卖一量
]
]
}
```
# 加密货币实时行情接口
Infoway加密货币实时行情接口提供超过100种主流虚拟币的行情数据，可查询实时和历史K线、买卖盘口等数据。
## 1. 获取加密货币清单
Infoway加密货币API支持查询100种主流虚拟币。您可以通过以下两种方式获取加密货币清单：
* **下载清单文件**：登录您的账户后台，在底部找到文件下载链接。
* **通过HTTP接口查询**：如需通过接口获取产品清单，请参考[GET查询产品列表](/rest-api/basic-info/get-symbol-list)。
## 2. 查询方式
我们为不同需求的用户提供两种高效的加密货币行情查询方式：
| 查询方式 | 适用场景 |
| ----------- | ------------------------------------------------------------------ |
| HTTP接口 | 适用于定期或批量查询的用户，支持灵活的查询请求。通过HTTP接口，您可以查询A股上市公司的基础信息、历史行情、实时K线、盘口等数据。 |
| WebSocket订阅 | 适合用于获取快速更新的实时行情数据，确保您获取最低延迟的行情推送。 |
{% hint style="info" %}
HTTP或者WebSocket均对查询频率有限制，详细限制说明请见[此页面](/getting-started/api-limitation)。
{% endhint %}
## 3. 支持的数据类型
Infoway加密货币实时行情接口提供以下几种数据查询服务：
### 3.1 获取加密货币实时K线数据
提供实时的加密货币K线数据，包括开盘、最高、最低、收盘价格、成交量、成交额、涨跌幅、涨跌额，帮助用户捕捉市场走势。详细了解如何获取K线，请前往
* [HTTP请求K线](/rest-api/http-endpoints/get-candles)
* [WebSocket订阅K线](/websocket-api/subscribe-and-unsubscribe/candles-subscribe)。
以下是BTCUSDT的实时K线返回示例：
```
{
"s": "BTCUSDT", //产品代码
"respList": [
{
"t": "1752944400", //秒时间戳（UTC+8）
"h": "117984.68000", //最高价
"o": "117974.00000", //开盘价
"l": "117745.57000", //最低价
"c": "117825.75000", //收盘价
"v": "119.69276", //成交量
"vw": "14107044.9828691", //成交额
"pc": "-0.13%", //涨跌幅
"pca": "-148.24000" //涨跌额
}
]
}
```
### 3.2 加密货币**实时成交明细**
查询加密货币的最新成交明细，确保获取市场的最新交易信息。详细接入方法请前往：
* [GET实时成交明细](/rest-api/http-endpoints/get-trade)
* [WebSocket订阅成交明细](/websocket-api/subscribe-and-unsubscribe/trade-subscribe)
实时成交明细返回示例如下：
```
{
"s": "BTCUSDT", //产品代码
"t": 1752947397177, //毫秒时间戳(UTC+8)
"p": "117783.22", //交易价格
"v": "0.00048", //成交量
"vw": "56.5359456", //成交额
"td": 2 //交易方向 1：BUY 2：SELL 0：默认值
}
```
### 3.3 买卖**盘口数据**
Infoway API提供加密货币买卖盘口查询，帮助用户了解市场深度和流动性。详细接入步骤请前往：
* [GET查询盘口数据](/rest-api/http-endpoints/get-depth)
* [WebSocket订阅盘口数据](/websocket-api/subscribe-and-unsubscribe/depth-subscribe)
买卖盘口返回示例如下：
```
{
"s": "BTCUSDT", //产品代码
"t": 1752947435539, //毫秒时间戳(UTC+8)
"a": [
[
"117783.22000000", //买一价
"36.18406000" //买二价
],
[
"117783.23000000", //买一量
"0.06819000" //买二量
]
],
"b": [
[
"117783.21000000", //卖一价
"1.17501000" //卖二价
],
[
"117783.20000000", //卖一量
"0.07635000" //卖二量
]
]
}
```
# 期货实时行情接口
Infoway期货实时行情接口提供超过30种商品/贵金属期货的行情数据，可查询实时和历史K线、买卖盘口等数据。
## 1. 获取商品期货清单
Infoway期货行情API支持查询30种期货产品（包含各类期货指数）。您可以通过以下两种方式获取期货产品清单：
* **下载清单文件**：登录您的账户后台，在底部找到文件下载链接。
* **通过HTTP接口查询**：如需通过接口获取期货清单，请参考[GET查询产品列表](/rest-api/basic-info/get-symbol-list)。
## 2. 查询方式
我们为不同需求的用户提供两种高效的期货行情查询方式：
| 查询方式 | 适用场景 |
| ----------- | ------------------------------------------------------------------ |
| HTTP接口 | 适用于定期或批量查询的用户，支持灵活的查询请求。通过HTTP接口，您可以查询A股上市公司的基础信息、历史行情、实时K线、盘口等数据。 |
| WebSocket订阅 | 适合用于获取快速更新的实时行情数据，确保您获取最低延迟的行情推送。 |
{% hint style="info" %}
HTTP或者WebSocket均对查询频率有限制，详细限制说明请见[此页面](/getting-started/api-limitation)。
{% endhint %}
## 3. 支持的数据类型
Infoway期货实时行情接口提供以下几种数据查询服务：
### 3.1 获取期货实时K线
提供实时的期货K线行情数据，包括开盘、最高、最低、收盘价格、成交量、成交额、涨跌幅、涨跌额，帮助用户捕捉市场走势。详细了解如何获取K线，请前往
* [HTTP请求K线](/rest-api/http-endpoints/get-candles)
* [WebSocket订阅K线](/websocket-api/subscribe-and-unsubscribe/candles-subscribe)。
以下是白银（XAGUSD）的实时K线返回示例：
{
"s": "XAGUSD", //产品代码
"respList": [
{
"t": "1752868800", //秒时间戳（UTC+8）
"h": "38.22500", //最高价
"o": "38.12555", //开盘价
"l": "38.11850", //最低价
"c": "38.16500", //收盘价
"v": "1003.0", //成交量
"vw": "38292.383500", //成交额
"pc": "0.12%", //涨跌幅
"pca": "0.04450" //涨跌额
}
]
}
### 3.2 期货**实时成交明细**
查询期货的最新成交明细，确保获取市场的最新交易信息。详细接入方法请前往：
* [GET实时成交明细](/rest-api/http-endpoints/get-trade)
* [WebSocket订阅成交明细](/websocket-api/subscribe-and-unsubscribe/trade-subscribe)
实时成交明细返回示例如下：
```
{
"s": "XAGUSD", //产品代码
"t": 1752872345319, //毫秒时间戳(UTC+8)
"p": "38.165", //交易价格
"v": "1.0", //成交量
"vw": "38.1650", //成交额
"td": 0 //交易方向 1：BUY 2：SELL 0：默认值
}
```
### 3.3 期货**盘口数据**
Infoway API提供商品期货的买卖盘口查询，帮助用户了解市场深度和流动性。详细接入步骤请前往：
* [GET查询盘口数据](/rest-api/http-endpoints/get-depth)
* [WebSocket订阅盘口数据](/websocket-api/subscribe-and-unsubscribe/depth-subscribe)
买卖盘口返回示例如下：
```
{
"s": "XAGUSD", //产品代码
"t": 1752975504045, //毫秒时间戳(UTC+8)
"a": [
[
"38.18" //买一价
],
[
"1" //买一量
]
],
"b": [
[
"38.15" //卖一价
],
[
"1" //卖一量
]
]
}
```
# 其他股票市场
# 日本股票实时行情接口
Infoway API 日本股票实时行情API提供全面的日本股市市场数据，数据来自东京交易所，涵盖3800只日本股票，帮助用户实时监控市场动态，做出及时决策。
## 1. 获取日本股票清单
Infoway API 支持查询总计约3800只日本股票。您可以通过以下两种方式获取股票清单：
* **下载清单文件**：登录您的账户后台，在底部找到文件下载链接。
* **通过HTTP接口查询**：如需通过接口获取股票清单，请参考[GET查询产品列表](/rest-api/basic-info/get-symbol-list)。
{% hint style="info" %}
股票清单将定期更新，新增新上市的股票，并移除已退市的股票。为了确保获取最新的市场信息，建议您定期查看清单。
{% endhint %}
## 2. 查询方式
我们为不同需求的用户提供两种高效的查询方式：
| 查询方式 | 适用场景 |
| ----------- | ------------------------------------------------------------------ |
| HTTP接口 | 适用于定期或批量查询的用户，支持灵活的查询请求。通过HTTP接口，您可以查询A股上市公司的基础信息、历史行情、实时K线、盘口等数据。 |
| WebSocket订阅 | 适合用于获取快速更新的实时行情数据，确保您获取最低延迟的行情推送。 |
{% hint style="info" %}
HTTP或者WebSocket均对查询频率有限制，详细限制说明请见[此页面](/getting-started/api-limitation)。
{% endhint %}
## 3. 支持的数据类型
Infoway日股实时行情接口提供以下几种数据查询服务：
### 3.1 获取日本股票的实时K线数据
提供实时的日股股票K线数据，包括开盘、最高、最低、收盘价格、成交量、成交额、涨跌幅、涨跌额，帮助用户捕捉市场走势。详细了解如何获取K线，请前往
* [HTTP请求K线](/rest-api/http-endpoints/get-candles)
* [WebSocket订阅K线](/websocket-api/subscribe-and-unsubscribe/candles-subscribe)。
日股 (丰田汽车 `7203.JP`)实时K线返回示例如下：
```
{
"s": "7203.JP", //股票代码
"respList": [
{
"t": "1773032040", //秒时间戳（UTC+8）
"h": "3349.0", //最高价
"o": "3348.0", //开盘价
"l": "3347.0", //最低价
"c": "3349.00", //收盘价
"v": "23100.0", //成交量
"vw": "77352800.00", //成交额
"pc": "0.03%", //涨跌幅
"pca": "1.00" //涨跌额
}
]
}
```
### 3.2 日**股实时成交明细**
查询日股上市公司的最新成交明细，确保获取市场的最新交易信息。详细接入方法请前往：
* [GET实时成交明细](/rest-api/http-endpoints/get-trade)
* [WebSocket订阅成交明细](/websocket-api/subscribe-and-unsubscribe/trade-subscribe)
实时成交明细返回示例如下：
```
{
"s": "7203.JP", //股票代码
"t": 1773030789341, //毫秒时间戳(UTC+8)
"p": "3357.0", //交易价格
"v": "2500.0", //成交量
"vw": "8392500.00", //成交额
"td": 0 //交易方向 1：BUY 2：SELL 0：默认值
}
```
### 3.3 日股一档**盘口数据**
实时提供一档买卖盘数据，帮助用户了解市场深度和流动性。详细接入步骤请前往：
* [GET查询盘口数据](/rest-api/http-endpoints/get-depth)
* [WebSocket订阅盘口数据](/websocket-api/subscribe-and-unsubscribe/depth-subscribe)
日股一档盘口返回示例如下：
```
{
"s": "7203.JP", //股票代码
"t": 1773031148913, //毫秒时间戳(UTC+8)
"a": [ //买盘
[
"3356.0", //买一价
],
[
"5800.0", //买一量
]
],
"b": [ //卖盘
[
"3354.0", //卖一价
],
[
"6800.0", //卖一量
]
]
}
```
### 3.4 日**股股票基础信息**
查询日股上市公司的基础信息，包括公司名称、股票代码、上市日期等。详细了解接入步骤，请前往[这个页面](/rest-api/basic-info/get-symbol-basic-info)。
日股（丰田汽车 7203.JP）股票基础信息返回示例如下：
```
{
"ret": 200,
"msg": "success",
"traceId": "d9e8f29a-c4f4-411b-b4a6-737a36fb2d37",
"data": [
{
"symbol": "7203.JP",
"market": "JP",
"name_cn": "",
"name_en": "Toyota Motor Corp.",
"name_hk": "",
"exchange": "TSE",
"currency": "JPY",
"lot_size": null,
"total_shares": null,
"circulating_shares": null,
"hk_shares": null,
"eps": "283.4305",
"eps_ttm": null,
"bps": null,
"dividend_yield": "0.0272910083309394",
"stock_derivatives": null,
"board": "Consumer Durables"
}
]
}
```
### 3.5 日本**股市交易日、交易时间**
查询日本市场的交易日和交易时间，包括开盘时间、收盘时间等，以确保用户了解每个交易日的市场活动周期。查询方法：
* [查询交易时间](/rest-api/basic-info/get-market-trading-hours)
* [查询交易日](/rest-api/basic-info/get-market-trading-days)
交易时间返回示例如下：
```
{
"market": "JP",
"remark": "日本股市",
"trade_schedules": [
{
"begin_time": "09:00:00",
"end_time": "11:30:00",
"type": "NormalTrade"
},
{
"begin_time": "12:30:00",
"end_time": "15:00:00",
"type": "NormalTrade"
}
]
}
```
交易日返回示例：
```
{
"trade_days": [
"20260202",
"20260203",
"20260204",
"20260205",
"20260206",
"20260209",
"20260210"
],
"half_trade_days": []
}
```
# 印度股票实时行情接口
Infoway API 印度股票实时行情API提供全面的印度股市市场数据，数据来自印度最大的两家股票交易所：BSE与NSE，涵盖约5800只印度上市股票。
## 1. 获取印度股票清单
Infoway API 支持查询总计约5800只印度股票。您可以通过以下两种方式获取股票清单：
* **下载清单文件**：登录您的账户后台，在底部找到文件下载链接。
* **通过HTTP接口查询**：如需通过接口获取股票清单，请参考[GET查询产品列表](/rest-api/basic-info/get-symbol-list)。
{% hint style="info" %}
股票清单将定期更新，新增新上市的股票，并移除已退市的股票。为了确保获取最新的市场信息，建议您定期查看清单。
{% endhint %}
## 2. 查询方式
我们为不同需求的用户提供两种高效的查询方式：
| 查询方式 | 适用场景 |
| ----------- | ------------------------------------------------------------------ |
| HTTP接口 | 适用于定期或批量查询的用户，支持灵活的查询请求。通过HTTP接口，您可以查询A股上市公司的基础信息、历史行情、实时K线、盘口等数据。 |
| WebSocket订阅 | 适合用于获取快速更新的实时行情数据，确保您获取最低延迟的行情推送。 |
{% hint style="info" %}
HTTP或者WebSocket均对查询频率有限制，详细限制说明请见[此页面](/getting-started/api-limitation)。
{% endhint %}
## 3. 支持的数据类型
Infoway印度实时行情接口提供以下几种数据查询服务：
### 3.1 获取印度股票的实时K线数据
提供实时的印度股票K线数据，包括开盘、最高、最低、收盘价格、成交量、成交额、涨跌幅、涨跌额，帮助用户捕捉市场走势。详细了解如何获取K线，请前往
* [HTTP请求K线](/rest-api/http-endpoints/get-candles)
* [WebSocket订阅K线](/websocket-api/subscribe-and-unsubscribe/candles-subscribe)。
印度股票 (InfoSys `INFY.IN` )实时K线返回示例如下：
```
{
"s": "INFY.IN", //股票代码
"respList": [
{
"t": "1773037920", //秒时间戳（UTC+8）
"h": "1303.40", //最高价
"o": "1301.50", //开盘价
"l": "1301.50", //最低价
"c": "1303.00", //收盘价
"v": "15615.0", //成交量
"vw": "20342210.20", //成交额
"pc": "0.15%", //涨跌幅
"pca": "1.90" //涨跌额
}
]
}
```
### 3.2 印度股票**实时成交明细**
查询印度股票的最新成交明细，确保获取市场的最新交易信息。详细接入方法请前往：
* [GET实时成交明细](/rest-api/http-endpoints/get-trade)
* [WebSocket订阅成交明细](/websocket-api/subscribe-and-unsubscribe/trade-subscribe)
实时成交明细返回示例如下：
```
{
"s": "INFY.IN", //股票代码
"t": 1773037319456, //毫秒时间戳(UTC+8)
"p": "1299.00", //交易价格
"v": "2.0", //成交量
"vw": "2598.00", //成交额
"td": 0 //交易方向 1：BUY 2：SELL 0：默认值
}
```
### 3.3 印度股票一档**盘口数据**
实时提供一档买卖盘数据，帮助用户了解市场深度和流动性。详细接入步骤请前往：
* [GET查询盘口数据](/rest-api/http-endpoints/get-depth)
* [WebSocket订阅盘口数据](/websocket-api/subscribe-and-unsubscribe/depth-subscribe)
印度股票 (InfoSys - `INFY.IN` )一档盘口返回示例如下：
```
{
"s": "INFY.IN", //股票代码
"t": 1773037524808, //毫秒时间戳(UTC+8)
"a": [ //买盘
[
"1302.0", //买一价
],
[
"1.0", //买一量
]
],
"b": [ //卖盘
[
"1301.9", //卖一价
],
[
"172.0", //卖一量
]
]
}
```
### 3.4 印度**股票基础信息**
查询印度上市公司的基础信息，包括公司名称、股票代码、上市日期等。详细了解接入步骤，请前往[这个页面](/rest-api/basic-info/get-symbol-basic-info)。
印度股票（InfoSys - `INFY.IN`）股票基础信息返回示例如下：
```
{
"ret": 200,
"msg": "success",
"traceId": "d9e8f29a-c4f4-411b-b4a6-737a36fb2d37",
"data": [
{
"symbol": "INFY.IN",
"market": "IN",
"name_cn": "",
"name_en": "Infosys Limited",
"name_hk": "",
"exchange": "NSE",
"currency": "INR",
"lot_size": null,
"total_shares": null,
"circulating_shares": null,
"hk_shares": null,
"eps": "67.4982",
"eps_ttm": null,
"bps": null,
"dividend_yield": "0.0344854011801671",
"stock_derivatives": null,
"board": "Technology Services"
}
]
}
```
### 3.5 印度**股市交易日、交易时间**
查询印度市场的交易日和交易时间，包括开盘时间、收盘时间等，以确保用户了解每个交易日的市场活动周期。查询方法：
* [查询交易时间](/rest-api/basic-info/get-market-trading-hours)
* [查询交易日](/rest-api/basic-info/get-market-trading-days)
交易时间返回示例如下：
```
{
"market": "IN",
"remark": "印度股市",
"trade_schedules": [
{
"begin_time": "09:15:00",
"end_time": "15:30:00",
"type": "NormalTrade"
}
]
}
```
交易日返回示例：
```
{
"trade_days": [
"20260202",
"20260203",
"20260204",
"20260205",
"20260206",
"20260209",
"20260210"
],
"half_trade_days": []
}
```
# 韩国股票实时行情接口
Infoway API 韩国股票实时行情API提供全面的韩国股市市场数据，数据来自韩国KRX股票交易所，涵盖约2600只韩国上市股票。
## 1. 获取韩国股票清单
Infoway API 支持查询总计约2660只韩国股票。您可以通过以下两种方式获取股票清单：
* **下载清单文件**：登录您的账户后台，在底部找到文件下载链接。
* **通过HTTP接口查询**：如需通过接口获取股票清单，请参考[GET查询产品列表](/rest-api/basic-info/get-symbol-list)。
{% hint style="info" %}
股票清单将定期更新，新增新上市的股票，并移除已退市的股票。为了确保获取最新的市场信息，建议您定期查看清单。
{% endhint %}
## 2. 查询方式
我们为不同需求的用户提供两种高效的查询方式：
| 查询方式 | 适用场景 |
| ----------- | ------------------------------------------------------------------ |
| HTTP接口 | 适用于定期或批量查询的用户，支持灵活的查询请求。通过HTTP接口，您可以查询A股上市公司的基础信息、历史行情、实时K线、盘口等数据。 |
| WebSocket订阅 | 适合用于获取快速更新的实时行情数据，确保您获取最低延迟的行情推送。 |
{% hint style="info" %}
HTTP或者WebSocket均对查询频率有限制，详细限制说明请见[此页面](/getting-started/api-limitation)。
{% endhint %}
## 3. 支持的数据类型
Infoway韩国实时行情接口提供以下几种数据查询服务：
### 3.1 获取韩国股票的实时K线数据
提供实时的韩国股票K线数据，包括开盘、最高、最低、收盘价格、成交量、成交额、涨跌幅、涨跌额，帮助用户捕捉市场走势。详细了解如何获取K线，请前往
* [HTTP请求K线](/rest-api/http-endpoints/get-candles)
* [WebSocket订阅K线](/websocket-api/subscribe-and-unsubscribe/candles-subscribe)。
韩国股票 (005930.KS)实时K线返回示例如下：
```
{
"s": "005930.KS", //股票代码
"respList": [
{
"t": "1781481600", //秒时间戳（UTC+8）
"h": "344000.00", //最高价
"o": "344000.00", //开盘价
"l": "340000.00", //最低价
"c": "341500.00", //收盘价
"v": "972079.00000", //成交量
"vw": "333747120093.07000", //成交额
"pc": "-0.73%", //涨跌幅
"pca": "-2500.00000" //涨跌额
}
]
}
```
### 3.2 韩国股票**实时成交明细**
查询韩国股票的最新成交明细，确保获取市场的最新交易信息。详细接入方法请前往：
* [GET实时成交明细](/rest-api/http-endpoints/get-trade)
* [WebSocket订阅成交明细](/websocket-api/subscribe-and-unsubscribe/trade-subscribe)
实时成交明细返回示例如下：
```
{
"s": "005930.KS", //股票代码
"t": 1773037319456, //毫秒时间戳(UTC+8)
"p": "341500.00", //交易价格
"v": "2.0", //成交量
"vw": "2598.00", //成交额
"td": 0 //交易方向 1：BUY 2：SELL 0：默认值
}
```
### 3.3 韩国股票一档**盘口数据**
实时提供一档买卖盘数据，帮助用户了解市场深度和流动性。详细接入步骤请前往：
* [GET查询盘口数据](/rest-api/http-endpoints/get-depth)
* [WebSocket订阅盘口数据](/websocket-api/subscribe-and-unsubscribe/depth-subscribe)
韩国股票 (InfoSys - `005930.KS` )一档盘口返回示例如下：
```
{
"s": "005930.KS", //股票代码
"t": 1773037524808, //毫秒时间戳(UTC+8)
"a": [ //买盘
[
"341500.00", //买一价
],
[
"1.0", //买一量
]
],
"b": [ //卖盘
[
"341500.00", //卖一价
],
[
"172.0", //卖一量
]
]
}
```
### 3.4 韩国**股票基础信息**
查询韩国上市公司的基础信息，包括公司名称、股票代码、上市日期等。详细了解接入步骤，请前往[这个页面](/rest-api/basic-info/get-symbol-basic-info)。
韩国股票（InfoSys - `005930.KS`）股票基础信息返回示例如下：
```
{
"ret": 200,
"msg": "success",
"traceId": "1407b1f0-b271-4b39-a905-67e538ce83b9",
"data": [
{
"symbol": "005930.KS",
"market": "KS",
"name_cn": "",
"name_en": "Samsung Electronics Co., Ltd.",
"name_hk": "",
"exchange": "KRX",
"currency": "KRW",
"lot_size": null,
"total_shares": null,
"circulating_shares": null,
"hk_shares": null,
"eps": "12475.8691",
"eps_ttm": null,
"bps": null,
"dividend_yield": "0.00471186440677966",
"stock_derivatives": null,
"board": "Electronic Technology"
}
]
}
```
### 3.5 韩国**股市交易日、交易时间**
查询韩国市场的交易日和交易时间，包括开盘时间、收盘时间等，以确保用户了解每个交易日的市场活动周期。查询方法：
* [查询交易时间](/rest-api/basic-info/get-market-trading-hours)
* [查询交易日](/rest-api/basic-info/get-market-trading-days)
交易时间返回示例如下：
```
{
"market": "KS",
"remark": "韩国股市",
"trade_schedules": [
{
"begin_time": "09:00:00",
"end_time": "15:30:00",
"type": "NormalTrade"
}
]
}
```
交易日返回示例：
```
{
"trade_days": [
"20260202",
"20260203",
"20260204",
"20260205",
"20260206",
"20260209",
"20260210"
],
"half_trade_days": []
}
```
# 快速开始
{% stepper %}
{% step %}
### 第一步：申请您的API Key（ [申请流程](/getting-started/api-key-application)）
确保可以正确的构造请求并且解析响应数据。
请详细阅读文档，确保不会因为请求头以及响应头格式问题影响正常使用。
{% endstep %}
{% step %}
### 第二步： 熟悉地址以及参数说明（ [地址说明](/getting-started/api-endpoints)）
理解接口的入参以及返回的结果是否满足您的要求。
请仔细阅读接口说明文档，防止使用时候出现一些问题。
{% endstep %}
{% step %}
### 第三步：了解接口的访问限制（[接口限制说明](/getting-started/api-limitation)）
了解HTTP接口以及WebSocket的访问限制。
一切请求请在限制以内使用，超出限制将会导致请求失败，如被系统判定为恶意请求，将会影响您的API Key后续的使用。
{% endstep %}
{% step %}
### 第四步：掌握请求以及响应格式（[请求和响应协议](/getting-started/api-protocols-and-response-formats)）
确保可以正确的构造请求并且解析响应数据。
请详细阅读文档，确保不会因为请求头以及响应头格式问题影响正常使用。
{% endstep %}
{% step %}
### 第五步：选择目标产品 （[获取产品列表](/rest-api/basic-info/get-symbol-list)）
帮助您确定是否有您所需要的产品，以及该如何请求获取产品数据。
请先判断是否有您所需要的产品信息，防止数据返回为空。
{% endstep %}
{% step %}
### 第六步：执行并且获取数据
在完成了上述步骤之后，可以直接获取所需的实时数据。
请详细阅读文档，如有疑问，欢迎联系我们的24小时人工客服。（[人工客服](https://t.me/infoway_StrongSickCat))
{% endstep %}
{% endstepper %}
### 官方建议
* **保密**：请保护您的个人API Key，避免泄密给其他人员。
* **监控**：定期检查接口文档是否更新，以便可以及时连接更改或者新增的内容。
* **测试**：在正式使用之前，请用免费套餐进行数据和代码测试。
* **反馈**：如果遇到任何问题，请及时与我们联系，如果是我们的问题影响了您的使用，将会提供额外的有效期作为补偿。
# API Key申请
包含如何申请Apikey，以及续费和升级逻辑
## 1、注册账号
* 完成账号注册（无需实名认证），点击前往 [注册页面](https://infoway.io/create-account)
* 注册完成之后，登录成功会自动跳转到用户[后台界面](https://infoway.io/dashboard)。
## 2、套餐购买
* 同一个账号可以同时拥有多个套餐，不同套餐拥有不重复的API Key
* 套餐购买唯一的入口：[**官网-定价**](https://infoway.io/#pricing)
## 3、套餐升级以及续费
* 免费套餐无法升级和续费
* 所有付费套餐均支持续费操作
* 升级操作必须有更高级的套餐才可以升级（如基础可以升级为高级或专业，高级可以升级为专业，专业无法升级），套餐升级时，用户只需要支付剩余时间的差价（如果升级所需价格低于8USDT，无法升级）。
* 套餐的续费和升级需要在用户后台界面进行操作
# 接口限制说明
# HTTP接口限制
## 频率限制
| 套餐 | 频率限制说明 |
| ------ | -------------------------------------- |
| **免费** | 所有接口，每秒最多1次，一分钟上限60次，一天请求上限86400次 |
| **基础** | 所有接口，每秒最多2次，一分钟上限120次，一天请求上限172800次 |
| **高级** | 所有接口，每秒最多10次，一分钟上限600次，一天请求上限864000次 |
| **专业** | 所有接口，每秒最多20次，一分钟上限1200次，一天请求上限1728000次 |
## IP限制
* 正常的业务接口请求只会对API Key的套餐权限做设置，不会对IP做限制
* 页面接口（如官网的实时数据展示）将会对IP做频率限制。
* 请合理请求接口，如果出现大量请求失败可能会被风控系统自动封禁一段时间，解封请联系Telegram客服人员
# WebSocket限制
### WebSocket连接数限制
| 套餐 | 频率限制说明 |
| --------- | ---------------------------------------------------------------------------------------------------------------- |
| **免费** | 支持1个Websocket连接（不同Websocket订阅地址不单独计为多个连接，详见本页下方说明）
所有连接的订阅总数不超过 10 个产品
|
| **基础** | 支持1个Websocket连接（不同Websocket订阅地址不单独计为多个连接，详见本页下方说明）
所有连接的订阅总数不超过 200 个产品
|
| **高级** | 支持2个Websocket连接（不同Websocket订阅地址不单独计为多个连接，详见本页下方说明）
每个连接最多可订阅 600 个不重复产品
所有连接的订阅总数不超过 800 个产品
|
| **专业** | 支持9个Websocket连接（不同Websocket订阅地址不单独计为多个连接，详见本页下方说明）
每个连接最多可订阅 600 个不重复产品
所有连接的订阅总数不超过 5000 个产品
|
| **市场套餐** | 根据市场的产品数确定Websocket连接，每根Websocket连接固定订阅产品数为600，Websocket连接数 = 市场总产品数 / 600向上取整 |
| **自定义套餐** | 可以自由选择Api接口的请求频率以及可以订阅的产品总数，Websocket的连接数计算方式同市场套餐 |
### Websocket订阅请求频率限制
* 所有Websocket订阅请求总和，限制为一分钟60次（如K线订阅、实时行情订阅等，包含心跳请求）
* 如果超出订阅请求，将会导致连接断开
### WebSocket订阅总数
WS主要用于订阅交易品种的实时行情，而订阅总数代表您可以通过WS订阅的交易品种的数量上限。100个订阅数可以订阅100个品种。
{% hint style="info" %}
**标准套餐和自定义套餐的WS可以订阅所有支持的品种分类（外汇/股票/期货等）**
**股票套餐的WS只能订阅所选的股票市场。比如全A股套餐只能订阅所有A股的股票。**
{% endhint %}
### WebSocket连接数
系统会根据您套餐的订阅总数，分配足够的 WebSocket 连接来承载数据。每条连接最多可承载 600 个订阅。如果您的订阅总数超过 600，系统会自动提供多条连接，以确保数据正常推送。
{% hint style="info" %}
**示例：**
* 订阅总数200 → 系统提供 1 条连接
* 订阅总数800 → 系统提供 2 条连接
* 订阅总数5000 → 系统提供 9 条连接
{% endhint %}
有多条WS连接的情况下，每条连接的订阅数量可自由分配，只要不超过每个连接600、以及套餐订阅总数的上限即可。
### 订阅不同市场数据不视作多个连接
Infoway API 的WebSocket分为以下市场通道：
* 股票行情：`wss://data.infoway.io/ws?business=stock`
* 加密货币行情：`wss://data.infoway.io/ws?business=crypto`
* 外汇与商品期货：`wss://data.infoway.io/ws?business=common`
* 日本行情：`wss://data.infoway.io/ws?business=japan`
* 印度行情：`wss://data.infoway.io/ws?business=india`
* 韩国行情：`wss://data.infoway.io/ws?business=korea`
**即使您同时订阅这三个通道的数据，也只视作1个WS连接。**
# 错误码说明
HTTP错误码以及WEBSOCKET错误码说明
# HTTP错误码
HTTP API接口错误码说明
| 错误码 | 说明 |
| --- | ------------------------------------------------- |
| 503 | K线查询数量超出限制 |
| 505 | 产品数量超出限制 |
| 508 | 查询的产品不存在，或已经退市 |
| 401 | 认证错误，API Key不正确，或者未将API Key放置在指定`header`或`query`中 |
| 404 | API接口不存在 |
| 429 | 请求频率限制，请求不符合您当前套餐配额 |
| 499 | 客户端主动中断，通常发生在网络不稳定的地区，请在良好网络环境连接 |
| 524 | 源服务器连接超时，通常发生在我们加速代理提供商到我们服务器之间不稳定导致，一般很快就能恢复 |
# WebSocket错误码
Websocket错误码说明
| 错误码 | 说明 |
| --- | ------------------------------------------------- |
| 500 | 服务异常 |
| 501 | 请求频率超出一分钟限制 |
| 505 | 产品数量超出限制 |
| 506 | 参数缺失 |
| 515 | 参数不是json格式 |
| 513 | WebSocket心跳超时 |
| 401 | 认证错误，API Key不正确，或者未将API Key放置在指定`header`或`query`中 |
| 404 | API接口不存在 |
| 427 | WebSocket连接数量超过套餐配额 |
| 429 | 请求频率限制，请求不符合您当前套餐配额 |
| 499 | 客户端主动中断，通常发生在网络不稳定的地区，请在良好网络环境连接 |
| 524 | 源服务器连接超时，通常发生在我们加速代理提供商到我们服务器之间不稳定导致，一般很快就能恢复 |
# 行情地址说明
包含HTTP以及WebSocket的URL地址说明
## HTTP接口地址
### 1、批量查询K线接口( [接口文档](/rest-api/http-endpoints/get-candles))
**股票（包括美股、港股、A股）K线查询接口（POST）**：
```
data.infoway.io/stock/v2/batch_kline
```
**加密货币K线查询接口（POST）**：
```
data.infoway.io/crypto/v2/batch_kline
```
**外汇商品期货K线查询接口（POST）**：
```
data.infoway.io/common/v2/batch_kline
```
**日本K线查询接口（POST）**：
```
data.infoway.io/japan/v2/batch_kline
```
**印度K线查询接口（POST）**：
```
data.infoway.io/india/v2/batch_kline
```
**韩国K线查询接口（POST）**：
```
data.infoway.io/korea/v2/batch_kline
```
### 2、批量查询成交明细接口( [接口文档](/rest-api/http-endpoints/get-trade))
**股票（包括美股、港股、A股）成交明细查询接口（GET）**：
```
data.infoway.io/stock/batch_trade/{codes}
```
**加密货币成交明细查询接口（GET）**：
```
data.infoway.io/crypto/batch_trade/{codes}
```
**外汇商品期货成交明细查询接口（GET）**：
```
data.infoway.io/common/batch_trade/{codes}
```
**日本成交明细查询接口（GET）**：
```
data.infoway.io/japan/batch_trade/{codes}
```
**印度成交明细查询接口（GET）**：
```
data.infoway.io/india/batch_trade/{codes}
```
**韩国成交明细查询接口（GET）**：
```
data.infoway.io/korea/batch_trade/{codes}
```
### 3、批量查询盘口接口( [接口文档](/rest-api/http-endpoints/get-depth))
**股票（包括美股、港股、A股）盘口查询接口（GET）**：
```
data.infoway.io/stock/batch_depth/{codes}
```
**加密货币盘口查询接口（GET）**：
```
data.infoway.io/crypto/batch_depth/{codes}
```
**外汇商品期货盘口查询接口（GET）**：
```
data.infoway.io/common/batch_depth/{codes}
```
**日本盘口查询接口（GET）**：
```
data.infoway.io/japan/batch_depth/{codes}
```
**印度盘口查询接口（GET）**：
```
data.infoway.io/india/batch_depth/{codes}
```
**韩国盘口查询接口（GET）**：
```
data.infoway.io/korea/batch_depth/{codes}
```
### 4、获取产品code列表
[产品列表接口文档](/rest-api/basic-info/get-symbol-list)
### 5、获取产品的基础信息
[产品基础信息接口文档](/rest-api/basic-info/get-symbol-basic-info)
### 6、获取市场的交易日以及交易时间段信息
[交易时间段接口文档](/rest-api/basic-info/get-market-trading-hours)
[市场交易日接口文档](/rest-api/basic-info/get-market-trading-days)
## Websocket请求地址
[文档地址](/websocket-api/endpoints)
# 请求协议以及响应格式
包括HTTP请求以及WEBSOCKET请求
## 1、HTTP请求协议以及响应协议
### 1.1、请求头
所有HTTP接口均为`GET`请求，需要在请求头`Headers`里面固定设置您的API Key
### 1.2、响应格式
```
{
"ret": 200,
"msg": "success",
"traceId": "698f920a-c53b-401c-bfac-4ea46b9b8f12",
"data": [
]
}
```
| 字段 | 描述 |
| --------- | -------------------------------------------------------------------------- |
| `ret` | 响应码。`200`为正常响应（[错误码](https://infoway.readme.io/reference/http-error-code)） |
| `msg` | success |
| `tradeId` | 由系统生成的唯一ID |
| `data` | 响应数据返回 |
## 2、Websocket
所有类型的WebSocket连接，地址相同，仅参数不同，详情请看[Websocket订阅地址说明](/websocket-api/endpoints)和[Websocket代码示例](/websocket-api/code-examples)。
# HTTP请求示例
{% tabs %}
{% tab title="Go" %}
```go
package main
import (
"fmt"
"io/ioutil"
"net/http"
)
func main() {
apiUrl := "https://data.infoway.io/stock/batch_kline/1/10/002594.SZ%2C00285.HK%2CTSLA.US"
// 创建HTTP客户端
client := &http.Client{}
// 创建GET请求
req, err := http.NewRequest("GET", apiUrl, nil)
if err != nil {
fmt.Println("Error creating request:", err)
return
}
// 设置请求头
req.Header.Set("User-Agent", "Mozilla/5.0")
req.Header.Set("Accept", "application/json")
req.Header.Set("apiKey", "yourApikey")
// 发送请求
resp, err := client.Do(req)
if err != nil {
fmt.Println("Error sending request:", err)
return
}
defer resp.Body.Close()
// 读取响应内容
body, err := ioutil.ReadAll(resp.Body)
if err != nil {
fmt.Println("Error reading response:", err)
return
}
// 输出结果
fmt.Printf("HTTP code:", resp.StatusCode)
fmt.Printf("message:", string(body))
}
```
{% endtab %}
{% tab title="Java" %}
```java
import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
public class HttpExample {
public static void main(String[] args) {
try {
// 定义请求URL
String apiUrl = "https://data.infoway.io/stock/batch_kline/1/10/002594.SZ%2C00285.HK%2CTSLA.US";
URL url = new URL(apiUrl);
// 创建HTTP连接
HttpURLConnection connection = (HttpURLConnection) url.openConnection();
// 设置请求方法为GET
connection.setRequestMethod("GET");
// 设置请求头（可选）
connection.setRequestProperty("User-Agent", "Mozilla/5.0");
connection.setRequestProperty("Accept", "application/json");
connection.setRequestProperty("apiKey","yourApikey");
// 获取响应码
int responseCode = connection.getResponseCode();
System.out.println("HTTP code: " + responseCode);
// 读取响应内容
BufferedReader reader;
if (responseCode == HttpURLConnection.HTTP_OK) {
reader = new BufferedReader(new InputStreamReader(connection.getInputStream()));
} else {
reader = new BufferedReader(new InputStreamReader(connection.getErrorStream()));
}
String line;
StringBuilder response = new StringBuilder();
while ((line = reader.readLine()) != null) {
response.append(line);
}
reader.close();
// 打印响应内容
System.out.println("message: " + response);
} catch (IOException e) {
e.printStackTrace();
}
}
}
```
{% endtab %}
{% tab title="PHP" %}
```php
```
{% endtab %}
{% tab title="Python" %}
```python
import requests
api_url = 'https://data.infoway.io/stock/batch_kline/1/10/002594.SZ%2C00285.HK%2CTSLA.US'
# 设置请求头
headers = {
'User-Agent': 'Mozilla/5.0',
'Accept': 'application/json',
'apiKey': 'yourApikey'
}
# 发送GET请求
response = requests.get(api_url, headers=headers)
# 输出结果
print(f"HTTP code: {response.status_code}")
print(f"message: {response.text}")
```
{% endtab %}
{% endtabs %}
# 基础信息查询
包含查询产品列表、产品的基本信息、市场信息（交易日、交易时间）
# GET查询产品列表
查询不同市场的产品列表，支持条件查询
## 接口说明
该接口是获取不同市场的产品列表，方便您确认是否包含您所需的产品数据
## 请求频率
跟其他接口请求频率使用同一个频率限制。具体每秒请求次数根据套餐决定。可以参考[接口限制说明](/getting-started/api-limitation)
## 错误码说明
参考[HTTP错误码说明](/getting-started/error-codes/http)
## 接口地址
* 基本路径：`/common/basic/symbols`
* 完整路径：`https://data.infoway.io
/common/basic/symbols`
## 请求头
| 参数 | 类型 | 必填 | 描述 |
| -------- | ------ | -- | ------------ |
| `apiKey` | String | 是 | 您套餐中的API Key |
## Request param入参说明
| 参数名 | 类型 | 必填 | 描述 | 示例值 |
| --------- | ------ | -- | ------------------------------------------------ | ------------------ |
| `type` | String | 是 | 标的类型，参考下面type类型 | `STOCK_US` |
| `symbols` | String | 否 | 标的列表，多个用,隔开 | `.DJI.US,.IXIC.US` |
#### type说明
| 类型代码 | 描述 |
| ---------- | ---- |
| `STOCK_US` | 美股 |
| `STOCK_CN` | A股 |
| `STOCK_HK` | 港股 |
| `FUTURES` | 期货 |
| `FOREX` | 外汇 |
| `ENERGY` | 能源 |
| `METAL` | 金属 |
| `CRYPTO` | 加密货币 |
| `STOCK_IN` | 印股 |
| `STOCK_JP` | 日股 |
| `STOCK_KS` | 韩股 |
| `INDICES` | 指数 |
## 返回示例
```json
{
"ret": 200,
"msg": "success",
"traceId": "ed8a84d9-4575-4077-bc1c-31b17d0c8977",
"data": [
{
"symbol": ".DJI.US",
"name_cn": "道琼斯指数",
"name_hk": "道瓊斯指數",
"name_en": "Dow Jones Industrial Average",
"index": true
},
{
"symbol": ".IXIC.US",
"name_cn": "纳斯达克综合指数",
"name_hk": "納斯達克綜合指數",
"name_en": "NASDAQ Composite Index",
"index": true
}
]
}
```
| 字段名 | 类型 | 必填 | 描述 | 示例值 |
| --------- | ------ | -- | ---- | ------------ |
| `symbol` | String | 是 | 标的代码 | `AAPL.US` |
| `name_cn` | String | 否 | 中文名称 | `苹果` |
| `name_hk` | String | 否 | 繁体名称 | `蘋果` |
| `name_en` | String | 否 | 英文名称 | `Apple Inc.` |
| `index` | String | 否 | 是否指数 | `true` |
# GET获取产品的基础信息
## 接口说明
该接口是获取不同产品的基础信息，包括名称、交易所、币种、股数等数据
## 请求频率
跟其他接口请求频率使用同一个频率限制。具体每秒请求次数根据套餐决定。可以参考[接口限制说明](/getting-started/api-limitation)
## 错误码说明
参考[HTTP错误码说明](/getting-started/error-codes/http)
## 接口地址
* 基本路径：`/common/basic/symbols/info`
* 完整路径：`https://data.infoway.io/common/basic/symbols/info`
## 请求头
| 参数 | 类型 | 必填 | 描述 |
| -------- | ------ | -- | ------------ |
| `apiKey` | String | 是 | 您套餐中的API Key |
## Request param入参说明
| 参数名 | 类型 | 必填 | 描述 | 示例值 |
| --------- | ------ | -- | ------------------------------------------------ | -------------------- |
| `type` | String | 是 | 标的类型，参考下面type类型 | `STOCK_US` |
| `symbols` | String | 是 | 标的列表，多个用,隔开，最大支持500个 | `000001.SZ,00076.HK` |
#### Type说明
| 类型代码 | 描述 |
| ---------- | ---- |
| `STOCK_US` | 美股 |
| `STOCK_CN` | A股 |
| `STOCK_HK` | 港股 |
| `FUTURES` | 期货 |
| `FOREX` | 外汇 |
| `ENERGY` | 能源 |
| `METAL` | 金属 |
| `CRYPTO` | 加密货币 |
| `STOCK_IN` | 印股 |
| `STOCK_JP` | 日股 |
| `STOCK_KS` | 韩股 |
| `INDEX` | 指数 |
## 返回示例
```json
{
"ret": 200,
"msg": "success",
"traceId": "52327ed3-e96a-4e9a-a591-e910a0fcc563",
"data": [
{
"symbol": "000001.SZ",
"market": "CN",
"name_cn": "平安银行",
"name_en": "PAB",
"name_hk": "平安銀行",
"exchange": "SZSE",
"currency": "CNY",
"lot_size": 100,
"total_shares": 19405918198,
"circulating_shares": 19405762053,
"hk_shares": 0,
"eps": "2.2935271367158012",
"eps_ttm": "2.2504474951615995",
"bps": "22.4755662447835698",
"dividend_yield": "0.9649999999963929",
"stock_derivatives": "",
"board": "SZMainConnect"
},
{
"symbol": "000002.SZ",
"market": "CN",
"name_cn": "万科A",
"name_en": "Vanke",
"name_hk": "萬科A",
"exchange": "SZSE",
"currency": "CNY",
"lot_size": 100,
"total_shares": 11930709471,
"circulating_shares": 9724196533,
"hk_shares": 0,
"eps": "-4.147148946357911",
"eps_ttm": "-4.6403502137102706",
"bps": "16.4892858366243256",
"dividend_yield": "0",
"stock_derivatives": "",
"board": "SZMainConnect"
}
]
}
```
| 字段名 | 类型 | 必填 | 描述 | 示例值/可选值 |
| -------------------- | ------ | -- | ---------- | ------------------------------------------------------------ |
| `symbol` | string | 是 | 标的代码 | `AAPL.US` |
| `name_cn` | string | 否 | 中文简体标的名称 | `苹果` |
| `name_en` | string | 否 | 英文标的名称 | `Apple` |
| `name_hk` | string | 否 | 中文繁体标的名称 | `蘋果` |
| `exchange` | string | 否 | 标的所属交易所 | `NASD`, `SSE`, `SZSE`, `SEHK`, `NYSE`, `AMEX`, `OTC`, `NYSD` |
| `currency` | string | 否 | 交易币种 | `USD`, `CNY`, `HKD`, `EUR`, `SGD`, `JPY`, `AUD`, `GBP` |
| `lot_size` | int32 | 否 | 每手股数 | `100` |
| `total_shares` | int64 | 否 | 总股本 | `1000000000` |
| `circulating_shares` | int64 | 否 | 流通股本 | `800000000` |
| `hk_shares` | int64 | 否 | 港股股本 (仅港股) | `500000000` |
| `eps` | string | 否 | 每股盈利 | `5.25` |
| `eps_ttm` | string | 否 | 每股盈利 (TTM) | `5.50` |
| `bps` | string | 否 | 每股净资产 | `120.50` |
| `dividend_yield` | string | 否 | 股息 | `3.5` |
| `board` | string | 否 | 标的所属板块 | 参考下面的说明 |
### Board
| 板块代码 | 描述 |
| ------------------ | ------------------- |
| `USMain` | 美股主板 |
| `USPink` | 粉单市场 |
| `USDJI` | 道琼斯指数 |
| `USNSDQ` | 纳斯达克指数 |
| `USSector` | 美股行业概念 |
| `USOption` | 美股期权 |
| `USOptionS` | 美股特殊期权（收盘时间为 16:15） |
| `HKEquity` | 港股股本证券 |
| `HKPreIPO` | 港股暗盘 |
| `HKWarrant` | 港股轮证 |
| `HKHS` | 恒生指数 |
| `HKSector` | 港股行业概念 |
| `SHMainConnect` | 上证主板 - 互联互通 |
| `SHMainNonConnect` | 上证主板 - 非互联互通 |
| `SHSTAR` | 科创板 |
| `CNIX` | 沪深指数 |
| `CNSector` | 沪深行业概念 |
| `SZMainConnect` | 深证主板 - 互联互通 |
| `SZMainNonConnect` | 深证主板 - 非互联互通 |
| `SZGEMConnect` | 创业板 - 互联互通 |
| `SZGEMNonConnect` | 创业板 - 非互联互通 |
# GET获取产品的复权因子
获取产品的复权因子
## 接口说明
该接口是获取产品的复权因子
## 请求频率
跟其他接口请求频率使用同一个频率限制。具体每秒请求次数根据套餐决定。可以参考[接口限制说明](/getting-started/api-limitation)
## 错误码说明
参考[HTTP错误码说明](/getting-started/error-codes/http)
## 接口地址
* 基本路径：`/common/basic/symbols/adjustment_factors`
* 完整路径：`https://data.infoway.io/common/basic/symbols/adjustment_factors`
## 请求头
| 参数 | 类型 | 必填 | 描述 |
| -------- | ------ | -- | ------------ |
| `apiKey` | String | 是 | 您套餐中的API Key |
## Request param入参说明
| 参数名 | 类型 | 必填 | 描述 | 示例值 |
| ---------- | ------ | -- | --------------------------------- | ----------- |
| `symbol` | String | 是 | 标的代码 | `000001.SZ` |
| `market` | String | 是 | 市场: `US`,`CN`,`JP`,`IN`,`HK`,`KS` | `US` |
| `beginDay` | String | 是 | 开始时间，格式`YYYYMMDD` | `20260323` |
| `endDay` | String | 是 | 结束时间，格式`YYYYMMDD` | `20260324` |
## 返回示例
```json
{
"ret": 200,
"msg": "success",
"traceId": "a50ecfd7-decf-4c80-8ee0-798ede935794",
"data": [
{
"symbol": "000001.SZ",
"market": "CN",
"trade_date": "19910102",
"forward_factor": 0.6399030867
},
{
"symbol": "000001.SZ",
"market": "CN",
"trade_date": "19910103",
"forward_factor": 0.6399029351
}
]
}
```
| 字段名 | 类型 | 必填 | 描述 | 示例值 |
|---|
symbol | String | 是 | 标的代码 | 000001.SZ |
market | String | 是 | 市场：US,CN,JP,IN,HK,KS | US |
trade_date | String | 是 | 交易日期，格式YYYYMMDD | 19910103 |
forward_factor | BigDecimal | 是 | 前复权因子 | 0.6499029351 |
# GET获取市场的交易日信息
获取不同市场的交易日信息，包含全天交易日以及半天交易日
## 接口说明
该接口是获取不同市场的交易日信息，包含全天交易日以及半天交易日
## 请求频率
跟其他接口请求频率使用同一个频率限制。具体每秒请求次数根据套餐决定。可以参考[接口限制说明](/getting-started/api-limitation)
## 错误码说明
参考[HTTP错误码说明](/getting-started/error-codes/http)
## 股票市场
### 接口地址
* 基本路径：`/common/basic/markets/trading_days`
* 完整路径：`https://data.infoway.io
/common/basic/markets/trading_days`
### 请求头
| 参数 | 类型 | 必填 | 描述 |
| -------- | ------ | -- | ------------ |
| `apiKey` | String | 是 | 您套餐中的API Key |
### Request param入参说明
| 参数名 | 类型 | 必填 | 描述 | 示例值 |
|---|
market | String | 是 | 市场 | US, HK, CN, JP, IN, KS |
beginDay | String | 是 | 开始日期，使用 YYYYMMDD 格式 | 20230101 |
endDay | String | 是 | 结束时间，使用 YYYYMMDD 格式 | 20230301 |
### 返回示例
```json
{
"ret": 200,
"msg": "success",
"traceId": "46fbf427-a30e-48ff-8760-9fb20025c667",
"data": {
"trade_days": [
"20230221",
"20230222",
"20230223",
"20230224",
"20230227",
"20230228",
"20230301"
],
"half_trade_days": []
}
}
```
| 字段名 | 类型 | 必填 | 描述 | 示例值 |
| ----------------- | ---- | -- | ------------------- | ---------- |
| `trade_days` | List | 否 | 交易日，使用 `YYYMMDD` 格式 | `20230101` |
| `half_trade_days` | List | 否 | 半日市，使用 `YYYMMDD` 格式 | `20230101` |
## 其他市场
### 接口地址
* 基本路径：`/common/basic/markets/trading_schedule`
* 完整路径：`https://data.infoway.io
/common/basic/markets/trading_schedule`
### 请求头
| 参数 | 类型 | 必填 | 描述 |
| -------- | ------ | -- | ------------ |
| `apiKey` | String | 是 | 您套餐中的API Key |
### Request param入参说明
| 参数名 | 类型 | 必填 | 描述 | 示例值 |
|---|
type | String | 否 | 类型（不传查所有） | ENERGY, FOREX, FUTURES, METAL，INDICES |
### 返回示例
```json
{
"ret": 200,
"msg": "success",
"traceId": "9ae7a566-0a08-4ecb-b0ed-da0d90c1e88c",
"data": [
{
"symbol": "XAGEUR",
"type": "METAL",
"name": "白银/欧元",
"timezone": "America/New_York",
"session": "1700-1700",
"holidays": {
"summary": "",
"dates": []
},
"symbol_code": "OANDA:XAGEUR",
"is_24_7": false,
"trading_hours": {
"summary": "（GMT 0）\n夏令时（每年3月第2个周日开始）周日至周五（连续 24 小时）\n冬令时（每年11月第1个周日开始）周日至周五（连续 24 小时）\nSummer Time (from the 2nd Sunday of March) Sunday-Friday (24h continuous)\nWinter Time (from the 1st Sunday of November) Sunday-Friday (24h continuous)",
"segments": [
{
"days": "周日至周五",
"overnight": true,
"gmt0": {
"summer": {
"start": "21:00",
"end": "21:00"
},
"winter": {
"start": "22:00",
"end": "22:00"
}
},
"days_en": "Sunday-Friday",
"continuous_24h": true,
"native": {
"start": "17:00",
"end": "17:00"
}
}
],
"is_dst": true
},
"break_time": {
"summary": "",
"windows": []
}
}
]
}
```
| 字段名 | 类型 | 必填 | 描述 | 示例 |
| --------------- | ------- | -- | ----------------------------- | -------------------- |
| `symbol` | string | 是 | 交易品种代码（不含数据源前缀） | `"XAGEUR"` |
| `type` | string | 是 | 品种类别（METAL/FX/STOCK 等） | `"METAL"` |
| `name` | string | 是 | 品种名称 | `"白银/欧元"` |
| `timezone` | string | 是 | 品种原生报价所采用的时区（IANA 时区名） | `"America/New_York"` |
| `session` | string | 是 | 原生交易时段区间，格式 `HHMM-HHMM` | `"1700-1700"` |
| `holidays` | object | 是 | 休市（节假日）信息容器 | 见 二、holidays |
| `symbol_code` | string | 是 | 含数据源前缀的完整品种标识（TradingView 格式） | `"OANDA:XAGEUR"` |
| `is_24_7` | boolean | 是 | 是否为 7×24 小时不间断交易品种 | `false` |
| `trading_hours` | object | 是 | 交易时段信息容器 | 见 三、trading\_hours |
| `break_time` | object | 否 | 盘中休息（集合竞价/午休）窗口容器 | 见 四、break\_time |
### holidays
| 字段名 | 类型 | 必填 | 描述 | 示例 |
| ------------------ | -------------- | -- | ---------------------------------- | ---- |
| `holidays.summary` | string | 否 | 休市说明的简短文字（无休市时为空串） | `""` |
| `holidays.dates` | array\ | 否 | 休市日期列表（通常为 `YYYY-MM-DD` 或 `MM/DD`） | `[]` |
### trading\_hours
| 字段名 | 类型 | 必填 | 描述 | 示例 |
| ------------------------ | -------------- | -- | -------------------- | ----------------- |
| `trading_hours.summary` | string | 否 | 交易时段的中文/英文汇总说明（多行文本） | `"（GMT 0）\n夏令时…"` |
| `trading_hours.segments` | array\