0si.ai Developers Console
0si.ai Pro Developer Platform

0si.ai Disclosure API

한국 주식 공시의 원문 근거, AI 방향성, 핵심 수치와 공시 후 시장반응을 시스템에 직접 연결합니다.

API 키 발급 OpenAPI JSON
Access
Pro included
Protocol
REST + SSE
Version
v1 stable
GET/api/v1/disclosures200 OK
curl https://app.0si.ai/api/v1/disclosures \
  -H "Authorization: Bearer $OSI_API_KEY"

{
  "object": "list",
  "data": [
    {
      "company_name": "삼성전자",
      "title": "단일판매ㆍ공급계약체결",
      "analysis": {
        "signal": "positive",
        "confidence": "high"
      }
    }
  ]
}
01

Overview

Disclosure API는 공시.ai의 분석 결과를 자동화 시스템, 사내 대시보드, 알림 봇과 리서치 워크플로에 연결하기 위한 Pro 기능입니다. 모든 시각은 ISO 8601 UTC로 반환하며, 숫자 필드는 문자열이 아닌 JSON number 또는 null을 사용합니다.

분석 결과방향성, 확신, 요약, 핵심 포인트, 위험 문구, 정정 여부
시장반응공시 기준가, 최신가, 공시 후 등락률과 전후 30분 시계열
실시간 전달새 분석과 갱신 이벤트를 SSE 연결로 순서대로 수신
02

Quickstart

  1. Pro 계정으로 아래 콘솔에서 API 키를 생성합니다.키 원문은 생성 직후 한 번만 표시됩니다.
  2. 키를 서버의 비밀 저장소에 보관합니다.브라우저 코드, 모바일 앱 번들, Git 저장소에는 넣지 마세요.
  3. Status 호출로 연결을 검증합니다.성공하면 HTTP 200과 현재 scope가 반환됩니다.
Shell
export OSI_API_KEY="osi_live_..."

curl https://app.0si.ai/api/v1/status \
  -H "Authorization: Bearer $OSI_API_KEY"
03

Authentication

모든 v1 요청은 HTTPS와 Bearer 인증을 사용합니다. API 키는 Pro 계정에 귀속되며 구독이 비활성화되거나 키를 폐기하면 즉시 사용할 수 없습니다.

Secret handling

키는 서버에서 HMAC 해시로만 저장됩니다. 유출이 의심되면 기존 키를 폐기하고 새 키를 발급하세요.

HTTP header
Authorization: Bearer osi_live_your_secret_key
04

REST Reference

GET/api/v1/disclosures

분석이 완료된 공시를 최신순으로 조회합니다. `after`를 사용하면 해당 sequence 이후 공시가 오름차순으로 반환됩니다.

cursorinteger이 sequence보다 오래된 항목
afterinteger이 sequence보다 새로운 항목
limit1..100기본 50
stock_codestring종목코드 정확히 일치
marketKOSPI | KOSDAQ | KONEX시장 구분
sectorstring업종명 부분 일치
sentimentenum5단계 방향성 필터
sourceKIND | OpenDART공시 출처 필터
qstring회사명, 종목코드, 제목 검색
GET/api/v1/disclosures/{disclosure_id}

단일 공시의 안정적인 분석 스키마와 수집된 원문 텍스트를 반환합니다. 원문의 법적 효력은 `source_url`에 연결된 KIND 또는 OpenDART 문서에 있습니다.

GET/api/v1/disclosures/{disclosure_id}/market-reaction

공시 시점을 중앙으로 하는 전후 30분 가격 시계열과 공시 후 등락률을 반환합니다. 휴장, 거래정지, 데이터 제공 제한 시 일부 값은 null일 수 있습니다.

05

Realtime SSE

폴링 대신 하나의 장기 연결에서 새 공시 분석을 받습니다. 마지막 `id`를 `Last-Event-ID` 헤더 또는 `cursor`로 다시 보내면 연결 중 놓친 항목을 순서대로 복구합니다.

Server-Sent Events
curl -N https://app.0si.ai/api/v1/stream \
  -H "Authorization: Bearer $OSI_API_KEY" \
  -H "Accept: text/event-stream"

event: disclosure.created
id: 16395578
data: {"id":"kind:20260722000912", ...}
stream.ready연결과 시작 cursor 확인
disclosure.created새 분석 완료 공시
disclosure.updated분석 또는 시장 기준값 갱신
heartbeat15초 주기 연결 생존 확인
06

Limits & Errors

Pro 키당 기본 한도는 분당 120회이며 실시간 스트림은 동시에 2개까지 연결할 수 있습니다. REST 응답에는 현재 한도를 확인할 수 있는 헤더가 포함됩니다.

X-RateLimit-Limit분당 허용 요청 수 X-RateLimit-Remaining현재 구간의 남은 요청 수 X-RateLimit-Reset다음 구간의 Unix timestamp X-Request-Id지원 문의와 추적에 사용하는 요청 ID
401invalid_api_key키가 없거나 유효하지 않음
403pro_plan_required활성 Pro 구독이 필요함
404not_found대상 공시를 찾을 수 없음
429rate_limit_exceeded호출 또는 스트림 한도 초과
07

API Key Console

현재 0si.ai 계정의 키를 발급하고 사용량을 확인합니다. 키 원문은 생성할 때만 표시됩니다.

계정과 API 권한을 확인하고 있습니다.