Skip to content
Alchemy Logo

User rate limit

This API is in private preview. Target October 2026; timing is subject to change.

Returns the native request allowance and usage for an account.

Available now. This read is served at the interim endpoint today.

POST /{apiKey}/info

ParameterTypeRequiredDescription
typestringYesSelects userRateLimit.
userstringYesMaster or sub-account address.
{
  "type": "userRateLimit",
  "user": "0x0000000000000000000000000000000000000000"
}

FieldTypeDescription
cumVlmstringCumulative volume used to scale the request cap.
nRequestsUsedintegerRequests used after reserved capacity.
nRequestsCapintegerCurrent request cap, which scales with cumVlm.
nRequestsSurplusintegerReserved request capacity remaining.

{
  "cumVlm": "2854574.593578",
  "nRequestsUsed": 2890,
  "nRequestsCap": 2864574,
  "nRequestsSurplus": 0
}

This example is one address at one point in time; nRequestsCap scales with that address's cumulative volume.

Was this page helpful?