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 one dimension.

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

POST/v1/usage/time-series

curl --request POST \  --url https://admin-api.alchemy.com/v1/usage/time-series \  --header 'Authorization: Bearer <Access Key>' \  --header 'Content-Type: application/json' \  --data '{  "startTime": "2026-06-01T00:00:00Z",  "endTime": "2026-06-07T23:59:59Z",  "products": [    "SUPERNODE_CU"  ],  "metrics": [    "amount"  ],  "filters": {    "appIds": [      "string"    ],    "networks": [      "string"    ],    "methods": [      "string"    ],    "requestTypes": [      "http"    ]  },  "groupBy": [    "requestType"  ],  "granularity": "hour"}'

{  "data": {    "query": {      "startTime": "string",      "endTime": "string",      "granularity": "hour",      "products": [        "SUPERNODE_CU"      ],      "metrics": [        "amount"      ],      "filters": {        "appIds": [          "string"        ],        "networks": [          "string"        ],        "methods": [          "string"        ],        "requestTypes": [          "http"        ]      },      "groupBy": [        "requestType"      ]    },    "freshness": {      "dataThrough": "string",      "containsPartialToday": false,      "updateCadence": "minute"    },    "data": [      {        "startTime": "string",        "endTime": "string",        "isPartial": false,        "dimensions": {          "requestType": "string",          "app": "string",          "network": "string",          "method": "string"        },        "amount": "string",        "unit": "string"      }    ]  }}

Was this page helpful?