日本股票及ETF数据接口文档

概述

StockTV 提供全面的日本股票市场数据接口，覆盖东京证券交易所（TSE）所有上市公司及日本ETF产品。支持实时行情、技术分析、ETF数据等多种功能。

交易所信息

  • 主要交易所: 东京证券交易所 (Tokyo Stock Exchange, TSE)
  • 市场分层:
    • 一部 (First Section) - 大型蓝筹股
    • 二部 (Second Section) - 中型股
    • Mothers (Market of the high-growth and emerging stocks) - 高增长新兴股
    • JASDAQ - 创业板块
  • 交易时间: 东京时间 09:00-11:30, 12:30-15:00
  • 货币: 日元 (JPY)

核心功能接口

1. 实时行情数据

获取日本股票列表

GET /stock/stocks?countryId=JP&pageSize=50&page=1&key=您的API_KEY

参数说明:

  • countryId: 日本国家ID (具体值需确认)
  • pageSize: 每页数量
  • page: 页码
  • exchangeId: 交易所ID (TSE一部、二部、Mothers、JASDAQ)

响应示例:

{
  "code": 200,
  "message": "操作成功",
  "data": {
    "records": [
      {
        "id": 72030,
        "symbol": "7203",
        "name": "Toyota Motor Corporation",
        "last": 3250,
        "chg": 25,
        "chgPct": 0.77,
        "high": 3265,
        "low": 3230,
        "volume": 12500000,
        "open": true,
        "lastPairDecimal": 0,
        "countryNameTranslated": "Japan",
        "flag": "JP",
        "exchangeId": 25,
        "time": 1716448222,
        "url": "/equities/toyota-motor-corp",
        "fundamentalMarketCap": 36500000000000,
        "fundamentalRevenue": "31.4T",
        "performanceDay": 0.77,
        "performanceWeek": 2.15,
        "performanceMonth": 5.32
      }
    ],
    "total": 3700,
    "current": 1,
    "pages": 74
  }
}

2. 主要指数数据

获取日本主要指数

GET /stock/indices?countryId=JP&key=您的API_KEY

包含的主要指数:

  • Nikkei 225 (日经225指数)
  • TOPIX (东证股价指数)
  • JPX-Nikkei Index 400
  • Mothers Index
  • JASDAQ Index

指数数据示例:

{
  "code": 200,
  "message": "操作成功",
  "data": [
    {
      "id": 18050,
      "name": "Nikkei 225",
      "symbol": "NI225",
      "last": 38520.45,
      "chg": 245.32,
      "chgPct": 0.64,
      "high": 38650.65,
      "low": 38350.43,
      "isOpen": true,
      "flag": "JP",
      "time": 1716458537
    }
  ]
}

3. ETF数据接口

获取日本ETF列表

GET /stock/stocks?countryId=JP&pairType=ETF&pageSize=100&page=1&key=您的API_KEY

热门日本ETF代码:

  • 1330: 日经225连动型上投信
  • 1348: TOPIX连动型上投信
  • 1473: 日本REIT指数连动型
  • 1678: 全世界株式指数连动型

ETF数据响应示例:

{
  "code": 200,
  "message": "操作成功",
  "data": [
    {
      "id": 95001,
      "name": "NEXT FUNDS Nikkei 225 Double Inverse Index",
      "symbol": "1357",
      "last": 19850,
      "chg": -150,
      "chgPct": -0.75,
      "marketCap": "245.81B",
      "time": "15:00:00",
      "country": "Japan",
      "pairType": "ETF"
    }
  ]
}

查询特定ETF

GET /stock/queryStocks?symbol=1330&key=您的API_KEY

4. 个股查询功能

查询特定股票

GET /stock/queryStocks?symbol=7203&key=您的API_KEY

通过PID查询股票

GET /stock/queryStocks?id=72030&key=您的API_KEY

批量查询多个股票

GET /stock/stocksByPids?key=您的API_KEY&pids=72030,83060,94320

