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

# getCompressedTokenAccountsByOwner

> 특정 계정이 소유한 압축된 토큰 계정을 반환합니다.

## 요청 매개변수

<ParamField body="cursor" type="string" default="3J98t1WpEZ73CNm">
  대량 보유 계정을 가진 Solana 지갑의 후속 압축 토큰 계정 세트를 검색하기 위한 페이지네이션 커서
</ParamField>

<ParamField body="limit" type="number">
  요청당 반환할 최대 압축 토큰 계정 수 (페이지네이션용)
</ParamField>

<ParamField body="mint" type="string" default="11111115q4EpJaTXAZWpCg3J2zppWGSZ46KXozzo9">
  특정 Solana 토큰 민트 주소로 압축된 토큰 계정을 필터링
</ParamField>

<ParamField body="owner" type="string" required default="11111115q4EpJaTXAZWpCg3J2zppWGSZ46KXozzo9">
  계정 및 지갑 주소를 위한 base58 문자열로 표현된 Solana 공개 키.
</ParamField>


## OpenAPI

````yaml ko/openapi/zk-compression/getCompressedTokenAccountsByOwner.yaml POST /
openapi: 3.0.3
info:
  title: Solana 압축 토큰 포트폴리오 API
  description: |
    효율적이고 비용 효율적인 토큰 저장 및 검색을 위해 상태 압축 기술을 사용하는 압축 토큰 계정용 고급 Solana 인덱서입니다.
    이 API는 Solana 압축 토큰 및 NFT에 최적화된 액세스를 제공하여 Solana 토큰 생태계와의
    전체 보안 및 호환성을 유지하면서 최대 1000배 비용 절감을 가능하게 합니다. 효율적인 포트폴리오 관리를
    필요로 하는 지갑 애플리케이션, 마켓플레이스 및 토큰 기반 dApp에 이상적입니다.
  license:
    name: Apache-2.0
  version: 0.50.0
servers:
  - url: https://mainnet.helius-rpc.com
    description: 메인넷 RPC 엔드포인트
  - url: https://devnet.helius-rpc.com
    description: Devnet RPC 엔드포인트
