概述

本文檔詳細説明如何對接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位數字
• 日本市場有獨特的行業分類體系，需要注意與全球標準的映射

錯誤代碼

示例代碼

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

  注意事項

1. 所有API調用都需要包含有效的API Key
2. 請合理控制請求頻率，避免過度請求
3. 數據僅供參考，投資決策請謹慎
4. 日本市場有特定的假日安排，非交易日數據可能不更新