Batch Query

Stock SDK provides efficient batch query capabilities for large-scale data fetching.

Get All A-Share Codes

// Get all A-Share stock codes
const codes = await sdk.getAShareCodeList();
console.log(`Total: ${codes.length} stocks`);
// Total: 5000+ stocks

// Codes include exchange prefix by default
console.log(codes[0]); // 'sh600000'

// Without prefix
const codesWithoutPrefix = await sdk.getAShareCodeList(false);
console.log(codesWithoutPrefix[0]); // '600000'

Get All HK Stock Codes

const hkCodes = await sdk.getHKCodeList();
console.log(hkCodes[0]); // '00700'

Get All US Stock Codes

const usCodes = await sdk.getUSCodeList();
console.log(usCodes[0]); // '105.AAPL'

// Without market prefix
const usCodesWithoutPrefix = await sdk.getUSCodeList(false);
console.log(usCodesWithoutPrefix[0]); // 'AAPL'

Batch Get All A-Share Quotes

const allQuotes = await sdk.getAllAShareQuotes({
  // Batch size (default: 500)
  batchSize: 300,
  // Concurrency (default: 7)
  concurrency: 5,
  // Progress callback
  onProgress: (completed, total) => {
    const percent = Math.round(completed / total * 100);
    console.log(`Progress: ${percent}% (${completed}/${total})`);
  },
});

console.log(`Got ${allQuotes.length} stocks`);

Batch Get Specific Quotes

const codes = ['sh600000', 'sz000001', 'sh600519', /* ... more codes */];

const quotes = await sdk.getAllQuotesByCodes(codes, {
  batchSize: 100,
  concurrency: 3,
  onProgress: (completed, total) => {
    console.log(`Progress: ${completed}/${total}`);
  },
});

Batch Get HK/US Quotes

// All HK stock quotes
const hkQuotes = await sdk.getAllHKShareQuotes({
  concurrency: 5,
  onProgress: (c, t) => console.log(`${c}/${t}`),
});

// All US stock quotes
const usQuotes = await sdk.getAllUSShareQuotes({
  concurrency: 5,
  onProgress: (c, t) => console.log(`${c}/${t}`),
});

Performance Tips

1. Adjust Concurrency

Higher concurrency = faster, but may hit rate limits:

// Conservative (slow but stable)
{ concurrency: 3 }

// Balanced (recommended)
{ concurrency: 5 }

// Aggressive (fast but may fail)
{ concurrency: 10 }

2. Adjust Batch Size

Larger batch = fewer requests, but larger payload:

// Small batch (more requests)
{ batchSize: 100 }

// Large batch (fewer requests)
{ batchSize: 500 }

3. Error Handling

try {
  const quotes = await sdk.getAllAShareQuotes({
    concurrency: 5,
    onProgress: (c, t) => console.log(`${c}/${t}`),
  });
} catch (error) {
  console.error('Batch fetch failed:', error);
  // Implement retry logic if needed
}

4. Caching

For frequently accessed data, consider caching:

// Simple in-memory cache
const cache = new Map();

async function getCachedQuotes(codes: string[]) {
  const cacheKey = codes.join(',');
  
  if (cache.has(cacheKey)) {
    const { data, timestamp } = cache.get(cacheKey);
    // Cache valid for 30 seconds
    if (Date.now() - timestamp < 30000) {
      return data;
    }
  }
  
  const quotes = await sdk.getSimpleQuotes(codes);
  cache.set(cacheKey, { data: quotes, timestamp: Date.now() });
  return quotes;
}

Next Steps

• API Documentation for detailed batch API
• Technical Indicators for indicator calculations