隨着巴菲特增持五大商社以及日經 225 指數的強勢表現，日本股市（Tokyo Stock Exchange）已成為全球投資者不可忽視的市場。對於開發者而言，如何快速、穩定地接入日本股票數據？
本文將分享如何使用 StockTV API 實現日本股票（countryId=35）的全面對接，重點聚焦實時數據與 IPO 新股日曆功能。
一、 接入準備
在開始調用接口前，請確保獲取以下基礎信息：
- API 基礎路徑：
https://api.stocktv.top - 國家 ID (countryId)：
35（日本市場專有 ID） - 認證方式：在請求參數中攜帶
key - 數據格式：標準 JSON
二、 核心功能實現
1. 實時行情：秒級同步東京證券交易所
StockTV 提供了豐富的行情接口，能夠實時反饋日本個股及大盤的波動情況。
A. 獲取日本股票市場列表
通過設置 countryId=35，你可以獲取日本交易所的全部股票清單及其最新成交價。
-
請求示例：
GET https://api.stocktv.top/stock/stocks?countryId=35&pageSize=20&page=1&key=YOUR_KEY - 核心字段：
last: 最新成交價chgPct: 漲跌幅high/low: 當日最高/最低價volume: 當前成交量
B. 日本大盤指數（日經 225）
監控日本市場離不開日經 225 (Nikkei 225) 和東證指數 (TOPIX)。
- 接口地址：
/stock/indices?countryId=35 - 實時狀態：接口通過
isOpen字段實時返回市場是否處於交易時間。
2. IPO 新股日曆：捕捉上市紅利
日本 IPO 市場（如東證 MOTHERS 板塊）非常活躍。利用 IPO 接口，你可以輕鬆構建新股提醒功能。
- 接口地址：
/stock/getIpo - 請求參數：
countryId=35，type=1（未上市）或type=2（已上市）。 -
請求示例：
GET https://api.stocktv.top/stock/getIpo?countryId=35&type=1&key=YOUR_KEY - 關鍵返回信息：
ipoListing: 預計上市時間戳。ipoPrice: 發行價格。company: 公司名稱及交易代碼。
3. K 線數據：專業級圖表支持
支持從 1 分鐘到 1 月不等的多種週期，滿足技術分析需求。
- 週期參數 (
interval)：PT1M(1分),PT15M(15分),PT1H(1時),P1D(1天) 等。 - 數據結構：返回包含 Open, High, Low, Close, Volume 的標準 OHLC 數組。
三、 為什麼選擇 StockTV 的日本數據？
- 低延遲實時性：直接對接底層數據源，確保價格變動秒級同步。
- 數據維度全：除了價格，還提供公司基本面描述、行業分類（
industry）及板塊（sector）信息。 - 多協議接入：同時支持 HTTP 調用和 WebSocket 實時推送，適合不同性能要求的應用場景。
- 易於集成：只需傳入
countryId=35，即可在同一套邏輯下快速切換至其他國家市場。
四、 快速上手示例 (Node.js)
const axios = require('axios');
async function getJapanStocks() {
const url = 'https://api.stocktv.top/stock/stocks';
try {
const response = await axios.get(url, {
params: {
countryId: 35, // 日本
key: 'YOUR_API_KEY',
pageSize: 10
}
});
console.log('日本股票實時列表:', response.data.data.records);
} catch (error) {
console.error('獲取失敗:', error);
}
}
getJapanStocks();
結語：日本股市的數字化投資時代已經到來。無論您是在開發金融終端、量化交易機器人，還是行情監控應用，穩定可靠的數據 API 都是您的核心競爭力。立即使用 StockTV API，開啓您的日本股市開發之旅！
