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

# getMultipleAccounts

> Pubkey 목록에 대한 계정 정보를 반환합니다.

<Info>
  **새로운 기능**: `getMultipleAccounts`가 이제 증분 업데이트를 위한 `changedSinceSlot` 매개변수를 지원합니다. 지정된 경우, 이 메서드는 주어진 슬롯 번호 이후에 수정된 계정만 반환합니다. 지정된 슬롯 이후 변경되지 않은 계정의 경우, 응답에는 `status: "unchanged"`가 포함됩니다.
</Info>

## 요청 매개변수

<ParamField body="address" type="array" required>
  단일 최적화된 배치 요청에서 가져올 최대 100개의 Solana 계정 주소 배열.
</ParamField>

<ParamField body="commitment" type="string">
  요청을 위한 커밋 수준.

  * `confirmed`
  * `finalized`
  * `processed`
</ParamField>

<ParamField body="minContextSlot" type="number">
  요청을 평가할 수 있는 최소 슬롯입니다.
</ParamField>

<ParamField body="dataSlice" type="object">
  계정 데이터의 일부를 요청합니다.
</ParamField>

<ParamField body="dataSlice.length" type="number">
  반환할 바이트 수.
</ParamField>

<ParamField body="dataSlice.offset" type="number">
  읽기를 시작할 바이트 오프셋.
</ParamField>

<ParamField body="encoding" type="string">
  반환된 계정 데이터의 인코딩 형식.

  * `jsonParsed`
  * `base58`
  * `base64`
  * `base64+zstd`
</ParamField>

<ParamField body="changedSinceSlot" type="number">
  이 슬롯 번호 이후에 수정된 계정만 반환합니다. 지정된 슬롯 이후에 변경되지 않은 계정의 경우, 응답에는 상태가 "변경되지 않음"으로 포함됩니다.
</ParamField>


## OpenAPI

````yaml ko/openapi/rpc-http/getMultipleAccounts.yaml POST /
openapi: 3.1.0
info:
  title: Solana RPC API
  version: 1.0.0
  description: >-
    여러 블록체인 계정을 단일 요청으로 효율적으로 접근할 수 있는 최적화된 Solana 일괄 계정 데이터 검색 API로, 구성 가능한 인코딩
    옵션을 제공합니다.
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
  - url: https://mainnet.helius-rpc.com
    description: 메인넷 RPC 엔드포인트
  - url: https://devnet.helius-rpc.com
    description: Devnet RPC 엔드포인트
