> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Admin API

> APIキー認証を通じてプロジェクトの使用状況および請求データへのプログラム的アクセス。

Admin APIは、プロジェクトのクレジット使用量、サブスクリプションの詳細、およびサービスごとのリクエスト数にプログラム的にアクセスする手段を提供します。これを使用して、内部ダッシュボードを構築したり、使用警告を自動化したり、Heliusの請求データを独自のシステムに取り込むことができます。すべてが標準のHelius APIキーで認証されます。

**ベースURL**: `https://admin-api.helius.xyz`

## クイック例

プロジェクトの現在の課金サイクルの使用状況を取得します：

<CodeGroup>
  ```bash cURL theme={"system"}
  curl "https://admin-api.helius.xyz/v0/admin/projects/YOUR_PROJECT_ID/usage" \
    -H "X-Api-Key: YOUR_API_KEY"
  ```

  ```javascript JavaScript theme={"system"}
  const response = await fetch(
    `https://admin-api.helius.xyz/v0/admin/projects/${PROJECT_ID}/usage`,
    { headers: { "X-Api-Key": API_KEY } }
  );
  const usage = await response.json();
  ```

  ```python Python theme={"system"}
  import requests

  response = requests.get(
      f"https://admin-api.helius.xyz/v0/admin/projects/{PROJECT_ID}/usage",
      headers={"X-Api-Key": API_KEY},
  )
  usage = response.json()
  ```
</CodeGroup>

### サンプルレスポンス

```json theme={"system"}
{
  "creditsRemaining": 486100,
  "creditsUsed": 13900,
  "prepaidCreditsRemaining": 50000,
  "prepaidCreditsUsed": 0,
  "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
  }
}
```

## 認証

Helius APIキーをヘッダー（推奨）またはクエリパラメータとして渡します：

* **ヘッダー**: `X-Api-Key: YOUR_API_KEY`
* **クエリパラメータ**: `?api-key=YOUR_API_KEY`

<Note>
  APIキーはクエリ対象のプロジェクトに属している必要があります。APIキーのプロジェクトがパス内のプロジェクトIDと一致しない場合、`400`エラーが返されます。
</Note>

## レート制限

Admin APIは、プロジェクトごとに**1秒あたり5リクエスト**のレート制限があります。

## エンドポイント

<CardGroup cols={2}>
  <Card title="プロジェクト使用状況の取得" href="/ja/api-reference/admin/get-project-usage">
    現在の課金サイクルのクレジット使用量、サブスクリプションの詳細、およびサービスごとのリクエスト数を取得します。
  </Card>
</CardGroup>
