> ## 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 데이터 쿼리를 만드십시오. getTransactionsForAddress, getTransfersByAddress, DAS API 및 Wallet API에 대한 예제를 복사하여 붙여넣으십시오.

## 빠른 설정

아래 모든 예제에는 [dashboard.helius.dev](https://dashboard.helius.dev)에서 Helius API 키만 필요합니다. `YOUR_API_KEY`를 교체한 후 가져오려는 항목에 맞는 경로를 선택하세요:

| 원하는 것                     | 사용 방법                            | 반환                      |
| ------------------------- | -------------------------------- | ----------------------- |
| 주소의 전체 거래 내역              | **getTransactionsForAddress**    | 한 주소에 대한 디코딩된 거래        |
| 주소의 전체 전송 내역              | **getTransfersByAddress**        | 한 주소에 대한 토큰 및 기본 SOL 전송 |
| 지갑이 소유한 토큰, NFT 및 자산      | **DAS API** — `getAssetsByOwner` | 메타데이터, 소유권 및 잔액이 있는 자산  |
| REST를 통한 USD 값이 포함된 지갑 잔액 | **Wallet API** — `/balances`     | USD 가격이 포함된 토큰 및 NFT 잔액 |

## 옵션 1: 거래 내역 백필 (getTransactionsForAddress)

`getTransactionsForAddress`는 주소에 대한 전체 디코딩된 거래 내역을 단일 메서드로 반환합니다. 데이터 인덱싱을 위해 데이터 백필을 수행하는 가장 빠른 방법입니다. 주소를 먼저 전달한 다음 선택적 필터가 있는 옵션 객체를 전달하세요.

<CodeGroup>
  ```typescript TypeScript theme={"system"}
  const response = await fetch(`https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY`, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      jsonrpc: '2.0',
      id: 1,
      method: 'getTransactionsForAddress',
      params: [
        '86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY',
        {
          transactionDetails: 'full',
          sortOrder: 'desc',
          limit: 100,
        },
      ],
    }),
  });

  const { result } = await response.json();
  console.log(`Fetched ${result.data.length} transactions`);
  ```

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

  url = "https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY"
  payload = {
      "jsonrpc": "2.0",
      "id": 1,
      "method": "getTransactionsForAddress",
      "params": [
          "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY",
          {"transactionDetails": "full", "sortOrder": "desc", "limit": 100},
      ],
  }
  result = requests.post(url, json=payload).json()["result"]
  print(f"Fetched {len(result['data'])} transactions")
  ```

  ```bash cURL theme={"system"}
  curl https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY \
    -X POST \
    -H "Content-Type: application/json" \
    -d '{
      "jsonrpc": "2.0",
      "id": 1,
      "method": "getTransactionsForAddress",
      "params": [
        "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY",
        { "transactionDetails": "full", "sortOrder": "desc", "limit": 100 }
      ]
    }'
  ```
</CodeGroup>

<CardGroup cols={2}>
  <Card title="getTransactionsForAddress 안내서" icon="clock-rotate-left" href="/docs/ko/rpc/gettransactionsforaddress">
    필터, 페이지 매김, 응답 형식 및 모범 사례.
  </Card>

  <Card title="인덱싱 가이드" icon="layer-group" href="/docs/ko/rpc/how-to-index-solana-data">
    Solana 인덱스를 구축하고 백필하고 최신 상태로 유지합니다.
  </Card>
</CardGroup>

## 옵션 2: 전송 내역 가져오기 (getTransfersByAddress)

`getTransfersByAddress`는 주소에 대한 파싱된 토큰 및 기본 SOL 전송 내역을 반환합니다. 거래 수준이 아니라 전송 수준에서 준비된 조정을 제공합니다. 주소를 전달하고 필터를 위한 옵션 객체를 추가하세요.

<CodeGroup>
  ```typescript TypeScript theme={"system"}
  const response = await fetch(`https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY`, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      jsonrpc: '2.0',
      id: 1,
      method: 'getTransfersByAddress',
      params: ['86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY'],
    }),
  });

  const { result } = await response.json();
  console.log(`Fetched ${result.data.length} transfers`);
  ```

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

  url = "https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY"
  payload = {
      "jsonrpc": "2.0",
      "id": 1,
      "method": "getTransfersByAddress",
      "params": ["86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY"],
  }
  result = requests.post(url, json=payload).json()["result"]
  print(f"Fetched {len(result['data'])} transfers")
  ```

  ```bash cURL theme={"system"}
  curl https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY \
    -X POST \
    -H "Content-Type: application/json" \
    -d '{
      "jsonrpc": "2.0",
      "id": 1,
      "method": "getTransfersByAddress",
      "params": ["86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY"]
    }'
  ```
</CodeGroup>

