Free Pearl API

Build dashboards, bots, pool pages, wallets, and research tools on top of PearlStack's indexed Pearl blockchain data.

Anonymous: 60 requests/minFree key: 300 requests/minAPI docsOpenAPI JSONManage your keys
CoverageBlocks, txs, addresses
Pearl NativeCertificates, pools, supply
AccessOptional API keys

Quick Start

Full docs

Anonymous requests work immediately:

curl https://api.pearlstack.net/v1/status
curl https://api.pearlstack.net/v1/blocks?limit=5
curl "https://api.pearlstack.net/v1/search?q=PearlHash"

With an API key, send either header:

curl -H "X-API-Key: psk_live_..." https://api.pearlstack.net/v1/api/me
curl -H "Authorization: Bearer psk_live_..." https://api.pearlstack.net/v1/blocks?limit=5

Authenticated key management

Open key dashboard

Sign in to create, rotate, and revoke API keys. Secrets are displayed once; PearlStack stores only a SHA-256 hash.

  1. Create a clearly named key for each application or environment.
  2. Copy the secret immediately and store it in your application's secret manager.
  3. Send it with X-API-Key or a Bearer authorization header.
  4. Rotate a key when changing environments or responding to possible exposure.

Every key operation is scoped to the signed-in owner. Rotation revokes the previous secret immediately.

Free Tier

The free API is meant for public dashboards, wallet integrations, pool pages, bots, and lightweight analytics. It includes response metadata, request ids, and cursor pagination.

Premium Later

The API is already shaped for higher limits, commercial keys, exports, webhooks, and richer historical data later. The public contract starts clean now so premium does not require a rewrite.

For now, everything public is free while PearlStack matures.