Admin API

Programmatic access to project usage and billing data via API key authentication.

The Admin API provides programmatic access to your project’s credit usage, subscription details, and per-service request counts. Use it to build internal dashboards, automate usage alerts, or pipe Helius billing data into your own systems, all authenticated with your standard Helius API key.

Base URL: https://admin-api.helius.xyz

Quick Example

Retrieve the current credit cycle’s usage for a project:

cURL

curl "https://admin-api.helius.xyz/v0/admin/projects/YOUR_PROJECT_ID/usage" \
  -H "X-Api-Key: YOUR_API_KEY"

Sample Response

{
  "creditsRemaining": 486100,
  "creditsUsed": 13900,
  "prepaidCreditsRemaining": 50000,
  "prepaidCreditsUsed": 0,
  "creditCycle": {
    "start": "2026-04-01",
    "end": "2026-05-01"
  },
  "subscriptionDetails": {
    "billingCycle": {
      "start": "2026-04-01",
      "end": "2026-05-01"
    },
    "creditsLimit": 500000,
    "plan": "business"
  },
  "credits": {
    "rpc": 4500,
    "enhancedApi": 1200,
    "walletApi": 0,
    "das": 5000,
    "webhooks": 800,
    "laserstreamGrpc": 1500,
    "laserstreamWebsocket": 800,
    "preConfirmations": 100,
    "archival": 0,
    "photon": 0,
    "other": 0
  },
  "requests": {
    "rpc": 4500,
    "enhancedApi": 1200,
    "walletApi": 0,
    "das": 5000,
    "webhooks": 800,
    "preConfirmations": 50,
    "archival": 0,
    "photon": 0,
    "other": 0
  },
  "dataTransfer": {
    "laserstreamGrpc": 15000000,
    "laserstreamWebsocket": 8000000
  }
}

Authentication

Pass your Helius API key either as a header (recommended) or a query parameter:

• Header: X-Api-Key: YOUR_API_KEY
• Query parameter: ?api-key=YOUR_API_KEY

The API key must belong to the project you’re querying. Requests where the API key’s project does not match the project ID in the path will return a 400 error.

Rate Limits

The Admin API is rate-limited to 5 requests per second per project.

Endpoints

Get Project Usage

Retrieve credit usage, subscription details, and per-service request counts for the current credit cycle.