Thursday, July 16, 2026
finlight API로 티커와 거래소를 제대로 다루기
finlight API로 티커와 거래소를 제대로 다루기
티커로 뉴스를 필터링하는 일은 현실에 부딪히기 전까지는 단순해 보입니다. 같은 티커가 거래소마다 다른 기업을 가리킬 수 있고, 한 기업이 전 세계에서 여러 티커로 거래될 수도 있습니다. 이를 잘못 다루면 당신의 "애플" 피드는 어느새 엉뚱한 기사로 가득 차게 됩니다.
finlight는 태깅된 모든 기업을 실재하고 모호함 없는 식별자로 해석함으로써 이 문제를 해결합니다. 이 가이드는 티커로 필터링하는 방법과 그 식별자를 읽는 방법을 보여 주어, 언제나 올바른 기업을 정확히 겨냥하도록 돕습니다.
티커로 필터링하기
가장 빠른 방법은 구조화된 tickers 필터입니다.
curl -X POST https://api.finlight.me/v2/articles \
-H "X-API-KEY: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"tickers": ["AAPL", "NVDA"],
"includeEntities": true,
"pageSize": 20
}'
includeEntities: true에 주목하세요. 이는 finlight가 각 기사에 대해 해석된 기업 데이터를 반환하도록
지시하며, 바로 이 데이터로 올바른 기업과 매칭되었는지 확인할 수 있습니다.
해석된 엔티티 읽기
includeEntities를 켜면 각 기사에 companies 배열이 담깁니다. 단일 기업의 구조는 다음과 같습니다.
{
"companyId": 320,
"name": "Apple Inc.",
"ticker": "AAPL",
"confidence": "0.98",
"isin": "US0378331005",
"openfigi": "BBG000B9XRY4",
"sector": "Technology",
"industry": "Consumer Electronics",
"primaryListing": {
"ticker": "AAPL",
"exchangeCode": "NASDAQ",
"exchangeCountry": "US"
},
"otherListings": [
{ "ticker": "APC", "exchangeCode": "XETRA", "exchangeCountry": "DE" }
]
}
몇몇 필드가 핵심 역할을 합니다.
primaryListing은 기업의 주요 상장으로,exchangeCode와exchangeCountry를 담고 있습니다.otherListings는 모든 부차적 상장을 포함합니다. 이를 통해 애플이 독일 XETRA에서APC로도 거래된다는 것을 알 수 있습니다.isin과openfigi는 전 세계적으로 고유한 식별자입니다. 단순한 티커와 달리 정확히 하나의 증권을 가리키므로, 당신의 데이터와 매칭하기에 이상적입니다.confidence는 이 기사가 정말 이 기업에 관한 것인지 finlight가 얼마나 확신하는지를 알려 줍니다.
정밀하게 모호함 해소하기
단순한 티커가 모호할 때는 쿼리 언어로 범위를 좁히세요. 거래소나 고유 식별자로 필터링할 수 있습니다.
ticker:AAPL AND exchange:NASDAQ
isin:US0378331005
isin이나 openfigi로 필터링하면 모호함이 완전히 사라집니다. 기업이 몇 개의 티커로 거래되든 각
식별자는 단 하나의 증권으로만 해석되기 때문입니다.
실용적인 패턴
포트폴리오나 관심 종목 작업에서는 가장 신뢰하는 식별자로 매칭하세요.
- 티커만 있다면
tickers를 보내고includeEntities를 켠 뒤,primaryListing이 예상한 거래소와 일치하는지 확인하세요. - ISIN이나 OpenFIGI가 있다면 쿼리에서
isin:/openfigi:로 정확히 매칭하세요. - finlight의
companyId를 당신의 레코드와 함께 저장해, 이후의 조회에서 모호함이 없도록 하세요.