GET /v1/account/history

The account's usage history, most recent request first.

Request

Query parameter	Required	Default	Description
limit	No	50	Number of entries per page, from 1 to 200.
cursor	No	none	Returns the page after a previous page. See Pagination below. Omit for the first page.

curl "https://api.alchemy.example/v1/account/history?limit=50" \
  -H "X-Api-Key: YOUR_API_KEY"

Response

An object with items, the entries on this page, and nextCursor:

{
  "items": [
    {
      "id": 4821,
      "requestDatetime": "2026-08-31T14:02:11Z",
      "endpoint": "v1/generate-table",
      "httpStatus": 200,
      "billable": true,
      "cost": 0.0042,
      "balanceAfter": 41.9,
      "currency": "USD",
      "tableCount": 1,
      "rowCount": 500,
      "columnCount": 4,
      "generatedBytes": 18230,
      "seed": 42,
      "schemaVersion": "1.0",
      "durationMs": 118
    }
  ],
  "nextCursor": 4790
}

Each entry in items:

Property	Type	Description
id	integer	Identifier of the entry.
requestDatetime	string (ISO 8601)	When the request was received.
endpoint	string	The endpoint called, such as v1/generate-table.
httpStatus	integer	The HTTP status of the response.
billable	boolean	Whether the request was charged.
cost	number	The amount charged. 0 when the request was not charged.
balanceAfter	number?	The balance after the request.
currency	string	ISO 4217 code of the currency of cost and balanceAfter.
tableCount	integer	Number of tables in the request.
rowCount	integer	Number of rows in the request, across every table.
columnCount	integer	Number of columns in the request.
generatedBytes	integer	Uncompressed size of the generated data, in bytes.
seed	integer?	The seed used.
schemaVersion	string	The request contract version.
durationMs	integer?	Time taken to process the request, in milliseconds.
errorMessage	string?	A message about the request, such as the reason it failed or that it was a free repeat. Absent when there is no message.

Pagination

nextCursor is the id of the last entry on the page. Send it as cursor to get the next page of older entries:

curl "https://api.alchemy.example/v1/account/history?limit=50&cursor=4790" \
  -H "X-Api-Key: YOUR_API_KEY"

nextCursor is null when the page has fewer entries than limit. When the last page has exactly limit entries, nextCursor is set, and the next request returns an empty items array with a null nextCursor.

Errors

401 with a ProblemDetails body for a missing or invalid API key:

{
  "type": "urn:alchemy:error:unauthorized",
  "title": "Missing or invalid API key.",
  "status": 401
}

Requires an API key (see Authentication) but is not billed.