获取日本股票实时数据API接口文档

原创于 2025-12-29 09:30:33 发布 · 483 阅读

10 ·

CC 4.0 BY-SA版权

文章标签：

#数据库 #java #金融 #web3

接口概览

StockTV API提供日本股票市场的实时行情数据，包括股票基本信息、实时价格、K线数据、指数信息等。

基础信息

基础URL: https://api.stocktv.top
认证方式: API Key参数认证
数据格式: JSON
日本国家ID: 44

接口列表

1. 获取日本股票市场列表

接口地址: /stock/stocks

请求方法: GET

请求参数:

参数名	类型	必填	说明
countryId	int	是	国家ID，日本为44
pageSize	int	否	每页数量，默认10
page	int	否	页码，默认1
key	string	是	API密钥

请求示例:

curl -X GET "https://api.stocktv.top/stock/stocks?countryId=44&pageSize=10&page=1&key=YOUR_API_KEY"

响应示例:

{
  "code": 200,
  "message": "操作成功",
  "data": {
    "records": [
      {
        "id": 7310,
        "symbol": "7203",
        "name": "Toyota Motor Corporation",
        "last": 2456.5,
        "chg": 12.5,
        "chgPct": 0.51,
        "high": 2468.0,
        "low": 2432.0,
        "volume": 3250000,
        "open": false,
        "time": 1716448222,
        "countryId": 44,
        "lastClose": 2444.0
      }
    ],
    "total": 500,
    "size": 10,
    "current": 1,
    "pages": 50
  }
}

2. 查询单个日本股票

接口地址: /stock/queryStocks

请求方法: GET

请求参数:

参数名	类型	必填	说明
id	int	否	股票PID
symbol	string	否	股票代码
name	string	否	股票名称
key	string	是	API密钥

请求示例:

# 通过股票代码查询
curl -X GET "https://api.stocktv.top/stock/queryStocks?symbol=7203&key=YOUR_API_KEY"

# 通过PID查询
curl -X GET "https://api.stocktv.top/stock/queryStocks?id=7310&key=YOUR_API_KEY"

响应示例:

{
  "code": 200,
  "message": "操作成功",
  "data": [
    {
      "id": 7310,
      "symbol": "7203",
      "name": "Toyota Motor Corporation",
      "last": 2456.5,
      "chg": 12.5,
      "chgPct": 0.51,
      "high": 2468.0,
      "low": 2432.0,
      "volume": 3250000,
      "avgVolume": 2800000,
      "fundamentalMarketCap": 32500000000000,
      "fundamentalRevenue": "31.4T",
      "technicalDay": "neutral",
      "open": false,
      "time": 1716448222,
      "lastClose": 2444.0
    }
  ]
}

3. 批量查询日本股票

接口地址: /stock/stocksByPids

请求方法: GET

请求参数:

参数名	类型	必填	说明
pids	string	是	股票PID列表，逗号分隔
key	string	是	API密钥

请求示例:

curl -X GET "https://api.stocktv.top/stock/stocksByPids?pids=7310,17976,41602&key=YOUR_API_KEY"

响应示例:

{
  "code": 200,
  "message": "操作成功",
  "data": [
    {
      "id": 7310,
      "symbol": "7203",
      "name": "Toyota Motor Corporation",
      "last": 2456.5,
      "chg": 12.5,
      "chgPct": 0.51
    },
    {
      "id": 17976,
      "symbol": "8306",
      "name": "Mitsubishi UFJ Financial Group",
      "last": 956.3,
      "chg": -5.2,
      "chgPct": -0.54
    }
  ]
}

4. 获取日本指数信息

接口地址: /stock/indices

请求方法: GET

请求参数:

参数名	类型	必填	说明
countryId	int	是	国家ID，日本为44
key	string	是	API密钥

请求示例:

curl -X GET "https://api.stocktv.top/stock/indices?countryId=44&key=YOUR_API_KEY"

响应示例:

{
  "code": 200,
  "message": "操作成功",
  "data": [
    {
      "id": 17950,
      "name": "Nikkei 225",
      "symbol": "NI225",
      "last": 38567.25,
      "chg": 256.8,
      "chgPct": 0.67,
      "high": 38620.5,
      "low": 38345.8,
      "isOpen": false,
      "time": 1716458537
    },
    {
      "id": 17951,
      "name": "TOPIX",
      "symbol": "TPX",
      "last": 2745.62,
      "chg": 18.35,
      "chgPct": 0.67,
      "isOpen": false,
      "time": 1716458537
    }
  ]
}

5. 获取K线数据

接口地址: /stock/kline

请求方法: GET

请求参数:

参数名	类型	必填	说明
pid	int	是	股票PID
interval	string	是	时间间隔
key	string	是	API密钥

时间间隔参数:

PT5M- 5分钟
PT15M- 15分钟
PT1H- 1小时
P1D- 日线
P1W- 周线
P1M- 月线

请求示例:

curl -X GET "https://api.stocktv.top/stock/kline?pid=7310&interval=P1D&key=YOUR_API_KEY"

响应示例:

{
  "code": 200,
  "message": "操作成功",
  "data": [
    {
      "time": 1719818400000,
      "open": 2430.0,
      "high": 2468.0,
      "low": 2425.5,
      "close": 2456.5,
      "volume": 3250000,
      "vo": 7982000000
    },
    {
      "time": 1719732000000,
      "open": 2415.0,
      "high": 2440.0,
      "low": 2408.5,
      "close": 2444.0,
      "volume": 2980000,
      "vo": 7250000000
    }
  ]
}

数据字段说明

股票基础信息字段

id: 股票唯一标识(PID)
symbol: 股票代码
name: 股票名称
last: 最新价格
chg: 涨跌额
chgPct: 涨跌幅(%)
high: 最高价
low: 最低价
volume: 成交量
open: 是否开市(true/false)
time: 数据时间戳

基本面数据字段

avgVolume: 平均成交量
fundamentalMarketCap: 市值
fundamentalRevenue: 营收
fundamentalBeta: Beta值

技术指标字段

technicalDay: 日线技术信号
technicalHour: 小时线技术信号

日本主要股票代码参考

股票代码	公司名称	行业
7203	丰田汽车	汽车
8306	三菱UFJ金融集团	金融
9432	日本电信电话	通信
9984	软银集团	投资
9433	KDDI	通信
6861	键讯电子	电子
6758	索尼集团	电子
7974	任天堂	游戏