API Documentation

Guide

Overview

What this is

Streaming US stock market data over WebSockets on the API host api.financialdata.online (same origin as REST). Each enabled feed has its own path, subscribe payload, and response schema in the reference panel.

URLs to know

Portal (website)
https://financialdata.online — sign up, pricing, and account area.
WebSocket base
wss://api.financialdata.online/ — use wss:// (not https://) for the handshake.
Example feed
wss://api.financialdata.online/ws/stocks/AM/

Paths match the feed entries in the sidebar (e.g. ws/stocks/AM/ for minute aggregates).

Suggested flow

  1. Basics Read (JWT on the upgrade request).
  2. Feed Pick a feed in the sidebar and open its reference for path, stream fields, and examples.
  3. Connect Open the WebSocket with Authorization: Bearer <jwt>, then send {"action":"subscribe","tickers":["AAPL"]}.
  4. REST For HTTP market data, switch to the REST API tab — it uses X-Request-Token, not JWT.

Client protocol

  1. Subscribe {"action": "subscribe", "tickers": ["AAPL", "MSFT"]}
  2. Unsubscribe {"action": "unsubscribe", "tickers": ["AAPL"]}
  3. Data JSON market updates (ev, sym, …) — field definitions are listed per feed in the reference.
Limits. Up to 50 ticker subscriptions per connection; one connection per feed endpoint per session is recommended.