Authentication

Send your API key in the x-api-key header. The key sets your rate-limit tier; the URL stays the same. Requests without a key use the Free tier.

Send your key

Add the header to every request, on any service and either network.

curl

curl https://api.provable.com/v2/mainnet/block/height/latest \
  -H "x-api-key: $PROVABLE_API_KEY"

JavaScript

const res = await fetch(
  "https://api.provable.com/v2/mainnet/block/height/latest",
  { headers: { "x-api-key": process.env.PROVABLE_API_KEY } }
);

Rate limits

Limits are requests per minute, by tier and service. Your key decides whether Standard or Enterprise applies.

Tier	Explorer API	Delegated Proving	Record Scanning
Free (no key)	No metered limit*	90 / min per IP	90 / min per IP
Standard (x-api-key)	300 / min	300 / min	300 / min
Enterprise (x-api-key)	1,000 / min	1,000 / min	1,000 / min

* Abuse protection only.

info

Need more than Enterprise? Email explorer@provable.com.

Get an API key

Standard and Enterprise keys come from Provable. To request one, email explorer@provable.com with the service and tier you need.

Don't use the legacy POST /consumers endpoint for new integrations.

Migrate from JWT

warning

JWT authentication is no longer supported. Switch to an API key in the x-api-key header.

1. Get an API key for the service and tier you need.
2. Remove the JWT exchange that calls POST /jwts/{consumerId}.
3. Replace the Authorization header with x-api-key:

- Authorization: Bearer <jwt>
+ x-api-key: <your-api-key>