<CardGroup cols={2}>
  <Card title="getTransfersByAddress 안내서" icon="arrow-right-arrow-left" href="/docs/ko/rpc/gettransfersbyaddress">
    전송 유형, 필터, 조정 및 응답 형식.
  </Card>

  <Card title="getTransfersByAddress 참조" icon="code" href="/docs/ko/api-reference/rpc/http/gettransfersbyaddress">
    전체 매개 변수 및 응답 스키마.
  </Card>
</CardGroup>

## 옵션 3: 지갑의 자산 가져오기 (DAS API)

DAS API는 지갑이 소유한 NFT, 대체 가능 토큰 및 압축 자산을 한 번의 호출로 반환합니다. 지갑, 포트폴리오 뷰 및 분석에 가장 일반적인 시작점입니다.

<CodeGroup>
  ```typescript TypeScript theme={"system"}
  const response = await fetch(`https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY`, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      jsonrpc: '2.0',
      id: '1',
      method: 'getAssetsByOwner',
      params: {
        ownerAddress: '86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY',
        page: 1,
        limit: 1000,
        options: {
          showFungible: true,
          showNativeBalance: true,
        },
      },
    }),
  });

  const { result } = await response.json();
  console.log(`Found ${result.total} assets`);
  ```

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

  url = "https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY"
  payload = {
      "jsonrpc": "2.0",
      "id": "1",
      "method": "getAssetsByOwner",
      "params": {
          "ownerAddress": "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY",
          "page": 1,
          "limit": 1000,
          "options": {
              "showFungible": True,
              "showNativeBalance": True,
          },
      },
  }
  result = requests.post(url, json=payload).json()["result"]
  print(f"Found {result['total']} assets")
  ```

  ```bash cURL theme={"system"}
  curl https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY \
    -X POST \
    -H "Content-Type: application/json" \
    -d '{
      "jsonrpc": "2.0",
      "id": "1",
      "method": "getAssetsByOwner",
      "params": {
        "ownerAddress": "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY",
        "page": 1,
        "limit": 1000,
        "options": {
          "showFungible": true,
          "showNativeBalance": true
        }
      }
    }'
  ```
</CodeGroup>

<CardGroup cols={2}>
  <Card title="DAS API 개요" icon="gem" href="/docs/ko/das-api">
    모든 자산 메서드, 특별 자산 유형, 모범 사례.
  </Card>

  <Card title="getAssetsByOwner 참조" icon="code" href="/docs/ko/api-reference/das/getassetsbyowner">
    전체 매개 변수 및 응답 스키마.
  </Card>
</CardGroup>

## 옵션 4: REST를 통한 지갑 잔액 가져오기 (Wallet API)

[Wallet API](/docs/ko/wallet-api/overview)는 고급 REST API입니다. 잔액 엔드포인트는 지갑의 토큰 및 NFT 보유를 USD 값과 함께 반환합니다. JSON-RPC 봉투가 필요하지 않습니다.

<CodeGroup>
  ```typescript TypeScript theme={"system"}
  const address = '86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY';
  const response = await fetch(
    `https://api.helius.xyz/v1/wallet/${address}/balances?api-key=YOUR_API_KEY`,
  );

  const data = await response.json();
  console.log(`Current page value: $${data.totalUsdValue}`);
  ```

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

  address = "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY"
  url = f"https://api.helius.xyz/v1/wallet/{address}/balances"
  data = requests.get(url, headers={"X-Api-Key": "YOUR_API_KEY"}).json()
  print(f"Current page value: ${data['totalUsdValue']}")
  ```

  ```bash cURL theme={"system"}
  curl "https://api.helius.xyz/v1/wallet/86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY/balances?api-key=YOUR_API_KEY"
  ```
</CodeGroup>

<CardGroup cols={2}>
  <Card title="Wallet API 개요" icon="wallet" href="/docs/ko/wallet-api/overview">
    모든 지갑 엔드포인트, 인증 및 단위.
  </Card>

  <Card title="지갑 잔액 참조" icon="code" href="/docs/ko/api-reference/wallet-api/balances">
    쿼리 매개 변수 및 전체 응답 스키마.
  </Card>
</CardGroup>

## 다음 단계

<CardGroup cols={2}>
  <Card title="데이터 얻기 개요" icon="database" href="/docs/ko/getting-data">
    모든 데이터 API를 비교하고, 사용 사례에 맞는 API를 선택하세요.
  </Card>

  <Card title="API 참조" icon="code" href="/docs/ko/api-reference">
    완전한 메서드 및 엔드포인트 문서.
  </Card>
</CardGroup>

**도움이 필요하신가요?** [Discord](https://discord.com/invite/6GXdee3gBj)에 참여하거나 [지원 문서](/docs/ko/support)를 참조하세요.