レート制限とクォータ

すべての finlight API キーはプランに紐づいており、プランによって使用制限とアクセスできる機能が決まります。制限は API キーごとにリアルタイムで適用されます。このページでは各制限と各プランがアンロックする内容を説明します。お使いのプランの正確な数値は、finlight ダッシュボードまたは料金ページをご覧ください。

4 つの使用制限

Name
月間リクエストクォータ
Description
各 REST リクエストは、月間割り当てから1 つのリクエストを消費します。カウンターは各請求期間の開始時にリセットされます。超過すると 429 が返り、メッセージは "Exceeded token limit of N for the current period." です。
Name
バーストレート
Description
10 秒あたりのリクエスト数に対する短期的な制限で、急増を平滑化します。これを定義しているプランでのみ適用されます。超過すると 429 が返り、メッセージは "Exceeded rate limit of N requests per 10 seconds." です。約 10 秒待ってから再試行してください。
Name
WebSocket 接続数
Description
キーで確立できる同時 WebSocket 接続の最大数。制限を超える新規接続は拒否されます。別の上限により、期間あたりにストリーミングされるメッセージの総数も制限されます。WebSocket には有料プランが必要です。
Name
Webhook 配信クォータ
Description
請求期間あたりの webhook 配信の最大数。付随する制限により、作成できる webhook の数も制限されます。配信クォータを使い切ると、次の期間まで配信は一時停止されます。

プランによってアンロックされる機能

生の制限に加えて、プランは利用可能な機能を制御します。プランに含まれていない機能をリクエストすると、(REST の場合) 403 が返るか、(webhook/WebSocket の場合) データが単に省略されます。

Name
履歴データ
Description
どこまで遡って照会できるかはプランによって異なります。Free および Pro Light プランは現在、およそ直近 1 か月の記事をカバーします。上位プランではより深い履歴をアンロックできます。from / to の日付フィルターを使って、プランの期間内で照会してください。期間外の日付に対するリクエストは、その範囲については結果を返しません。各プランの正確な履歴期間については料金ページをご覧ください。
Name
感情分析
Description
記事の sentiment および confidence フィールドを含みます。付与されていない場合はペイロードから除去されます。
Name
企業エンティティ
Description
companies 配列（AI が解決したティッカー、ISIN、取引所など）を含み、includeEntities を有効にします。付与されていない場合は除去されます。
Name
カスタムソース
Description
既定のセットに追加された、プライベートまたは顧客固有のニュースソース。上位 / エンタープライズプランで利用可能です。

適用の仕組み

キーごとにリアルタイム。 各リクエストでカウンターが加算され、制限を超えた時点で API はただちに 429 を返します。
ダッシュボードの使用量はリアルタイムではありません。 finlight ダッシュボードに表示される使用量はおよそ1 日に 1 回集計され、前日までのアクティビティを反映します。リアルタイムのカウンターではありません。適用はリアルタイムであるため、今日の実際の残りクォータはダッシュボードの表示と異なる場合があります。
月次カウンターのリセットは請求期間の開始時に行われ、クォータの 429 は自動的に解消されます。
レート制限ヘッダーはありません。 finlight は現在 Retry-After や X-RateLimit-* ヘッダーを送信しません。バーストの 429 は「約 10 秒待つ」、月次の 429 は「この期間のクォータに達した」と捉えてください。エラーとステータスコードを参照してください。

プラン

プラン	典型的な用途
Free	評価および少量の利用。REST のみ（WebSocket なし）。
Pro (Light / Standard / Scale)	クォータが段階的に増える本番ワークロード。WebSocket、webhook、より充実したエンリッチメントを含む。
Enterprise	大量利用、カスタムソース、個別対応の制限。

正確な数値制限（月間トークン、バーストレート、WebSocket 接続数、webhook クォータ）と各プランの機能セットは料金の一部であり、変更される場合があります。常に finlight ダッシュボードで現在のプランの制限を確認するか、料金ページでプランを比較してください。より高い制限やカスタムソースが必要ですか？お問い合わせください。

制限に達したとき

バースト 429 → 約 10 秒一時停止してから続行します。
月間クォータ 429 → 今期のリクエストを使い切りました。アップグレードするか、リセットをお待ちください。
WebSocket 接続が拒否された → 同時接続の上限に達しています。アイドル状態の接続を閉じてください（WebSocket クイックスタートの takeover オプションを参照）。
Webhook 配信の一時停止 → 今期の配信クォータを使い切りました。次の期間に再開します。
機能に対する 403 → その機能はプランに含まれていません。上の表を参照してください。

正確なエラー本文については、エラーとステータスコードを参照してください。