finlight Logo

경제 뉴스 API

로이터, AP, CNBC를 비롯한 100개 이상의 소스에서 연준, CPI, 인플레이션, 금리 결정 관련 헤드라인을 하나의 쿼리로 필터링해 REST, WebSocket, 또는 웹훅으로 시스템에 전달합니다.

API 키 받기

제품 데모 페이로드

매크로 기사 하나가 담고 있는 것

이 페이지가 기반으로 하는 쿼리로 실시간으로 가져온 결과입니다:

query: "federal reserve" OR FOMC OR CPI OR inflation
categories: economy
Single article response
{
  "title": "America In Focus: US employers unexpectedly cut 23,000 jobs; mortgage rates rise again",
  "link": "https://apnews.com/article/inflation-economy-trump-iran-unemployment-7e17e0d7b7baf952878274ced568a2f8",
  "source": "apnews.com",
  "publishDate": "2026-08-08T14:10:06.000Z",
  "language": "en",
  "sentiment": "negative",
  "confidence": 0.7371397614479065,
  "categories": ["business", "economy", "markets"],
  "countries": ["US"],
  "summary": "U.S. employers unexpectedly cut 23,000 jobs last month, and Labor Department revisions shaved 103,000 jobs off payrolls in May and June.",
  "companies": []
}

페이로드는 축약되었습니다: images 배열은 생략되었습니다. 이 기사에서 companies가 비어 있는 이유는 고용 보고서가 상장 기업을 언급하지 않기 때문입니다. 매크로 기사가 기업을 언급할 때는 각 엔티티에 티커, 거래소(MIC 코드), ISIN, 섹터, 산업, 교차 상장 정보가 포함됩니다. 같은 실시간 쿼리로 반환된 Benzinga의 주간 시장 기사는 PLTR, AMAT, TTD, ZBRA, COHR, DVA에 이 모든 필드가 태그되어 있었습니다. 전체 필드 참조는 문서.

매크로 알림

매크로 데스크가 지금도 직접 만들고 있는 알림

매크로 알림은 finlight의 유료 사용자들이 독립적으로, 거의 동일하게 반복해서 만드는 패턴입니다: 연준, FOMC, CPI, PPI, 고용, GDP, 인플레이션, 관세 관련 용어에 대한 OR 체인을 economy 뉴스로 필터링한 것입니다. 팀들은 서로의 쿼리를 본 적 없이 같은 조건으로 수렴합니다. 이 페이지는 빈 쿼리 상자 대신 그 패턴을 시작점으로 제공합니다:

JSON
{
  "name": "Macro news alert",
  "query": "\"federal reserve\" OR FOMC OR CPI OR inflation",
  "categories": ["economy"],
  "url": "https://your-endpoint.example.com/macro-news"
}
이 알림 만들기

기사가 일치하면 이 POST가 엔드포인트로 전달됩니다. 아래 헤더와 본문 형식은 실제로 캡처된 전달 내용입니다:

POST /macro-news HTTP/1.1
Content-Type: application/json
X-Webhook-Signature: sha256=01c4d3b9...913527fd
X-Webhook-Timestamp: 2026-08-08T20:40:58.736Z
{
  "link": "https://apnews.com/article/inflation-economy-trump-iran-unemployment-7e17e0d7b7baf952878274ced568a2f8",
  "source": "apnews.com",
  "title": "America In Focus: US employers unexpectedly cut 23,000 jobs; mortgage rates rise again",
  "images": ["..."],
  "summary": "U.S. employers unexpectedly cut 23,000 jobs last month, and Labor Department revisions shaved 103,000 jobs off payrolls in May and June.",
  "language": "en",
  "publishDate": "2026-08-08T14:10:06.000Z",
  "createdAt": "2026-08-08T14:11:52.000Z",
  "categories": ["business", "economy", "markets"],
  "sentiment": "negative",
  "confidence": 0.7371397614479065,
  "countries": ["US"],
  "content": "...",
  "isUpdate": false,
  "revisedDate": "2026-08-08T14:10:06.000Z"
}

페이로드는 축약되었습니다: images와 content는 단축되었습니다. 모든 전달은 HMAC-SHA256(X-Webhook-Signature)으로 서명되며 전달 타임스탬프가 포함됩니다. 실패한 전달은 지수 백오프로 자동 재시도됩니다. 웹훅은 이를 포함하는 플랜에서 사용할 수 있습니다. 자세한 내용은 요금제.

하나의 쿼리, 세 가지 전달 경로.

