US Stock Quotes

Get real-time quotes for US stocks.

getUSQuotes

const quotes = await sdk.getUSQuotes(['AAPL', 'MSFT', 'BABA']);

Parameters

Parameter	Type	Required	Description
codes	string[]	Yes	US stock tickers

Return Type

interface USQuote {
  code: string;           // Stock code
  name: string;           // Stock name
  price: number;          // Current price (USD)
  change: number;         // Price change
  changePercent: number;  // Change percentage
  volume: number;         // Trading volume
  amount: number;         // Trading amount
  high: number;           // Day high
  low: number;            // Day low
  open: number;           // Open price
  prevClose: number;      // Previous close
  time: string;           // Quote time
  high52w: number;        // 52-week high
  low52w: number;         // 52-week low
  pe: number;             // P/E ratio
  marketCap: number;      // Market cap
}

getUSCodeList

Get all US stock codes.

Signature

getUSCodeList(includeMarket?: boolean): Promise<string[]>

Parameters

Parameter	Type	Default	Description
includeMarket	boolean	true	Include market prefix (e.g. 105.)

Example

// With market prefix (default)
const codes = await sdk.getUSCodeList();
// ['105.MSFT', '105.AAPL', '106.BABA', ...]

// Without market prefix
const pureCodes = await sdk.getUSCodeList(false);
// ['MSFT', 'AAPL', 'BABA', ...]

console.log(`Total ${codes.length} US stocks`);

getAllUSShareQuotes

Get all US stock quotes.

const allQuotes = await sdk.getAllUSShareQuotes({
  concurrency: 5,
  onProgress: (completed, total) => {
    console.log(`Progress: ${completed}/${total}`);
  },
});

Example

import { StockSDK } from 'stock-sdk';

const sdk = new StockSDK();

// Get US stock quotes
const quotes = await sdk.getUSQuotes(['AAPL', 'MSFT', 'GOOGL', 'BABA']);
quotes.forEach(q => {
  console.log(`${q.name}: USD ${q.price} (${q.changePercent}%)`);
});
// Apple Inc.: USD 180.00 (1.20%)
// Microsoft Corp.: USD 380.00 (0.80%)

// Get US stock K-line
const klines = await sdk.getUSHistoryKline('105.AAPL', {
  period: 'daily',
  startDate: '20240101',
});
console.log(`Got ${klines.length} K-line records`);