> ## 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. # getTokenAccountBalance > Retorna o saldo de token de uma conta de Token SPL. ## Parâmetros da Solicitação Endereço da conta de token SPL Solana para consultar as informações de saldo, como uma string codificada em base-58. O nível de compromisso para a solicitação. * `confirmed` * `finalized` * `processed` ## OpenAPI ````yaml pt-BR/openapi/rpc-http/getTokenAccountBalance.yaml POST / openapi: 3.1.0 info: title: Solana RPC API version: 1.0.0 description: >- API rápida e confiável de recuperação de saldo de token SPL da Solana para acessar saldos de tokens fungíveis e NFTs com formatação decimal adequada e valores legíveis para humanos. license: name: Apache 2.0 url: https://www.apache.org/licenses/LICENSE-2.0.html servers: - url: https://mainnet.helius-rpc.com description: Ponto de extremidade Mainnet RPC - url: https://devnet.helius-rpc.com description: Ponto de extremidade Devnet RPC security: [] paths: /: post: tags: - RPC summary: getTokenAccountBalance description: > Recupere saldos de tokens SPL de qualquer conta de token Solana com formatação decimal adequada. Esta API essencial fornece acesso a saldos de tokens fungíveis, participações NFT e outros dados de tokens SPL com suporte para casas decimais específicas do token para exibição precisa. Retorna saldos brutos e formatados com valores legíveis para humanos, críticos para wallets, aplicações DeFi, exchanges e qualquer serviço que precise exibir saldos de tokens para os usuários. operationId: getTokenAccountBalance requestBody: required: true content: application/json: schema: type: object properties: jsonrpc: type: string enum: - '2.0' description: A versão do protocolo JSON-RPC. example: '2.0' default: '2.0' id: type: string description: Um identificador único para a solicitação. example: '1' default: '1' method: type: string enum: - getTokenAccountBalance description: O nome do método RPC a ser invocado. example: getTokenAccountBalance default: getTokenAccountBalance params: type: array description: Parâmetros para consulta do saldo da conta do token. default: - 3emsAVdmGKERbHjmGfQ6oZ1e35dkf5iYcS6U4CPKFVaa items: oneOf: - type: string description: >- Endereço da conta de token SPL Solana a ser consultado para informações de saldo, como uma string codificada em base-58. example: 3emsAVdmGKERbHjmGfQ6oZ1e35dkf5iYcS6U4CPKFVaa - type: object description: Opções de configuração. properties: commitment: type: string description: O nível de compromisso para a solicitação. enum: - confirmed - finalized - processed example: finalized responses: '200': description: Saldo da conta do token recuperado com sucesso. content: application/json: schema: type: object properties: jsonrpc: type: string description: A versão do protocolo JSON-RPC. enum: - '2.0' example: '2.0' id: type: string description: Identificador correspondente à solicitação. example: '1' result: type: object description: Detalhes do contexto e saldo da conta do token. properties: context: type: object description: Contexto da resposta. properties: slot: type: integer description: Slot no qual os dados foram buscados. example: 1114 value: type: object description: Detalhes do saldo da conta do token. properties: amount: type: string description: >- O saldo bruto do token Solana como uma string inteira sem formatação decimal. example: '9864' decimals: type: integer description: >- Número de casas decimais definidas pela cunhagem do token para formatação de exibição adequada. example: 2 uiAmount: type: number description: >- O saldo do token Solana legível com formatação decimal adequada (obsoleto). example: 98.64 uiAmountString: type: string description: >- A representação canônica em string do saldo do token com casas decimais adequadas. example: '98.64' examples: default: $ref: '#/components/examples/getTokenAccountBalanceResponse' '400': description: >- Bad Request - Parâmetros de solicitação inválidos ou solicitação malformada. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: jsonrpc: '2.0' error: code: -32602 message: Parâmetros inválidos id: '1' '401': description: Não autorizado - Chave de API inválida ou ausente. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: jsonrpc: '2.0' error: code: -32001 message: Não autorizado id: '1' '429': description: Muitas Solicitações - Limite de taxa excedido. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: jsonrpc: '2.0' error: code: -32005 message: Muitas solicitações id: '1' '500': description: Erro Interno do Servidor - Ocorreu um erro no servidor. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: jsonrpc: '2.0' error: code: -32603 message: Erro interno id: '1' '503': description: Serviço Indisponível - O serviço está temporariamente indisponível. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: jsonrpc: '2.0' error: code: -32002 message: Serviço indisponível id: '1' '504': description: >- Tempo Limite do Gateway - O tempo limite da solicitação foi excedido. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: jsonrpc: '2.0' error: code: -32003 message: Tempo limite do gateway id: '1' security: - ApiKeyQuery: [] components: examples: getTokenAccountBalanceResponse: value: jsonrpc: '2.0' id: '1' result: context: slot: 1114 value: amount: '9864' decimals: 2 uiAmount: 98.64 uiAmountString: '98.64' schemas: ErrorResponse: type: object properties: jsonrpc: type: string description: A versão do protocolo JSON-RPC. enum: - '2.0' example: '2.0' error: type: object properties: code: type: integer description: O código de erro. example: -32602 message: type: string description: A mensagem de erro. data: type: object description: Dados adicionais sobre o erro. id: type: string description: Identificador correspondente à solicitação. example: '1' securitySchemes: ApiKeyQuery: type: apiKey in: query name: api-key description: >- Sua chave API Helius. Você pode obter uma gratuitamente no [dashboard](https://dashboard.helius.dev/api-keys). ````