한국·미국 공시 분석 API

한국 상장사와 SEC 공시 기업의 회사명·종목코드·미국 티커 검색, 시장·업종 필터, 최대 50개 종목의 일괄 자산 조회를 지원합니다. market=US로 미국 기업만 조회할 수 있습니다.

종목의 현재 시가총액, 밸류에이션, 재무·주식수 기준, 대기 중 기업행동을 반환합니다. 각 값의 기준 시점과 출처는 basis에서 확인할 수 있습니다.

공시 분석 당시 저장된 기업 자산 스냅샷을 최신순으로 반환합니다. 현재 값으로 과거를 덮어쓰지 않으므로 시점 재현과 백테스트에 사용할 수 있습니다.

분석이 완료된 공시를 최신순으로 조회합니다. delta는 실적·정기보고서·정정·계약·배당·증자 등 공시 유형별 구조화 값이며, 기존 earnings_delta도 계속 제공됩니다.

SEC EDGAR API

미국 공시만 조회하는 전용 경로입니다. ticker, cik, 반복 가능한 form, periodic_only, 방향성 및 제출 시각 필터를 지원합니다. 응답의 sec에는 accession number, CIK, 원본 form, 수정공시·정기보고서 여부가 구조화됩니다.

curl "https://app.0si.ai/api/v1/sec/filings?form=10-Q&form=10-K&periodic_only=true" \
  -H "Authorization: Bearer $OSI_API_KEY"

SEC accession number로 분석, 수집 원문과 구조화 메타데이터를 조회합니다. 예: 0000320193-26-000079.

10-Q·10-K·20-F·40-F의 SEC Companyfacts XBRL 수치를 동일 기간과 비교한 periodic_delta를 반환합니다. 매출, 영업이익, 순이익, 자산·부채·자본, 현금 및 영업현금흐름 중 확인된 항목만 제공하며, 비교 근거와 통화를 함께 표시합니다.

{
  "type": "periodic_delta",
  "label": "SEC 실적 Delta",
  "metrics": [{
    "key": "revenue",
    "current": "$12.4B",
    "prior": "$10.8B",
    "change": "+14.8%",
    "change_value": 14.8,
    "comparison_basis": "전년 동기"
  }],
  "source_note": "SEC XBRL 연결재무제표 비교"
}

분석과 수집 원문을 반환합니다. 한국 공시는 구조화 Delta, 기업 자산 스냅샷과 공시 규모를 함께 제공하고, 미국 공시는 jurisdiction: US, filing_form, sec 메타데이터 및 지원되는 XBRL Delta를 제공합니다. 법적 원문은 source_url의 KIND·OpenDART 또는 SEC EDGAR 문서입니다.

{
  "schema_version": 1,
  "type": "earnings_delta",
  "period": "2026년 2분기",
  "basis": "consolidated",
  "basis_label": "연결",
  "unit": "백만원",
  "is_correction": false,
  "metrics": [{
    "key": "operating_income",
    "label": "영업이익",
    "current": { "value": 11186, "display": "11,186 백만원" },
    "qoq": {
      "rate_pct": 44.57,
      "transition": null,
      "label": "+44.57%",
      "direction": "up",
      "prior": { "value": 7738, "display": "7,738 백만원" },
      "period": "2026년 1분기"
    },
    "yoy": {
      "rate_pct": 34.69,
      "transition": null,
      "label": "+34.69%",
      "direction": "up",
      "prior": { "value": 8305, "display": "8,305 백만원" },
      "period": "2025년 2분기"
    },
    "cumulative": null
  }],
  "source_note": "공시 원문의 잠정실적 표 기준"
}

국가별 월간 실적 표를 지원하는 공시는 period_type: month와 항목별 mom(전월 대비), yoy(전년 동월 대비), scope(국가·법인 기준)를 추가 제공합니다. 이 경우 qoq는 null이며 항목 키는 country:한국:revenue와 같이 구분합니다. 국가별 수치를 합산해 연결 실적으로 해석하면 안 됩니다. 지원되지 않거나 원문 수치가 없는 비교는 제공하지 않으며 기존 분기 응답 구조는 유지됩니다.

한국·미국 공시의 전후 30분 가격 시계열과 공시 후 등락률을 반환합니다. status는 available, pending, reference_missing, insufficient_samples, unavailable, market_closed, unsupported로 구분됩니다. unavailable은 구간 시세가 없거나 보완 조회가 실패한 상태이며, recovery_status: failed로 조회 실패를 구분할 수 있습니다. market_closed는 공시 전후 30분 전체가 미국 시세 수집 시간(뉴욕 시간 평일 04:00~20:00) 밖인 경우이며 휴장일 판정을 뜻하지 않습니다.

미국 공시의 비교 기준은 reference_basis로 명시합니다. pre_disclosure는 공시 전 실제 체결가, first_post는 공시 후 첫 체결가이며, 기준이 없으면 null입니다. 실제 비교 가격·시각은 effective_reference_price와 effective_reference_at을 사용하세요. first_post는 반드시 이후의 다른 시각에 체결 표본이 있어야 reliable: true가 되며, 단일 표본은 0% 수익률을 뜻하지 않습니다. 사용자에게는 ‘첫 체결 이후’로 표시하고 공시 직전 대비로 표현하지 마세요.

reference_stale: true는 공시 전 30분보다 오래된 실제 체결가를 비교 기준으로 사용했음을 뜻합니다. 이 경우 ‘최근 체결 대비’로 구분하세요. 차트의 전후 30분 구간은 늘어나지 않습니다. 공시 후 구간 가격은 post_disclosure_price와 post_disclosure_price_at에 별도로 제공됩니다. 목록·상세의 latest_price는 현재가일 수 있으므로 이 값으로 공시 후 등락률을 다시 계산하지 마세요. 차트 엔드포인트의 latest_price는 차트 구간의 마지막 가격입니다. 후속 표본이 30분 종료 시점과 멀면 정확히 ‘공시 30분 후’가 아닌 ‘공시 후 체결’로 표시하고 실제 표본 시각을 함께 사용하세요.

위 기준가·후속 가격·복구 상태 필드는 공시 목록 및 상세 응답의 market_reaction에도 추가 제공됩니다. 기존 필드는 유지되며, 결측 가격이나 reliable: false를 0%로 대체하지 마세요.

목록 전체가 필요하지 않을 때 해당 공시의 구조화 Delta만 조회합니다. 지원되지 않는 유형은 HTTP 200과 available: false로 구분합니다.

명시적으로 연결된 KIND·OpenDART·SEC 원문, 처리 이벤트와 현재 정정 Delta를 반환합니다. 추정으로 서로 다른 공시를 연결하지 않습니다.

현재 키의 분당 잔여 호출, 누적 요청, 활성 SSE 연결, 웹훅과 최근 24시간 전달 상태를 반환합니다.

이름·URL·이벤트·필터를 바꾸거나 enabled=false로 일시 중지합니다. 보낸 필드만 변경되며, 중지하면 대기 중인 전달은 취소됩니다.

웹훅과 전달 기록을 삭제합니다.

서명 비밀값을 새로 발급합니다. 새 whsec_... 값은 응답에서 한 번만 표시되고 이전 값은 즉시 무효화됩니다.

webhook.test 이벤트를 한 번 보내 서명 검증과 수신 서버를 점검합니다.

최근 전달 시도의 상태, 응답 코드, 지연 시간과 오류를 확인합니다.