日本股票数据接口集成文档股票数据源API

maxiaohuan0731

448

收藏 2025-12-03

本接口支持获取日本东京证券交易所（TSE）及其相关市场的实时行情、历史K线图以及主要指数数据。所有请求均基于HTTP/HTTPS协议，返回的数据格式为JSON。

基础信息

API 基础地址（Base URL）：

https://api.stocktv.top

WebSocket 连接地址：

wss://ws-api.stocktv.top/connect

认证方式：通过URL参数传递鉴权信息

key

日本市场国家ID（Country ID）：

核心接口说明

2.1 获取日本股票列表（Market List）

该接口用于获取日本市场的全部股票列表，包含公司名称、股票代码（Symbol）和系统内部唯一标识PID。其中，PID是后续调用K线或实时行情接口的关键参数。接口地址：

/stock/stocks

请求方法：

GET

关键请求参数说明：

参数名	类型	必填	示例值	说明
`key`	String	是	`您的API密钥`	鉴权 Key
`countryId`	Int	是	35	日本的国家 ID
`pageSize`	Int	否	`20`	每页返回数量
`page`	Int	否	`1`	当前页码

请求示例：

GET https://api.stocktv.top/stock/stocks?countryId=35&pageSize=20&page=1&key=YOUR_KEY

响应示例：

{
  "code": 200,
  "data": {
    "records": [
      {
        "id": 953373,          // [重要] PID，用于后续K线查询
        "name": "Toyota Motor",// 公司全称
        "symbol": "7203",      // 股票代码
        "last": 3150.0,        // 最新成交价
        "chgPct": 1.5,         // 涨跌幅百分比
        "volume": 500000       // 成交量
      }
    ]
  }
}

2.2 获取日本市场指数（Indices）

用于获取如日经225（Nikkei 225）、TOPIX等主要市场指数的实时行情数据。接口地址：

/stock/indices

请求方法：

GET

关键参数：

参数名	类型	必填	示例值	说明
`key`	String	是	`您的API密钥`	-
`countryId`	Int	是	35	代表日本市场

请求示例：

GET https://api.stocktv.top/stock/indices?countryId=35&key=YOUR_KEY

2.3 获取K线数据（Candlestick / Kline）

用于获取指定股票的历史价格数据，适用于绘制K线图表。接口地址：

/stock/kline

请求方法：

GET

关键参数：

参数名	类型	必填	示例值	说明
`key`	String	是	`您的API密钥`	鉴权Key
`pid`	Int	是	`953373`	通过2.1接口获得的股票PID
`interval`	String	是	`P1D`	K线周期，遵循ISO 8601标准

支持的周期（Interval）枚举值如下： -

PT1M

（1分钟） -

PT5M

（5分钟） -

PT1H

（1小时） -

P1D

（日K） -

P1W

（周K） -

P1M

（月K）响应示例：

{
  "code": 200,
  "data": [
    {
      "time": 1719818400000, // 时间戳（毫秒）
      "open": 3100.0,        // 开盘价
      "high": 3160.0,        // 最高价
      "low": 3090.0,         // 最低价
      "close": 3150.0,       // 收盘价
      "volume": 45000        // 成交量
    }
  ]
}

2.4 WebSocket 实时数据推送

建立长连接以接收日本股票的实时价格变动信息。连接地址：

wss://ws-api.stocktv.top/connect?key=YOUR_KEY

推送数据结构示例：

{
  "pid": "953373",        // 产品唯一ID
  "last_numeric": 3155,   // 最新成交价
  "bid": 3154,            // 当前买一价
  "ask": 3156,            // 当前卖一价
  "timestamp": "1717728251", // 数据时间戳
  "pcp": "1.25"           // 涨跌幅（%）
}

常见问题解答（FAQ）

Q1: 如何根据股票代码查找特定股票的数据（例如7203丰田）？
A: 当前接口不支持直接使用Symbol（如7203）调用K线接口。正确流程为：先调用

/stock/stocks?countryId=35

接口，在返回结果中搜索匹配

symbol="7203"

字段，获取其对应的

id

（即PID），再使用该PID发起K线数据请求。 Q2: 为什么获取到的K线数据时间戳顺序混乱？
A: 接口偶尔可能返回非严格按时间排序的数据。建议客户端在接收到数据后，依据

time

字段进行升序排列

sort((a,b) => a.time - b.time)

后再用于图表渲染。 Q3: K线接口是否支持分页？
A: 目前

/stock/kline

接口仅一次性返回指定周期内的最近历史数据，暂未提供分页功能。

接入代码示例（JavaScript 使用 Fetch）

const API_KEY = 'YOUR_API_KEY';
const JAPAN_ID = 35;


async function getJapanStockData(symbolCode) {
    // 1. 获取股票列表并查找 PID
    const listRes = await fetch(`https://api.stocktv.top/stock/stocks?countryId=${JAPAN_ID}&pageSize=100&key=${API_KEY}`);
    const listData = await listRes.json();

    // 根据输入的股票代码（如 '7203'）在返回结果中匹配目标股票
    const targetStock = listData.data.records.find(stock => stock.symbol === symbolCode);
    
    if (!targetStock) {
        console.error('未找到该股票');
        return;
    }

    console.log(`找到股票: ${targetStock.name}, PID: ${targetStock.id}`);

    // 2. 获取日K线数据
    const klineRes = await fetch(`https://api.stocktv.top/stock/kline?pid=${targetStock.id}&interval=P1D&key=${API_KEY}`);
    const klineData = await klineRes.json();

    console.log('K线数据:', klineData.data);
}

// 示例调用：获取丰田汽车 (代码 7203) 的行情数据
getJapanStockData('7203');