Authentication
Prysmatic is a prepaid API. Before you can call anything you need two things: an API key (your identity) and a credit balance (what you spend per call). Both are set up from the dashboard — you never have to handle private keys or write any signing code.
1. Connect your wallet
Open the Prysmatic dashboard and connect your Phantom wallet. You sign a one-time login message in the wallet popup to prove ownership — nothing leaves your wallet, no transaction is sent. That wallet becomes your account identity.
2. Get your API key
Once connected, your account page shows your API key. This single key is what authenticates every request you make.
- Keep it secret — anyone with the key can spend your credits.
- You can rotate it from the dashboard at any time. Rotating immediately invalidates the old key.
3. Load credits
Credits are bought with USDT. From the dashboard you send USDT to the displayed
store address from your connected wallet, then hit verify. The deposit is
detected and converted to credits at the published rate (for example,
1 USDT = 1000 credits). Your payment history and current balance are shown on the
same page.
A few rules worth knowing:
- The deposit must come from your connected wallet — that's how it's matched to your account.
- Each deposit is credited exactly once.
- Your live balance and rate are always visible on the dashboard.
4. Use the key
REST
Send your API key as a Bearer token:
Authorization: Bearer <API_KEY>
WebSocket
The key does not go in the URL. It is sent in the Sec-WebSocket-Protocol
header so it never lands in proxy logs:
Sec-WebSocket-Protocol: bearer, <API_KEY>
See WebSocket for the full connection flow.
What spends credits
| Action | Cost |
|---|---|
GET /wallets and /wallets/{alias}/* | light (1) |
GET /tokens/{mint}/* and /tokens/held | heavier (3) |
| Each live-feed message you receive | 1 per message |
When your balance can't cover a call, REST returns 402 insufficient_credits and
the WebSocket closes after telling you the balance is exhausted. Top up from the
dashboard to continue.
Error codes
401 unauthorized— missing or invalid API key.402 insufficient_credits— not enough balance for this call.404 wallet_not_found— the alias does not resolve to a tracked wallet.