API referenceSystem
Who the API takes the request for, every rate bucket it may pay with the tokens left in each, and the account's write limits. A route's own allowance for each caller is not listed. Reading it charges only its own request.
Authorization
bearer AuthorizationBearer <token>
A Blockhash API key, sent from your server. It is optional: every route answers without one, and a key raises the rate limits. A request with a key and an Origin header is refused 403 key-server-only. See Get a key.
In: header
Response Body
application/json
application/json
curl -X GET "https://example.com/v1/limits"{ "caller": { "kind": "session", "wallet": "0xfe1a867b752c2f3033655d222a674bd1d8cb0f03", "account": "0xfe1a867b752c2f3033655d222a674bd1d8cb0f03", "issuedAt": 1793500000, "expiresAt": 1794104800 }, "buckets": [ { "name": "session", "scope": "session", "rate": 30, "burst": 120, "remaining": 119, "resetSeconds": 1, "applies": "every request the session makes, from any address" }, { "name": "ip-ceiling", "scope": "ip", "rate": 60, "burst": 240, "remaining": 239, "resetSeconds": 1, "applies": "every request from this address but those an API key authorizes, all callers there together" }, { "name": "account-write", "scope": "account", "rate": 2, "burst": 10, "remaining": 10, "resetSeconds": 0, "applies": "an account's writes: POST, PUT, PATCH and DELETE under /v1/me, a report, the X link's steps, a Book's records" } ], "durable": [ { "name": "follows-per-hour", "limit": 100, "windowSeconds": 3600, "used": 3, "applies": "PUT /v1/me/following/{id}: 429 follow-limit" } ]}