韩国股票市场实时数据API接口文档（Seoul/KOSDAQ）

引言

本文档基于StockTV全球金融数据API，面向开发者提供韩国股票市场标准化数据接入方案，完整覆盖首尔证券交易所（Seoul/KOSPI）、科斯达克交易所（KOSDAQ） 的股票、指数、ETF、实时行情、历史K线、IPO日历、公司基本面等全维度数据。接口支持HTTP（RESTful） 与WebSocket双接入方式，统一返回UTF-8编码的JSON格式数据，适用于行情展示、量化系统、金融工具、投研平台等场景，可快速完成韩国股市数据集成。

1. 核心特性与优势

1.1 低延迟实时数据流

• 交易所直连：与韩国Seoul、KOSDAQ行情源直连，端到端延迟≤400ms，数据与交易所盘口同步更新；
• 高频刷新：实时价格、成交量、涨跌幅秒级推送，最小支持1分钟粒度K线更新，时间戳精准到毫秒级；
• 全时段覆盖：支持韩国股市盘中、盘后全时段数据采集，无行情断档。

1.2 高可用稳定架构

• 服务可用性：年度SLA≥99.9%，全年计划外中断≤8.76小时；
• 分布式容灾：多节点集群+故障自动切换，无单点失效风险；
• 全链路监控：接口响应、数据同步、服务负载实时监控，异常秒级告警，7×24小时技术响应；
• 数据一致性：与交易所原始数据偏差率＜0.01%，无数据失真、丢包问题。

1.3 数据全面性与覆盖范围

• 交易所全覆盖：
  • exchangeId=60：首尔证券交易所（KOSPI主板）
  • exchangeId=110：科斯达克交易所（KOSDAQ创业板）
• 核心指数：KOSPI综合指数、KOSDAQ 150等韩国核心指数实时行情；
• 数据类型：基础行情、历史K线、IPO日历、涨跌排行榜、公司基本面、技术指标、ETF全量数据；
• 标的覆盖：三星电子、SK海力士等韩国核心标的全量收录。

1.4 开发者友好

• 极简接入：全接口GET请求，仅需API Key鉴权，无复杂配置；
• 标准化响应：字段命名统一，注释清晰，降低解析成本；
• 灵活查询：支持分页、按交易所筛选、批量查询；
• 免费技术支持：全程辅助对接，覆盖开发—测试—上线全流程。

2. 接口详情

2.1 基础信息（韩国专属固定参数）

2.2 韩国股票市场列表接口

获取韩国全市场股票分页列表，支持按交易所筛选。

请求地址

GET /stock/stocks

请求参数

响应示例（精简）

{
  "code": 200,
  "message": "操作成功",
  "data": {
    "records": [
      {
        "id": 941243,
        "name": "Samsung Electronics",
        "symbol": "005930",
        "last": 72000,
        "chg": 500,
        "chgPct": 0.70,
        "volume": 12500000,
        "exchangeId": 60,
        "flag": "KR",
        "technicalDay": "strong_buy",
        "time": 1747000000
      }
    ],
    "total": 2500,
    "current": 1,
    "pages": 125
  }
}

2.3 韩国股票实时行情查询

按PID/代码/名称精准查询单只韩国股票实时行情。

请求地址

GET /stock/queryStocks

请求参数

2.4 韩国股票批量查询接口

一次查询多只韩国股票行情，提升效率。

请求地址

GET /stock/stocksByPids

请求参数

2.5 韩国指数接口（KOSPI/KOSDAQ）

获取韩国核心指数实时行情。

请求地址

GET /stock/indices

请求参数

2.6 韩国股票K线历史数据

请求地址

GET /stock/kline

请求参数

2.7 韩国股票涨跌排行榜

请求地址

GET /stock/updownList

请求参数

2.8 WebSocket实时推送接口

订阅韩国股票实时行情，替代高频轮询。

连接地址

wss://ws-api.stocktv.top/connect?key=你的密钥&countryId=11&pids=941243,953367

核心推送字段

2.9 其他韩国专属接口

3. 接入流程

3.1 获取API Key

1. 联系官方渠道申请：https://t.me/CryptoRzz；
2. Key为唯一鉴权凭证，妥善保管，禁止泄露。

3.2 环境准备

• 网络：可正常访问api.stocktv.top；
• 依赖：HTTP无额外依赖；WebSocket推荐使用websockets（Python）、原生WebSocket（JS）。

3.3 调用示例（Python）

示例1：查询首尔交易所股票列表

import requests

BASE_URL = "https://api.stocktv.top"
API_KEY = "你的API Key"

def get_korea_seoul_stocks(page=1, page_size=20):
    url = f"{BASE_URL}/stock/stocks"
    params = {
        "countryId": 11,
        "exchangeId": 60,
        "page": page,
        "pageSize": page_size,
        "key": API_KEY
    }
    try:
        res = requests.get(url, params=params, timeout=5)
        return res.json()
    except Exception as e:
        print(f"请求异常：{e}")
        return None

# 调用
if __name__ == "__main__":
    data = get_korea_seoul_stocks()
    for item in data["data"]["records"]:
        print(f"{item['symbol']} {item['name']} {item['last']}원 {item['chgPct']}%")

示例2：WebSocket订阅韩国实时行情

import asyncio
import websockets
import json

API_KEY = "你的API Key"
WS_URL = f"wss://ws-api.stocktv.top/connect?key={API_KEY}&countryId=11&pids=941243"

async def subscribe_korea_realtime():
    async with websockets.connect(WS_URL) as ws:
        print("已连接韩国股票实时推送")
        while True:
            msg = await ws.recv()
            print(json.loads(msg))

asyncio.run(subscribe_korea_realtime())

4. 服务保障与限制

4.1 服务级别协议（SLA）

• 可用性：≥99.9%；
• 故障响应：重大故障10分钟内响应，一般问题1小时内响应；
• 补偿规则：服务异常可按影响时长延长Key有效期。

4.2 请求频率限制

4.3 数据更新频率

5. 常见问题（FAQ）

Q1：韩国股票的countryId和exchangeId是多少？

A1：countryId=11；exchangeId=60（首尔交易所）、exchangeId=110（KOSDAQ）。

Q2：如何获取三星电子（005930）的PID？

A2：先调用/stock/stocks?countryId=11&symbol=005930，从返回结果中提取id即为PID。

Q3：WebSocket频繁断开怎么办？

A3：① 增加自动重连；② 每3分钟发送心跳包避免空闲断开。

Q4：返回价格单位是什么？

A4：韩国股票价格单位为韩元（KRW），多数个股为整数报价。

Q5：K线时间戳是毫秒还是秒？

A5：K线接口time为毫秒级，行情接口time为秒级。

结语

本韩国股票API以低延迟、高可用、双交易所全覆盖为核心优势，为开发者提供一站式韩国股市数据接入方案，完美适配KOSPI、KOSDAQ两大市场，支持从个人工具到企业级系统的全场景集成。

如需完整字段文档、权限升级、更高QPS扩容，可联系服务商获取官方完整版文档与专属技术支持。

需要我把这篇文档整理成CSDN直接发布格式（带目录、代码高亮、适配移动端排版），你复制粘贴即可发布吗？