B2B API

계약 기반 FINATA API

한국 상장기업 데이터와 행동주의 타깃 인텔리전스를 고객 서비스와 내부 시스템에 연결합니다.

Overview

서비스에 바로 연결할 수 있는 상장기업 데이터 API

FINATA B2B API는 셀프가입형 공개 API가 아니라 계약 고객에게 key를 발급하는 방식으로 운영됩니다. 고객사는 월 quota, rate limit, 허용 Origin, 사용 범위를 계약 단위로 정하고 스코어, 재무, 소유구조, 지배구조, 행동주의/주주관여 후보 신호를 API로 연동할 수 있습니다.

AuthBearer / X-API-Key
Quota계약별 월 사용량
Limit분당 호출 제한
Scope계약 범위 내 사용
Data Trust

공개 명세와 데이터 기준일을 직접 확인합니다

확인 중

배포된 OpenAPI 명세와 데이터 메타데이터를 확인하고 있습니다.

Contract 확인 중 공개 명세 응답 확인
Data Build 확인 중 배포 메타데이터 확인
Score As Of 확인 중 기업 스코어 기준일
Market Cap As Of 확인 중 시가총액 기준일

이 표시는 API key 없이 조회 가능한 공개 명세와 배포 메타데이터만 검사합니다. 실제 계약 endpoint의 인증·quota·응답 검증은 고객 온보딩 절차에서 별도로 진행합니다.

Product Packages

고객 목적에 맞춰 세 가지 API 상품으로 제안합니다

Company Data API 기본 기업 데이터 연동

핀테크, 리서치, 내부 CRM/대시보드가 종목 핵심 지표와 재무·소유·지배구조, 공시 기반 채무·희석 후보 데이터를 안정적으로 가져가는 기본 패키지입니다.

  • metrics, financials, ownership, governance, exposures, dilution
  • 종목 검색 결과, 기업 요약 카드, 내부 리서치 화면 연동
  • 파일럿에서 business 전환이 쉬운 표준 계약 범위
이 상품으로 문의
Risk Radar Signals API 공시 위험 후보 모니터링

무자본 M&A, 가장납입, 임원 이동, 자금 사용 후보 신호를 candidate-only로 제공해 사전 검토와 사후 모니터링 큐를 구성합니다.

  • /api/risk-radar health, scores, events, fund-use, executives
  • reviewed signal과 후보 사건을 분리해 내부 검토 흐름 유지
  • 운영 snapshot, versioned manifest, production verifier 기반
이 상품으로 문의
파일럿 산출물
  • OpenAPI 3.1 명세와 JavaScript/Python 샘플
  • 계약 key, quota, rate limit, Origin 기준
  • 운영 production verify 결과와 월간 사용량 CSV
  • 청구 후보 report와 handoff bundle
Resources

제공 endpoint

Metrics

종목 핵심 지표

스코어, 시장, 업종, 현재 시가총액 등 종목 진단의 출발 데이터를 제공합니다.

Financials

연간 재무 데이터

상장기업별 연간 재무제표 shard를 API 응답으로 제공합니다.

Ownership

소유구조

최대주주와 지분 구조를 계약 서비스에 연결할 수 있습니다.

Governance

지배구조

이사회, 감사, 주주총회 등 지배구조 profile 데이터를 제공합니다.

Exposures

부외·우발채무 후보

재무제표 주석과 공시에서 추출한 보증, 약정, 우발채무 등 원문 검토 후보를 제공합니다.

Dilution

잠재 지분 희석 후보

미상환 전환사채와 신주인수권 등 잠재주식 관련 공시 후보를 제공합니다.

Activism

행동주의 타깃 신호

저PBR, 순현금, 지배지분, 의결사항 키워드를 결합해 주주관여 검토 우선순위를 제공합니다.

Screener

행동주의 후보 목록

점수, 시장, 업종, 의결사항 분류축으로 오늘 검토할 후보군을 좁힙니다.

Risk Radar

공시 위험 후보

M/P/E score와 공시 event 후보를 계약형 API로 검토할 수 있습니다.

Activist Target Intelligence

행동주의 운용사와 거버넌스 리서치 고객을 위한 후보 선별 API

activism resource는 저평가, 자본배분 여력, 최대주주 방어력, 지배구조 복잡도, 주요 의결사항의 주주 영향 신호를 하나의 응답으로 묶습니다. 고객사는 자체 투자·리서치 정책에 맞춰 후보군을 재정렬하고 원문 검토 workflow로 넘길 수 있습니다.

