Skip to content

Releases: fcsapi/websocket-js

4.0.0

25 Dec 11:01

Choose a tag to compare

FCS WebSocket JavaScript v4.0.0

First Release - JavaScript & Node.js WebSocket client for real-time Forex, Crypto, and Stock market data from FCS API.

What's New

Initial release with complete WebSocket implementation:

  • Universal Library - Works in both Browser (Vanilla JS) and Node.js
  • Real-time Streaming - Live OHLCV and Ask/Bid price updates (1-5 second updates)
  • Multi-Market Support - Forex (FX:EURUSD), Crypto (BINANCE:BTCUSDT), Stocks (NASDAQ:AAPL)
  • Auto-Reconnect - Automatic reconnection with configurable retry limit
  • Tab Visibility - Smart disconnect when browser tab is hidden (bandwidth optimization)
  • Heartbeat Mechanism - Built-in WebSocket keep-alive
  • Zero Dependencies - No external libraries required for browser
  • npm & CDN - Available via npm package or CDN

Installation

npm (Recommended):

npm install fcsapi-websocket

Browser (CDN):

<script src="https://cdn.jsdelivr.net/gh/fcsapi/websocket-js/fcs-client-lib.js"></script>

Quick Start

Browser:

<script src="fcs-client-lib.js"></script>
<script>
    const client = new FCSClient('YOUR_API_KEY');
    
    client.onmessage = (data) => {
        if (data.type === 'price' && data.prices) {
            console.log(`${data.symbol}: $${data.prices.c}`);
        }
    };
    
    client.connect().then(() => {
        client.join('BINANCE:BTCUSDT', '1D');
    });
</script>

Node.js:

const FCSClient = require('fcsapi-websocket');
const client = new FCSClient('YOUR_API_KEY');

client.onmessage = (data) => {
    if (data.type === 'price') {
        console.log(data.symbol, data.prices);
    }
};

client.connect().then(() => client.join('FX:EURUSD', '1D'));

Examples Included

  • forex-example.html - Real-time Forex prices (EUR/USD, GBP/USD)
  • crypto-example.html - Cryptocurrency prices (Bitcoin, Ethereum)
  • stock-example.html - Stock prices (AAPL, TSLA, GOOGL)

Supported Markets

  • Forex: FX:EURUSD, FX:GBPUSD, FX:USDJPY
  • Crypto: BINANCE:BTCUSDT, BINANCE:ETHUSDT
  • Stocks: NASDAQ:AAPL, NYSE:TSLA

Timeframes

1m, 5m, 15m, 30m, 1h, 4h, 1D, 1W, 1M

Demo Access

Test without signup: fcs_socket_demo

Requirements

  • Browser: Modern browser with WebSocket support
  • Node.js: v12.0 or higher

Documentation

Get API Key

Sign up for free at https://fcsapi.com