종목 핵심 지표
스코어, 시장, 업종, 현재 시가총액 등 종목 진단의 출발 데이터를 제공합니다.
B2B API
계약 기반 FINATA API
한국 상장기업 데이터를 고객 서비스와 내부 시스템에 연결합니다.
Overview
서비스에 바로 연결할 수 있는 상장기업 데이터 API
FINATA B2B API는 셀프가입형 공개 API가 아니라 계약 고객에게 key를 발급하는 방식으로 운영됩니다. 고객사는 월 quota, rate limit, 허용 Origin, 사용 범위를 계약 단위로 정하고 스코어, 재무, 소유구조, 지배구조 데이터를 API로 연동할 수 있습니다.
AuthBearer / X-API-Key
Quota계약별 월 사용량
Limit분당 호출 제한
Scope계약 범위 내 사용
Resources
Phase 1 제공 endpoint
연간 재무 데이터
상장기업별 연간 재무제표 shard를 API 응답으로 제공합니다.
소유구조
최대주주와 지분 구조를 계약 서비스에 연결할 수 있습니다.
지배구조
이사회, 감사, 주주총회 등 지배구조 profile 데이터를 제공합니다.
Operating Flow
계약부터 운영 리포트까지 한 흐름으로 관리합니다
계약 조건 확정
사용 목적, 호출량, 데이터 범위, 재배포 여부, 허용 Origin을 확인합니다.
API key 발급
원문 key는 1회만 전달하고 FINATA에는 prefix와 hash만 저장합니다.
Production 검증
대표 ticker로 네 endpoint, quota, rate limit 헤더를 확인합니다.
월간 리포트
고객별 quota 사용률, 오류율, key 상태를 월 단위로 점검합니다.
Example
호출 예시
curl -H "Authorization: Bearer $FINATA_API_KEY" \
https://finata.co.kr/api/v1/stocks/005930/metrics/api/v1/stocks/{ticker}/metrics
/api/v1/stocks/{ticker}/financials
/api/v1/stocks/{ticker}/ownership
/api/v1/stocks/{ticker}/governance
FINATA API는 실시간 시세 API가 아니며, 투자자문이나 매매추천을 제공하지 않습니다. 데이터 기준일은 응답의 `meta.data`에서 확인합니다.
Pilot
파일럿은 작게 시작하고 사용량으로 확장합니다
| 구분 | pilot | business | enterprise |
|---|---|---|---|
| 목적 | PoC와 내부 검증 | 운영 서비스 연동 | 대형 고객·전용 조건 |
| 월 quota | 10,000 | 100,000 | 별도 협의 |
| 분당 제한 | 120 | 300 | 별도 협의 |
Partnership
데이터/API 문의하기
B2B API 도입을 검토하고 계신가요?
사용 목적, 예상 호출량, 고객 서비스 노출 여부를 알려주시면 파일럿 조건과 연동 범위를 함께 정리해 드립니다.