API Documentation

Guide

Overview

What this is

WebSocket feeds on api.financialdata.online push market updates for quotes, trade prices, and OHLCV on the tickers you subscribe to—suited for dashboards, alerts, and live charts. Each enabled feed documents its path, subscribe payload, and response fields 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 stock OHLCV updates, ws/forex/C/ for forex quotes).

Suggested flow

  1. Basics Read (JWT on the upgrade request).
  2. Feed Pick a feed in the sidebar and open its reference for path, fields, and examples.
  3. Connect Open the WebSocket with Authorization: Bearer <jwt> (and Origin: https://api.financialdata.online for CLI clients), then send {"action":"subscribe","tickers":["AAPL"]}.
  4. REST For on-demand snapshots and historical 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.