TWSE OpenAPI (대만 증권거래소 臺灣證券交易所)
대만 증권거래소의 공식 공개 데이터 API입니다. 무료이며 API 키나 등록이 필요 없습니다.
- 기본 URL:
https://openapi.twse.com.tw/v1 - 방식: 모든 엔드포인트는 단순
GET이며, 매개변수가 전혀 없습니다 (쿼리 문자열이나 경로 매개변수 없음) - 응답: 항상 평면 객체의 JSON 배열이며, 모든 값은 문자열입니다 (숫자 포함)
- 전체 엔드포인트 카탈로그: 7개 카테고리에 걸쳐 143개 엔드포인트 (아래 엔드포인트 카탈로그 참조)
- Swagger 명세:
https://openapi.twse.com.tw/v1/swagger.json(UI 문서: https://openapi.twse.com.tw/)
중요한 규칙 (호출 전에 읽어보세요)
-
서버 측 필터링 없음. 각 엔드포인트는 전체 데이터셋을 반환합니다 (일반적으로 최신 거래일의 스냅샷 또는 과거 시계열). 특정 주식의 데이터를 얻으려면 전체 배열을 가져와 클라이언트 측에서 주식 코드(
Code또는公司代號)로 필터링하세요. 응답 크기는 몇 행에서 약 30,000행(내부자 전이 테이블)까지 다양하므로, 필터링은 스크립트를 사용하고 원시 출력을 컨텍스트에 덤프하지 마세요. -
두 가지 필드 명명 스타일.
/exchangeReport,/indicesReport,/announcement,/block,/fund,/holidaySchedule등의 엔드포인트는 대부분 영어 JSON 키(Code,Name,ClosingPrice…)를 사용합니다./opendata아래 엔드포인트(t187ap*데이터셋)는 중국어 번체 JSON 키(公司代號,公司名稱,營業收入-當月營收…)를 사용합니다. 참조 파일에는 엔드포인트별 정확한 키가 나와 있습니다. 이를 그대로 사용하고 추측하거나 키 이름을 번역하지 마세요. -
ROC(민국 民國) 날짜. 대부분의
Date/出表日期값은1150706처럼 보입니다. 이는 ROC 115년 7월 6일 = 2026-07-06 (그레고리력 연도 = ROC 연도 + 1911)입니다. 일부 필드(예: 회사 설립일成立日期)는 그레고리력YYYYMMDD를 사용합니다. 숫자 자릿수를 확인하세요. 7자리로 시작하는1은 ROC, 8자리로 시작하는19/20은 그레고리력입니다. -
스냅샷 데이터, 과거 조회 불가. 대부분의 엔드포인트는 최신 기간만 노출합니다.
STOCK_DAY_ALL= 최신 거래일,FMSRFK_ALL= 현재 월 누계(주식당 한 행),FMNPTK_ALL= 현재 연도 누계입니다. 이 API를 통해 임의의 과거 날짜를 요청할 방법은 없습니다. 실제 시계열 데이터는 명시된 경우에만 존재합니다 (예: TAIEX 일별 기록을 위한/indicesReport/MI_5MINS_HIST). -
숫자 파싱. 숫자 문자열에는 쉼표(
"1,030,726,137")가 포함되거나, 비어 있거나, N/A를 나타내는"-"/"-"일 수 있습니다. 변환 전에 쉼표를 제거하고 빈 값을 처리하세요. -
데이터 범위는 TWSE 상장(上市) 증권입니다. OTC/TPEx(上櫃) 증권은 다른 API(
https://www.tpex.org.tw/openapi/)에서 제공되며, 이 API가 아닙니다._L접미사 엔드포인트 = 상장 회사(上市),_P/_X= 공개 비상장 회사(公開發行).
빠른 시작
# 모든 상장 주식의 일일 OHLC, TSMC(2330) 필터링
curl -s https://openapi.twse.com.tw/v1/exchangeReport/STOCK_DAY_ALL |
python3 -c "import json,sys; print([r for r in json.load(sys.stdin) if r['Code']=='2330'])"
import json, urllib.request
BASE = "https://openapi.twse.com.tw/v1"
def twse(path):
with urllib.request.urlopen(BASE + path) as r:
return json.load(r)
# 한 주식의 PER, 배당수익률, P/B
row = next(r for r in twse("/exchangeReport/BWIBBU_ALL") if r["Code"] == "2330")
# {'Code': '2330', 'Name': '台積電', 'PEratio': '...', 'DividendYield': '...', 'PBratio': '...'}
# 회사 프로필 (중국어 키!)
tsmc = next(r for r in twse("/opendata/t187ap03_L") if r["公司代號"] == "2330")
작업 → 엔드포인트 치트 시트
| 작업 | 엔드포인트 |
|---|---|
| 오늘의 OHLC/거래량, 전체 주식 | /exchangeReport/STOCK_DAY_ALL |
| PER, 배당수익률, P/B | /exchangeReport/BWIBBU_ALL |
| 종가 + 월평균 | /exchangeReport/STOCK_DAY_AVG_ALL |
| 주식별 현재 월 / 현재 연도 누계 | /exchangeReport/FMSRFK_ALL / FMNPTK_ALL |
| TAIEX 지수 기록 (일별 OHLC) | /indicesReport/MI_5MINS_HIST |
| 시장 전체 일일 거래량/금액 | /exchangeReport/FMTQIK |
| 회사 기본 프로필 | /opendata/t187ap03_L |
| 모든 회사의 월별 수익 | /opendata/t187ap05_L |
| 손익계산서 (일반 산업) | /opendata/t187ap06_L_ci |
| 대차대조표 (일반 산업) | /opendata/t187ap07_L_ci |
| 배당 분배 | /opendata/t187ap45_L |
| 중요 뉴스 / 공시 | /opendata/t187ap04_L |
| 배당락일 캘린더 | /exchangeReport/TWT48U_ALL |
| 신용거래 잔고 | /exchangeReport/MI_MARGN |
| 휴장일 / 시장 캘린더 | /holidaySchedule/holidaySchedule |
| TWSE 뉴스 | /news/newsList |
엔드포인트 카탈로그
필요한 카테고리의 참조 파일을 읽으세요. 각 파일은 정확한 응답 키(중국어 원본이 주석으로 유지됨)와 함께 모든 엔드포인트를 나열합니다.
| 참조 파일 | 카테고리 (原分類) | 엔드포인트 수 | 내용 |
|---|---|---|---|
| references/securities-trading.md | 증권 거래 | 36 | 일일 시세, 평가 비율, 시장 통계, 신용/블록/데이트레이딩, 주의 및 관리종목, 시장 캘린더 |
| references/corporate-governance.md | 기업 지배구조 | 56 | 회사 프로필, 내부자/임원 보유, 이사회 데이터, 중요 뉴스, 배당, 주주총회, 21개 ESG 데이터셋 |
| references/financial-statements.md | 재무제표 | 30 | 월별 수익, 업종별 손익계산서 및 대차대조표, 수익성 요약 |
| references/indices.md | 지수 | 5 | TAIEX, Taiwan 50, Formosa Index 기록 |
| references/warrants.md | 워런트 | 3 | 워런트 발행 및 거래 통계 |
| references/brokers.md | 증권사 데이터 | 9 | 증권사 디렉토리, 인력, 월별 재무제표 |
| references/misc.md | 기타 | 4 | TWSE 뉴스/이벤트, 국채, 펀드 |