/api/v1/screeners/activist-targets는 여러 종목을 한 번에 훑어 점수순 후보 목록을 반환합니다. 운용사와 거버넌스 리서치 고객은 band, market, sector, category 필터로 검토 대상을 좁힌 뒤 개별 종목 activism 상세 응답으로 들어갈 수 있습니다.

Screening 저PBR 후보 우선순위

PBR, 수익성, 순현금 여력을 함께 보며 단순 저평가와 관여 가능성을 분리합니다.

Governance 지배구조 취약 신호

낮은 지배지분, 복잡한 control chain, 이사회 독립성 gap을 신호화합니다.

Agenda 의결사항 영향 태그

배당·자사주·정관변경·제3자배정 등 안건을 주주친화/주의/혼합과 주주환원·자본구조·특수관계거래 축으로 요약합니다.

GET /api/v1/stocks/005930/activism
{
  "resource": "activism",
  "ticker": "005930",
  "data": {
    "schema_version": "finata.activism.v1",
    "opportunity_score": 51.9,
    "target_band": "actionable",
    "score_basis": "heuristic_candidate_screen",
    "signals": [
      { "code": "low_pbr", "direction": "opportunity" },
      { "code": "control_chain_complexity", "direction": "opportunity" },
      { "code": "agenda_shareholder_watch", "direction": "governance_watch" }
    ],
    "agenda_impact_summary": {
      "positive": 2,
      "watch": 1,
      "mixed": 1,
      "category_counts": {
        "shareholder_return": 2,
        "capital_structure": 1,
        "related_party_transactions": 1
      }
    },
    "agenda_impacts": [
      {
        "shareholder_impact": "watch",
        "primary_category": { "key": "capital_structure" }
      }
    ]
  }
}

activism 응답은 후보 선별용입니다. 투자자문, 의결권 자문, 매매 권유 또는 위법 판단으로 사용하지 않으며, 외부 활용 전 원문 공시와 고객 내부 기준으로 검토해야 합니다.

Operating Flow

계약부터 운영 리포트까지 한 흐름으로 관리합니다

01

계약 조건 확정

사용 목적, 호출량, 데이터 범위, 재배포 여부, 허용 Origin을 확인합니다.

02

API key 발급

원문 key는 1회만 전달하고 FINATA에는 prefix와 hash만 저장합니다.

03

Production 검증

대표 ticker로 계약 범위 endpoint, quota, rate limit 헤더를 확인합니다.

04

월간 리포트

고객별 quota 사용률, 오류율, key 상태를 월 단위로 점검합니다.

Example

호출 예시

curl -H "Authorization: Bearer $FINATA_API_KEY" \
  https://finata.co.kr/api/v1/stocks/005930/activism

curl -H "Authorization: Bearer $FINATA_API_KEY" \
  "https://finata.co.kr/api/v1/screeners/activist-targets?limit=30&band=actionable,high"
/api/v1/stocks/{ticker}/metrics /api/v1/stocks/{ticker}/financials /api/v1/stocks/{ticker}/ownership /api/v1/stocks/{ticker}/governance /api/v1/stocks/{ticker}/exposures /api/v1/stocks/{ticker}/dilution /api/v1/stocks/{ticker}/activism /api/v1/screeners/activist-targets /api/v1/openapi

exposuresdilution은 공시 원문 검토를 돕는 candidate-only 데이터입니다. 빈 결과가 위험 또는 희석 가능성이 없다는 뜻은 아니며, 검증되지 않은 합계로 사용하지 않습니다. FINATA API는 실시간 시세 API가 아니며, 투자자문이나 매매추천을 제공하지 않습니다.

Risk Radar

공시 기반 Risk Radar API를 점검합니다

계약 API key로 health, score, event, fund-use, executive episode 응답을 확인하는 운영 preview console입니다.

콘솔 열기
Pilot

파일럿은 작게 시작하고 사용량으로 확장합니다

구분 pilot business enterprise
목적 PoC와 내부 검증 운영 서비스 연동 대형 고객·전용 조건
월 quota 10,000 100,000 별도 협의
분당 제한 120 300 별도 협의
도입 문의 pilot 문의 business 문의 enterprise 문의
Partnership

B2B API 도입을 검토하고 계신가요?

사용 목적, 예상 호출량, 고객 서비스 노출 여부를 알려주시면 파일럿 조건과 연동 범위를 함께 정리해 드립니다.

데이터/API 문의하기