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

概述

本文档详细说明如何对接StockTV全球股票API中的日本股票数据。日本股票市场是全球重要金融市场之一，包含东京证券交易所(TSE)等多个交易所。
认证方式

所有API请求都需要在URL参数中包含API Key：

1. key=您的API密钥

复制代码

基础信息

• 日本国家ID: countryId=35
  

API端点

1. 日本股票市场列表

获取日本股票市场列表，支持分页查询。
请求示例:

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
  

响应示例:

1. {
2.   "code": 200,
3.   "message": "操作成功",
4.   "data": {
5.     "records": [
6.       {
7.         "id": 7310,
8.         "name": "Toyota Motor Corp",
9.         "symbol": "7203",
10.         "last": 3285.00,
11.         "chg": 25.00,
12.         "chgPct": 0.77,
13.         "high": 3300.00,
14.         "low": 3270.00,
15.         "volume": 4521800,
16.         "exchangeId": 57,
17.         "countryId": 16,
18.         "flag": "JP",
19.         "open": false,
20.         "lastClose": 3260.00,
21.         "time": 1716458537,
22.         "url": "/equities/toyota-motor-corp"
23.       }
24.     ],
25.     "total": 3782,
26.     "size": 50,
27.     "current": 1,
28.     "pages": 76
29.   }
30. }

复制代码

2. 查询特定日本股票

通过股票ID、名称或代码查询日本股票信息。
请求示例:

1. GET https://api.stocktv.top/stock/queryStocks?countryId=16&symbol=7203&key=您的API密钥

复制代码

参数说明:

• id: 股票PID(可选)
  
• name: 股票名称(可选)
  
• symbol: 股票代码(可选)
  
• url: 股票详情页URL(可选)
  

3. 日本指数数据

获取日本主要股票指数信息。
请求示例:

1. GET https://api.stocktv.top/stock/indices?countryId=16&key=您的API密钥

复制代码

响应包含:

• 日经225指数(Nikkei 225)
  
• 东证股价指数(TOPIX)
  
• JPX日经400指数等
  

4. 日本股票K线数据

获取日本股票的K线图表数据。
请求示例:

1. 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. 日本股票涨跌排行榜

获取日本股票的涨跌幅排行榜。
请求示例:

1. GET https://api.stocktv.top/stock/updownList?countryId=16&type=1&key=您的API密钥

复制代码

类型参数:

• 1: 涨幅榜
  
• 2: 跌幅榜
  
• 3: 涨停榜
  
• 4: 跌停榜
  

6. 日本上市公司信息

获取日本上市公司的详细信息。
请求示例:

1. GET https://api.stocktv.top/stock/companies?countryId=16&pageSize=10&page=1&key=您的API密钥

复制代码

7. WebSocket实时数据

通过WebSocket获取日本股票的实时价格数据。
连接示例:

1. 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示例

1. import requests
3. def get_japan_stocks(symbol=None):
4.     url = "https://api.stocktv.top/stock/stocks"
5.     params = {
6.         "countryId": 16,
7.         "pageSize": 50,
8.         "page": 1,
9.         "key": "您的API密钥"
10.     }
11.    
12.     if symbol:
13.         params["symbol"] = symbol
14.         
15.     response = requests.get(url, params=params)
16.     return response.json()
18. # 获取丰田汽车股票数据
19. toyota_data = get_japan_stocks("7203")
20. print(toyota_data)

复制代码

JavaScript示例

1. async function fetchJapanStocks() {
2.   const response = await fetch(
3.     `https://api.stocktv.top/stock/stocks?countryId=16&pageSize=50&page=1&key=您的API密钥`
4.   );
5.   const data = await response.json();
6.   return data;
7. }
9. // 使用示例
10. fetchJapanStocks().then(data => {
11.   console.log(data);
12. });

复制代码

技术支持

如有疑问或需要帮助，请通过以下方式联系:

• Telegram: https://t.me/CryptoRzz
  

注意事项

• 所有API调用都需要包含有效的API Key
  
• 请合理控制请求频率，避免过度请求
  
• 数据仅供参考，投资决策请谨慎
  
• 日本市场有特定的假日安排，非交易日数据可能不更新
  

来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！