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

# Solana DAS API: 통합된 NFT 및 토큰 데이터 접근

> NFT, 압축 NFT 및 토큰을 위한 가장 포괄적인 Solana API. 전체 메타데이터, 소유권 및 검색이 가능한 모든 디지털 자산을 위한 하나의 통합 인터페이스.

## DAS API란 무엇인가요?

디지털 자산 표준(DAS) API는 Solana의 모든 유형의 디지털 자산에 대한 하나의 통합 인터페이스를 제공하는 오픈 소스 명세입니다:

* 일반 NFT (Non-Fungible Tokens)
* 압축 NFT (cNFT, 상태 압축 사용)
* 대체 가능 토큰 (SPL 토큰 및 토큰-2022, 확장 포함)

단일 메서드 세트가 메타데이터, 소유권, 잔액, 컬렉션, 생성자, 검색 및 머클 증명을 다룹니다 — 이렇게 하면 동일한 API를 기반으로 NFT 시장, 지갑, 포트폴리오 추적기, 토큰 게이트 앱 및 분석 도구를 구축할 수 있습니다.

두 네트워크는 동일한 메서드를 공유합니다:

* 메인넷: `https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY`
* Devnet: `https://devnet.helius-rpc.com/?api-key=YOUR_API_KEY`

## DAS API에 Helius를 사용하는 이유는?

<CardGroup cols={2}>
  <Card title="모든 자산 유형, 하나의 API" icon="gem">
    하나의 인터페이스를 통해 NFT, 압축 NFT 및 대체 가능 토큰 (SPL 및 토큰-2022).
  </Card>

  <Card title="완전한 메타데이터" icon="database">
    온체인 및 오프체인 데이터 (Arweave, IPFS)가 함께 인덱싱되어 한 번의 호출로 반환됩니다.
  </Card>

  <Card title="가격 데이터 포함" icon="coins">
    확인된 토큰의 USD 가격 정보가 잔액과 함께 반환됩니다.
  </Card>

  <Card title="검색 및 필터링" icon="magnifying-glass">
    소유자, 컬렉션, 생성자, 권한 또는 풍부한 속성 필터를 기준으로 쿼리합니다.
  </Card>
</CardGroup>

## 어떤 메서드를 사용해야 하나요?

대부분의 통합은 세 가지 메서드 중 하나로 시작됩니다. 이 표를 사용하여 적절한 시작점을 선택한 다음, 아래의 전문화된 메서드를 사용하세요.

| 메서드                    | 사용 용도           | 반환값                                    |
| ---------------------- | --------------- | -------------------------------------- |
| **`getAsset`**         | 이미 ID가 있는 단일 자산 | 하나의 자산에 대한 전체 메타데이터, 소유권 및 (토큰의 경우) 가격 |
| **`getAssetsByOwner`** | 지갑이 보유한 모든 것    | 주소에 대한 모든 자산, 메타데이터 및 잔액과 함께           |
| **`searchAssets`**     | 자산에 대한 필터링된 쿼리  | 소유자, 컬렉션, `tokenType` 및 속성 필터와 일치하는 자산 |

기본 규칙:

* 정확한 자산 ID를 알고 있나요? `getAsset` 사용 (또는 여러 개의 경우 `getAssetBatch` 사용).
* 지갑의 보유 자산을 나열하고 있나요? `getAssetsByOwner` 사용.
* 컬렉션, 토큰 유형, 또는 속성으로 필터링하나요? `searchAssets` 사용.

## 주요 메서드

### 단일 자산

<CardGroup cols={2}>
  <Card title="getAsset" icon="gem" href="/docs/ko/api-reference/das/getasset">
    ID로 하나의 자산에 대한 전체 데이터.
  </Card>

  <Card title="getAssetBatch" icon="layer-group" href="/docs/ko/api-reference/das/getassetbatch">
    한 번의 요청으로 최대 1,000개 자산.
  </Card>
</CardGroup>

### 소유자, 컬렉션 또는 생성자별 자산

<CardGroup cols={2}>
  <Card title="getAssetsByOwner" icon="wallet" href="/docs/ko/api-reference/das/getassetsbyowner">
    지갑이 보유한 모든 자산, 메타데이터 및 잔액과 함께.
  </Card>

  <Card title="getAssetsByGroup" icon="layer-group" href="/docs/ko/api-reference/das/getassetsbygroup">
    컬렉션의 모든 자산 (그룹 키 `collection`).
  </Card>

  <Card title="getAssetsByCreator" icon="user" href="/docs/ko/api-reference/das/getassetsbycreator">
    특정 생성자가 발행한 모든 자산.
  </Card>

  <Card title="getAssetsByAuthority" icon="address-card" href="/docs/ko/api-reference/das/getassetsbyauthority">
    주어진 권한에 의해 제어되는 모든 자산.
  </Card>
</CardGroup>

### 검색

<CardGroup cols={2}>
  <Card title="searchAssets" icon="magnifying-glass" href="/docs/ko/api-reference/das/searchassets">
    소유자, 컬렉션, `tokenType` 및 속성으로 유연하게 필터링.
  </Card>
</CardGroup>

### 압축 자산 및 증명

