API 레퍼런스

개요

MiniValuator는 주식 펀더멘털 데이터를 프로그래밍 방식으로 가져올 수 있는 REST API를 제공합니다. 동일한 크레딧 과금 규칙이 적용됩니다 — 새 티커는 10크레딧, 7일 이내 재조회는 무료입니다.

기본 URL: https://minivaluator.com

인증: Authorization: Bearer sk-... 헤더를 통한 API 키

API 키 발급받기

MiniValuator 계정에 로그인합니다
설정 → API 키로 이동합니다
Add API Key를 클릭하고 이름을 지정한 뒤, 생성된 키(sk-...)를 복사합니다

API 키를 비밀로 유지하세요. 키를 가진 사람은 누구나 회원님의 크레딧을 소모할 수 있습니다.

엔드포인트

GET /api/stock/fundamentals

주어진 주식 티커에 대한 펀더멘털 데이터를 반환합니다.

요청

curl "https://minivaluator.com/api/stock/fundamentals?symbol=AAPL" \
  -H "Authorization: Bearer sk-your-api-key-here"

쿼리 파라미터

파라미터	타입	필수	설명
`symbol`	string	예	주식 티커 심볼 (예: `AAPL`, `MSFT`, `GOOGL`)

응답

{
  "data": {
    "symbol": "AAPL",
    "name": "Apple Inc.",
    "fcfPerShare": 7.43,
    "currentPrice": 211.45,
    "currentPFCF": 28,
    "eps": 6.42,
    "currentPE": 33,
    "growthEstimate": {
      "rates": [0.062, 0.091, 0.08, 0.08, 0.08],
      "cagr": 0.082,
      "quality": "ok",
      "flags": []
    },
    "earningsGrowthEstimate": {
      "rates": [0.11, 0.13, 0.12, 0.12, 0.12],
      "cagr": 0.12,
      "quality": "ok",
      "flags": []
    },
    "dataSource": "Financial Modeling Prep"
  }
}

응답 필드

필드	타입	설명
`symbol`	string	대문자 티커 심볼
`name`	string	기업명
`fcfPerShare`	number	주당 잉여현금흐름 (TTM, USD)
`currentPrice`	number	현재 주가 (USD)
`currentPFCF`	number	주가 대비 잉여현금흐름 배수 (TTM)
`eps`	number	주당순이익 (TTM, USD)
`currentPE`	number	주가수익비율 (TTM)
`growthEstimate`	object \| null	매출 기반 5년 성장 추정치
`earningsGrowthEstimate`	object \| null	EPS 기반 5년 성장 추정치
`dataSource`	string	데이터 제공업체명

growthEstimate 필드

필드	타입	설명
`rates`	number[]	5개의 전년 대비 성장률 (소수, 예: `0.08` = 8%)
`cagr`	number	전체 기간에 걸친 연평균 복합 성장률
`quality`	`"ok"` \| `"partial"` \| `"insufficient"`	데이터 신뢰 수준
`flags`	string[]	보완되거나 제한된 값에 대한 비고

오류 응답

HTTP 상태	메시지	원인
`400`	`"Symbol required"`	`symbol` 파라미터 누락
`400`	`"Invalid symbol format"`	심볼에 유효하지 않은 문자 포함
`400`	`"Insufficient credits"`	계정의 크레딧이 10 미만
`400`	`"Rate limit exceeded"`	이 IP에서 너무 많은 요청
`400`	`"Stock not found"`	데이터 제공업체가 인식하지 못하는 티커

모든 오류는 다음 형식을 따릅니다:

{ "error": "Insufficient credits" }

크레딧 사용량

시나리오	청구되는 크레딧
새 티커에 대한 첫 조회	10크레딧
7일 이내 재조회	무료 (캐시에서 제공)
7일 이후 재조회	10크레딧

코드 예시

Python

import requests

API_KEY = "sk-your-api-key-here"

response = requests.get(
    "https://minivaluator.com/api/stock/fundamentals",
    params={"symbol": "AAPL"},
    headers={"Authorization": f"Bearer {API_KEY}"},
)
data = response.json()
print(data["data"]["fcfPerShare"])  # 7.43

JavaScript / Node.js

const API_KEY = "sk-your-api-key-here";

const res = await fetch(
  "https://minivaluator.com/api/stock/fundamentals?symbol=AAPL",
  { headers: { Authorization: `Bearer ${API_KEY}` } }
);
const { data } = await res.json();
console.log(data.fcfPerShare); // 7.43