Skip to content
Alchemy Logo

Get usage time series

POST
https://admin-api.alchemy.com/v1/usage/time-series

Retrieves usage over time in hourly or daily buckets. You can filter by product, app, network, method, and request type. You can group by up to three dimensions.

When more data remains, the response includes cursor. Send that value as cursor on the next request, with the same startTime and filters, until cursor is absent. endTime may be omitted on later pages; the cursor keeps the original range. Each query may span at most 30 days. Cursors expire 15 minutes after they are issued. Cursor follow-up pages are exempt from the distinct-payload rate limit.

See Time series products for products values and units.

Headers

stringrequired

Access key.

⚠️ This is not an app API key. Learn how to create an access key.

Request Body

Responses

200

Retrieved usage time series successfully

400

Invalid input

401

Requires authentication

403

Forbidden

404

Not found

Was this page helpful?