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

Bearer authentication token

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 <token>' \  --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?