随着巴菲特增持五大商社以及日经 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，你可以获取日本交易所的全部股票清单及其最新成交价。
* **核心字段**：
* `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`（已上市）。
* **请求示例**：
```http
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，开启您的日本股市开发之旅！