security: []
paths:
  /:
    post:
      tags:
        - RPC
      summary: getMultipleAccounts
      description: |
        여러 Solana 계정의 데이터를 단일 효율적인 일괄 요청으로 검색합니다.
        이 성능 최적화된 API는 최대 100개의 계정을 동시에 가져옴으로써 네트워크 부담을 줄이며,
        알려진 프로그램 유형에 대한 JSON 파싱을 비롯한 다양한 데이터 인코딩을 지원합니다.
        DApps, 지갑, 여러 토큰 잔액, NFT 메타데이터, 프로그램 상태 또는 최소 지연 시간 및 대역폭 사용으로
        체인 계정 데이터의 조합에 접근해야 하는 서비스에 이상적입니다.
      operationId: getMultipleAccounts
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - jsonrpc
                - id
                - method
                - params
              properties:
                jsonrpc:
                  type: string
                  description: JSON-RPC 프로토콜 버전입니다.
                  enum:
                    - '2.0'
                  example: '2.0'
                  default: '2.0'
                id:
                  type: string
                  description: 요청에 대한 고유 식별자입니다.
                  example: '1'
                  default: '1'
                method:
                  type: string
                  description: 호출할 RPC 메서드 이름입니다.
                  enum:
                    - getMultipleAccounts
                  example: getMultipleAccounts
                  default: getMultipleAccounts
                params:
                  type: array
                  description: 메서드에 대한 매개변수입니다.
                  default:
                    - - vines1vzrYbzLMRdu58ou5XTby4qAqVRLmqo36NKPTg
                      - 4fYNw3dojWmQ4dXtSGE9epjRGy9pFSx62YypT7avPYvA
                  items:
                    oneOf:
                      - type: array
                        description: 단일 최적화된 일괄 요청으로 검색할 Solana 계정 주소(최대 100개) 배열입니다.
                        items:
                          type: string
                        example:
                          - vines1vzrYbzLMRdu58ou5XTby4qAqVRLmqo36NKPTg
                          - 4fYNw3dojWmQ4dXtSGE9epjRGy9pFSx62YypT7avPYvA
                      - type: object
                        description: 배치 계정 데이터 검색을 사용자 정의하기 위한 고급 구성 옵션입니다.
                        properties:
                          commitment:
                            type: string
                            description: 요청에 대한 커밋 수준입니다.
                            enum:
                              - confirmed
                              - finalized
                              - processed
                            example: finalized
                          minContextSlot:
                            type: integer
                            description: 요청을 평가할 수 있는 최소 슬롯입니다.
                            example: 1000
                          dataSlice:
                            type: object
                            description: 계정의 데이터를 슬라이스 요청합니다.
                            properties:
                              length:
                                type: integer
                                description: 반환할 바이트 수입니다.
                                example: 50
                              offset:
                                type: integer
                                description: 읽기 시작할 바이트 오프셋입니다.
                                example: 0
                          encoding:
                            type: string
                            description: 반환된 계정 데이터의 인코딩 형식입니다.
                            enum:
                              - jsonParsed
                              - base58
                              - base64
                              - base64+zstd
                            example: base58
                          changedSinceSlot:
                            type: integer
                            description: >-
                              이 슬롯 이후에 수정된 계정만 반환합니다. 지정된 슬롯 이후 변경되지 않은 계정이
                              존재하더라도 응답은 "변경되지 않음" 상태로 포함됩니다.
                            example: 464175999
      responses:
        '200':
          description: 계정 세부 정보를 성공적으로 검색했습니다.
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                    description: JSON-RPC 프로토콜 버전입니다.
                    enum:
                      - '2.0'
                    example: '2.0'
                  id:
                    type: string
                    description: 요청과 일치하는 식별자입니다.
                    example: '1'
                  result:
                    type: object
                    description: 컨텍스트가 포함된 계정 정보입니다.
                    properties:
                      context:
                        type: object
                        description: 응답의 컨텍스트입니다.
                        properties:
                          apiVersion:
                            type: string
                            description: 응답의 API 버전입니다.
                            example: 2.0.15
                          slot:
                            type: integer
                            description: 데이터가 가져온 슬롯입니다.
                            example: 341197247
                      value:
                        type: array
                        description: 계정 세부 정보 배열입니다.
                        items:
                          oneOf:
                            - type: 'null'
                              description: 계정이 존재하지 않을 경우 null 입니다.
                            - type: object
                              description: 계정 세부 정보입니다.
                              properties:
                                lamports:
                                  type: integer
                                  description: 계정에 할당된 lamports 수입니다.
                                  example: 88849814690250
                                owner:
                                  type: string
                                  description: 계정이 할당된 프로그램의 Base-58로 인코딩된 Pubkey입니다.
                                  example: '11111111111111111111111111111111'
                                data:
                                  type: array
                                  description: 인코딩된 바이너리 또는 JSON 형식의 계정 데이터입니다.
                                  items:
                                    type: string
                                  example:
                                    - ''
                                    - base58
                                executable:
                                  type: boolean
                                  description: 계정에 프로그램이 포함되어 있는지 여부를 나타냅니다.
                                  example: false
                                rentEpoch:
                                  type: integer
                                  description: 이 계정이 다음에 임대료를 납부해야 할 시기의 에포크입니다.
                                  example: 18446744073709552000
                                space:
                                  type: integer
                                  description: 계정의 데이터 크기입니다.
                                  example: 0
                            - type: object
                              description: 계정이 존재하지만 지정된 슬롯 이후 변경되지 않았을 때의 상태 전용 응답입니다.
                              properties:
                                status:
                                  type: string
                                  description: 지정된 슬롯 이후 계정이 변경되지 않았음을 나타내는 상태입니다.
                                  enum:
                                    - unchanged
                                  example: unchanged
        '400':
          description: 잘못된 요청 - 잘못된 요청 매개변수 또는 요청 형식이 잘못되었습니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32602
                  message: Invalid params
                  data:
                    additionalInfo: 요청 매개변수를 확인하고 유효한지 확인하세요.
                id: '1'
        '401':
          description: 권한 없음 - 잘못되었거나 누락된 API 키입니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32001
                  message: Unauthorized
                  data:
                    additionalInfo: API 키를 확인하고 다시 시도하세요.
                id: '1'
        '429':
          description: 요청이 너무 많음 - 속도 제한을 초과했습니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32005
                  message: Too many requests
                  data:
                    additionalInfo: 허용된 요청 수를 초과했습니다. 잠시 후 다시 시도하세요.
                id: '1'
        '500':
          description: 내부 서버 오류 - 서버에서 오류가 발생했습니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32603
                  message: Internal error
                  data:
                    additionalInfo: 서버에서 예기치 않은 오류가 발생했습니다. 나중에 다시 시도하거나 지원팀에 문의하세요.
                id: '1'
        '503':
          description: 서비스 이용 불가 - 서비스가 일시적으로 이용 불가능합니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32002
                  message: Service unavailable
                  data:
                    additionalInfo: 서비스가 현재 사용 불가능합니다. 나중에 다시 시도하거나 지원팀에 문의하세요.
                id: '1'
        '504':
          description: 게이트웨이 타임아웃 - 요청이 시간 초과되었습니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32003
                  message: Gateway timeout
                  data:
                    additionalInfo: 요청 시간 초과가 발생했습니다. 나중에 다시 시도하거나 지원팀에 문의하세요.
                id: '1'
      security:
        - ApiKeyQuery: []
components:
  schemas:
    ErrorResponse:
      type: object
      properties:
        jsonrpc:
          type: string
          description: JSON-RPC 프로토콜 버전입니다.
          enum:
            - '2.0'
          example: '2.0'
        error:
          type: object
          properties:
            code:
              type: integer
              description: 오류 코드입니다.
              example: -32602
            message:
              type: string
              description: 오류 메시지입니다.
            data:
              type: object
              description: 오류에 대한 추가 데이터입니다.
        id:
          type: string
          description: 요청과 일치하는 식별자입니다.
          example: '1'
  securitySchemes:
    ApiKeyQuery:
      type: apiKey
      in: query
      name: api-key
      description: >-
        당신의 Helius API 키입니다.
        [dashboard](https://dashboard.helius.dev/api-keys)에서 무료로 받을 수 있습니다.

````