Skip to main content
GET
Usage
Reports your key’s plan, current rate limit state, and consumption history. Free. Because it costs nothing and reports all three rate limit windows at once, this is the right endpoint to poll from a dashboard or to check before starting a large job.

Query parameters

string
default:"month"
Window for the usage figures. One of day, week, month. Anything else returns INVALID_PARAMETER.

Request

Response

object

Notes

plan reports the internal plan name (Developer, Startup), not the tier you bought. See plans. total_credits exceeding total_requests is expected, not a billing error. A 50-wallet batch is one request and 50 credits. error_rate is already a percentage. 0.24 means 0.24%, not 24%. Unlimited plans report the string "unlimited" in plan_limits where a number would otherwise be, so parse defensively.
requests_by_endpoint is keyed by the concrete request path, not by route template. Single-wallet and reverse lookups therefore appear as one entry per address or handle, so this object grows with the number of distinct things you looked up and can get very large over a busy month. POST /v1/batch is a single fixed path and stays as one entry.If you only need totals, read total_requests and total_credits and ignore this field. Use period=day to keep the response small.

Errors

INVALID_PARAMETER, plus the standard errors.