日本股票 API 对接实战指南（实时行情与 IPO 专题）

随着巴菲特增持五大商社以及日经 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，你可以获取日本交易所的全部股票清单及其最新成交价。

请求示例：

http 复制代码

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（已上市）。
请求示例：

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)

javascript 复制代码

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，开启您的日本股市开发之旅！