모든 API

대만 공시와 재무제표용 MOPS API

대만 TWSE 및 TPEx에 상장된 약 1,980개 회사의 재무제표를 가져옵니다. 현재 API는 2026년 반기 보고서를 다룹니다.

무료 API 키 받기
문서 읽기 →
정상 운영 중97.81% uptime, last 30일295 ms 일반 응답 시간

첫 요청

반기 재무제표 가져오기

curl --request GET \
  --url "https://api.narwhalapi.com/v1/companies/twn:2330/financials?period=semiannual&fields=revenue,net_income,total_assets" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
응답 예시
{
  "id": "twn:2330",
  "currency": "TWD",
  "semiannual": [
    {
      "fy": 2026,
      "fh": 1,
      "end": "2026-06-30",
      "derived": [],
      "revenue": "2404483690000",
      "net_income": "1279041690000",
      "total_assets": "9375654727000"
    }
  ],
  "as_of": "2026-10-24"
}

엔드포인트

GET회사 목록 조회/v1/companies

이름으로 기업을 검색하고 ID를 확인합니다. 다른 모든 호출에서 이 ID를 사용합니다.

매개변수

  • q선택

    기업 이름 같은 검색어.

전체 레퍼런스 →
GET기업의 공시 목록/v1/companies/{company_id}/filings

기업의 공시를 최신순으로 제공하며, 각 공시의 공식 사본 링크가 포함됩니다.

매개변수

  • company_id필수

    usa:0000789019 같은 기업 ID 또는 usa:MSFT 같은 티커 별칭.

  • type선택

    annual 같은 공시 분류.

전체 레퍼런스 →
GET표준화된 회사 재무제표 가져오기/v1/companies/{company_id}/financials

기업의 표준화된 재무제표로, 기간별 한 행이며 공시 통화 기준입니다.

매개변수

  • company_id필수

    usa:0000789019 같은 기업 ID 또는 usa:MSFT 같은 티커 별칭.

  • period선택

    등록 기관에 따라 annual 또는 semiannual.

  • statement선택

    income, balance, cash_flow 또는 per_share.

  • fields선택

    revenue,net_income처럼 쉼표로 구분한 항목 이름.

전체 레퍼런스 →

활용 사례

수년간의 기업 데이터 불러오기

긴 이력을 페이지 단위로 가져오고 작업이 중단되면 이어서 진행합니다.

가이드 읽기 →

일정에 따라 새로 고침

작은 스크립트로 매일 새 공시와 수치를 가져옵니다.

가이드 읽기 →

한도 내에서 사용하기

응답을 캐시하고 요청 손실 없이 429 오류를 처리합니다.

가이드 읽기 →

에이전트에게 기업에 대해 질문하기

MCP를 통해 LLM 에이전트에 공시와 재무제표 읽기 권한을 제공합니다.

가이드 읽기 →

데이터 범위

  • 대만약 1,980개 기업. 2026년 반기 보고서.

출처

  • 대만TWSE 및 TPEx 상장 기업

관련 API

기업 연간 공시를 위한 ESEF API

EU 및 EEA 26개국 회사의 연차 보고서

API 탐색 →

규제 시장 기업을 위한 영국 공시 API

영국 규제 시장 발행사의 연차 보고서

API 탐색 →

EDINET API 지원 시작

일본 공시와 재무제표, 실시간 제공

API 탐색 →

DART API 지원 시작

한국 공시와 재무제표, 실시간 제공

API 탐색 →

공시 목록과 개별 기록을 위한 기업 공시 API

기업 전반의 공시 목록, 개별 레코드, 최신 공시

API 탐색 →

자주 묻는 질문

대만 회사 ID는 어떻게 구성되나요?

대만 회사 ID는 twn:과 종목 코드를 결합한 형태입니다(예: twn:2330).

재무상태표는 어떤 날짜를 기준으로 하나요?

재무상태표는 각 보고 기준일 시점으로 제공됩니다.

대만의 5% 이상 보유자도 포함되나요?

아니요. 대만은 5% 이상 보유자를 포함하지 않습니다.

TWSE OpenAPI 및 TPEx 오픈 데이터

data.gov.tw의 Taiwan Open Government Data Licence v1.0에 따라 Taiwan Stock Exchange(TWSE) OpenAPI와 Taipei Exchange(TPEx) 오픈 데이터를 사용합니다. 이 소스들은 MOPS 공시를 반영합니다.

반기 수치

손익 및 주당 수치는 반기 누적 기준입니다(period=semiannual). 연간 수치는 연차 보고서가 나오면 제공됩니다.

대만 달러 정수 단위

금액은 소스의 천 단위 값을 올려 환산한 대만 달러 정수 단위입니다. EPS 같은 주당 수치는 소수이며 단위 조정되지 않습니다.