Community연구 & 데이터 분석github.com

TWSE OpenAPI (臺灣證券交易所)

대만 증권거래소(TWSE)의 공개 데이터 API 스킬입니다. 주식 시세, PER/배당수익률, TAIEX 지수, 재무제표, ESG 데이터 등 143개 엔드포인트를 API 키 없이 제공합니다.

TWSE OpenAPI (臺灣證券交易所)란 무엇인가요?

이 스킬은 TWSE(대만 증권거래소)가 공식 제공하는 오픈 데이터 API를 기반으로 합니다. 사용자는 API 키나 등록 없이 143개의 GET 엔드포인트에 접근하여 주식 시세, PER 및 배당수익률, TAIEX 지수 히스토리, 재무제표, ESG 데이터 등 방대한 금융 정보를 획득할 수 있습니다. API는 서버 측 필터링을 지원하지 않으므로, 클라이언트 측에서 전체 데이터를 받아 주식 코드로 필터링해야 합니다. 응답 필드는 엔드포인트에 따라 영어 또는 중국어(번체) 키로 제공되며, 날짜는 대부분 민국(ROC) 연도를 사용하므로 주의가 필요합니다. 이 스킬은 Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼과 호환되며, 주식 분석, 재무 조사, 시장 모니터링 작업을 자동화하는 데 유용합니다. 빠른 시작 코드 예제와 작업별 엔드포인트 치트 시트가 포함되어 있어 개발자가 쉽게 활용할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add NanookAI/twse-api

Installed? Explore more 연구 & 데이터 분석 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

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/)

중요한 규칙 (호출 전에 읽어보세요)

  1. 서버 측 필터링 없음. 각 엔드포인트는 전체 데이터셋을 반환합니다 (일반적으로 최신 거래일의 스냅샷 또는 과거 시계열). 특정 주식의 데이터를 얻으려면 전체 배열을 가져와 클라이언트 측에서 주식 코드(Code 또는 公司代號)로 필터링하세요. 응답 크기는 몇 행에서 약 30,000행(내부자 전이 테이블)까지 다양하므로, 필터링은 스크립트를 사용하고 원시 출력을 컨텍스트에 덤프하지 마세요.

  2. 두 가지 필드 명명 스타일. /exchangeReport, /indicesReport, /announcement, /block, /fund, /holidaySchedule 등의 엔드포인트는 대부분 영어 JSON 키(Code, Name, ClosingPrice…)를 사용합니다. /opendata 아래 엔드포인트(t187ap* 데이터셋)는 중국어 번체 JSON 키(公司代號, 公司名稱, 營業收入-當月營收…)를 사용합니다. 참조 파일에는 엔드포인트별 정확한 키가 나와 있습니다. 이를 그대로 사용하고 추측하거나 키 이름을 번역하지 마세요.

  3. ROC(민국 民國) 날짜. 대부분의 Date/出表日期 값은 1150706처럼 보입니다. 이는 ROC 115년 7월 6일 = 2026-07-06 (그레고리력 연도 = ROC 연도 + 1911)입니다. 일부 필드(예: 회사 설립일 成立日期)는 그레고리력 YYYYMMDD를 사용합니다. 숫자 자릿수를 확인하세요. 7자리로 시작하는 1은 ROC, 8자리로 시작하는 19/20은 그레고리력입니다.

  4. 스냅샷 데이터, 과거 조회 불가. 대부분의 엔드포인트는 최신 기간만 노출합니다. STOCK_DAY_ALL = 최신 거래일, FMSRFK_ALL = 현재 월 누계(주식당 한 행), FMNPTK_ALL = 현재 연도 누계입니다. 이 API를 통해 임의의 과거 날짜를 요청할 방법은 없습니다. 실제 시계열 데이터는 명시된 경우에만 존재합니다 (예: TAIEX 일별 기록을 위한 /indicesReport/MI_5MINS_HIST).

  5. 숫자 파싱. 숫자 문자열에는 쉼표("1,030,726,137")가 포함되거나, 비어 있거나, N/A를 나타내는 "-"/"-"일 수 있습니다. 변환 전에 쉼표를 제거하고 빈 값을 처리하세요.

  6. 데이터 범위는 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지수5TAIEX, Taiwan 50, Formosa Index 기록
references/warrants.md워런트3워런트 발행 및 거래 통계
references/brokers.md증권사 데이터9증권사 디렉토리, 인력, 월별 재무제표
references/misc.md기타4TWSE 뉴스/이벤트, 국채, 펀드

관련 스킬