Taiwan Market Open Data (Unofficial)

Search the catalog of Taiwan Stock Exchange (TWSE) OpenAPI and Taiwan Futures Exchange (TAIFEX) OAS datasets and get the dataset_id to fetch. Reads a local catalog (no upstream call). Keywords may be Chinese or English, separated by spaces; every keyword must match. 搜尋臺灣證交所與期交所 OpenAPI 有哪些資料集可用。取資料前先用這個找 dataset_id。範圍比股票廣：還有公司治理、ESG、財報、權證、券商、期貨與選擇權，以及期交所的每日外幣參考匯率——覺得「交易所大概沒有這種資料」時，先搜再下結論。會比對資料集代號、中文說明與欄位名稱；多個關鍵字用空白分隔（每個都要命中），結果依相關度排序。期交所的資料集代號一律以 taifex/ 開頭，搜期貨與選擇權可用 tag="期貨與選擇權"。

{
  "type": "object",
  "properties": {
    "query": {
      "default": "",
      "description": "關鍵字，例如 \"ETF\"、\"融資\"、\"三大法人 期貨\"。留空列出全部。",
      "type": "string"
    },
    "tag": {
      "default": "",
      "description": "依分類過濾，例如 \"證券交易\"、\"公司治理\"、\"財務報表\"。",
      "type": "string"
    },
    "limit": {
      "default": 25,
      "description": "最多回傳幾筆（預設 25）。",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

{
  "type": "object",
  "properties": {
    "total_matched": {
      "type": "number"
    },
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "dataset_id": {
            "type": "string"
          },
          "summary": {
            "type": "string"
          },
          "tags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "required": [
          "dataset_id",
          "summary",
          "tags"
        ],
        "additionalProperties": {}
      }
    }
  },
  "required": [
    "total_matched",
    "results"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": {}
}

Show one dataset's definition: id, source (TWSE or TAIFEX), summary, tags, and every field key with its Chinese description. The where, sort_by, fields and match parameters of dataset.get take these field keys. Reads the local catalog only, so it has no row counts or dates. 查看某個資料集的定義：代號、來源（證交所或期交所）、中文說明、分類標籤，以及每個欄位的鍵名與中文說明。dataset.get 的 where、sort_by、fields、match 都要用這裡的鍵名（例如 PEratio），不是中文說明。只讀本機目錄、不抓上游，所以不含資料筆數或最新日期。代號不存在時回 error，請先用 dataset.search 找。

{
  "type": "object",
  "properties": {
    "dataset_id": {
      "type": "string",
      "description": "來自 dataset.search 的資料集代號，例如 \"exchangeReport/STOCK_DAY_ALL\"。"
    }
  },
  "required": [
    "dataset_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "source": {
      "type": "string",
      "enum": [
        "twse",
        "taifex"
      ]
    },
    "summary": {
      "type": "string"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "fields": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "string"
      }
    }
  },
  "required": [
    "id",
    "source",
    "summary",
    "tags",
    "fields"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": {}
}

Fetch rows from a TWSE OpenAPI or TAIFEX OAS dataset. Find the dataset_id with dataset.search first; do not guess it, since each metric lives in its own table. Supports server-side filtering (code is an exact match; match and where), sorting, field selection and paging: 30 rows by default, 200 at most. For rankings and screens (top 10 by dividend yield, P/E below 10) use where and sort_by instead of paging through rows. Most daily tables hold the previous trading day's after-close data, not live prices; the response note states the period. Data is republished under Taiwan's Open Government Data License. 取得證交所或期交所資料集內容，支援伺服器端過濾、欄位投影與分頁。上游每個資料集都是整份回傳（可能上萬筆），這支工具預設只回前 30 筆（上限 200）；用 code/match/where/fields 縮小到需要的範圍。排名與篩選（殖利率最高的前 20 檔、本益比低於 10 的股票）用 where + sort_by，不要自己翻頁比大小。

