东南亚日本股票数据API对接文档
概述本文档详细说明如何对接StockTV全球股票API中的日本股票数据。日本股票市场是全球重要金融市场之一，包含东京证券交易所(TSE)等多个交易所。
认证方式
所有API请求都需要在URL参数中包含API Key：
key=您的API密钥基础信息
[*]日本国家ID: countryId=35
API端点
1. 日本股票市场列表
获取日本股票市场列表，支持分页查询。
请求示例:
GET https://api.stocktv.top/stock/stocks?countryId=16&pageSize=50&page=1&key=您的API密钥参数说明:
[*]countryId: 必须为16(日本)
[*]pageSize: 每页返回数量(默认10，最大100)
[*]page: 页码(默认1)
[*]exchangeId: 可选，交易所ID
响应示例:
{
"code": 200,
"message": "操作成功",
"data": {
"records": [
{
"id": 7310,
"name": "Toyota Motor Corp",
"symbol": "7203",
"last": 3285.00,
"chg": 25.00,
"chgPct": 0.77,
"high": 3300.00,
"low": 3270.00,
"volume": 4521800,
"exchangeId": 57,
"countryId": 16,
"flag": "JP",
"open": false,
"lastClose": 3260.00,
"time": 1716458537,
"url": "/equities/toyota-motor-corp"
}
],
"total": 3782,
"size": 50,
"current": 1,
"pages": 76
}
}2. 查询特定日本股票
通过股票ID、名称或代码查询日本股票信息。
请求示例:
GET https://api.stocktv.top/stock/queryStocks?countryId=16&symbol=7203&key=您的API密钥参数说明:
[*]id: 股票PID(可选)
[*]name: 股票名称(可选)
[*]symbol: 股票代码(可选)
[*]url: 股票详情页URL(可选)
3. 日本指数数据
获取日本主要股票指数信息。
请求示例:
GET https://api.stocktv.top/stock/indices?countryId=16&key=您的API密钥响应包含:
[*]日经225指数(Nikkei 225)
[*]东证股价指数(TOPIX)
[*]JPX日经400指数等
4. 日本股票K线数据
获取日本股票的K线图表数据。
请求示例:
GET https://api.stocktv.top/stock/kline?pid=7310&interval=PT1H&key=您的API密钥时间间隔参数:
[*]PT5M: 5分钟
[*]PT15M: 15分钟
[*]PT1H: 1小时
[*]PT5H: 5小时
[*]P1D: 1天
[*]P1W: 1周
[*]P1M: 1月
5. 日本股票涨跌排行榜
获取日本股票的涨跌幅排行榜。
请求示例:
GET https://api.stocktv.top/stock/updownList?countryId=16&type=1&key=您的API密钥类型参数:
[*]1: 涨幅榜
[*]2: 跌幅榜
[*]3: 涨停榜
[*]4: 跌停榜
6. 日本上市公司信息
获取日本上市公司的详细信息。
请求示例:
GET https://api.stocktv.top/stock/companies?countryId=16&pageSize=10&page=1&key=您的API密钥7. WebSocket实时数据
通过WebSocket获取日本股票的实时价格数据。
连接示例:
const ws = new WebSocket("wss://ws-api.stocktv.top/connect?key=您的API密钥");数据说明
交易时间
[*]日本股市交易时间(日本标准时间JST):
[*]早盘: 9:00-11:30
[*]午盘: 12:30-15:00
[*]API中的open字段表示当前是否处于交易时间
价格货币
[*]所有日本股票价格均以日元(JPY)为单位
特殊处理
[*]日本股票代码通常为4位数字
[*]日本市场有独特的行业分类体系，需要注意与全球标准的映射
错误代码
代码说明处理建议200成功-400参数错误检查请求参数401认证失败检查API Key404资源不存在检查股票代码或ID500服务器错误联系技术支持示例代码
Python示例
import requests
def get_japan_stocks(symbol=None):
url = "https://api.stocktv.top/stock/stocks"
params = {
"countryId": 16,
"pageSize": 50,
"page": 1,
"key": "您的API密钥"
}
if symbol:
params["symbol"] = symbol
response = requests.get(url, params=params)
return response.json()
# 获取丰田汽车股票数据
toyota_data = get_japan_stocks("7203")
print(toyota_data)JavaScript示例
async function fetchJapanStocks() {
const response = await fetch(
`https://api.stocktv.top/stock/stocks?countryId=16&pageSize=50&page=1&key=您的API密钥`
);
const data = await response.json();
return data;
}
// 使用示例
fetchJapanStocks().then(data => {
console.log(data);
});技术支持
如有疑问或需要帮助，请通过以下方式联系:
[*]Telegram: https://t.me/CryptoRzz
注意事项
[*]所有API调用都需要包含有效的API Key
[*]请合理控制请求频率，避免过度请求
[*]数据仅供参考，投资决策请谨慎
[*]日本市场有特定的假日安排，非交易日数据可能不更新
来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！
页:
[1]