Live Spreads API Documentation

// JavaScript - Market Status Detection
function processSpreadData(spreads) {
  const openMarkets = [];
  const closedMarkets = [];
  
  spreads.forEach(spread => {
    // Market is OPEN when market_status field is missing/undefined
    if (!spread.market_status && typeof spread.spread === 'number') {
      openMarkets.push({
        ...spread,
        displaySpread: spread.spread_points + ' points',
        displayBid: spread.bid.toFixed(spread.digits),
        displayAsk: spread.ask.toFixed(spread.digits),
        isOpen: true
      });
    } else {
      // Market is CLOSED when market_status field is present
      const statusMessages = {
        'Rollover': 'Market temporarily closed for rollover',
        'Weekend_Market_Closed': 'Markets closed for weekend',
        'Early_Market_Closing': 'Market closed early today',
        'Holiday_Market_Close': 'Markets closed for holiday'
      };
      
      closedMarkets.push({
        ...spread,
        displayMessage: statusMessages[spread.market_status] || 'Market closed',
        rawStatus: spread.market_status,
        isOpen: false,
        // digits and point are still numeric even when closed
        digits: spread.digits,
        point: spread.point
      });
    }
  });
  
  // Return open markets first, then closed
  return [...openMarkets, ...closedMarkets];
}

// Example usage with proper type checking
function displaySpread(spread) {
  if (!spread.market_status) {
    // Market is open - safe to use numeric values
    return `${spread.symbol}: ${spread.spread_points} points (Bid: ${spread.bid}, Ask: ${spread.ask})`;
  } else {
    // Market is closed - show status message
    return `${spread.symbol}: Market closed (${spread.market_status})`;
  }
}