{
  "type": "object",
  "properties": {
    "dataset_id": {
      "type": "string",
      "description": "資料集代號，例如 \"exchangeReport/STOCK_DAY_ALL\"。"
    },
    "code": {
      "default": "",
      "description": "證券／基金／契約代號，例如 \"0050\"、\"TX\"。一律精確比對（不分大小寫），實際用了哪個欄位會回在 code_field_used。找不到完全相符的代號時回 0 筆，並在 code_candidates 給出拼法相近的代號——**那些是候選不是答案**，可能是不同商品（MXF 與 MXFFX 是不同契約），請確認後改用該代號重查，不要直接引用它們的數字。",
      "type": "string"
    },
    "match": {
      "description": "其他欄位的子字串過濾，例如 {\"基金類型\": \"ETF\"}。最多 20 個欄位。",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "string"
      }
    },
    "where": {
      "description": "數值條件，全部都要成立。例如本益比低於 10、殖利率至少 5%：[{\"field\":\"PEratio\",\"op\":\"lt\",\"value\":10},{\"field\":\"DividendYield\",\"op\":\"gte\",\"value\":5}]。欄位值會去逗號轉數字；空值或非數字（例如虧損公司的本益比）無法比較，會被排除並回報筆數。",
      "maxItems": 10,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "field": {
            "type": "string",
            "description": "欄位鍵名（dataset.describe 列出的鍵名），例如 \"PEratio\"。"
          },
          "op": {
            "type": "string",
            "enum": [
              "gt",
              "gte",
              "lt",
              "lte",
              "eq",
              "ne"
            ],
            "description": "比較方式：gt 大於、gte 大於等於、lt 小於、lte 小於等於、eq 等於、ne 不等於。"
          },
          "value": {
            "type": "number",
            "description": "要比較的數值。"
          }
        },
        "required": [
          "field",
          "op",
          "value"
        ]
      }
    },
    "sort_by": {
      "default": "",
      "description": "依這個欄位排序，在分頁之前做——要「前 N 名」就用它配 limit。多數值是數字就依數值排，否則依字串排；空值與非數字一律排最後。",
      "type": "string"
    },
    "order": {
      "default": "desc",
      "description": "\"desc\"（大到小，預設）或 \"asc\"。",
      "type": "string",
      "enum": [
        "desc",
        "asc"
      ]
    },
    "fields": {
      "description": "只回傳這些欄位。",
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "limit": {
      "default": 30,
      "description": "回傳筆數上限（硬上限 200）。",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "offset": {
      "default": 0,
      "description": "分頁位移。",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "dataset_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

{
  "type": "object",
  "properties": {
    "dataset_id": {
      "type": "string"
    },
    "summary": {
      "type": "string"
    },
    "rows_in_source": {
      "type": "number"
    },
    "rows_matched": {
      "type": "number"
    },
    "returned": {
      "type": "number"
    },
    "offset": {
      "type": "number"
    },
    "note": {
      "type": "string"
    },
    "source": {
      "type": "string"
    },
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {},
        "additionalProperties": {}
      }
    }
  },
  "required": [
    "dataset_id",
    "summary",
    "rows_in_source",
    "rows_matched",
    "returned",
    "offset",
    "note",
    "source",
    "data"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": {}
}

One TWSE-listed ETF in a single call: fund profile, the previous trading day's price and volume, and regular-savings (定期定額) popularity. Source: TWSE OpenAPI, updated after each trading day; not live. A section that cannot be fetched comes back null with a caveat. 一次取得單一上市 ETF 的完整概況：基本資料 + 前一交易日價量 + 定期定額熱度。價量為前一交易日，不是盤中即時；要當下價格請用 quote.realtime。合併三個證交所資料集並行查詢。任何一段查不到都會標成 null 並記在 caveats，不會整個失敗。

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "description": "ETF 代號，例如 \"0056\"、\"0050\"、\"00878\"。"
    },
    "include_realtime": {
      "default": false,
      "description": "是否附上盤中即時報價。預設 false，需要當下價格時才帶 true（多一次外呼）。",
      "type": "boolean"
    }
  },
  "required": [
    "code"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string"
    },
    "name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "is_etf": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ]
    },
    "profile": {
      "anyOf": [
        {
          "type": "object",
          "properties": {},
          "additionalProperties": {}
        },
        {
          "type": "null"
        }
      ]
    },
    "quote": {
      "anyOf": [
        {
          "type": "object",
          "properties": {},
          "additionalProperties": {}
        },
        {
          "type": "null"
        }
      ]
    },
    "realtime": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {},
            "additionalProperties": {}
          }
        },
        {
          "type": "null"
        },
        {
          "type": "string",
          "const": "未查詢"
        }
      ]
    },
    "regular_savings": {
      "anyOf": [
        {
          "type": "object",
          "properties": {},
          "additionalProperties": {}
        },
        {
          "type": "null"
        }
      ]
    },
    "derived": {
      "anyOf": [
        {
          "type": "object",
          "properties": {},
          "additionalProperties": {}
        },
        {
          "type": "null"
        }
      ]
    },
    "caveats": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "source": {
      "type": "string"
    }
  },
  "required": [
    "code",
    "name",
    "is_etf",
    "profile",
    "quote",
    "realtime",
    "regular_savings",
    "derived",
    "caveats",
    "source"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": {}
}