security: []
paths:
  /:
    summary: getCompressedTokenAccountsByOwner
    post:
      description: >
        특정 Solana 지갑 주소가 소유한 모든 압축된 토큰 계정을 검색합니다. 이 포트폴리오 엔드포인트는 Solana의 상태 압축
        기술을 사용하여

        비용을 크게 절감하면서 완전한 압축 SPL 토큰 및 NFT 보유 데이터를 제공합니다. 민트 주소로 결과를 필터링하고,

        대규모 컬렉션을 효율적으로 페이지네이션하며 소유권 검증과 함께 자세한 계정 데이터에 액세스합니다.


        주요 이점:

        - 토큰 계정의 온체인 저장 비용 절감 (최대 1000배 절감)

        - 효율적인 페이지네이션을 통한 대규모 지갑 통합 지원

        - Solana의 SPL 토큰 표준 및 압축 NFT와의 호환성

        - 목표 토큰 쿼리를 위한 민트별 필터링

        - 잔액, 대리인 및 상태를 포함한 전체 토큰 계정 데이터
      operationId: getCompressedTokenAccountsByOwner
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
                - jsonrpc
                - id
                - method
                - params
              properties:
                jsonrpc:
                  type: string
                  description: JSON-RPC 프로토콜 버전.
                  enum:
                    - '2.0'
                  default: '2.0'
                id:
                  type: string
                  description: 요청을 식별하기 위한 ID입니다.
                  default: '1'
                method:
                  type: string
                  description: 호출할 메서드의 이름입니다.
                  enum:
                    - getCompressedTokenAccountsByOwner
                  default: getCompressedTokenAccountsByOwner
                params:
                  type: object
                  required:
                    - owner
                  properties:
                    cursor:
                      allOf:
                        - $ref: '#/components/schemas/Base58String'
                      nullable: true
                      description: Solana 지갑의 대규모 보유 계정에서 후속 세트를 검색하기 위한 페이지네이션 커서
                    limit:
                      allOf:
                        - $ref: '#/components/schemas/Limit'
                      nullable: true
                      description: 요청당 반환할 최대 압축 토큰 계정 수(페이지네이션용)
                    mint:
                      allOf:
                        - $ref: '#/components/schemas/SerializablePubkey'
                      nullable: true
                      description: 특정 Solana 토큰 민트 주소로 압축 토큰 계정을 필터링합니다.
                    owner:
                      $ref: '#/components/schemas/SerializablePubkey'
                      description: 검색할 압축된 토큰 계정을 소유한 Solana 지갑 주소
                  additionalProperties: false
        required: true
      responses:
        '200':
          description: 지정된 지갑 소유자에 대한 Solana 블록체인에서 압축된 토큰 계정을 성공적으로 검색했습니다.
          content:
            application/json:
              schema:
                type: object
                required:
                  - context
                  - value
                properties:
                  context:
                    $ref: '#/components/schemas/Context'
                  value:
                    $ref: '#/components/schemas/TokenAccountList'
                additionalProperties: false
        '400':
          description: 잘못된 요청 - 잘못된 요청 매개 변수 또는 잘못된 요청입니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32602
                  message: 잘못된 매개변수
                id: '1'
        '401':
          description: 권한 없음 - 잘못되었거나 누락된 API 키입니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32001
                  message: 권한 없음
                id: '1'
        '429':
          description: 요청이 너무 많습니다 - 속도 제한 초과.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32005
                  message: 요청이 너무 많습니다
                id: '1'
        '500':
          description: 내부 서버 오류 - 서버에서 오류가 발생했습니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32603
                  message: 내부 오류
                id: '1'
        '503':
          description: 서비스를 사용할 수 없음 - 서비스가 일시적으로 사용 불가입니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32002
                  message: 서비스 불가
                id: '1'
        '504':
          description: 게이트웨이 시간 초과 - 요청 시간이 초과되었습니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32003
                  message: 게이트웨이 시간 초과
                id: '1'
      security:
        - ApiKeyQuery: []
