> ## 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,
  "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
  }
}
```

## 인증

Helius API 키를 헤더(권장) 또는 쿼리 매개변수로 전달합니다:

* **헤더**: `X-Api-Key: YOUR_API_KEY`
* **쿼리 매개변수**: `?api-key=YOUR_API_KEY`

<Note>
  API 키는 쿼리 중인 프로젝트에 속해야 합니다. API 키의 프로젝트가 경로에 있는 프로젝트 ID와 일치하지 않는 요청은 `400` 오류를 반환합니다.
</Note>

## 속도 제한

Admin API는 프로젝트당 **초당 5개의 요청**으로 속도가 제한됩니다.

## 엔드포인트

<CardGroup cols={2}>
  <Card title="프로젝트 사용량 가져오기" href="/docs/ko/api-reference/admin/get-project-usage">
    현재 크레딧 사이클에 대한 크레딧 사용량, 구독 세부 사항 및 서비스별 요청 수를 검색합니다.
  </Card>
</CardGroup>