Find the code of a TWSE-listed company or fund (including ETFs) from its name or code, e.g. 台積電 → 2330. Use it first when the user gives only a name. English matching covers the exchange's English short names (TSMC, UMC, MediaTek) and fund English names, not full company names; if an English name finds nothing, try its short form or the Chinese name. Listed (TWSE) securities only. Source: TWSE OpenAPI. 用名稱或代號找上市公司與上市基金（含 ETF）的代號。使用者只講名稱（「台積電」「元大高股息」）時先用這個取得代號，不要憑印象猜代號。比對公司簡稱、全名、英文簡稱與代號，不分全半形與台／臺。只收上市標的；上櫃公司的名稱對照取不到。

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "名稱或代號，例如 \"台積電\"、\"TSMC\"、\"高股息\"、\"2330\"。"
    },
    "limit": {
      "default": 10,
      "description": "最多回傳幾筆（預設 10，上限 50）。",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "required": [
    "query"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "total_matched": {
      "type": "number"
    },
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {},
        "additionalProperties": {}
      }
    },
    "caveats": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "source": {
      "type": "string"
    }
  },
  "required": [
    "query",
    "total_matched",
    "results",
    "caveats",
    "source"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": {}
}

One TWSE-listed company in a single call: profile, the previous trading day's price and volume, P/E, dividend yield, P/B, latest monthly revenue, dividends and upcoming ex-dividend dates, attention/disposition status, and market cap. Optional sections: financial statements (include_financials; year-to-date cumulative figures), corporate governance (include_governance), margin trading and securities lending (include_margin), ESG disclosures (esg_topics). To compare 2–5 companies side by side (price, P/E, dividend yield, P/B, market cap), pass codes instead of code. For recent price history (daily closes and the period change, archived by this service since 2026-09-29), pass history_days. Source: TWSE OpenAPI; daily tables are previous-trading-day, revenue monthly, financials quarterly; not live. 一次取得單一上市公司的完整概況：基本資料、前一交易日價量、本益比／殖利率／股價淨值比、最新月營收（含月增率與年增率）、近一年各期股利與近期除權除息預告、是否為注意股或處置股，以及市值。合併八個證交所資料集。價量為前一交易日，不是盤中即時；要當下價格請用 quote.realtime。要財報（損益、資產負債、毛利率等，會自動找對業別的表）帶 include_financials；要公司治理（董事長兼任總經理、董監質押、裁罰、董監持股不足）帶 include_governance。要融資融券餘額、券資比與可借券賣出股數帶 include_margin。要 ESG 帶 esg_topics（主題名稱陣列，最多 6 個）；只說「ESG」時用溫室氣體排放、能源管理、董事會、人力發展。要並排比較 2–5 家（價量、本益比、殖利率、股價淨值比、市值）時，改帶 codes 而不是 code。要最近幾個交易日的走勢（每日收盤價量與期間漲跌幅，本服務自 2026-09-29 起存檔）帶 history_days。ETF 請用 snapshot.etf。任何一段查不到都會標成 null 並記在 caveats，不會整個失敗。

