Why the CLI's usage timeseries command returns fewer days than requested

The alchemy usage timeseries command in the Alchemy CLI is currently in alpha and has a historical lookback limit based on your plan:

• Free plan: last 1 day

• Pay-As-You-Go plan: last 7 days

• Enterprise plan: last 30 days

If you need a longer historical range than your plan allows, contact our sales team.

If you request a date range that starts further back than your plan's limit allows, the command does not return an error. It returns data for the most recent allowed window instead of the range you asked for. For example, requesting a two-month range on an Enterprise plan will return only the trailing 30 days of data, not the full requested period.

Make sure you're on the latest version of the CLI (the @alchemy/cli npm package), since usage timeseries is a recently added command and older versions may not support it.

Getting multiple months of usage history

If you need multi-month historical usage data for utilization or spend analysis, use the CSV export on the dashboard's Usage page at dashboard.alchemy.com/usage instead of the CLI. This export is broken down by month and product, and is available to Enterprise customers as a self-serve download.

If you have questions about your plan's usage limits or need help with a custom range, contact billing@alchemy.com.