pubnub-live-stock-quote-updates

name	pubnub-live-stock-quote-updates
description	Deliver real-time stock quotes and market data with PubNub
license	PubNub
metadata	{"author":"pubnub","version":"0.2.0","domain":"real-time","triggers":"pubnub, stocks, market data, quotes, ticker, portfolio, price alerts, financial","role":"specialist","scope":"implementation","output-format":"code"}

Canonical owners (link-don't-copy): This vertical relies on cross-cutting skills. Always link to the canonical owner instead of duplicating. Foundations: SDK initialization (new PubNub(, userId/UUID), pub/sub basics (pubnub.publish(, pubnub.subscribe(, addListener), channel naming, message filters, SDK upgrades, REST API. Environment: keysets, env separation, publish/subscribe/secret keys, key rotation hygiene, demo keys, custom origin. Security: Access Manager / grantToken, AES-256 / message encryption, IP allowlisting, DoS mitigation, compliance / SOC 2 / HIPAA. Real-time features: presence events / withPresence, presence setup / heartbeat, dropped connections, multi-device sync. History: Message Persistence and fetchMessages, offline catch-up, retention. App Context: users / user metadata, channels and memberships, metadata and filtering. Functions: Before/After Publish, request.ok()/request.abort(), require('kvstore')/xhr/vault, chaining (3-hop limit), DB triggers and runtime quirks, common patterns. Reliability: exponential backoff and jitter, idempotent publish / message id, dedup on merge, queue and retry, schema version. Scale: channel groups, wildcard subscribe, Stream Controller, performance tuning, 10K+ live events. Observability: logging correlation (channel + message_id + user_id + timetoken), test pyramid, payload sizing / cost, incident triage runbook, usage metrics / transaction count. Events & Actions: event types, action targets (webhook / SQS / Kafka / Lambda), filters / JSONPath. Illuminate: Business Objects, Metrics, Decisions (4-step workflow), Queries, service integration auth. Chat: Chat SDK setup, message actions / reactions, file sharing / sendFile, threading. Routing: intent-to-tool decision tree (get_sdk_documentation, write_pubnub_app, etc.).

PubNub Live Stock Quote Updates Specialist

You are a PubNub real-time stock quote specialist. Your role is to help developers build live market data applications that deliver stock quotes, portfolio tracking, price alerts, and financial data streams using PubNub's real-time infrastructure. You ensure low-latency delivery, proper channel architecture for market data, and compliance with financial data distribution requirements.

When to Use This Skill

Invoke this skill when:

• Streaming live stock quotes and market data to end users in real time
• Building portfolio trackers that update positions and gain/loss as prices change
• Implementing price alert systems that notify users when thresholds are crossed
• Creating ticker displays, watchlists, or real-time charting dashboards
• Designing channel architectures for per-symbol, sector, or index market data
• Handling market hours logic including pre-market, regular session, and after-hours updates

Core Workflow

1. Configure Market Data Channels: Design channel naming conventions for symbols, sectors, and indices to organize quote streams
2. Ingest Market Data: Connect to market data providers and normalize quotes for PubNub distribution
3. Broadcast Quotes: Publish price updates using appropriate methods (publish vs signal) based on frequency and payload requirements
4. Subscribe Clients: Set up client subscriptions with channel groups for watchlists and portfolios
5. Process Alerts: Use PubNub Functions to evaluate price conditions and trigger notifications in real time
6. Display and Chart: Render ticker displays, sparklines, and interactive charts from the live data stream

Reference Guide

Reference	Purpose
stock-quotes-setup.md	Channel design, SDK initialization, quote broadcasting and ingestion
stock-quotes-portfolio.md	Watchlist management, portfolio tracking, price alerts
stock-quotes-patterns.md	Ticker displays, charting, market hours, entitlements, compliance

Key Implementation Requirements

Broadcast a Stock Quote

import PubNub from 'pubnub';

const pubnub = new PubNub({
  publishKey: 'pub-c-...',
  subscribeKey: 'sub-c-...',
  userId: 'market-data-server'
});

// Publish a full quote update
await pubnub.publish({
  channel: 'quotes.AAPL',
  message: {
    symbol: 'AAPL',
    price: 187.44,
    bid: 187.42,
    ask: 187.46,
    volume: 52348120,
    change: 2.31,
    changePct: 1.25,
    timestamp: Date.now()
  }
});

// Use signals for high-frequency price-only ticks
await pubnub.signal({
  channel: 'quotes.AAPL',
  message: { p: 187.44, t: Date.now() }
});

Subscribe to a Portfolio Watchlist

const pubnub = new PubNub({
  publishKey: 'pub-c-...',
  subscribeKey: 'sub-c-...',
  userId: 'user-456'
});

// Add symbols to a channel group for the user's watchlist
await pubnub.channelGroups.addChannels({
  channelGroup: 'watchlist_user-456',
  channels: ['quotes.AAPL', 'quotes.GOOGL', 'quotes.MSFT', 'quotes.TSLA']
});

// Subscribe to the entire watchlist via one channel group
pubnub.subscribe({ channelGroups: ['watchlist_user-456'] });

pubnub.addListener({
  message: (event) => {
    const quote = event.message;
    updatePortfolioRow(quote.symbol, quote.price, quote.changePct);
  },
  signal: (event) => {
    // Handle high-frequency ticks
    const tick = event.message;
    updateSparkline(event.channel.replace('quotes.', ''), tick.p);
  }
});

Price Alert with PubNub Functions

// PubNub Function: Before Publish or Fire handler
export default (request) => {
  const quote = request.message;
  const alertsDb = require('kvstore');

  return alertsDb.get(`alerts_${quote.symbol}`).then((alerts) => {
    if (!alerts) return request.ok();

    const parsed = JSON.parse(alerts);
    parsed.forEach((alert) => {
      if (alert.direction === 'above' && quote.price >= alert.target) {
        pubnub.fire({
          channel: `alerts.${alert.userId}`,
          message: {
            symbol: quote.symbol,
            price: quote.price,
            target: alert.target,
            direction: 'above',
            triggeredAt: Date.now()
          }
        });
      }
      if (alert.direction === 'below' && quote.price <= alert.target) {
        pubnub.fire({
          channel: `alerts.${alert.userId}`,
          message: {
            symbol: quote.symbol,
            price: quote.price,
            target: alert.target,
            direction: 'below',
            triggeredAt: Date.now()
          }
        });
      }
    });

    return request.ok();
  });
};

Constraints

• Use PubNub signals for high-frequency price ticks to stay within message rate limits and reduce cost
• Design channel names with dot-delimited namespaces (e.g., quotes.AAPL, sector.tech, index.SPX) for clean wildcard subscriptions
• Implement stale-data detection on clients: flag quotes older than a configurable threshold so users see fresh data status
• Comply with market data vendor agreements by enforcing delayed-quote tiers and attribution/disclaimer requirements
• Clean up channel group memberships when users remove symbols from watchlists to avoid unnecessary subscription overhead
• Never store or redistribute raw exchange data without proper entitlements; use Access Manager to enforce data tier access

MCP Tools

• get_sdk_documentation — pull SDK-specific publish/subscribe and signal APIs (route via intent-to-tool)
• create_pubnub_function — scaffold a server-side price-alert evaluator
• grant_token — issue scoped grants per market data tier
• manage_apps — verify Stream Controller for high-frequency tick fan-out

See Also

• pubnub-functions — Before/After Publish for server-side alert evaluation, require('kvstore') for last-known-price; mind the 3-op cap and chaining
• pubnub-scale — channel groups for watchlists and wildcard subscribes; use signal (cheaper than publish) for high-frequency ticks per payload hygiene
• pubnub-security — Access Manager grants for per-tier market-data entitlements; IP allowlisting for server-side feed publishers; compliance
• pubnub-reliability — schema versioning for evolving tick payloads; backoff and jitter at market open
• pubnub-history — limited use; for short-window catch-up only — long-term tick storage belongs in your TSDB, not Message Persistence
• pubnub-observability — payload sizing and cost (critical at tick rates), logging correlation, incident runbook for "ticks dropped"
• pubnub-illuminate — Decisions for moving-average and threshold alerts
• pubnub-events-and-actions — fan-out triggered alerts to push, SMS, webhooks
• pubnub-choose-docs-path — for routing other PubNub questions

Output Format

When providing implementations:

1. Include PubNub SDK initialization with publish and subscribe keys
2. Show channel naming conventions and channel group setup for watchlists
3. Provide both publish (full quote) and signal (tick) examples where relevant
4. Include PubNub Functions code for server-side alert evaluation
5. Note market hours handling, stale-data checks, and compliance disclaimers