> For the complete documentation index, see [llms.txt](https://docs.infoway.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.infoway.io/readme/other-stock-markets/taiwan-realtime-stock-market-data-api.md).

# 台湾股票实时行情接口

Infoway API 台湾股票实时行情API提供全面的台湾股市市场数据，数据来自台湾证券交易所(TWSE)与证券柜台买卖中心(TPEX)，涵盖约2340只台湾上市及上柜股票。

## 1. 获取台湾股票清单

Infoway API 支持查询总计约2340只台湾股票，覆盖台湾证券交易所(TWSE)上市股票与证券柜台买卖中心(TPEX)上柜股票。您可以通过以下两种方式获取股票清单：

* **下载清单文件**：登录您的账户后台，在底部找到文件下载链接。
* **通过HTTP接口查询**：如需通过接口获取股票清单，请参考[GET查询产品列表](/rest-api/basic-info/get-symbol-list.md)，产品类型传 `STOCK_TW`。

{% hint style="info" %}
股票清单将定期更新，新增新上市的股票，并移除已退市的股票。为了确保获取最新的市场信息，建议您定期查看清单。
{% endhint %}

## 2. 查询方式

我们为不同需求的用户提供两种高效的查询方式：

| 查询方式        | 适用场景                                                               |
| ----------- | ------------------------------------------------------------------ |
| HTTP接口      | 适用于定期或批量查询的用户，支持灵活的查询请求。通过HTTP接口，您可以查询台湾上市公司的基础信息、历史行情、实时K线、盘口等数据。 |
| WebSocket订阅 | 适合用于获取快速更新的实时行情数据，确保您获取最低延迟的行情推送。                                  |

{% hint style="info" %}
HTTP或者WebSocket均对查询频率有限制，详细限制说明请见[此页面](/getting-started/api-limitation.md)。
{% endhint %}

## 3. 支持的数据类型

Infoway台湾实时行情接口提供以下几种数据查询服务：

### 3.1 获取台湾股票的实时K线数据

提供实时的台湾股票K线数据，包括开盘、最高、最低、收盘价格、成交量、成交额、涨跌幅、涨跌额，帮助用户捕捉市场走势。详细了解如何获取K线，请前往

* [HTTP请求K线](/rest-api/http-endpoints/get-candles.md)
* [WebSocket订阅K线](/websocket-api/subscribe-and-unsubscribe/candles-subscribe.md)。

台湾股票 (台积电 - `2330.TW`)实时K线返回示例如下：

```
{
  "s": "2330.TW",    //股票代码
  "respList": [
    {
      "t": "1789660800",    //秒时间戳（UTC+8）
      "h": "2460.00",    //最高价
      "o": "2460.00",    //开盘价
      "l": "2435.00",    //最低价
      "c": "2460.00",    //收盘价
      "v": "35250000",    //成交量
      "vw": "86533765000",    //成交额
      "pc": "1.44%",    //涨跌幅
      "pca": "35.00"    //涨跌额
    }
  ]
}
```

### 3.2 台湾股票**实时成交明细**

查询台湾股票的最新成交明细，确保获取市场的最新交易信息。详细接入方法请前往：

* [GET实时成交明细](/rest-api/http-endpoints/get-trade.md)
* [WebSocket订阅成交明细](/websocket-api/subscribe-and-unsubscribe/trade-subscribe.md)

实时成交明细返回示例如下：

```
{
  "s": "2330.TW",    //股票代码
  "t": 1789709096396,    //毫秒时间戳(UTC+8)
  "p": "2455.00",    //交易价格
  "v": "1000.00",    //成交量
  "vw": "2455000.00",    //成交额
  "td": 0    //交易方向 1：BUY 2：SELL 0：默认值
}
```

### 3.3 台湾股票一档**盘口数据**

实时提供一档买卖盘数据，帮助用户了解市场深度和流动性。详细接入步骤请前往：

* [GET查询盘口数据](/rest-api/http-endpoints/get-depth.md)
* [WebSocket订阅盘口数据](/websocket-api/subscribe-and-unsubscribe/depth-subscribe.md)

台湾股票 (台积电 - `2330.TW` )一档盘口返回示例如下：

```
{
  "s": "2330.TW",    //股票代码 
  "t": 1789799766892,    //毫秒时间戳(UTC+8)
  "a": [    //卖盘
    [
      "2460.00"    //卖一价
    ],
    [
      "898000.0"    //卖一量
    ]
  ],
  "b": [    //买盘
    [
      "2455.00"    //买一价
    ],
    [
      "494000.0"    //买一量
    ]
  ]
}
```

### 3.4 台湾**股票基础信息**

查询台湾上市公司的基础信息，包括公司名称、交易所、币种、每股盈利等。详细了解接入步骤，请前往[这个页面](/rest-api/basic-info/get-symbol-basic-info.md)。

台湾股票（台积电 - `2330.TW`）股票基础信息返回示例如下：

```
{
    "ret": 200,
    "msg": "success",
    "traceId": "1407b1f0-b271-4b39-a905-67e538ce83b9",
    "data": [
        {
            "symbol": "2330.TW",
            "market": "TW",
            "name_cn": "台積電",
            "name_en": "",
            "name_hk": "",
            "exchange": "TWSE",
            "currency": "TWD",
            "lot_size": null,
            "total_shares": null,
            "circulating_shares": null,
            "hk_shares": null,
            "eps": "86.2692",
            "eps_ttm": null,
            "bps": null,
            "dividend_yield": "0.009072206597938141",
            "stock_derivatives": null,
            "board": "Electronic Technology"
        }
    ]
}
```

{% hint style="info" %}
上柜股票的 `exchange` 返回 `TPEX`，例如环球晶（`6488.TW`）。
{% endhint %}

### 3.5 台湾**股市交易日、交易时间**

查询台湾市场的交易日和交易时间，包括开盘时间、收盘时间等，以确保用户了解每个交易日的市场活动周期。查询方法：

* [查询交易时间](/rest-api/basic-info/get-market-trading-hours.md)
* [查询交易日](/rest-api/basic-info/get-market-trading-days.md)

交易时间返回示例如下：

```
{
    "market": "TW",
    "remark": "台湾股市",
    "trade_schedules": [
        {
            "begin_time": "09:00:00",
            "end_time": "13:30:00",
            "type": "NormalTrade"
        }
    ]
}
```

交易日返回示例：

```
{
  "trade_days": [
    "20260901",
    "20260902",
    "20260903",
    "20260904",
    "20260907",
    "20260908",
    "20260909"
  ],
  "half_trade_days": []
}
```