StockTV 全球股票、外汇、期货、加密货币 API 接口文档详解
概述
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: 每页显示数量，默认值为 10page: 页码，默认值为 1
1.2 查询股票
根据股票 ID、名称或代码查询股票信息。
请求示例：
GET https://api.stocktv.top/stock/queryStocks?id=7310&key=您的Key
参数说明：
id: 股票 IDname: 股票名称symbol: 股票代码
1.3 指数
获取指定国家的股票指数。
请求示例：
GET https://api.stocktv.top/stock/indices?countryId=14&key=您的Key
参数说明：
countryId: 国家 IDflag: 国家简称（非必要参数）
1.4 K 线数据
获取指定股票的 K 线数据。
请求示例：
GET https://api.stocktv.top/stock/kline?pid=7310&interval=PT15M&key=您的Key
参数说明：
pid: 产品 IDinterval: 时间间隔，支持 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: 国家 IDpageSize: 每页数量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: 产品 IDlast_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: 分页参数，默认 1limit: 分页大小，默认 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 对接方式