finlight API로 할 수 있는 것

finlight는 금융 뉴스 API입니다. 끊임없이 쏟아지는 어수선한 글로벌 시장 뉴스를 깔끔하고 구조화된, AI로 강화된 데이터로 바꿔 주어, 여러분이 조회하거나 스트리밍하거나 직접 푸시받을 수 있게 합니다. 이제 직접 웹사이트를 스크래핑하고 HTML을 파싱할 필요 없이, 감성 분석, 회사 태깅, 풍부한 필터링이 기본 내장된 하나의 일관된 인터페이스를 얻게 됩니다.

이 페이지는 일종의 지도입니다. finlight가 무엇을 제공하는지, 데이터를 가져오는 네 가지 방식, 그리고 다음에 어디로 가야 할지를 다룹니다. 일단 첫 호출부터 해보고 싶다면 빠른 시작 가이드부터 시작하세요.

모든 기사에 담긴 것

finlight가 반환하는 모든 기사는 단순한 헤드라인과 링크가 아니라 구조화되고 강화된 형태입니다. 다음을 얻게 됩니다:

핵심 필드: 제목, 요약, 전체 본문(선택), 출처, 발행일, 언어, 이미지.
감성: 각 기사는 신뢰도 값과 함께 positive, neutral, negative 로 평가되므로, 모든 기사를 일일이 읽지 않고도 톤을 정량화할 수 있습니다.
회사 엔티티: finlight는 기사가 다루는 회사를 태깅하고 이를 실제 식별자로 해석합니다: 티커, ISIN, OpenFIGI, 섹터 및 산업, 그리고 해당 회사가 상장된 모든 거래소(주요 및 보조 상장, 각각 거래소 코드와 국가 포함).
분류: 각 기사는 영향을 미치는 국가와 13개 분류 중 하나 이상으로 태깅됩니다.

이는 곧 "이번 주 AAPL에 대한 감성이 어떻게 바뀌었지?" 또는 "특정 회사 그룹에 영향을 주는 모든 규제 관련 기사를 보여 줘" 같은 질문에 직접 NLP 파이프라인을 구축하지 않고도 답할 수 있다는 뜻입니다.

데이터를 가져오는 네 가지 방식

동일한 강화 데이터를 네 가지 전달 방식으로 가져올 수 있습니다. 여러분의 작업 특성에 가장 잘 맞는 것을 고르면 됩니다.

REST API

필요할 때 뉴스를 조회합니다: 요청을 보내면 매칭되는 기사 한 페이지를 돌려받습니다. 검색, 과거 데이터 백필, 정기적으로 갱신되는 대시보드, 그리고 모든 요청/응답 워크플로에 가장 적합합니다. 고급 POST /v2/articles 엔드포인트는 전체 필터 세트를 지원하며, URL로 단일 기사를 가져오거나 사용 가능한 출처를 나열하는 엔드포인트도 있습니다. REST 문서를 참고하세요.

WebSocket

기사가 발행되는 순간 폴링 없이 실시간으로 스트리밍합니다. 두 가지 형태가 있습니다: 완전한 강화(감성과 엔티티)를 포함한 향상된 스트림, 그리고 기본 정보만 빠르게 필요할 때를 위한 경량 원시(raw) 스트림. 실시간 대시보드, 트레이딩 신호, 모니터링에 이상적입니다. WebSocket 문서를 참고하세요.

Webhooks

뉴스가 여러분의 필터에 매칭되는 순간 finlight가 여러분의 엔드포인트로 직접 푸시하게 합니다. 강화 버전과 원시 버전을 모두 제공하며, 전송에는 서명이 포함되어 검증할 수 있습니다. 이벤트 기반 파이프라인, 알림, 그리고 폴링 없이 실행되어야 하는 자동화에 가장 적합합니다. webhook 문서를 참고하세요.

MCP 서버

Model Context Protocol을 통해 finlight를 Claude나 ChatGPT 같은 AI 어시스턴트에 연결한 다음, 자연어로 시장 뉴스를 요청하세요. 코드 작성 없이 하는 리서치와 즉석 분석에 가장 적합합니다. AI 어시스턴트 문서를 참고하세요.

경험칙: 필요할 때는 REST, 실시간에는 WebSocket, 푸시 자동화에는 webhooks, AI 기반 리서치에는 MCP. 전용 비교 가이드도 곧 게시될 예정입니다.

정밀한 필터링

finlight는 원하는 뉴스를 정확히 가져오는 데 초점을 맞춰 설계되었습니다. REST, WebSocket, webhooks 전반에서 다음 조건으로 필터링할 수 있습니다:

티커: AAPL 이나 NVDA 같은 회사.
국가: ISO 국가 코드로 특정 시장에 집중.
분류: markets, economy 부터 crypto, regulation, energy 까지 13개 분류 중 어떤 것이든.
출처: 특정 매체를 포함하거나 제외하고, 추가 출처를 선택적으로 포함.
날짜 범위와 완전한 쿼리 언어, 불리언 연산자와 필드 필터를 지원합니다. 예: (ticker:AAPL OR ticker:NVDA) AND NOT source:reuters.com.

전체 쿼리 구문은 고급 쿼리 문서를 참고하세요.

글로벌, 다국어 커버리지

finlight는 9개 언어의 뉴스를 다룹니다: 영어, 중국어 간체, 힌디어, 스페인어, 일본어, 한국어, 포르투갈어, 아랍어, 러시아어. 국가 및 분류 필터와 결합하면, 영어 보도에만 의존하는 대신 각 시장을 그 시장의 언어와 지역으로 추적할 수 있습니다.

개발자를 위해 설계됨

순수 HTTP로 finlight를 호출할 수도 있고, 공식 SDK를 사용할 수도 있습니다:

Node / TypeScript: npm install finlight-client
Python: pip install finlight-client

둘 다 REST와 WebSocket API를 감싸고, 인증과 재시도를 처리하며, 타입이 지정된 객체를 반환합니다. 인증은 매 요청마다 단 하나의 X-API-KEY 헤더만 있으면 되며, 대시보드에서 생성한 키를 사용합니다. 최소한의 요청은 다음과 같습니다:

curl -X POST https://api.finlight.me/v2/articles \
  -H "X-API-KEY: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "tickers": ["AAPL"], "pageSize": 5 }'

플랜

finlight는 테스트용 무료 플랜부터 엔터프라이즈까지 다양한 플랜을 제공하며, 주된 차이는 요청량, 과거 데이터 깊이, 실시간 접근, 그리고 커스텀 출처 같은 기능에 있습니다. 무료 플랜은 REST 전용이며 평가용으로 이상적입니다. 현재 한도와 각 등급에서 제공하는 기능은 finlight.me/pricing에서 확인하세요.

개발 시작하기

처음이신가요? 빠른 시작 가이드를 따라 5분 만에 첫 호출을 해 보세요.
깊이 파고들 준비가 됐나요? 전체 문서를 둘러보세요.
궁금한 점이 있나요? Discord에 참여하거나 info@finlight.me로 이메일을 보내세요.

무료 API 키 받기 →

Friday, June 26, 2026

finlight API로 할 수 있는 것: 완전 개요