热门日本股票代码:

  • 7203: Toyota Motor (丰田汽车)
  • 8306: Mitsubishi UFJ Financial (三菱UFJ金融)
  • 9432: NTT (日本电信电话)
  • 9984: SoftBank Group (软银集团)
  • 6861: Keyence (基恩士)
  • 6098: Recruit Holdings (瑞可利)
  • 6758: Sony Group (索尼集团)

5. K线数据（技术分析）

获取股票K线数据

GET /stock/kline?pid=72030&interval=PT1H&key=您的API_KEY

时间间隔参数:

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

K线数据格式:

{
  "time": 1719818400000,
  "open": 3235,
  "high": 3265,
  "low": 3230,
  "close": 3250,
  "volume": 12500000,
  "vo": 40625000000
}

6. 涨跌排行榜

获取日本市场排行榜

GET /stock/updownList?countryId=JP&type=1&key=您的API_KEY

排行榜类型:

  • type=1: 涨幅榜
  • type=2: 跌幅榜
  • type=3: 成交额榜
  • type=4: 成交量榜

7. 公司基本信息

获取日本上市公司信息

GET /stock/companies?countryId=JP&pageSize=20&page=1&key=您的API_KEY

公司信息示例:

{
  "code": 200,
  "message": "操作成功",
  "data": {
    "records": [
      {
        "companyName": "Toyota Motor Corporation Company Profile",
        "description": "Toyota Motor Corporation is a Japan-based company mainly engaged in the automobile business and financial business. The Company operates in three business segments. The Automobile segment is engaged in the design, manufacture and sale of sedans, minivans, sport utility vehicles, trucks and related parts...",
        "industry": "Automobiles",
        "sector": "Consumer Discretionary",
        "employeeCount": 375000,
        "market": "Japan",
        "countryId": "JP",
        "url": "/equities/toyota-motor-corp",
        "id": 301
      }
    ],
    "total": 3700,
    "current": 1,
    "pages": 185
  }
}

8. 技术指标数据

包含的技术指标:

  • technicalDay: 日线技术指标
  • technicalHour: 小时线技术指标
  • technicalWeek: 周线技术指标
  • technicalMonth: 月线技术指标

技术指标值:

  • strong_buy: 强烈买入
  • buy: 买入
  • neutral: 中性
  • sell: 卖出
  • strong_sell: 强烈卖出

9. 基本面数据

包含的基本面指标:

  • fundamentalBeta: Beta值
  • fundamentalMarketCap: 市值 (日元)
  • fundamentalRevenue: 收入
  • fundamentalRatio: 基本面比率
  • performanceDay: 当日表现
  • performanceWeek: 周表现
  • performanceMonth: 月表现
  • performanceYtd: 年初至今表现

10. WebSocket 实时数据

连接WebSocket

const wsUri = "wss://ws-api.stocktv.top/connect?key=您的API_KEY";
const websocket = new WebSocket(wsUri);

实时数据格式

{
  "pid": "72030",
  "last_numeric": "3250",
  "bid": "3248",
  "ask": "3252",
  "high": "3265",
  "low": "3230",
  "last_close": "3225",
  "pc": "25",
  "pcp": "0.77",
  "turnover_numeric": "12500000",
  "time": "15:00:25",
  "timestamp": "1717728251",
  "type": 1
}

日本市场特色

1. 交易所分层

东京证券交易所一部 (First Section)

  • 大型蓝筹股，流动性最强
  • 包含日经225指数成分股
  • 严格的上市要求

东京证券交易所二部 (Second Section)

  • 中型企业
  • 相对宽松的上市要求

Mothers市场

  • 高增长新兴企业
  • 风险较高，波动性大

JASDAQ市场

  • 创业型企业
  • 科技和成长型公司集中

2. ETF市场特点

主要ETF类型

  • 日经225连动型: 跟踪日经225指数
  • TOPIX连动型: 跟踪东证股价指数
  • 行业ETF: 特定行业指数跟踪
  • REIT ETF: 不动产投资信托ETF
  • 国际ETF: 跟踪海外市场指数