{
  "type": "object",
  "properties": {
    "code": {
      "description": "上市公司股票代號，例如 \"2330\"、\"2317\"。只知道名稱時先用 quote.lookup。與 codes 擇一。",
      "type": "string"
    },
    "codes": {
      "description": "要並排比較的 2–5 檔代號，例如 [\"2330\", \"2303\", \"2454\"]。回傳 compared：每檔的價量、本益比、殖利率、股價淨值比與市值。與 code 擇一；比較模式不支援 include_financials、include_governance、include_margin、esg_topics。",
      "minItems": 2,
      "maxItems": 5,
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[0-9A-Za-z]{1,10}$"
      }
    },
    "include_financials": {
      "default": false,
      "description": "附上最新一季財報摘要：營收、毛利率、營業利益率、淨利率、每股盈餘、每股參考淨值、資產負債與負債比率（多一到兩次外呼）。預設 false。",
      "type": "boolean"
    },
    "include_governance": {
      "default": false,
      "description": "附上公司治理摘要（多五次外呼）。預設 false。",
      "type": "boolean"
    },
    "include_margin": {
      "default": false,
      "description": "附上融資融券（買賣、餘額、增減、使用率、券資比、停止或分配註記）與當日可借券賣出股數（多兩次外呼）。預設 false。",
      "type": "boolean"
    },
    "esg_topics": {
      "description": "附上這些 ESG 主題的最新年度申報資料（每個主題多一次外呼）。不帶就不查。例如資訊安全含資訊外洩事件數與受影響顧客數，職業安全衛生含職災人數，董事會含女性董事比率。約一半的主題只有特定產業須揭露；公司不在某主題的表中會標明，不代表數值為 0。氣候相關議題管理是長篇文字，只在問到氣候風險時才帶。",
      "maxItems": 6,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "溫室氣體排放",
          "能源管理",
          "水資源管理",
          "廢棄物管理",
          "人力發展",
          "董事會",
          "投資人溝通",
          "氣候相關議題管理",
          "功能性委員會",
          "燃料管理",
          "產品生命週期",
          "食品安全",
          "供應鏈管理",
          "產品品質與安全",
          "社區關係",
          "資訊安全",
          "普惠金融",
          "持股及控制力",
          "風險管理政策",
          "反競爭行為法律訴訟",
          "職業安全衛生"
        ]
      }
    },
    "history_days": {
      "description": "附上最近 N 個交易日的收盤價量與整段期間的漲跌幅（本服務自己存的日成交資訊，存檔自 2026-09-29 開始；不足 N 日會說明）。問「最近走勢」「這個月漲多少」時才帶。不支援比較模式（codes）。",
      "type": "integer",
      "minimum": 2,
      "maximum": 250
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string"
    },
    "name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "is_listed_company": {
      "anyOf": [
        {
          "type": "boolean"
        },
        {
          "type": "null"
        }
      ]
    },
    "profile": {
      "anyOf": [
        {
          "type": "object",
          "properties": {},
          "additionalProperties": {}
        },
        {
          "type": "null"
        }
      ]
    },
    "quote": {
      "anyOf": [
        {
          "type": "object",
          "properties": {},
          "additionalProperties": {}
        },
        {
          "type": "null"
        }
      ]
    },
    "valuation": {
      "anyOf": [
        {
          "type": "object",
          "properties": {},
          "additionalProperties": {}
        },
        {
          "type": "null"
        }
      ]
    },
    "monthly_revenue": {
      "anyOf": [
        {
          "type": "object",
          "properties": {},
          "additionalProperties": {}
        },
        {
          "type": "null"
        }
      ]
    },
    "upcoming_ex_rights": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {},
            "additionalProperties": {}
          }
        },
        {
          "type": "null"
        }
      ]
    },
    "dividends": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {},
            "additionalProperties": {}
          }
        },
        {
          "type": "null"
        }
      ]
    },
    "alerts": {
      "type": "object",
      "properties": {},
      "additionalProperties": {}
    },
    "derived": {
      "anyOf": [
        {
          "type": "object",
          "properties": {},
          "additionalProperties": {}
        },
        {
          "type": "null"
        }
      ]
    },
    "financials": {
      "anyOf": [
        {
          "type": "object",
          "properties": {},
          "additionalProperties": {}
        },
        {
          "type": "null"
        },
        {
          "type": "string",
          "const": "未查詢"
        }
      ]
    },
    "governance": {
      "anyOf": [
        {
          "type": "object",
          "properties": {},
          "additionalProperties": {}
        },
        {
          "type": "string",
          "const": "未查詢"
        }
      ]
    },
    "margin": {
      "anyOf": [
        {
          "type": "object",
          "properties": {},
          "additionalProperties": {}
        },
        {
          "type": "string",
          "const": "未查詢"
        }
      ]
    },
    "esg": {
      "anyOf": [
        {
          "type": "object",
          "properties": {},
          "additionalProperties": {}
        },
        {
          "type": "string",
          "const": "未查詢"
        }
      ]
    },
    "compared": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {},
        "additionalProperties": {}
      }
    },
    "history": {
      "anyOf": [
        {
          "type": "object",
          "properties": {},
          "additionalProperties": {}
        },
        {
          "type": "null"
        }
      ]
    },
    "note": {
      "type": "string"
    },
    "caveats": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "source": {
      "type": "string"
    }
  },
  "required": [
    "note",
    "caveats",
    "source"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": {}
}

