Add pagination support

[karlwaldman]

Overview

Add automatic pagination for endpoints that return large result sets.

Implementation

Add optional paginate: true parameter to historical endpoints that automatically fetches all pages and returns combined results.

Endpoints to Update

• getHistoricalPrices() - May return large datasets for long date ranges

Example API

const allPrices = await client.getHistoricalPrices({
  commodity: 'WTI_USD',
  startDate: '2024-01-01',
  endDate: '2024-12-31',
  paginate: true  // Auto-fetch all pages
});

Priority

P2 - Nice to have - Improves UX but not critical

Related

Mentioned in Walk phase requirements in PRD