finlight Logo

Friday, June 26, 2026

finlight 金融ニュース API クイックスタート

Finlight - Content Manager
Tutorial

finlight 金融ニュース API クイックスタート

実時間の金融ニュースは雑然としています。数多くのソース、バラバラなフォーマット、構造の欠如、そしてシグナルの不在。finlight はこの情報の奔流を、クリーンで構造化された AI 強化済みのデータに変え、1 回のリクエストで照会できるようにします。しかも各ニュースには感情分析と、その記事が扱う企業情報が付いてきます。

本ガイドは、およそ 5 分で初めての API 呼び出しを完了するところまでご案内します。読み終えるころには、ある銘柄の最新ニュースを取得し、レスポンスを読み解き、実時間ストリームを有効にする方法まで把握できているはずです。

得られるもの

finlight は金融ニュース API であり、同じ強化済みデータを取得するための 4 つの方法を提供します。

  • REST. 必要なときにニュースを照会します（本ガイドの内容）。
  • WebSocket. 記事が公開されると同時に実時間でストリーミングします。
  • Webhooks. ニュースをあなた自身のエンドポイントにプッシュします。
  • MCP サーバー. AI アシスタント（Claude、ChatGPT）にニュースの照会を任せます。

各記事は構造化され、次の情報で強化された状態で返されます。

  • 感情（positive、neutral、または negative）と信頼度スコア。
  • 企業エンティティ： ティッカー、ISIN、取引所の上場情報、セクターと業種。
  • 9 言語および 13 カテゴリ（マーケット、経済、暗号資産、テクノロジーなど）のカバレッジ。

ステップ 1：API キーを取得する

  1. app.finlight.me で無料アカウントを作成します。
  2. ダッシュボードを開き、API キーを生成します。
  3. 安全な場所に保管してください。すべてのリクエストで X-API-KEY ヘッダーに付けて送信します。

無料プランは REST 専用で、テストに最適です。現在の制限や各プランで使える機能については finlight.me/pricing をご覧ください。

ステップ 2：クライアントをインストールする（任意）

素の HTTP でも API を呼び出せますが、公式 SDK は認証、リトライ、型の処理を代わりに行ってくれます。

# TypeScript / Node.js
npm install finlight-client

# Python
pip install finlight-client

素の HTTP のほうがよいですか？このステップは飛ばして構いません。以下の各サンプルには cURL 版も用意してあります。

ステップ 3：初めてのリクエスト

Apple（AAPL） に関する最新記事を取得してみましょう。これは tickers フィルターを使って POST /v2/articles を呼び出します。

# cURL
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
  }'

// TypeScript
import { FinlightApi } from 'finlight-client';

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

const response = await client.articles.fetchArticles({
  tickers: ['AAPL'],
  pageSize: 5,
});

console.log(`Got ${response.articles.length} articles`);
for (const article of response.articles) {
  console.log(article.publishDate, article.sentiment, article.title);
}

# Python
from finlight_client import FinlightApi, ApiConfig
from finlight_client.models import GetArticlesParams

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

response = client.articles.fetch_articles(
    GetArticlesParams(tickers=["AAPL"], pageSize=5)
)

print(f"Got {len(response.articles)} articles")
for article in response.articles:
    print(article.publishDate, article.sentiment, article.title)

ステップ 4：レスポンスを読み解く

レスポンスはページネーション付きのエンベロープです。各記事にはソース、見出し、要約、そして強化情報が含まれます。

{
  "status": "ok",
  "page": 1,
  "pageSize": 5,
  "articles": [
    {
      "link": "https://www.example.com/apple-earnings",
      "title": "Apple beats expectations on services revenue",
      "summary": "Apple reported quarterly results above analyst estimates...",
      "source": "www.example.com",
      "publishDate": "2026-06-18T14:32:00.000Z",
      "language": "en",
      "sentiment": "positive",
      "confidence": "0.93",
      "images": ["https://www.example.com/img/apple.jpg"]
    }
  ]
}

2 つのフラグで、必要なときにより多くの情報をリクエストできます。

  • includeContent: true は要約だけでなく、スクレイピングした記事本文の全文を返します。
  • includeEntities: true は各記事について companies 配列（ティッカー、ISIN、取引所の上場情報）を返します。

ヒント：軽量なリスト表示では includeContent と includeEntities をオフのままにし、詳細が必要なときだけオンにしましょう。レスポンスが小さく、速くなります。

ステップ 5：実時間にする（準備ができたら）

最初はポーリングでも問題ありませんが、ライブのダッシュボードや取引シグナルには、ニュースが公開された瞬間にプッシュしてほしいはずです。それが WebSocket です。フィルターは同じで、ポーリングは不要です。

// TypeScript
import { FinlightApi } from 'finlight-client';

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

client.websocket.connect({ tickers: ['AAPL'] }, (article) => {
  console.log('New article:', article.sentiment, article.title);
});

WebSocket ストリーミングは有料プランで利用できます。詳しい設定方法は WebSocket ドキュメント をご覧ください。

次のステップ

これで初めての呼び出しを終え、データの形を把握できました。ここから先は次のとおりです。

  • 完全な API ドキュメントを読む で、各エンドポイント、パラメータ、そして WebSocket と webhook のガイドを確認しましょう。
  • 高度なフィルタリングを学ぶ。 ティッカー、国、カテゴリ、そしてクエリ言語を組み合わせて、欲しいニュースを正確に取得します*（記事は近日公開予定）*。
  • プランを比較する ——無料枠を超えて使う準備ができたときに。

ご質問は？Discord に参加するか、 info@finlight.me までメールでお問い合わせください。

無料で構築を始める →

Back to blog