Skip to Content
Blockhash Docs
API referenceSystem
GET
/v1/limits

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"    }  ]}