로그인

Guides / Changelog

변경 이력

엔드포인트·필드·한도·주소가 바뀌면 여기에 최신순으로 적습니다.

    • 변경PoC 기본 기간을 7일로 바꿨습니다(이전 14일). 기간은 협의로 조정할 수 있습니다. 이미 시작한 PoC의 종료일은 바뀌지 않습니다. 호출 한도와 쿼터
    • 문서MCP 안내를 바로잡았습니다. Data API 키(ck_live_)로도 MCP 서버에 연결할 수 있고, 그때는 Data API 도구가 열립니다. PRO 도구는 PRO API 키나 OAuth로 연결할 때만 나옵니다. MCP 연결
    • 문서레퍼런스를 Data API 1.16.0 명세로 맞췄습니다. 아래 10월 26~28일 변경이 사이드바와 /openapi.json·/openapi.en.json에 들어갔습니다.

    • 추가Data API 1.13.0. 미국 전용 GET /us-earnings(종목·접수일로 목록, cursor)와 GET /us-earnings/{id}. 8-K 항목 2.02 실적 발표에서 검증한 수치(매출·영업이익·순이익·GAAP·조정 EPS·조정 EBITDA·현금흐름 등)를 기본 단위로 주고, 전년 값과 증감률, 수치마다 근거(표 칸·원문 인용), 마진, 회사 KPI와 전망, 시각(SEC 접수·발표 확인·추출), 코드로 만든 한두 줄 속보 문장을 담습니다. 상세 엔드포인트는 발표 직전 시장 예상치 대비(surprise)도 줍니다.
    • 추가Data API 1.14.0. 실적 수치에 reaction을 더했습니다. 발표 전 마지막 정규장 종가에서 발표 후 첫 정규장 종가까지의 변화율(change_pct), 발표 세션, 상태(measured·pending·unavailable)를 줍니다.
    • 추가Data API 1.15.0. GET /us-earnings/{id}에 guidance_comparison을 더했습니다. 발표의 전망 문장마다 같은 기간에 대한 회사의 직전 전망 대비 변화와, 발표일 전에 관측한 같은 기간·지표의 시장 예상치 대비 위치를 줍니다.
    • 추가Data API 1.16.0. 실적 수치에 사업 부문별 매출·부문 이익(segments)을 더했습니다. 부문 합계가 매출과 맞을 때만 담고, 비교한 합계는 segment_check에 있습니다.
    • 추가웹훅 이벤트 us_earnings.figures(수치를 처음 확인했을 때, 새 판독으로 값이 바뀌면 다시)와 us_filing.analysis_revoked(알린 분석을 내렸을 때). 정정한 분석을 다시 공개하면 us_filing.analysis_published가 새 판(publication.revision·replaces)으로 한 번 더 옵니다. 이벤트를 지정하지 않은 새 구독은 네 이벤트를 모두 받고, 기존 구독의 이벤트 목록은 그대로입니다.
    • 추가국내 /companies/{symbol}/financials의 meta.preliminary_releases. preliminary=true 줄의 근거인 잠정 실적 공시마다 신고한 원화 값, 증감률, 흑자·적자 전환 표기, 발표 직전 컨센서스 비교를 줍니다. 줄의 칸은 바뀌지 않습니다.

    • 추가Data API 1.11.0. 미국 전용 GET /us-filings. 미국 상장사 전체의 SEC 공시(8-K·6-K·10-Q·10-K·20-F·40-F와 정정)를 최신순(접수일 → SEC 접수 시각 → id)으로 cursor와 함께 줍니다. 항목마다 cik, 8-K 항목 코드와 한국어·영어 이름, accepted_at, detected_at, analysis(상태·헤드라인·공개 시각·지연)가 있습니다. 필터는 since·until(접수 시각), from·to(접수일), form, items, symbol, analysis=published입니다. 분석 본문은 PRO API에서 제공합니다.
    • 추가Data API 1.12.0. 웹훅 POST·GET /webhooks, PATCH·DELETE /webhooks/{id}, POST /webhooks/{id}/test, GET /webhooks/{id}/deliveries. 계정당 최대 5개이고, 유료 등급과 미국 시장을 계약한 PoC에서 씁니다. us_filing.detected·us_filing.analysis_published 이벤트는 GET /us-filings 항목과 같은 모양이며 종목·서식·8-K 항목 코드로 거를 수 있습니다. Standard Webhooks 방식으로 서명하고(whsec_ 비밀값은 등록할 때 한 번만 보입니다), 실패하면 1분·5분·30분·2시간·6시간 뒤 다시 보냅니다. 100번 연달아 실패하면 웹훅이 꺼집니다.
    • 추가Data API 1.10.0. 미국 전용 GET /companies/{symbol}/earnings-surprises(분기 EPS 예상·실제·서프라이즈 이력, 다음 발표, EPS·매출 추정치 추이와 수정)와 GET /companies/{symbol}/analyst-ratings(투자의견·목표가 변경, 월별 의견 분포, 목표가 요약). 국내 종목은 400 UNSUPPORTED_MARKET입니다. MCP 도구 get_us_earnings_surprises·get_us_analyst_ratings가 대응합니다.

    • 변경Data API 등급 Launch · Business · Scale을 더했습니다. 모든 등급이 모든 엔드포인트를 쓰고, 등급별 분당·하루·AI 호출 한도를 적용합니다. Enterprise 한도는 그대로입니다. 등급은 새 칸 plan_tier와 헤더 X-Plan-Tier로 확인합니다. 호출 한도와 쿼터
    • 변경PoC는 목표 등급(Launch · Business · Scale)의 체험 한도로 씁니다. 목표 등급을 정하지 않으면 Launch입니다. Enterprise 한도의 절반을 쓰던 규칙은 없앴습니다. 기존 PoC의 plan: poc·X-Plan: PoC 값은 그대로입니다.
    • 추가계약에 따라 AI 호출 월 한도를 둘 수 있습니다. 넘으면 429 AI_MONTHLY_QUOTA_EXCEEDED이고, ai_quota.monthly와 X-AI-Quota-Monthly-* 헤더로 확인합니다.

    • 변경Data API 1.4.0(백엔드 배포 후 적용). /companies/{symbol}/financials가 원장 전체를 돌려주고 회계연도·분기 최신순 → 계정 순으로 정렬합니다. 회사 IR 자료로 채운 기간도 같은 순서로 섞입니다. limit(기본 100·최대 200)과 cursor로 나눠 받고 next_cursor·has_more가 붙습니다. 예전에는 상한(약 100줄)에서 잘려 일부 계정이 빠질 수 있었습니다.
    • 추가재무제표 줄에 기계용 칸: account_code(영문 계정 코드) · fiscal_quarter · period_code(FY2025·2026Q3) · period_end · fs_code · unit_code · report_code. account에 영문 코드(revenue·operating_income …)와 fs 필터를 받습니다. 표는 데이터 규약.
    • 추가오류 코드 400 BAD_PERIOD(기간 형식 오류) · 404 SYMBOL_NOT_FOUND(모르는 종목) · 404 NOT_APPLICABLE(ETF·ETN처럼 회사 데이터가 해당 없는 상품). 예전에는 틀린 기간이 200으로 엉뚱한 줄을 돌려줄 수 있었습니다.
    • 변경가이던스의 unit·unit_scale가 값의 단위를 말합니다(KRW·USD, 배율 1). 예전 뜻(표 단위 억원·백만달러)은 display_unit·display_scale로 옮겼습니다. 이 칸을 읽던 코드는 고쳐 주세요.
    • 추가컨센서스 unit=raw|eok|million(기본 raw 그대로)·값마다 unit·unit_scale·comparison_status. 미국은 매출만 주며 meta.metrics도 그 시장에서 주는 지표만 적습니다.
    • 추가미국 공시 form·exclude_forms 필터와 공시 줄의 report_code. 뉴스에 미국 기사(market=US, 이미 모아 둔 것)와 lang·title_ko. market을 생략하면 국내·미국 기사가 함께 옵니다(계약한 시장의 기사만). 종목 필터는 태그가 검증된 기사만 돌려줘 예전보다 결과가 줄 수 있습니다.
    • 변경GET /quotes/{symbol}가 표준 모양 data·meta를 함께 줍니다. data.valuation은 지표 엔드포인트와 같은 계산입니다. 예전 최상위 칸은 그대로 둡니다(deprecated).
    • 추가영어판 명세 /openapi.en.json(백엔드 openapi.json?lang=en). 영어·일본어 레퍼런스가 이 판을 씁니다.
    • 문서빠른 시작에 회사 데이터 예시·응답 모양, MCP는 PRO API 전용이라는 안내, curl -G --data-urlencode 예시를 더했습니다. 문서 사이드바·푸터·<head>에 llms.txt·llms-full.txt 링크를 달았습니다.
    • 변경계정은 신청을 받아 발급합니다(이용 신청). 받은 계정 ID와 비밀번호로 개발자 콘솔에 로그인해 키를 직접 만들고, 교체하고, 폐기합니다. 셀프 가입과 무료 체험 키 신규 발급은 끝났습니다. 이미 받은 키는 그대로 씁니다.
    • 추가PoC 플랜(14일). Enterprise 엔드포인트를 Enterprise 한도의 절반으로 쓰고, AI 호출은 하루 200회까지입니다. 기간이 끝나면 403 POC_ENDED로 멈춥니다.
    • 추가콘솔의 키 교체: 같은 이름·범위로 새 키를 만들고 이전 키를 바로 폐기합니다.
    • 문서개발자 포털을 한국어 · 영어 · 일본어로 제공합니다.
    • 추가새 베이스 URL https://api.chickstockfi.com/openapi/v1(Data API)와 https://api.chickstockfi.com/openapi/pro/v1(PRO API). 기존 www.chickstockfi.com 주소도 그대로 씁니다.
    • 추가API 레퍼런스에 PRO API 명세를 더했습니다. 명세 JSON: /openapi-pro.json
    • 추가개발자 콘솔에서 PRO API 키(ck_pers_)를 발급합니다. PRO 플랜이 적용된 계정만 만들 수 있습니다.
    • 제거GET /trending을 문서에서 뺐습니다. 이 엔드포인트는 더 이상 제공하지 않습니다.
    • 문서가이드를 새로 냈습니다: 빠른 시작, 인증과 API 키, 호출 한도와 쿼터, 오류 코드, 데이터 규약, MCP 연결. 영어판: Quickstart.
    • 문서예시 코드를 curl · JavaScript fetch · Python requests로 통일했습니다. 다른 언어는 명세 JSON으로 클라이언트를 만들어 쓰세요.

    • 변경고객 주소를 /openapi/v1(Data API)과 /openapi/pro/v1(PRO API)로 정했습니다. 예전 /api/v1 주소도 같은 API로 열려 있습니다.
    • 추가PRO 플랜으로 쓰는 원격 MCP 서버 https://www.chickstockfi.com/openapi/pro/v1/mcp. PRO API 키 또는 OAuth 2.1로 연결합니다.

    • 추가PRO API(Data · Ask · Bundle 플랜). 공시·재무·시세·스크리너·업종·일정·브리프·리포트와 대화형 질문을 제공합니다.
    • 변경서비스 설명(GET /)과 기사 원문 열기(/articles/{id}/read)를 뺀 모든 Data API 엔드포인트가 키를 요구합니다.

    • 변경GET /briefings/{symbol}의 가격 필드는 값이 없으면 null이고, date는 정규장 거래일입니다.