概述

StockTV 提供了全球范围内的股票、外汇、期货和加密货币的实时数据接口，支持 HTTP 和 WebSocket 两种对接方式。本文将详细介绍如何使用 StockTV 的 API 接口获取实时数据，并重点介绍印度数据源的使用。

接口文档

1. 获取 Key

在使用 StockTV 的 API 接口之前，您需要先获取一个 Key。请通过以下方式联系我们获取 Key：

• 联系我们获取 Key

2. 调用 API

在调用 API 时，请将获取到的 Key 添加到请求参数中，例如：

https://api.stocktv.top/stock/stocks?countryId=14&pageSize=10&page=1&key=您的Key

3. 数据格式

所有 API 返回的数据均为 JSON 格式。

支持的国家和地区

StockTV 支持以下国家和地区的股票行情数据：

• 印度
• 中国
• 马来西亚
• 印度尼西亚
• 美国
• 日本
• 韩国
• 新加坡
• 巴西
• 哥伦比亚
• 越南
• 沙特阿拉伯

主要功能

1. 股票市场数据

1.1 市场列表

获取指定国家的股票市场列表。

请求示例：

GET https://api.stocktv.top/stock/stocks?countryId=14&pageSize=10&page=1&key=您的Key

参数说明：

• countryId: 国家 ID，例如 14 代表印度
• pageSize: 每页显示数量，默认值为 10
• page: 页码，默认值为 1

1.2 查询股票

根据股票 ID、名称或代码查询股票信息。

请求示例：

GET https://api.stocktv.top/stock/queryStocks?id=7310&key=您的Key

参数说明：

• id: 股票 ID
• name: 股票名称
• symbol: 股票代码

1.3 指数

获取指定国家的股票指数。

请求示例：

GET https://api.stocktv.top/stock/indices?countryId=14&key=您的Key

参数说明：

• countryId: 国家 ID
• flag: 国家简称（非必要参数）

1.4 K 线数据

获取指定股票的 K 线数据。

请求示例：

GET https://api.stocktv.top/stock/kline?pid=7310&interval=PT15M&key=您的Key

参数说明：

• pid: 产品 ID
• interval: 时间间隔，支持 PT5M、PT15M、PT1H、PT5H、P1D、P1W、P1M

1.5 IPO 新股日历

获取指定国家的 IPO 新股日历。

请求示例：

GET https://api.stocktv.top/stock/getIpo?key=您的Key&countryId=14

参数说明：

• countryId: 国家 ID

1.6 公司信息

获取指定国家的公司信息。

请求示例：

GET https://api.stocktv.top/stock/companies?countryId=14&pageSize=10&page=1&key=您的Key

参数说明：

• countryId: 国家 ID
• pageSize: 每页数量
• page: 页数

1.7 国际新闻

获取国际新闻。

请求示例：

GET https://api.stocktv.top/stock/news?pageSize=10&page=1&key=您的Key

参数说明：

• pageSize: 每页数量
• page: 页数

1.8 WebSocket 实时推送

通过 WebSocket 获取实时股票数据。

请求示例：

wss://ws-api.stocktv.top/connect?key=您的Key

返回值：

• pid: 产品 ID
• last_dir: 最后交易方向
• last_numeric: 最后交易价格数值
• bid: 买入价
• ask: 卖出价
• high: 最高价
• low: 最低价
• last_close: 前收盘价
• pc: 当前价格变化
• pcp: 涨跌幅
• pc_col: 价格变化颜色
• turnover_numeric: 成交量数值
• time: 交易时间
• timestamp: 时间戳
• type: 类型（1 股票，2 指数）

2. 外汇 API

2.1 市场列表

获取外汇市场列表。

请求示例：

GET https://api.stocktv.top/market/currencyList?key=您的Key

2.2 实时汇率列表

获取实时汇率列表。

请求示例：

GET https://api.stocktv.top/market/currency?key=您的Key&countryType=sg

参数说明：

• countryType: 国家交叉汇率（可选参数）

2.3 当前外汇信息

获取当前外汇信息。

请求示例：

GET https://api.stocktv.top/market/todayMarket?key=您的Key&symbol=EUR=X

参数说明：

• symbol: 交易对

2.4 汇率信息

获取汇率信息。

请求示例：

GET https://api.stocktv.top/market/spark?key=您的Key&symbol=EURUSD=X&interval=5m

参数说明：

• symbol: 交易对
• interval: 时间间隔，默认 5m

2.5 K 线图表数据

获取外汇 K 线图表数据。

请求示例：

GET https://api.stocktv.top/market/chart?key=您的Key&symbol=EURUSD=X&interval=5m

参数说明：

• symbol: 交易对
• interval: 时间间隔，支持 1m、2m、5m、15m、30m、60m、90m、1h、1d、5d、1wk、1mo、3mo

3. 期货市场

3.1 市场列表

获取期货市场列表。

请求示例：

GET https://api.stocktv.top/futures/list?key=您的Key

3.2 当前期货行情

获取当前期货行情。

请求示例：

GET https://api.stocktv.top/futures/querySymbol?key=您的Key&symbol=XAG

参数说明：

• symbol: 交易对

3.3 K 线图表数据

获取期货 K 线图表数据。

请求示例：

GET https://api.stocktv.top/futures/kline?key=您的Key&symbol=EUA&interval=1

参数说明：

• symbol: 交易对
• interval: 时间间隔，支持 1、5、15、30、60、1d

4. 加密货币

4.1 交易对信息

获取加密货币交易对信息。

请求示例：

GET https://api.stocktv.top/crypto/getCoinInfo?key=您的Key

4.2 交易对列表

获取加密货币交易对列表。

请求示例：

GET https://api.stocktv.top/crypto/getCoinList?key=您的Key&start=1&limit=1000

参数说明：

• start: 分页参数，默认 1
• limit: 分页大小，默认 1000

4.3 获取最新行情

获取加密货币最新行情。

请求示例：

GET https://api.stocktv.top/crypto/tickerPrice?key=您的Key&symbols=BTCUSDT,ETHUSDT

参数说明：

• symbols: 交易对列表，通过逗号隔开（最大传 100 个交易对）

4.4 获取最新价格

获取加密货币最新价格。

请求示例：

GET https://api.stocktv.top/crypto/lastPrice?key=您的Key&symbols=BTCUSDT,ETHUSDT

参数说明：

• symbols: 交易对列表，通过逗号隔开（最大传 100 个交易对）

4.5 K 线数据

获取加密货币 K 线数据。

请求示例：

GET https://api.stocktv.top/crypto/getKlines?key=您的Key&symbol=BTCUSDT&interval=5m

参数说明：

• symbol: 交易对
• interval: 时间间隔，支持 1s、1m、3m、5m、15m、30m、1h、2h、4h、6h、8h、12h、1d、3d、1w、1M

4.6 获取近期成交

获取加密货币近期成交数据。

请求示例：

GET https://api.stocktv.top/crypto/getTrades?key=您的Key&symbol=BTCUSDT

参数说明：

• symbol: 交易对

总结

StockTV 提供了丰富的 API 接口，支持全球范围内的股票、外汇、期货和加密货币的实时数据获取。通过 HTTP 和 WebSocket 两种对接方式，您可以轻松获取所需的金融数据。本文详细介绍了如何使用这些接口，并重点介绍了印度数据源的使用。希望本文能帮助您更好地使用 StockTV 的 API 接口。

如果您有任何问题或需要技术支持，请随时联系我们。

关键字： 印度数据源、实时数据、HTTP 和 WS 对接方式