# Phoenix AI (피닉스 AI) — 전체 레퍼런스

Phoenix AI(피닉스 AI)는 투자 리서치를 위한 버티컬 AI입니다. 한국 DART와 미국 SEC EDGAR 공시, 재무, 매크로, 뉴스와이어를 연결해 기업을 분석·비교하고, PheonixAI 자체 모델의 목표가와 기간별 도달 확률을 예측차트로 보여 줍니다. 모델 산출값은 화면에 "PheonixAI" 모델 추정치로 표기되며, 적중률이나 수익·도달을 보장하지 않습니다.
공시 기반 답변에는 보고서명·공시일·원문 링크를 함께 제공하고, 근거 문서가 없으면 답변을 보류합니다. 재무 비율·밸류에이션은 LLM이 아니라 코드가 계산하며 산식과 수치를 공개합니다.
운영: [주식회사 알프소프트 (Alpsoft Inc.)](https://www.alpsoft.io) · 문의: help@alpsoft.io · 070-4211-0627 · 최종 업데이트: 2026-10-30

## 제품
- 대화형 공시 분석: 국내 재무인텔리전스, 공시 기반 위험 점검, 미국 8-K 승인 분석, 주가 변동 분석, 뉴스와이어를 질문으로 탐색
- 예측차트: PheonixAI 모델의 목표가격·분석 기간·기간 내 도달 확률을 실제 가격 이력과 함께 표시
- 포트폴리오 리서치: 보유 종목·비중·운용 방침 기준 모닝 브리프(공시·리스크·컨센서스·반대 의견)
- 미국 공시 뉴스룸(PRO, 경제 뉴스와이어·언론사용): SEC 공시(실적 8-K 등)로 한국어 기사 초안을 속보·표준·심층 판으로 작성, 숫자·인용마다 원문 근거(표 칸의 행·열·단위 선언, 영어 원문 인용과 번역), HTML·Markdown·JSON 내려받기, 출처 줄과 'AI 작성 초안' 고지 상시 포함(게재 여부는 기자 결정). 초대 또는 계약 계정 전용, PoC는 만들어진 초안 열람만, 가격 협의 → https://openapi.chickstockfi.com/#newsroom
- 도입: 30분 제품 데모(https://openapi.chickstockfi.com/demo), Enterprise PoC 협의(기본 7일, 기간은 협의로 조정), 도입 문의 https://openapi.chickstockfi.com/#contact

## 개발자 API 개요
두 가지 REST API를 제공합니다. 둘 다 OpenAPI 3.1 명세로 공개하며, 별도 라이브러리 없이 HTTP로 호출합니다.
- Data API(기업용): 종목 코드 하나로 뉴스·시세·재무·AI 종목 브리핑·공시(DART)와 AI 요약·미국 SEC 공시 피드·미국 실적 발표 수치·지분·배당·신용등급·기업 이벤트·IR/IPO 일정·임상·국내·미국 경제 캘린더·미국 실적 일정을 받습니다. 미국 공시·실적 이벤트는 웹훅으로도 받습니다. 코스피·코스닥 상장 종목과 ETF, 미국 상장 종목을 다룹니다. 베이스 URL https://api.chickstockfi.com/openapi/v1 · 명세 https://openapi.chickstockfi.com/openapi.json
- PRO API: 공시·재무·시세·스크리너·업종·일정·브리프·리포트 데이터와 Phoenix AI PRO 대화형 질문을 프로그램에서 씁니다. 베이스 URL https://api.chickstockfi.com/openapi/pro/v1 · 명세 https://openapi.chickstockfi.com/openapi-pro.json
- MCP 서버: https://www.chickstockfi.com/openapi/pro/v1/mcp — Claude·ChatGPT·Cursor 같은 AI 도구에서 씁니다. Data API 키(ck_live_)로 연결하면 Data API 도구(도구 호출 1번 = REST 요청 1번), PRO API 키나 OAuth 2.1로 연결하면 PRO 도구가 열리고, 각 API의 플랜·한도를 그대로 씁니다. 안내: https://openapi.chickstockfi.com/docs/mcp
- 두 API 모두 www.chickstockfi.com 주소(/openapi/v1, /openapi/pro/v1)로도 호출할 수 있습니다.

## 인증
- 계정은 신청(https://openapi.chickstockfi.com/request)을 검토한 뒤 발급합니다. 셀프 가입은 없습니다. 받은 계정 ID와 비밀번호로 개발자 콘솔(https://openapi.chickstockfi.com/login)에 로그인해 키를 직접 만들고, 교체하고, 폐기합니다. 키는 만들 때 한 번만 보이고 서버에는 해시만 저장합니다.
- Data API 키: `ck_live_…`(활성 키 유료 등급 3개 · PoC 2개) · PRO API 키: `ck_pers_…`(PRO 플랜 계정, 2개). 두 API의 키는 서로 열리지 않습니다.
- 요청 헤더: `Authorization: Bearer <키>` 또는 `X-API-Key: <키>`
- 안내: https://openapi.chickstockfi.com/docs/authentication

## 요금·한도
- 가격: Data API·Enterprise·PRO API 모두 가격 협의(도입 문의 help@alpsoft.io).
- Data API 등급(모두 전체 엔드포인트, 기본 한도 = 분당 · 하루 · AI 호출 하루): Launch 120 · 3,334 · 50 / Business 600 · 16,667 · 200 / Scale 1,800 · 66,667 · 500 / Enterprise 6,000 · 1,000,000(계약으로 조정) · AI 기본 한도 없음. 계약에 따라 AI 호출 월 한도를 둘 수 있습니다(429 AI_MONTHLY_QUOTA_EXCEEDED).
- PoC(체험): 기본 7일 동안 목표 등급의 체험 한도로 모든 엔드포인트를 씁니다(분당 · 하루 · AI 호출 하루 — Launch 60 · 2,000 · 20 / Business 300 · 8,000 · 80 / Scale 900 · 30,000 · 200, 목표 미지정은 Launch). 기간은 협의로 조정할 수 있고, 끝나면 모든 키가 403 POC_ENDED로 멈춥니다.
- PRO API 플랜(가격 협의): Data(기본 하루 1,000회·초당 2회·AI 공시 요약 즉석 생성 하루 50건) · Ask(대화형 질문 월 300회 포함) · Bundle(둘 다). 한도는 계약으로 조정합니다.
- 하루 한도는 한국시간 0시에 초기화됩니다. 응답 헤더: X-RateLimit-Limit/Remaining, X-Quota-Limit/Remaining/Period/Reset, Data API는 X-Plan · X-Plan-Tier · X-Plan-Expires · X-Markets와 AI 호출 엔드포인트의 X-AI-Quota-*(PRO는 X-Budget-Remaining, X-Ask-Remaining 추가), 429에는 Retry-After.
- 오류 형식: { "error": { "code", "message", "docs" } }. 코드표: https://openapi.chickstockfi.com/docs/errors · 한도: https://openapi.chickstockfi.com/docs/rate-limits

## Data API 응답 규약
- 한 문서: { "data": {...}, "meta": {...} } · 목록: { "data": [...], "next_cursor": "c1.…" | null, "has_more": true | false, "meta": {...} }. meta에는 as_of(응답 시각)가 있고, 회사 엔드포인트는 disclaimer·unit_note도 줍니다.
- 재무제표(GET /companies/{symbol}/financials): 줄은 data.rows, next_cursor·has_more는 최상위. 기본 100줄·최대 200줄. 회계연도·분기 최신순 → 계정(재무제표 순) → 연결 먼저.
- 기계용 코드: period_code(FY2025 · 2026Q3 · 2025YTDQ2) · account_code(revenue · operating_income · net_income …) · fs_code(CFS · OFS) · report_code(annual_report · half_year_report · q1_report · q3_report · SEC 서식) · unit_code(KRW_EOK · USD_MIL …).
- 기간 입력(period): FY2025 · 2026Q3 · 2025H1 · latest_quarter … 그 밖은 400 BAD_PERIOD. 없는 종목은 404 SYMBOL_NOT_FOUND, ETF·ETN처럼 회사 데이터가 해당 없는 상품은 404 NOT_APPLICABLE, 자료가 없으면 404 NOT_FOUND.
- 단위: 재무제표 국내 억원·미국 백만달러, 컨센서스는 기본 원·달러 그대로(unit=eok·million으로 바꿀 수 있음), 가이던스 값은 원·달러 그대로(표 단위는 display_unit).
- Data API의 회사 지표는 GET /companies/{symbol}/metrics입니다. GET /metrics/{symbol}은 PRO API(https://api.chickstockfi.com/openapi/pro/v1) 경로입니다.
- 상세: https://openapi.chickstockfi.com/docs/conventions · 영어판 명세: https://openapi.chickstockfi.com/openapi.en.json

## Data API 웹훅(미국 공시·실적)
- 미국 공시·실적 이벤트를 등록한 HTTPS 주소로 보냅니다(계정당 최대 5개): us_filing.detected · us_filing.analysis_published · us_filing.analysis_revoked · us_earnings.figures. 공시 이벤트의 data는 GET /us-filings 항목, 실적 이벤트의 data는 GET /us-earnings/{id}와 같은 모양입니다.
- 서명은 Standard Webhooks 방식입니다(webhook-id · webhook-timestamp · webhook-signature). whsec_ 비밀값은 등록할 때 한 번만 보입니다. 실패하면 1분 · 5분 · 30분 · 2시간 · 6시간 뒤 다시 보냅니다.
- 관리: POST · GET /webhooks · PATCH · DELETE /webhooks/{id} · POST /webhooks/{id}/test · GET /webhooks/{id}/deliveries. 이벤트 본문은 명세(https://openapi.chickstockfi.com/openapi.json)의 webhooks에 있습니다.

## Data API 엔드포인트
### 서비스
- GET / — 서비스 설명
- GET /key — 이 키의 플랜·기간·오늘 사용량
- GET /openapi.json — 이 명세

### 재무제표
- GET /companies/{symbol}/financials — 재무제표 계정
- POST /query — 데이터 쿼리 실행

### 지표·성장
- GET /companies/{symbol}/metrics — 재무 비율·밸류에이션·성장률

### 매출 구성
- GET /companies/{symbol}/segments — 매출 구성

### 배당
- GET /companies/{symbol}/dividends — 배당 요약·이력
- GET /dividends/{symbol} — 배당에 관한 사항

### 순이익 구성
- GET /companies/{symbol}/net-income-split — 순이익 소유주 구분

### 컨센서스
- GET /companies/{symbol}/consensus — 시장 컨센서스
- GET /companies/{symbol}/earnings-surprises — EPS 서프라이즈·추정치
- GET /companies/{symbol}/analyst-ratings — 투자의견·목표주가

### 가이던스
- GET /companies/{symbol}/guidance — 실적·가이던스 차이표

### 공시 목록
- GET /companies/{symbol}/disclosures — 회사 공시
- GET /disclosures — 종목 공시 목록
- GET /us-filings — 미국 SEC 공시 피드

### 공시 원문·요약
- GET /disclosures/{id} — 공시 원문
- GET /disclosures/{id}/summary — 공시 AI 요약

### 종목 마스터
- GET /symbols — 국내 종목 마스터·검색

### 시세
- GET /quotes/{symbol} — 시세 + 핵심 재무
- GET /quotes/{symbol}/daily — 일별 종가 이력

### 대주주
- GET /major-holders/{symbol} — 5% 대량보유 상황보고

### 내부자 거래
- GET /insider-trades/{symbol} — 임원·주요주주 소유 상황

### 자사주
- GET /treasury/{symbol} — 자기주식 취득·처분·소각

### 임직원
- GET /employees/{symbol} — 직원 현황

### 신용등급
- GET /credit-ratings/{symbol} — 신용평가·채권 공시

### 임상시험
- GET /clinical-trials — 글로벌 임상시험

### 실적 일정
- GET /earnings — 실적 발표 일정

### 실적 발표 수치
- GET /us-earnings — 미국 실적 발표 수치
- GET /us-earnings/{id} — 미국 실적 발표 수치

### 웹훅
- GET /webhooks — 웹훅 목록
- POST /webhooks — 웹훅 등록
- PATCH /webhooks/{id} — 웹훅 수정·다시 켜기
- DELETE /webhooks/{id} — 웹훅 삭제
- POST /webhooks/{id}/test — 테스트 이벤트 보내기
- GET /webhooks/{id}/deliveries — 전달 기록

### IR
- GET /ir-calendar — IR
- GET /ir-materials — IR 발표자료 피드

### IPO
- GET /ipo-offerings — 공모청약 일정
- GET /ipo-listings — 신규 상장 일정

### 기업 이벤트
- GET /corporate-actions — 기업 이벤트 피드
- GET /corporate-actions/{symbol} — 기업 이벤트
- GET /events — 이벤트 피드

### 경제 지표
- GET /macro/rates — 미국 국채·실질금리·인플레이션
- GET /macro/credit — 미국 신용 OAS
- GET /macro/oil — 원유 현물
- GET /macro/sectors — 미국 섹터 상대강도
- GET /economic-calendar — 경제 일정
- GET /us-economic-calendar — 미국 경제·FDA 일정

### 뉴스
- GET /news — 뉴스 피드
- GET /news/{symbol} — 종목 뉴스
- GET /search — 키워드·테마 뉴스 검색
- GET /articles/{id}/read — 기사 원문으로 이동

### 브리핑
- GET /briefings/{symbol} — 종목 데일리 브리핑

### Q&A
- GET /rag — 근거 인용 답변

### 제공 중단
- GET /research/search — 증권사 리서치 검색
- GET /research/{symbol} — 종목 리서치

## PRO API 엔드포인트
### 서비스 정보
- GET / — 서비스 설명
- GET /openapi.json — 이 명세

### 계정
- GET /me — 내 플랜·오늘/이번 달 사용량

### 데이터
- GET /disclosures — 국내 주요 공시 목록
- GET /disclosures/{rcept_no} — 공시 1건
- GET /disclosures/{rcept_no}/summary — AI 공시 요약 — 저장본은 무료, 없으면 즉석 생성
- GET /financials/{symbol} — 재무제표 계정
- GET /earnings/{symbol}/variance — 실적 차이표 — 한 회계 기간의 매출·영업이익·순이익·EPS 실제값
- GET /metrics/{symbol} — 재무 비율
- GET /quotes — 여러 종목 지금 시세
- GET /quotes/{symbol} — 한 종목 지금 시세
- GET /screener/{preset} — 스크리너 프리셋 결과
- GET /sectors — 업종 목록과 종목 수
- GET /sectors/ranking — 업종·기업 재무 순위
- GET /events — 일정 — 배당·IR·공모
- GET /briefs/{symbol} — 국내 종목 데일리 브리프
- GET /reports — 마감 리포트 목록
- GET /reports/{market}/{date} — 마감 리포트 본문
- GET /analyses — 분석 글 목록

### 대화형 질문(Ask)
- POST /ask — Phoenix AI PRO에 질문
- GET /ask/{job_id} — 질문 작업 상태·답

### MCP
- POST /mcp — 원격 MCP 서버
- GET /mcp — SSE 스트림 — 지원하지 않음
- DELETE /mcp — 세션 종료 — 지원하지 않음

## 코드 예시(cURL)
```
curl -G -H "Authorization: Bearer $PHOENIX_API_KEY" "https://api.chickstockfi.com/openapi/v1/news" --data-urlencode "symbol=005930" --data-urlencode "limit=5"
curl -G -H "Authorization: Bearer $PHOENIX_API_KEY" "https://api.chickstockfi.com/openapi/v1/companies/005930/financials" --data-urlencode "account=revenue,operating_income" --data-urlencode "period=FY2025"
curl -G -H "Authorization: Bearer $PHOENIX_API_KEY" "https://api.chickstockfi.com/openapi/v1/companies/005930/metrics"
curl -H "Authorization: Bearer $PHOENIX_PRO_KEY" "https://api.chickstockfi.com/openapi/pro/v1/me"
```
JavaScript fetch·Python requests 예시: https://openapi.chickstockfi.com/docs/quickstart

## 참고 링크
- 홈: https://openapi.chickstockfi.com/ · 리서치 플랫폼: https://openapi.chickstockfi.com/platform
- 빠른 시작: https://openapi.chickstockfi.com/docs/quickstart · API 레퍼런스: https://openapi.chickstockfi.com/docs · 변경 이력: https://openapi.chickstockfi.com/docs/changelog · 지원: https://openapi.chickstockfi.com/docs/support
- 영어 문서: https://openapi.chickstockfi.com/en/docs/quickstart · 데이터 규약: https://openapi.chickstockfi.com/docs/conventions · 오류 코드: https://openapi.chickstockfi.com/docs/errors · 요약판: https://openapi.chickstockfi.com/llms.txt
- 제품 데모(미팅 예약): https://openapi.chickstockfi.com/demo
- 서비스 소개서(PDF): https://openapi.chickstockfi.com/phoenix-brochure.pdf

## 주의·면책
- 제공되는 모든 데이터·요약은 투자 참고용 정보이며, 투자자문이나 매매 권유가 아닙니다. 투자 판단과 책임은 이용자 본인에게 있습니다.
- 데이터는 공개 공시(DART·SEC 등) 및 시장 정보 기반이며, 정확성·적시성을 보장하지 않습니다.
- 운영: [주식회사 알프소프트 (Alpsoft Inc.)](https://www.alpsoft.io) · 경기도 성남시 분당구 대왕판교로 660, 유스페이스1 A · 사업자등록번호 432-88-02372