Whole-market overview for the previous trading day: TAIEX and its change, turnover, advancers and decliners, top 10 by volume, plus futures positioning (institutional net open interest, TAIEX futures positions, put/call ratio, large traders). scope="events" lists ex-dividend dates and shareholder meetings in the next two weeks and attention/disposition stocks. Every scope also includes a trading calendar: whether the market is open today and the next trading day (TWSE holiday schedule). Sources: TWSE OpenAPI and TAIFEX OAS; not live. 一次看完整體市場（前一交易日）：加權指數與漲跌、成交金額、上市股票漲跌家數、成交量前十名；以及期貨籌碼：三大法人期貨未平倉淨部位、台指期各法人部位、Put/Call 比、台指期大額交易人淨部位。只要其中一邊時用 scope="stock" 或 "futures"。scope="events" 另外列出全市場的近期事件：兩週內的除權除息與股東會、今天公布的注意股、處置中與即將處置的股票（皆為上市）；每個 scope 都附交易日曆：今天有沒有開盤、下一個交易日（證交所休市日表）。只問某一檔股票的除息、注意或處置狀態時，用 snapshot.stock。不含個別契約的行情價格；要查台指期、小台、個股期貨等單一期貨契約的收盤價與部位，用 snapshot.futures。

{
  "type": "object",
  "properties": {
    "scope": {
      "default": "all",
      "description": "\"all\"（預設，證券市場加期貨籌碼）、\"stock\"、\"futures\"，或 \"events\"（近期事件行事曆）。",
      "type": "string",
      "enum": [
        "all",
        "stock",
        "futures",
        "events"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

{
  "type": "object",
  "properties": {
    "證券市場": {
      "type": "object",
      "properties": {},
      "additionalProperties": {}
    },
    "期貨籌碼": {
      "type": "object",
      "properties": {},
      "additionalProperties": {}
    },
    "事件行事曆": {
      "type": "object",
      "properties": {},
      "additionalProperties": {}
    },
    "交易日曆": {
      "type": "object",
      "properties": {},
      "additionalProperties": {}
    },
    "note": {
      "type": "string"
    },
    "caveats": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "source": {
      "type": "string"
    }
  },
  "required": [
    "note",
    "caveats",
    "source"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": {}
}

One TAIFEX futures contract for the latest trading day: open, high, low, close, change, volume, settlement and open interest for each contract month (regular and after-hours sessions), a near-month summary, institutional and large-trader positions, and final settlement prices. Accepts codes ("TX", "MTX") or Chinese names; an ambiguous name returns candidates only. Source: TAIFEX OAS; futures only; not live. 一個期貨契約（最新一個交易日）的完整概況：各月份的開高低收、漲跌、成交量、結算價、未平倉（一般與盤後時段）、近月摘要、三大法人部位（指數類期貨）、大額交易人部位與最後結算價。可用代號（"TX"、"MTX"、"TMF"、"CDF"）或名稱（"台指期"、"小台"、"台積電期貨"）；名稱對到多個契約時只回 candidates，請向使用者確認再用代號重查。只含期貨；選擇權與整體期貨籌碼請用 dataset.search 或 snapshot.market。

{
  "type": "object",
  "properties": {
    "contract": {
      "type": "string",
      "description": "期貨契約代號或名稱，例如 \"TX\"、\"小台\"、\"台積電期貨\"。"
    }
  },
  "required": [
    "contract"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "contract": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "name": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "candidates": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {},
        "additionalProperties": {}
      }
    },
    "date": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "near_month": {
      "anyOf": [
        {
          "type": "object",
          "properties": {},
          "additionalProperties": {}
        },
        {
          "type": "null"
        }
      ]
    },
    "quotes": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {},
        "additionalProperties": {}
      }
    },
    "institutional": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {},
            "additionalProperties": {}
          }
        },
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "large_traders": {
      "anyOf": [
        {
          "type": "object",
          "properties": {},
          "additionalProperties": {}
        },
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "final_settlement": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {},
            "additionalProperties": {}
          }
        },
        {
          "type": "null"
        }
      ]
    },
    "caveats": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "source": {
      "type": "string"
    }
  },
  "required": [
    "query",
    "contract",
    "name",
    "caveats",
    "source"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": {}
}