<CardGroup cols={2}>
  <Card title="getAssetProof" icon="shield-check" href="/docs/ko/api-reference/das/getassetproof">
    온체인 작업에 필요한 압축 자산에 대한 머클 증명.
  </Card>

  <Card title="getAssetProofBatch" icon="shield-check" href="/docs/ko/api-reference/das/getassetproofbatch">
    여러 압축 자산에 대한 머클 증명을 한 번에.
  </Card>

  <Card title="getSignaturesForAsset" icon="clock-rotate-left" href="/docs/ko/api-reference/das/getsignaturesforasset">
    자산에 대한 거래 서명 기록.
  </Card>

  <Card title="getNftEditions" icon="image" href="/docs/ko/api-reference/das/getnfteditions">
    마스터 NFT에서 인쇄된 모든 에디션.
  </Card>
</CardGroup>

### 토큰 계정

<CardGroup cols={2}>
  <Card title="getTokenAccounts" icon="coins" href="/docs/ko/api-reference/das/gettokenaccounts">
    잔액과 함께 조폐 또는 소유자별 토큰 계정.
  </Card>
</CardGroup>

## 시작하기

<CardGroup cols={2}>
  <Card title="자산 가져오기 (NFTs)" icon="image" href="/docs/ko/das/get-nfts">
    단일 자산, 소유자별, 컬렉션별, 증명 및 에디션을 통해 NFT 및 디지털 수집품을 가져옵니다.
  </Card>

  <Card title="SPL 토큰 가져오기" icon="coins" href="/docs/ko/das/get-tokens">
    대체 가능 토큰 쿼리: 잔액, 공급량, 보유자 및 토큰 계정.
  </Card>

  <Card title="자산 검색" icon="magnifying-glass" href="/docs/ko/das/search">
    소유자, 컬렉션, 토큰 유형 및 속성별로 자산을 필터링합니다.
  </Card>

  <Card title="페이지네이션" icon="list" href="/docs/ko/das/pagination">
    대규모 결과 집합에 대한 페이지 기반 및 키셋 페이지네이션.
  </Card>
</CardGroup>

## 특수 자산 유형 작업하기

### 대체 가능 토큰

Helius는 DAS API를 확장하여 메타데이터가 없는 일반 SPL 토큰 및 토큰-2022 (및 확장 포함) 등 **모든 토큰**을 다룹니다. 대체 가능 토큰 지원은 `getAsset`, `getAssetsByOwner` 및 `searchAssets`에서 `tokenType` 매개변수를 사용하여 가능하며, 확인된 토큰 가격은 `token_info.price_info`에서 반환됩니다.

잔액, 공급량, 보유자 및 토큰 계정 쿼리에 대해서는 [SPL 토큰 가져오기 안내서](/docs/ko/das/get-tokens) 및 [대체 가능 토큰 확장](/docs/ko/das/fungible-token-extension)을 참조하세요.

### 압축 NFT

상태 압축 NFT (cNFT)는 정규 NFT와 동일한 메서드를 사용하여 읽기를 수행합니다 (`getAsset`, `getAssetsByOwner`, `searchAssets`) 그 외에 두 가지 압축 전용 메서드가 추가됩니다:

* `getAssetProof`는 전송 및 소각과 같은 온체인 작업을 확인하고 수행하는 데 필요한 머클 증명을 반환합니다.
* `getSignaturesForAsset`는 압축 자산에 대한 거래 내역을 반환합니다.

완전한 압축 NFT 예제는 [자산 가져오기 안내서](/docs/ko/das/get-nfts)를 참조하세요.

### 오프체인 데이터

대부분의 NFT 컬렉션은 추가 메타데이터(속성, 이미지)를 Arweave 또는 IPFS와 같은 오프체인에 저장합니다. DAS API는 이 오프체인 데이터를 인덱스하고 온체인 데이터와 함께 한 번의 호출로 반환합니다.

<Note>
  Helius는 오프체인 데이터 변이를 감지할 수 없습니다. 오프체인 데이터는 자산이 온체인에서 다시 나타날 때만 다시 새로 고쳐집니다 (예: 수정될 때). 재색인을 요청하려면 Helius 지원에 문의하세요.
</Note>

## 모범 사례

<CardGroup cols={2}>
  <Card title="페이지네이션" icon="list">
    페이지 1에서 시작합니다 (0이 아님). 100–1,000의 제한을 사용하고 대용량 데이터 세트에는 페이지네이션을 사용하십시오.
  </Card>

  <Card title="오류 처리" icon="shield-check">
    모든 응답에서 오류를 확인하고 지수 백오프로 재시도하세요.
  </Card>

  <Card title="성능" icon="bolt">
    가능한 경우 배치 메서드를 사용하고, 응답을 캐시하며, 하나로 해결 가능한 호출을 체이닝하지 마세요.
  </Card>

  <Card title="보안" icon="lock">
    API 키를 클라이언트 측 코드에서 노출하지 마십시오. 서버를 통해 요청을 프록시하고 CORS 정책을 설정하십시오.
  </Card>
</CardGroup>

## 다음 단계

<CardGroup cols={3}>
  <Card title="자산 가져오기 (NFTs)" icon="image" href="/docs/ko/das/get-nfts">
    NFT 및 디지털 수집품을 검색하고 쿼리합니다.
  </Card>

  <Card title="DAS API 참조" icon="code" href="/docs/ko/api-reference/das">
    모든 DAS 메서드의 전체 요청 및 응답 스키마.
  </Card>

  <Card title="DAS API FAQ" icon="book" href="/docs/ko/faqs/das-api">
    자산, 가격 데이터, 사용에 대한 일반적인 질문.
  </Card>
</CardGroup>