Skip to main content
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 billing cycle’s usage for a project: 
curl "https://admin-api.helius.xyz/v0/admin/projects/YOUR_PROJECT_ID/usage" \
  -H "X-Api-Key: YOUR_API_KEY"

​
Sample Response

{
  "creditsRemaining": 487500,
  "creditsUsed": 12500,
  "prepaidCreditsRemaining": 50000,
  "prepaidCreditsUsed": 0,
  "subscriptionDetails": {
    "billingCycle": {
      "start": "2026-04-01",
      "end": "2026-05-01"
    },
    "creditsLimit": 500000,
    "plan": "business"
  },
  "usage": {
    "api": 1200,
    "archival": 0,
    "das": 5000,
    "grpc": 300,
    "grpcGeyser": 0,
    "photon": 0,
    "rpc": 4500,
    "stream": 100,
    "webhook": 800,
    "websocket": 600
  }
}

​
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 billing cycle.