빠른 시작

finlight.me WebSocket API를 사용하면 금융 뉴스 기사가 게시되는 즉시 실시간으로 받아볼 수 있습니다. 새 데이터를 가져오기 위해 주기적인 폴링이 필요한 REST API와 달리, WebSocket API는 새로 게시된 기사를 실시간으로 푸시하므로 반복 요청 없이 최신 상태를 유지할 수 있습니다.

실시간 업데이트: 연결되면 먼저 쿼리와 일치하는 최신 기사를 받습니다. 그 후, 쿼리와 일치하는 새로 게시된 기사가 자동으로 전송됩니다.
연속 스트리밍: 필요한 만큼 연결을 유지하세요. 각 요금제에는 한 달 내내 열어 둘 수 있는 병렬 WebSocket 연결이 고정된 수만큼 포함됩니다. 사용량 기반 요금은 없으며, 요금제에서 허용하는 동시 연결 수로만 제한됩니다.
감성 분석: 기사에는 감성 데이터가 함께 제공되어 시장 분위기를 빠르게 파악하는 데 도움이 됩니다.

가입하고 무료 API 키 받기

아직 하지 않았다면 finlight 대시보드에서 가입하여 무료 API 키를 받으세요. 이 키는 REST API와 마찬가지로 WebSocket 연결을 인증하는 데 사용됩니다.

클라이언트 선택

finlight.me WebSocket API에 연결하려면 당사의 Node.js 또는 Python 클라이언트 라이브러리를 사용할 수 있습니다. 이 라이브러리는 연결, 인증, 연결 유지(ping/pong) 메커니즘의 처리를 단순화합니다.

# Install the Node.js client library via npm
npm install finlight-client

연결하고 실시간 기사 받기

API 키와 선택한 클라이언트가 있으면 이제 WebSocket 연결을 설정할 수 있습니다. 연결하면 쿼리와 일치하는 가장 최근 기사를 즉시 받고, 이어서 새 기사가 들어오는 대로 받습니다. 클라이언트 라이브러리가 인증과 ping/pong 연결 유지 메커니즘을 대신 처리합니다.

WebSocket

wss://wss.finlight.me

import { FinlightApi } from 'finlight-client'

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

client.websocket.connect(
  { query: 'nvidia', language: 'en' },
  (article) => {
    console.log('New article received:', article)
  },
)

이 연결은 필요한 만큼 열려 있으며, 쿼리와 일치하는 새 기사를 지속적으로 전송합니다. 요금은 연결 시간을 기준으로 부과되므로, 더 이상 업데이트가 필요 없을 때는 연결을 끊는 데 유의하세요.

연결 한도 관리

각 요금제에는 고정된 수의 병렬 WebSocket 연결이 포함됩니다. 한도에 도달한 상태에서 다른 연결을 열려고 하면 takeover 옵션을 활성화하여 가장 오래된 연결을 자동으로 닫을 수 있습니다:

import { FinlightApi } from 'finlight-client'

const client = new FinlightApi(
  {
    apiKey: 'YOUR_API_KEY',
  },
  {
    // WebSocket-specific options
    takeover: true, // Automatically close oldest connection when limit is reached (default: false)
  },
)

client.websocket.connect(
  { query: 'nvidia', language: 'en' },
  (article) => {
    console.log('New article received:', article)
  },
)

takeover: true를 설정하면 연결 한도에 도달한 경우 새 연결이 가장 오래된 기존 연결을 자동으로 대체합니다. 이는 개발 중이거나 애플리케이션을 재배포할 때 유용합니다. 프로덕션에서는 연결을 명시적으로 제어하기 위해 기본값(takeover: false)을 유지하는 것이 좋습니다.

다음 단계

WebSocket API에 성공적으로 연결하고 실시간 기사를 받았으니, 도움이 될 만한 몇 가지 다음 단계를 소개합니다:

받는 기사를 좁히기 위해 source 또는 extended 쿼리로 필터링하는 것을 살펴보세요.
다양한 회사, 지수 또는 금융 주제를 추적하기 위해 필요에 따라 query 매개변수를 조정하세요.
무료 등급 한도 내에 머무르도록 finlight 대시보드에서 사용량과 연결 시간(분)을 확인하세요.