> ## 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.

# Wallet API (베타)

> Solana 지갑 데이터(잔액, 거래 내역, 전송, 신원 및 자금 조달 정보)를 쿼리하기 위한 REST API 엔드포인트입니다.

<Note>
  **베타**: Wallet API는 현재 베타 버전입니다. API 및 응답 형식이 변경될 수 있습니다.
</Note>

모든 Wallet API 요청은 호출당 **100 크레딧**이 소요됩니다. 자세한 내용은 [크레딧 비용](/docs/ko/billing/credits#월렛-api-크레딧)을 참조하세요.

`identity`, `batch-identity` 및 `funded-by` 엔드포인트는 유료 플랜이 필요합니다 — 무료 플랜 요청은 `403 Forbidden`를 반환합니다. 다른 모든 엔드포인트는 모든 플랜에서 사용할 수 있습니다.

<CardGroup cols={2}>
  <Card title="identity" href="/docs/ko/api-reference/wallet-api/identity">
    주소 또는 SNS/ANS 도메인을 통한 지갑 신원 확인
  </Card>

  <Card title="balances" href="/docs/ko/api-reference/wallet-api/balances">
    모든 토큰 및 NFT 잔액을 USD 값 포함 조회
  </Card>

  <Card title="balance-at" href="/docs/ko/api-reference/wallet-api/balance-at">
    과거 타임스탬프 또는 슬롯에서의 토큰 또는 SOL 잔액 확인
  </Card>

  <Card title="history" href="/docs/ko/api-reference/wallet-api/history">
    잔액 변동이 포함된 거래 내역 가져오기
  </Card>

  <Card title="transfers" href="/docs/ko/api-reference/wallet-api/transfers">
    발신자/수신자 정보가 포함된 모든 토큰 전송 활동 가져오기
  </Card>

  <Card title="funded-by" href="/docs/ko/api-reference/wallet-api/funded-by">
    지갑의 원래 자금 출처 발견하기
  </Card>
</CardGroup>

## 인증

모든 Wallet API 요청은 API 키를 통한 인증이 필요합니다:

```bash theme={"system"}
# Query parameter
GET https://api.helius.xyz/v1/wallet/{wallet}/balances?api-key=YOUR_API_KEY

# Header (recommended)
GET https://api.helius.xyz/v1/wallet/{wallet}/balances
X-Api-Key: YOUR_API_KEY
```

## 기본 URL

```
https://api.helius.xyz
```

## 빠른 참조

| 엔드포인트                                | 크레딧 | 무료 플랜 | 설명                                         |
| ------------------------------------ | --- | ----- | ------------------------------------------ |
| `GET /v1/wallet/{wallet}/identity`   | 100 | `403` | 주소 또는 SNS/ANS 도메인을 통한 지갑 신원 확인             |
| `POST /v1/wallet/batch-identity`     | 100 | `403` | 일괄 신원 조회 (최대 100개의 주소/도메인)                 |
| `GET /v1/wallet/{wallet}/balances`   | 100 | 사용 가능 | 모든 토큰 및 NFT 잔액 가져오기                        |
| `GET /v1/wallet/{wallet}/balance-at` | 100 | 사용 가능 | 과거 타임스탬프, 날짜/시간 또는 슬롯에서의 토큰 또는 SOL 잔액 가져오기 |
| `GET /v1/wallet/{wallet}/history`    | 100 | 사용 가능 | 잔액 변동이 포함된 거래 내역 가져오기                      |
| `GET /v1/wallet/{wallet}/transfers`  | 100 | 사용 가능 | 모든 토큰 전송 활동 가져오기                           |
| `GET /v1/wallet/{wallet}/funded-by`  | 100 | `403` | 원래 자금 출처 찾기                                |