> ## 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 계정 데이터 가져오기

> 표준 RPC 메서드 — getAccountInfo, getMultipleAccounts, getProgramAccounts, getBalance로 Solana 계정 상태 읽기.

## 계정 데이터란?

Solana의 모든 상태는 지갑, 토큰 계정, 프로그램(스마트 계약) 상태를 포함하여 계정에 존재합니다. 계정 메서드는 주소를 통해 해당 상태를 직접 읽습니다: 원시 또는 구문 분석된 데이터, 소유 프로그램, 램포트(SOL) 잔액, 및 임대 메타데이터.

상위 수준의 토큰 및 NFT 데이터의 경우, [토큰 & NFTs](/docs/ko/das-api) API를 사용하여 원시 계정 읽기 대신 사용할 수 있습니다. 거래 기록은 [거래](/docs/ko/rpc/historical-data)를 참조하세요.

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

| 필요한 것                    | 사용할 메서드                   |
| ------------------------ | ------------------------- |
| 하나의 계정의 전체 내용            | **`getAccountInfo`**      |
| 한 번의 요청으로 여러 계정(최대 100개) | **`getMultipleAccounts`** |
| 필터가 있는 프로그램 소유의 모든 계정    | **`getProgramAccounts`**  |
| 계정의 SOL 잔액만              | **`getBalance`**          |

## 주요 메서드

<CardGroup cols={2}>
  <Card title="getAccountInfo" icon="circle-info" href="/docs/ko/rpc/guides/getaccountinfo">
    단일 주소의 전체 계정 상태 — 데이터, 소유자, 램포트, 임대 에포크.
  </Card>

  <Card title="getMultipleAccounts" icon="layer-group" href="/docs/ko/rpc/guides/getmultipleaccounts">
    한 번의 호출로 최대 100개의 계정을 가져옵니다 — 여러 계정을 한 번에 효율적으로 읽는 방법입니다.
  </Card>

  <Card title="getProgramAccounts" icon="diagram-project" href="/docs/ko/rpc/guides/getprogramaccounts">
    프로그램 소유의 모든 계정, 대상 쿼리를 위한 `memcmp` 및 `dataSize` 필터 포함.
  </Card>

  <Card title="getBalance" icon="scale-balanced" href="/docs/ko/rpc/guides/getbalance">
    단일 계정의 램포트(SOL) 잔액.
  </Card>
</CardGroup>

## 빠른 시작

`getAccountInfo`로 단일 계정을 읽습니다. 모든 Solana RPC 호출은 [dashboard.helius.dev](https://dashboard.helius.dev)에서 제공하는 API 키로 동일한 엔드포인트에 갑니다.

<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: 'getAccountInfo',
      params: ['86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY', { encoding: 'jsonParsed' }],
    }),
  });

  const { result } = await response.json();
  console.log(result.value);
  ```

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

  url = "https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY"
  payload = {
      "jsonrpc": "2.0",
      "id": "1",
      "method": "getAccountInfo",
      "params": ["86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY", {"encoding": "jsonParsed"}],
  }
  print(requests.post(url, json=payload).json()["result"]["value"])
  ```

  ```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": "getAccountInfo",
      "params": ["86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY", { "encoding": "jsonParsed" }]
    }'
  ```
</CodeGroup>

여러 계정을 읽으시겠습니까? 주소 배열과 함께 `getMultipleAccounts`를 사용하면 `getAccountInfo`를 반복하는 대신 한 번의 요청으로 최대 100개의 계정을 반환합니다.

## 다음 단계

<CardGroup cols={2}>
  <Card title="getAccountInfo 참조" icon="code" href="/docs/ko/api-reference/rpc/http/getaccountinfo">
    전체 매개변수, 인코딩 및 응답 스키마.
  </Card>

  <Card title="토큰 & NFTs" icon="coins" href="/docs/ko/das-api">
    토큰 잔액 및 NFT 데이터를 위해 DAS API는 원시 계정 읽기보다 상위에 있습니다.
  </Card>

  <Card title="거래" icon="clock-rotate-left" href="/docs/ko/rpc/historical-data">
    주소의 거래 및 전송 기록 쿼리.
  </Card>

  <Card title="모든 RPC 메서드" icon="server" href="/docs/ko/rpc/guides/overview">
    전체 Solana RPC 메서드 참조를 탐색하세요.
  </Card>
</CardGroup>