같은 쿼리가 세 가지 모두를 구동합니다: 검색과 백필을 위한 REST 엔드포인트, 지속적인 연결을 위한 WebSocket 스트림, 그리고 이미 사용 중인 시스템으로 푸시하는 웹훅입니다. 금융 뉴스 피드를 한 번 정의하면 시스템이 필요로 하는 곳 어디에서나 사용할 수 있습니다. 소비자가 매크로 헤드라인에 반응하는 트레이딩 시스템이라면, 트레이딩 시스템 페이지에서 이를 위해 구축된 듀얼 스트림 설정을 확인할 수 있습니다.

복사해서 바로 실행하는 코드

매크로 쿼리, 실행 가능

REST API에 대한 동일한 OR 체인입니다. 빠진 것은 API 키뿐입니다.

TypeScript
import { FinlightApi } from 'finlight-client'

const api = new FinlightApi({ apiKey: 'YOUR_API_KEY' })

const res = await api.articles.fetchArticles({
  query: '"federal reserve" OR FOMC OR CPI OR inflation',
  categories: ['economy'],
  includeEntities: true,
  pageSize: 20,
})

for (const a of res.articles) {
  console.log(a.publishDate, a.sentiment, a.confidence, a.title)
}
Python
from finlight_client import FinlightApi
from finlight_client.models import ApiConfig, GetArticlesParams

api = FinlightApi(config=ApiConfig(api_key="YOUR_API_KEY"))

res = api.articles.fetch_articles(
    params=GetArticlesParams(
        query='"federal reserve" OR FOMC OR CPI OR inflation',
        categories=["economy"],
        include_entities=True,
        page_size=20,
    )
)

for a in res["articles"]:
    print(a["publishDate"], a["sentiment"], a["confidence"], a["title"])

npm install finlight-client 또는 pip install finlight-client로 설치하세요. 쿼리 언어는 불리언 로직, 정확한 문구, 필드 필터를 지원하므로 그 팀들이 확장한 것과 같은 방식으로 체인을 확장할 수 있습니다: 데스크에 필요한 대로 ECB, BOJ, 고용, GDP, 관세 관련 용어를 추가하세요. 관세와 제재 쪽에 가까운 조건은 지정학 뉴스 API를 참고하세요. 전체 쿼리 참조는 문서에, 제품 개요는 News API에 있습니다.

finlight가 하지 않는 것

finlight는 경제 캘린더가 아닙니다: 지표 값, 컨센서스나 전망치, 발표 일정을 제공하지 않습니다. 흔히 쓰는 조합은 무료 발표 일정 사이트(Forex Factory, Trading Economics)와 범용 뉴스 API 또는 직접 만든 RSS 스크래핑을 결합한 뒤, 이 둘을 엮어 매크로 알림을 만드는 것입니다. finlight는 이 조합의 후반부를 대체합니다: 로이터, AP, CNBC, Yahoo Finance, the Guardian를 비롯한 100개 이상의 소스를 감시해 연준, CPI, 인플레이션, 금리 결정 헤드라인을 찾아내고, 카테고리와 키워드로 필터링해 그 결과를 알림에 연결합니다. 지표 값과 발표 시점이 필요하다면 그 절반에는 데이터 제품을 사용하세요. 계속 직접 다시 만들고 있는 부분이 뉴스 쪽이라면, 그것이 바로 이 API가 대체하는 부분입니다.

자주 묻는 질문

경제 뉴스 API: 자주 묻는 질문

매크로 뉴스 알림을 구성하기 전에 개발자들이 묻는 모든 것입니다.

테스트용 무료 플랜이 있으며, 유료 플랜은 월 29달러부터 시작합니다. 플랜마다 요청량, 실시간 액세스, 웹훅, 히스토리컬 데이터가 다릅니다. 현재 가격과 한도는 요금제 페이지에 있습니다.

아직 질문이 있으신가요?

개발자 중심의 지원 팀이 통합 및 확장을 도와드립니다.

이메일 지원

통합 및 기술 질문에 대한 도움을 받으세요

info@finlight.me

Discord 커뮤니티

다른 개발자와 연결하고 빠른 답변을 받으세요

Discord 가입

다음 발표 전에 알림을 설정하세요

다음 CPI 발표, 고용 보고서, 금리 결정은 이미 예정되어 있습니다. 알림은 그것이 도착하기 전에 준비되어 있어야 합니다. 키를 받고, 위의 매크로 알림을 만들고, 데모가 아닌 실제 발표로 피드를 판단해보세요.

API 키 받기