API REFERENCE

종목 점수

종목 하나의 AI 재무진단 점수(0~100), 산식 기반 적정가, 현재가 대비 괴리율(상승여력 %)을 한 번에 가져올 수 있어요. 관심 종목 watch list 백엔드나 알람 봇의 데이터 소스로 가장 많이 써요.

요청

http

GET /api/public/v2/stocks/{code}/score HTTP/1.1
Host: www.bulliza.com
Authorization: Bearer rfk_live_<your-key>

경로 파라미터

이름	타입	설명
`code`	string	KOSPI 종목 = 6자리 숫자(`005930`), 미국 종목 = 티커(`AAPL`)

응답

필드	타입	설명
`ticker`	string	종목 코드
`name`	string	종목명
`market`	string	`KOSPI` \| `KOSDAQ` \| `NASDAQ` \| `NYSE`
`sector`	string \| null	업종 분류
`marketCap`	number	시가총액 — KR은 억원, US는 USD
`currentPrice`	number	현재가 — KR은 원, US는 USD
`priceDate`	string	가격 기준일 YYYY-MM-DD
`currency`	string	`KRW` \| `USD`
`healthGrade`	string	재무 등급 A+ ~ D
`healthScore`	number	재무 점수 0 ~ 100
`targetPrice`	number	산식 기반 적정가
`gapPct`	number	괴리율 % = (적정가 − 현재가) / 현재가 × 100
`fairPer`	number	적정 PER (Price-Earnings Ratio)
`disclaimer`	string	면책 문구 — 화면 노출 권장

json

{
  "ticker": "005930",
  "name": "삼성전자",
  "market": "KOSPI",
  "sector": "반도체와반도체장비",
  "marketCap": 18854249,
  "currentPrice": 322500,
  "priceDate": "2026-06-14",
  "currency": "KRW",
  "healthGrade": "A+",
  "healthScore": 87,
  "targetPrice": 380000,
  "gapPct": 17.8,
  "fairPer": 12.5,
  "disclaimer": "본 응답은 공개된 산식으로 계산된 정량 점수이며 종목 추천·투자권유가 아닙니다."
}

호출 예시

bash

# 삼성전자 (KOSPI)
curl -H "Authorization: Bearer rfk_live_<your-key>" \
  https://bulliza.com/api/public/v2/stocks/005930/score

# Apple (NASDAQ)
curl -H "Authorization: Bearer rfk_live_<your-key>" \
  https://bulliza.com/api/public/v2/stocks/AAPL/score

python

import os, requests

def get_score(code):
    r = requests.get(
        f"https://bulliza.com/api/public/v2/stocks/{code}/score",
        headers={"Authorization": f"Bearer {os.environ['RICHGO_API_KEY']}"},
        timeout=5,
    )
    return r.json()

s = get_score("005930")
print(f"{s['name']} 점수 {s['healthScore']}, 괴리율 {s['gapPct']}%")

단위에 주의해 주세요

marketCap 은 KR 종목은 억원, US 종목은 USD 단위예요.currency 필드로 단위를 판별하세요.

에러

상태	에러 코드	의미
404	`STOCK_NOT_FOUND`	code 가 유효한 종목 코드가 아니에요
401	`NO_KEY / INVALID_KEY`	인증 실패
429	`RPM_EXCEEDED / DAILY_QUOTA_EXCEEDED`	quota 초과

다음 단계