日韩实时股票数据API对接，包含新闻、WebSocket 推送及 IPO 新股数据

本文档帮助开发者快速对接日本和韩国股票市场的实时行情、WebSocket 推送及 IPO 新股数据。所有接口均返回 JSON 格式，支持毫秒级数据更新。

1. 快速接入

• Base URL: https://api.stocktv.top
• 认证方式: 所有请求需携带 key 参数（您的 API Key）
  • 示例: ?key=您的API_KEY
• 数据格式: JSON
• 市场标识:

提示：日本市场的 exchangeId / countryId 请向技术支持获取，或使用 /stock/stocks 接口配合搜索功能。

2. 核心功能

2.1 实时行情（HTTP）

接口：获取股票列表

支持按交易所分页查询，返回实时报价、涨跌幅、成交量等。

• 端点: /stock/stocks
• 方法: GET
• 请求参数:
  • exchangeId: 60 (韩国KOSPI) 或 110 (韩国KOSDAQ)
  • pageSize: 10 (每页数量，默认10)
  • page: 1 (页码)
  • key: 您的 API Key
• 响应示例（韩国股票）:

{
  "code": 200,
  "message": "操作成功",
  "data": {
    "records": [
      {
        "id": 41602,
        "name": "Samsung Electronics",
        "symbol": "005930",
        "last": 78400,
        "chg": 1200,
        "chgPct": 1.55,
        "high": 78800,
        "low": 77500,
        "volume": 15234000,
        "time": 1716448222,
        "open": true,
        "exchangeId": 60
      }
    ],
    "total": 2000,
    "pages": 200
  }
}

2.2 WebSocket 实时推送

通过 WebSocket 订阅单只或多只股票的 Tick 级别数据，适合行情大屏、高频监控。

• 连接地址: wss://ws-api.stocktv.top/connect?key=您的API_KEY
• 连接成功后需定期发送心跳保持连接（如每30秒发送 ping）。
• 订阅方式：连接后发送特定格式的消息（格式请参考官方示例或联系支持）。
• 推送数据示例:

{
  "pid": "41602",
  "last_numeric": "78400",
  "pc": "1200",
  "pcp": "1.55",
  "high": "78800",
  "low": "77500",
  "turnover_numeric": "15234000",
  "time": "15:30:02",
  "timestamp": "1716448222",
  "type": 1
}

2.3 IPO 新股日历

实时获取日韩市场即将上市和已上市的新股信息，包括发行价、发行市值、上市日期等。

• 端点: /stock/getIpo
• 方法: GET
• 请求参数:
  • key: 您的 API Key
  • countryId: 日本或韩国的国家 ID（日本ID需联系支持获取；韩国ID通常为 kr 对应值，请咨询支持）
  • type: 1 (未上市) 或 2 (已上市)，非必填
• 响应示例:

{
  "code": 200,
  "message": "操作成功",
  "data": [
    {
      "id": 19,
      "company": "K Bank Corp.",
      "symbol": "KBANK",
      "ipoPrice": "12500",
      "ipoValue": "2.3B",
      "ipoListing": 1724112000,
      "date": "2024-08-20",
      "exchange": "KRX",
      "pid": 1218991
    }
  ]
}

2.4 K线数据

支持多种周期（1分钟、5分钟、日线等）的历史K线查询，用于技术图表。

• 端点: /stock/kline
• 方法: GET
• 请求参数:
  • pid: 股票产品 ID（从上面接口的 id 字段获取）
  • interval: 可选 PT5M(5分) PT15M(15分) PT1H(1小时) P1D(日线) P1W(周线) P1M(月线)
  • key: 您的 API Key
• 响应示例:

{
  "code": 200,
  "message": "操作成功",
  "data": [
    {
      "time": 1719818400000,
      "open": 77000,
      "high": 78800,
      "low": 76800,
      "close": 78400,
      "volume": 15234000,
      "vo": 0
    }
  ]
}

3. 辅助接口

• 指数行情: /stock/indices – 获取日经225、韩国KOSPI等指数实时数据。
• 公司信息: /stock/companies – 查询公司简介、行业、员工数等。
• 涨跌排行榜: /stock/updownList – 获取日韩市场的涨幅榜、跌幅榜。
• 国际新闻: /stock/news – 获取与日韩市场相关的财经新闻。

4. 获取 API Key

请联系技术支持获取您的专属 API Key 以及日本和韩国的准确国家ID / 交易所ID。