Intraday quotes, refreshed about every 5 seconds, for up to 50 TWSE-listed (market="tse") or OTC (market="otc") codes; each quote carries the trading date it belongs to. Source: the TWSE Market Information System (mis.twse.com.tw), which is not covered by the Open Government Data License. 取得盤中即時報價（約 5 秒更新一次），每筆帶 date（報價所屬交易日）。OpenAPI 只有前一交易日資料，要當下的價格得走基本市況報導站。ETF 與上市股票用 market="tse"，上櫃用 "otc"。

{
  "type": "object",
  "properties": {
    "codes": {
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[0-9A-Za-z]{1,10}$"
      },
      "description": "代號清單，例如 [\"0050\", \"0056\", \"2330\"]。"
    },
    "market": {
      "default": "tse",
      "description": "\"tse\"（上市）或 \"otc\"（上櫃）。",
      "type": "string",
      "enum": [
        "tse",
        "otc"
      ]
    }
  },
  "required": [
    "codes"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

{
  "type": "object",
  "properties": {
    "count": {
      "type": "number"
    },
    "quotes": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {},
        "additionalProperties": {}
      }
    },
    "units": {
      "type": "string"
    },
    "caveats": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "source": {
      "type": "string"
    }
  },
  "required": [
    "count",
    "quotes",
    "units",
    "caveats",
    "source"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": {}
}