交易特点

  • 以1股为单位交易
  • 流动性较好
  • 管理费率相对较低

3. 行业分类

  • 汽车工业: 丰田、本田、日产
  • 电子科技: 索尼、松下、基恩士
  • 金融业: 三菱UFJ、三井住友、瑞穗
  • 制造业: 发那科、安川电机
  • 医药健康: 武田药品、第一三共
  • 消费品: 花王、资生堂

4. 主要板块

  • 日经225成分股: 日本最具代表性的225家公司
  • TOPIX Core30: 东证股价指数核心30成分股
  • 银行板块: 主要都市银行
  • 汽车板块: 主要汽车制造商
  • 科技板块: 电子、半导体公司

使用示例

获取日经225成分股

GET /stock/stocks?countryId=JP&pageSize=225&key=您的API_KEY

获取主要ETF列表

GET /stock/stocks?countryId=JP&pairType=ETF&pageSize=50&key=您的API_KEY

监控汽车板块

GET /stock/stocksByPids?key=您的API_KEY&pids=72030,72670,72690,72700

获取实时指数数据

GET /stock/indicesById?id=18050&key=您的API_KEY

分市场获取股票

GET /stock/stocks?countryId=JP&exchangeId=26&pageSize=100&key=您的API_KEY

ETF投资策略接口

获取ETF持仓分析

GET /stock/queryStocks?symbol=1330&key=您的API_KEY

比较多个ETF表现

GET /stock/stocksByPids?key=您的API_KEY&pids=95001,95002,95003,95004

数据更新频率

  • 实时行情: 秒级更新
  • K线数据: 按选择间隔实时更新
  • 指数数据: 实时更新
  • ETF数据: 实时更新
  • 公司信息: 每日更新
  • 基本面数据: 实时更新

错误处理

{
  "code": 400,
  "message": "参数错误",
  "data": null
}

常见错误代码:

  • 200: 操作成功
  • 400: 参数错误
  • 401: API Key无效
  • 404: 数据不存在
  • 500: 服务器内部错误

最佳实践

  1. 批量查询: 使用stocksByPids接口批量获取日经225成分股数据
  2. ETF筛选: 使用pairType=ETF参数筛选ETF产品
  3. WebSocket连接: 对于实时监控使用WebSocket连接
  4. 市场分层: 根据投资策略选择不同市场层次的股票
  5. 本地缓存: 对公司信息等静态数据实施缓存

注意事项

  1. 货币单位: 所有价格均为日元，注意数值格式化
  2. 交易时间: 注意东京时区与本地时区的转换
  3. 价格单位: 日本股票价格通常较高，注意显示格式
  4. ETF代码: 日本ETF代码为4位数字
  5. 数据精度: 价格精确到日元，成交量精确到股

日本特色股票和ETF

蓝筹股代表

  • Toyota Motor (7203) - 汽车制造
  • Sony Group (6758) - 电子娱乐
  • Mitsubishi UFJ (8306) - 金融业
  • Keyence (6861) - 工业自动化
  • SoftBank Group (9984) - 投资控股

主要ETF产品

  • 日经225连动型ETF (1330) - 最大规模的ETF
  • TOPIX连动型ETF (1348) - 覆盖范围更广
  • 日本REIT指数ETF (1473) - 不动产投资
  • 全世界株式指数ETF (1678) - 全球分散投资

高成长股票

  • Mercari (4385) - 二手交易平台
  • MonotaRO (3064) - MRO产品电商
  • Rakuten Group (4755) - 电商和金融
  • Z Holdings (4689) - 互联网服务

本文档基于 StockTV API 生成，具体接口参数以最新官方文档为准。日本国家ID和交易所ID需要向官方确认正确数值。ETF功能可能需要联系客服开通。

posted @ 2025-10-21 16:30  CryptoRzz  阅读(25)  评论(0)    收藏  举报