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

是 否 +2 论坛币

k人 参与回答

经管之家送您一份

应届毕业生专属福利!

求职就业群

赵安豆老师微信：zhaoandou666

经管之家联合CDA

送您一个全额奖学金名额~ !

立即领取

感谢您参与论坛问题回答

经管之家送您两个论坛币！

+2 论坛币

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

基础信息

API 基础地址（Base URL）：

https://api.stocktv.top

WebSocket 连接地址：

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

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

key

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

35

核心接口说明

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');

扫码加我 拉你入群

请注明：姓名-公司-职位

以便审核进群资格，未注明则拒绝

分享0 收藏0 回帖

关键词：股票数据 数据源 API Candlestick Javascript

thanks for sharing

thanks for sharing

谢谢分享！

点赞分享

还是路过。