기업 재무 API: 금융 에이전트를 위한 재무상태표·현금흐름·내부자 거래

가격은 시장이 어떻게 생각하는지 알려주고, 재무는 그게 맞는지 알려준다. AI 에이전트에 맞게 다듬어진 재무 API — 재무제표, 배당, 내부자 거래를 하나의 엔드포인트로 — 와 그것이 원시 SEC EDGAR 및 재무제표 API 벤더와 어떻게 비교되는지.
한눈에
- •재무 = '사업이 실제로 건강한가' 계층: 재무상태표, 손익계산서, 현금흐름표, 배당, 내부자 거래.
- •SEC EDGAR(XBRL)에서 무료로 파싱할 수 있지만, 신고자와 기간 전반에 걸쳐 XBRL을 정규화하는 것은 진짜이고 지속적인 엔지니어링이다 — 게다가 미국 한정이며 신고 주기에 묶여 있고 쿼리 형태가 아니다.
- •API Pick Financials Search는 미국 기업 재무 다섯 가지 모두를 하나의 POST 엔드포인트 뒤로 반환한다 — 호출당 200 크레딧, 성공 시에만 — LLM 추론에 맞게 미리 다듬어진 형태로.
- •내부자 거래(Form 4)와 배당 이력은 덜 활용되는 신호다: 여기서는 끌어오기가 싸지만, EDGAR에서 조립하기는 고통스럽다.
- •Financials를 SEC Filings(정성적 10-K/10-Q 텍스트), Markets(가격)와 짝지어 완전한 근거 있는 그림을 얻어라.
가격은 의견이고, 재무는 증거다
시장 데이터 호출은 에이전트에게 주식이 얼마인지 알려준다. 하지만 그 뒤의 사업이 성장하고 있는지, 부채에 빠져 죽고 있는지, 아니면 임원들이 조용히 팔아치우고 있는지는 알려주지 못한다. 그것이 재무 계층이고 — 리서치 에이전트가 "가격을 인용한다"에서 "견해를 형성한다"로 넘어가는 지점이다.
다섯 데이터셋이 신호의 대부분을 나른다: 재무상태표, 손익계산서, 현금흐름표, 배당 이력, 내부자 거래.
EDGAR 세금
이 모든 것은 SEC EDGAR에 공개돼 있고 무료다. 함정은 XBRL이다. company-facts JSON은 거대하고 일관성이 없다: 같은 개념이 신고자마다 다르게 태깅되고, 재작성이 히스토리를 흐리며, 다운스트림이 쓰기 전에 방대한 분류 체계를 깔끔한 스키마로 매핑해야 한다. 내부자 데이터(Form 4)와 배당은 각각 따로 파싱하는 별도의 신고 유형이다. 한 티커에 대해 한 번 하는 건 주말 작업이지만, 어떤 회사든 질의하는 에이전트를 위해 안정적으로 하는 건 유지보수되는 파이프라인이다.
도구 하나로서의 재무
Financials Search는 미국 상장사의 재무상태표, 손익계산서, 현금흐름, 배당, 내부자 거래를 하나의 POST 엔드포인트 뒤로 반환한다 — 호출당 200 크레딧, 성공 시에만, LLM에 맞게 미리 다듬어진 형태로.
import httpx, os
API, HEADERS = "https://api.apipick.com/v1", {"x-api-key": os.environ["APIPICK_KEY"]}
def fundamentals(query: str):
return httpx.post(f"{API}/search/financials", headers=HEADERS,
json={"query": query}).json()["results"]
fundamentals("Apple latest balance sheet and cash flow")
fundamentals("recent insider transactions at Meta")
fundamentals("Microsoft revenue and net income trend")EDGAR 대 벤더 대 묶음
| SEC EDGAR 파싱 | 재무제표 API 벤더 | API Pick Financials | |
|---|---|---|---|
| 비용 | 무료 + 엔지니어링 | 구독 | 호출당 200 크레딧, 성공 시에만 |
| 셋업 | XBRL 정규화 파이프라인 | 타입 엔드포인트 통합 | 엔드포인트 하나, 형태 하나 |
| 커버리지 | 미국, 신고 단위 정리 | 깊음, 긴 히스토리 | 미국 재무 + 내부자 + 배당 |
| 쿼리 방식 | 신고/개념별 | 타입 파라미터 | 자연어 |
| 최적 용도 | 일회성 / 완전한 통제 | 재무가 제품일 때 | 금융 에이전트(여러 도구 중 하나) |
완전한 그림
재무는 정성적 측면(리스크 요인, MD&A, 실적 발표 언어)을 위한 SEC Filings Search, 그리고 가격을 위한 Markets Search와 자연스럽게 짝을 이룬다. 함께라면 그것들은 투자 리서치 에이전트의 척추다. 키 하나, 전부 JSON, 성공 시에만 과금. 무료 100 크레딧으로, 카드 없이 시작하라.
자주 묻는 질문
재무를 그냥 SEC EDGAR에서 무료로 얻으면 안 되나?
할 수 있다 — EDGAR의 company-facts와 XBRL 데이터는 무료이고 권위 있다. 비용은 엔지니어링이다: XBRL 태그는 신고자와 기간 전반에서 흔들리고, 재작성이 히스토리를 복잡하게 하며, 모델(또는 차트)이 쓰기 전에 수천 개의 분류 개념을 깔끔한 스키마로 매핑해야 한다. 게다가 미국 한정이고 질문이 아니라 신고 단위로 정리돼 있다. 한 회사를 가끔 본다면 EDGAR로 충분하다. 자연어로 많은 회사를 질의하는 에이전트라면, 정규화된 API가 수 주를 아껴 준다.
무엇이 커버되며, 미국 한정인가?
미국 상장사의 재무상태표, 손익계산서, 현금흐름표, 배당 이력, 내부자 거래. 미국 재무다. 미국 외 발행사는 다른 소스를 써야 한다. 신고 텍스트 자체(10-K 리스크 요인, 10-Q MD&A, 실적 발표)는 별도의 SEC Filings Search 엔드포인트를 써라.
내부자 거래와 배당을 강조할 가치가 있는 이유는?
고신호이면서 직접 조립하기 성가시기 때문이다. 내부자 매수/매도(SEC Form 4)는 주목받는 행동 신호이고, 배당 이력은 인컴과 퀄리티 스크린에 중요하다. 둘 다 EDGAR에서 특정 신고 유형을 파싱해야 한다. 여기서는 재무제표와 같은 엔드포인트의 일급 필드다.
이것은 재무제표 API 벤더와 어떻게 비교되나?
전용 벤더(예: 재무제표 API)는 깊고 타입 지정된 엔드포인트와 긴 히스토리를 준다 — 재무가 제품 전부라면 훌륭하다. API Pick의 각도는 다르다: 하나의 키 뒤에 있는 도구 묶음(markets, SEC, economic, news) 중 하나로서의 재무, 에이전트에 맞춘 쿼리 형태, 성공 시에만 과금. 재무 제품이 아니라 금융 에이전트를 만든다면, 하나의 형태로 된 묶음이 더 빠른 길이다.
이것은 투자 자문인가?
아니다. 리서치와 에이전트 근거를 위한 구조화된 공개 재무 데이터다. 자격 있는 사람이나 감독받는 에이전트의 분석에 정보를 제공하지만, 자문이 아니며 인간 책임과 리스크 통제 없이 자동 거래를 구동해서는 안 된다.
이 글에서 사용한 API
Sarah Choy는 API Pick의 CEO입니다. AI 에이전트와 LLM 워크플로를 위한 프로덕션 등급 API에 대해 씁니다.