メインコンテンツへスキップ
Benzinga ウェブソケット API のドキュメントへようこそ。このガイドでは、Benzinga のリアルタイムデータストリームへのアクセスを開始する方法を説明します。これにより、マーケットのリアルタイム気配値、約定、ニュースなどの重要なインサイトを含む金融データの継続的な更新を購読して受信できるようになります。

​
ウェブソケットエンドポイント

すべてのウェブソケット接続は、以下のエンドポイントを使用して確立できます。 
wss://api.benzinga.com

​
認証

Benzinga ウェブソケット API では Bearer 認証が必要です。ウェブソケット接続を開始する際は、接続 URL のクエリパラメータとして、次の形式で API トークンを指定してください。 token クエリパラメータに、token: <token> という形式で必ず API トークンを含める必要があります。 API トークンの取得と管理の詳細については、Authentication ページを参照してください。

​
ストリームの購読

接続が確立されたら、株価気配、約定データ、ニュース更新など、要件に応じて特定のデータストリームを購読できます。各購読には、一意の識別子と、データ種別に応じた特定のパラメータが必要です。

​
購読メッセージの例

リアルタイム株価ストリームを購読するには、以下の形式の JSON メッセージを送信します。 
{
  "action": "subscribe",
  "symbol": "AAPL",
  "type": "quote"
}

​
ハートビートメカニズム

健全な接続を維持し、クライアントとサーバー間の同期を確保するために、Benzinga のウェブソケット API にはハートビートメカニズムが実装されています。

​
クライアント側ハートビート

  • ping メッセージをプレーンテキストフレームとして送信した場合（例: 文字列 ping）、サーバーはプレーンテキストの pong メッセージで応答します（例: 文字列 pong）。
  • これは、接続が引き続き有効で応答していることを確認するために使用できます。

​
例

  • クライアントは ping を送信
  • サーバーは pong と応答

​
サーバー側のハートビート

  • サーバーは接続がアクティブな状態であることを確認するため、10秒ごとにクライアントへ ping フレームを自動送信します。
  • クライアントはこの ping フレームに応答する必要があります（ほとんどのウェブソケットライブラリでは自動的に処理されます）。

​
ハートビートの処理

  • ほとんどのウェブソケットクライアントライブラリ（JavaScript、Python、Go など）は、サーバーから送信される ping を自動的に処理し、pong で応答します。
  • ただし、独自にウェブソケットクライアントを実装する場合は、接続が切断されるのを防ぐために、サーバーの ping フレームに正しく応答するようにしてください。

​
レート制限

Benzinga API には、不正利用の防止とサービスの安定性を維持するためのレート制限があります。1 つの API トークンにつき、同時に許可される接続は 1 つのみです。レート制限を超過した場合は、エラーレスポンスが返されます。
このガイドが Benzinga API の利用開始に役立てば幸いです。ご不明な点がありましたら、遠慮なくサポートチームまでお問い合わせください。