韩国作为全球半导体与电子产业的枢纽，其股市（如三星电子、SK海力士等）一直是国际投资者关注的焦点。对于金融科技开发者而言，如何稳定地获取韩国综合股价指数（KOSPI）及高斯达克（KOSDAQ）的实时行情是构建相关应用的核心。
今天，我们将介绍如何利用 StockTV 全球金融 API，通过极简的集成方式接入韩国股票市场数据。
一、 韩国市场数据概览
在对接韩国数据时，StockTV 提供了对两大核心交易所的支持：
- 韩国交易所 (KRX/Seoul)：交易所 ID 为
60。 - KOSDAQ：交易所 ID 为
110。 - 国家代码：韩国在系统中的
countryId通常为11（注：具体以接口返回列表为准，下文将说明如何查询）。
二、 核心接口调用指南
1. 获取韩国股票列表
要开始对接，首先需要获取韩国市场的个股 PID（产品 ID）。你可以通过国家 ID 进行分页查询。
- 请求示例：
GET https://api.stocktv.top/stock/stocks?countryId=11&pageSize=10&page=1&key=YOUR_KEY - 返回数据：接口将返回包含股票名称、代码（Symbol）、最新价以及所属交易所 ID（60 或 110）的列表。
2. 获取实时行情与技术指标
通过个股的 PID，你可以获取极度丰富的实时数据，包括基本面和技术面信息。
- 接口地址：
https://api.stocktv.top/stock/queryStocks?id=股票PID&key=YOUR_KEY - 核心字段：
last: 最新成交价。chgPct: 涨跌幅百分比。technicalDay: 日线级别的技术分析建议（如strong_buy强力买入）。fundamentalMarketCap: 基本面市值数据。
3. 获取历史 K 线（图表开发）
无论是 1 分钟线还是日线，K 线接口都能提供标准化的 OHLC（开高低收）数据。
- 接口地址：
https://api.stocktv.top/stock/kline?pid=股票PID&interval=P1D&key=YOUR_KEY - 参数说明：
interval支持PT1M(1分钟)、PT1H(1小时)、P1D(1天) 等多种周期。
4. 追踪韩国大盘指数
获取 KOSPI 200 或 KOSDAQ 指数的走势，是判断韩国市场整体热度的关键。
- 接口地址：
https://api.stocktv.top/stock/indices?countryId=11&key=YOUR_KEY - 数据内容：包含指数最新价、单日最高/最低价及市场是否开盘的状态。
三、 高阶应用：涨跌榜与公司信息
- 排行榜：通过
stock/updownList接口，可以快速获取韩国市场的涨幅榜或跌幅榜，实时定位当天的热门个股。 - 公司深度资料：利用
stock/companies接口获取上市公司的详细背景、所属行业及板块分类，为用户提供更深度的投资决策辅助。
四、 开发小贴士
- Key 获取：所有接口均需
key参数，你可以通过联系官方获取。 - 数据格式：所有返回数据均为标准 JSON 格式，方便前端展示或后端逻辑处理。
- 连接方式：StockTV 不仅提供 HTTP 接口，还支持 WebSocket (WS) 接入，适合需要价格“秒动”推送的高频场景。
结语
借助 StockTV 强大的全球金融数据网，对接韩国股票市场不再需要处理繁琐的跨境合规与复杂的原始数据清洗。只需几行代码，即可让你的金融产品具备全球视野。