components:
  schemas:
    Base58String:
      type: string
      description: Solana 주소 및 식별자에 사용되는 base 58 인코딩 문자열.
      default: 3J98t1WpEZ73CNm
      example: 3J98t1WpEZ73CNm
    Limit:
      type: integer
      format: int64
      minimum: 0
      description: 단일 요청에서 반환할 최대 압축 토큰 계정 수
    SerializablePubkey:
      type: string
      description: 계정 및 지갑 주소에 대한 base58 문자열로 표시된 Solana 공개 키.
      default: 11111115q4EpJaTXAZWpCg3J2zppWGSZ46KXozzo9
      example: 11111115q4EpJaTXAZWpCg3J2zppWGSZ46KXozzo9
    Context:
      type: object
      required:
        - slot
      properties:
        slot:
          type: integer
          default: 100
          example: 100
          description: 이 응답에 대한 현재 Solana 블록체인 슬롯
    TokenAccountList:
      type: object
      required:
        - items
      properties:
        cursor:
          $ref: '#/components/schemas/Base58String'
          description: 후속 요청에서 압축 토큰 계정의 다음 세트를 검색하기 위한 페이지네이션 커서
        items:
          type: array
          items:
            $ref: '#/components/schemas/TokenAcccount'
          description: 지정된 Solana 지갑 주소가 소유한 압축 토큰 계정 배열
    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'
    TokenAcccount:
      type: object
      required:
        - account
        - tokenData
      properties:
        account:
          $ref: '#/components/schemas/Account'
          description: Solana의 토큰 계정에 대한 압축된 계정 정보, 트리 위치 및 검증 데이터 포함
        tokenData:
          $ref: '#/components/schemas/TokenData'
          description: 잔액, 민트, 소유자 및 위임 상태를 포함한 특정 토큰 관련 데이터
      additionalProperties: false
    Account:
      type: object
      required:
        - hash
        - owner
        - lamports
        - tree
        - leafIndex
        - seq
        - slotCreated
      properties:
        address:
          $ref: '#/components/schemas/SerializablePubkey'
          description: Solana에서 압축된 계정의 고유 주소
        data:
          $ref: '#/components/schemas/AccountData'
          description: Solana에 압축된 형식으로 저장된 계정 데이터
        hash:
          $ref: '#/components/schemas/Hash'
          description: 압축된 계정 데이터 검증용 암호 해시
        lamports:
          $ref: '#/components/schemas/UnsignedInteger'
          description: 압축된 계정에 연결된 램포트 잔액
        leafIndex:
          $ref: '#/components/schemas/UnsignedInteger'
          description: 압축된 계정이 저장된 머클 트리의 인덱스 위치
        owner:
          $ref: '#/components/schemas/SerializablePubkey'
          description: 이 압축된 계정을 소유한 Solana 프로그램
        seq:
          $ref: '#/components/schemas/UnsignedInteger'
          description: 압축된 계정의 업데이트 추적용 시퀀스 번호
        slotCreated:
          $ref: '#/components/schemas/UnsignedInteger'
          description: 압축된 계정이 생성된 Solana 블록체인 슬롯
        tree:
          $ref: '#/components/schemas/SerializablePubkey'
          description: 이 압축된 계정을 포함하는 머클 트리의 주소
      additionalProperties: false
    TokenData:
      type: object
      required:
        - mint
        - owner
        - amount
        - state
      properties:
        amount:
          $ref: '#/components/schemas/UnsignedInteger'
          description: 이 압축된 토큰 계정에 보유된 토큰 잔액 수량
        delegate:
          $ref: '#/components/schemas/SerializablePubkey'
          description: 이 압축된 토큰 계정에서 작업을 수행할 권한이 있는 선택적 대리인 주소
        mint:
          $ref: '#/components/schemas/SerializablePubkey'
          description: 이 압축된 토큰 계정이 속하는 Solana SPL 토큰 민트 주소
        owner:
          $ref: '#/components/schemas/SerializablePubkey'
          description: 이 압축된 토큰 계정을 소유한 Solana 지갑 주소
        state:
          $ref: '#/components/schemas/AccountState'
          description: 압축된 토큰 계정의 현재 상태 (초기화되었거나 동결됨)
        tlv:
          $ref: '#/components/schemas/Base64String'
          description: 확장된 토큰 계정 정보를 위한 선택적 유형-길이-값 인코딩 데이터
    AccountData:
      type: object
      required:
        - discriminator
        - data
        - dataHash
      properties:
        data:
          $ref: '#/components/schemas/Base64String'
          description: 압축된 Solana 계정의 Base64로 인코딩된 데이터
        dataHash:
          $ref: '#/components/schemas/Hash'
          description: 무결성 검증을 위한 압축된 계정 데이터의 해시
        discriminator:
          $ref: '#/components/schemas/UnsignedInteger'
          description: Solana 프로그램에서 계정 유형의 식별자
      additionalProperties: false
    Hash:
      type: string
      description: Solana 데이터 검증을 위해 base58 문자열로 표시된 32바이트 암호 해시.
      example: 11111112cMQwSC9qirWGjZM6gLGwW69X22mqwLLGP
    UnsignedInteger:
      type: integer
      default: 100
      example: 100
      description: 토큰 수량, 시퀀스 번호 및 기타 숫자 값에 사용되는 비음수 정수 값
    AccountState:
      type: string
      enum:
        - initialized
        - frozen
      description: 압축된 토큰 계정의 현재 상태 (초기화되었거나 동결됨)
    Base64String:
      type: string
      description: 압축된 Solana 계정에 이진 데이터를 저장하기 위한 base 64 인코딩 문자열.
      default: SGVsbG8sIFdvcmxkIQ==
      example: SGVsbG8sIFdvcmxkIQ==
  securitySchemes:
    ApiKeyQuery:
      type: apiKey
      in: query
      name: api-key
      description: >-
        사용자의 Helius API 키입니다. [대시보드](https://dashboard.helius.dev/api-keys)에서
        무료로 받을 수 있습니다.

````