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

# getCompressedTokenAccountBalance

> 주어진 토큰 계정의 잔액을 반환합니다.

## 요청 매개변수

<ParamField body="address" type="string" default="111111131h1vYVSYuKP6AhS86fbRdMw9XHiZAvAaj">
  base58 문자열로 표현된 Solana 공개 키입니다.
</ParamField>

<ParamField body="hash" type="string">
  base58 문자열로 표현된 32바이트 해시입니다.
</ParamField>


## OpenAPI

````yaml ko/openapi/zk-compression/getCompressedTokenAccountBalance.yaml POST /
openapi: 3.0.3
info:
  title: photon-indexer
  description: 일반 압축을 위한 Solana 인덱서
  license:
    name: Apache-2.0
  version: 0.50.0
servers:
  - url: https://mainnet.helius-rpc.com
    description: Mainnet RPC 엔드포인트
  - url: https://devnet.helius-rpc.com
    description: Devnet RPC 엔드포인트
security: []
paths:
  /:
    summary: getCompressedTokenAccountBalance
    post:
      description: getCompressedTokenAccountBalance 정보를 검색합니다.
      operationId: getCompressedTokenAccountBalance
      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:
                    - getCompressedTokenAccountBalance
                  default: getCompressedTokenAccountBalance
                params:
                  type: object
                  description: 압축된 계정 데이터에 대한 요청
                  default:
                    address: null
                    hash: '11111111111111111111111111111111'
                  properties:
                    address:
                      allOf:
                        - $ref: '#/components/schemas/SerializablePubkey'
                      nullable: true
                    hash:
                      allOf:
                        - $ref: '#/components/schemas/Hash'
                      nullable: true
                  additionalProperties: false
                  example:
                    address: null
                    hash: '11111111111111111111111111111111'
        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/TokenAccountBalance'
                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:
    SerializablePubkey:
      type: string
      description: base58 문자열로 표현된 Solana 공개 키.
      default: 111111131h1vYVSYuKP6AhS86fbRdMw9XHiZAvAaj
      example: 111111131h1vYVSYuKP6AhS86fbRdMw9XHiZAvAaj
    Hash:
      type: string
      description: base58 문자열로 표현된 32바이트 해시.
      example: 11111112cMQwSC9qirWGjZM6gLGwW69X22mqwLLGP
    Context:
      type: object
      required:
        - slot
      properties:
        slot:
          type: integer
          default: 100
          example: 100
    TokenAccountBalance:
      type: object
      required:
        - amount
      properties:
        amount:
          $ref: '#/components/schemas/UnsignedInteger'
      additionalProperties: false
    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'
    UnsignedInteger:
      type: integer
      default: 100
      example: 100
  securitySchemes:
    ApiKeyQuery:
      type: apiKey
      in: query
      name: api-key
      description: >-
        귀하의 Helius API 키입니다. 무료로 [대시보드](https://dashboard.helius.dev/api-keys)에서
        받을 수 있습니다.

````