finlight Logo

Friday, June 26, 2026

finlight API でできること：完全ガイド

Finlight - Content Manager
Guide

finlight API でできること

finlight は金融ニュース API です。絶え間なく流れ込む雑然としたグローバル市場ニュースを、クリーンで構造化された AI 強化済みのデータに変換し、照会したり、ストリーミングで受け取ったり、自分にプッシュしてもらったりできるようにします。自分でウェブサイトをスクレイピングして HTML を解析する代わりに、感情分析、企業タグ付け、豊富なフィルタリングが組み込まれた 1 つの一貫したインターフェースが手に入ります。

このページは地図です。finlight が何を提供するのか、それを取得する 4 つの方法、そして次にどこへ進めばよいかを扱います。とにかく最初の呼び出しをしたいだけなら、まず クイックスタートガイド から始めてください。

すべての記事に含まれるもの

finlight が返す各記事は、単なる見出しとリンクではなく、構造化され強化されています。次の情報が得られます。

  • コアフィールド： タイトル、要約、全文（任意）、ソース、公開日、言語、画像。
  • 感情： 各記事は信頼度の値とともに positive、neutral、または negative に評価されるため、すべての記事を読まずに論調を定量化できます。
  • 企業エンティティ： finlight は記事が扱う企業をタグ付けし、実際の識別子に解決します。ティッカー、ISIN、OpenFIGI、セクターと業種、さらにその企業が上場しているすべての取引所（主要・副次の上場情報それぞれに取引所コードと国を付与）。
  • 分類： 各記事には影響を受ける国と、13 カテゴリのうち 1 つ以上がタグ付けされます。

これにより、「今週 AAPL に対する感情はどう変化したか？」や「ある企業群に影響するすべての規制ニュースを見せて」といった問いに、自分で NLP パイプラインを構築することなく答えられます。

データを取得する 4 つの方法

同じ強化済みデータは、4 つの配信方式で利用できます。自分のワークロードに合ったものを選んでください。

REST API

必要なときにニュースを照会します。リクエストを送ると、一致する記事のページが返ってきます。検索、過去データのバックフィル、定時更新のダッシュボード、その他あらゆるリクエスト/レスポンス型のワークフローに最適です。高度な POST /v2/articles エンドポイントは完全なフィルターセットをサポートし、さらに URL で単一記事を取得するエンドポイントや、利用可能なソースを一覧表示するエンドポイントもあります。REST ドキュメント をご覧ください。

WebSocket

記事が公開されると同時に、ポーリングなしで実時間にストリーミングします。2 つの形式があります。完全な強化（感情とエンティティ）を含む拡張ストリームと、基本情報をすばやく取得したいときのための軽量な raw ストリームです。ライブダッシュボード、取引シグナル、モニタリングに最適です。WebSocket ドキュメント をご覧ください。

Webhooks

finlight に、ニュースがフィルターに一致した瞬間にあなた自身のエンドポイントへプッシュさせます。強化版と raw 版が利用でき、配信には署名が付くため検証できます。イベント駆動のパイプライン、アラート、ポーリングなしで動かしたい自動化に最適です。webhook ドキュメント をご覧ください。

MCP サーバー

Model Context Protocol を通じて finlight を Claude や ChatGPT のような AI アシスタントに接続し、自然な言葉で市場ニュースを尋ねます。コードを書かずに行うリサーチやアドホックな分析に最適です。AI アシスタントのドキュメント をご覧ください。

おおまかな目安：オンデマンドなら REST、ライブなら WebSocket、プッシュ自動化なら webhooks、AI 駆動のリサーチなら MCP。専用の比較ガイドは近日公開予定です。

精密なフィルタリング

finlight は、欲しいニュースを正確に取得することを中心に設計されています。REST、WebSocket、webhooks のいずれでも、次の条件でフィルタリングできます。

  • ティッカー： AAPL や NVDA などの企業。
  • 国： ISO 国コード。特定の市場に絞り込みます。
  • カテゴリ： 13 カテゴリのいずれか。markets や economy から crypto、regulation、energy まで。
  • ソース： 特定のメディアを含めたり除外したり、あるいは追加のソースをオプトインしたりします。
  • 日付範囲と完全なクエリ言語。ブール演算子とフィールドフィルターをサポートします。例： (ticker:AAPL OR ticker:NVDA) AND NOT source:reuters.com。

完全なクエリ構文については 高度なクエリのドキュメント をご覧ください。

グローバルで多言語のカバレッジ

finlight は 9 言語のニュースをカバーします。英語、簡体字中国語、ヒンディー語、スペイン語、日本語、韓国語、ポルトガル語、アラビア語、ロシア語です。国とカテゴリのフィルターと組み合わせれば、英語のみの報道に頼らず、ある市場をその市場自身の言語と地域で追跡できます。

開発者のために作られている

finlight は素の HTTP で呼び出すこともできますし、公式 SDK を使うこともできます。

  • Node / TypeScript： npm install finlight-client
  • Python： pip install finlight-client

どちらも REST と WebSocket API をラップし、認証とリトライを処理して、型付きのオブジェクトを返します。認証は、ダッシュボード で生成したキーを使い、すべてのリクエストに X-API-KEY ヘッダーを 1 つ付けるだけです。最小限のリクエストは次のようになります。

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 をご覧ください。

構築を始める

無料の API キーを取得する →

Back to blog