当前位置：首页 > news >正文

东南亚日本股票数据API对接文档

news 2025/9/29 10:48:32

概述

本文档详细说明如何对接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 Key
404	资源不存在	检查股票代码或ID
500	服务器错误	联系技术支持

示例代码

Python示例

import requestsdef 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"] = symbolresponse = 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);
});