当前位置：首页 > news >正文

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

news 2026/7/10 15:14:59

随着巴菲特增持五大商社以及日经 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)

constaxios=require('axios');asyncfunctiongetJapanStocks(){consturl='https://api.stocktv.top/stock/stocks';try{constresponse=awaitaxios.get(url,{params:{countryId:35,// 日本key:'YOUR_API_KEY',pageSize:10}});console.log('日本股票实时列表:',response.data.data.records);}catch(error){console.error('获取失败:',error);}}getJapanStocks();