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

# getSignaturesForAddress

> Retorna assinaturas de transações confirmadas que incluem o endereço fornecido em sua lista `accountKeys`. Retorna assinaturas retrocedendo no tempo a partir da assinatura fornecida ou do bloco confirmado mais recente

<Tip>
  Para filtragem, ordenação e histórico de contas de token avançados, use [`getTransactionsForAddress`](/docs/pt-BR/rpc/gettransactionsforaddress) em vez disso. Observe que `getSignaturesForAddress` não inclui transações envolvendo contas de token associadas.
</Tip>

## Parâmetros da Solicitação

<ParamField body="address" type="string" required>
  Endereço da conta Solana para recuperar o histórico de transações (carteira, token, programa, NFT, etc.).
</ParamField>

<ParamField body="commitment" type="string">
  O nível de compromisso para a solicitação. O compromisso `processed` não é suportado.

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

<ParamField body="minContextSlot" type="number">
  O slot mínimo em que a solicitação pode ser avaliada.
</ParamField>

<ParamField body="limit" type="number">
  Número máximo de assinaturas de transações a serem retornadas em uma única solicitação (1-1.000).
</ParamField>

<ParamField body="before" type="string">
  Parâmetro de paginação para obter transações antes desta assinatura (mais antigo no tempo).
</ParamField>

<ParamField body="until" type="string">
  Obtenha transações até que esta assinatura seja alcançada, útil para intervalos de tempo específicos.
</ParamField>


## OpenAPI

````yaml pt-BR/openapi/rpc-http/getSignaturesForAddress.yaml POST /
openapi: 3.1.0
info:
  title: Solana RPC API
  version: 1.0.0
  description: >-
    API abrangente de histórico de transações Solana para recuperar e analisar
    atividades históricas de blockchain associadas a qualquer endereço de
    carteira ou programa.
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
  - url: https://mainnet.helius-rpc.com
    description: Endpoint RPC Mainnet
  - url: https://devnet.helius-rpc.com
    description: Endpoint RPC Devnet
security: []
paths:
  /:
    post:
      tags:
        - RPC
      summary: getSignaturesForAddress
      description: >
        Recupere assinaturas de transações para atividades envolvendo um
        endereço específico do Solana com paginação poderosa.

        Esta API essencial fornece histórico de transações para qualquer
        carteira Solana, token, programa ou endereço NFT,

        retornando assinaturas de transações cronológicas com seu status, tempo
        e resultados de execução.

        Perfeito para construir históricos de transações de carteira,
        monitoramento de atividade de programas, análise de endereços

        e qualquer aplicação que precise rastrear operações históricas na
        blockchain Solana.

        Suporta paginação flexível para acessar o histórico completo de
        transações.
      operationId: getSignaturesForAddress
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - jsonrpc
                - id
                - method
                - params
              properties:
                jsonrpc:
                  type: string
                  enum:
                    - '2.0'
                  example: '2.0'
                  description: A versão do protocolo JSON-RPC.
                  default: '2.0'
                id:
                  type: string
                  example: '1'
                  description: Um identificador único para a solicitação.
                  default: '1'
                method:
                  type: string
                  enum:
                    - getSignaturesForAddress
                  example: getSignaturesForAddress
                  description: O nome do método RPC a ser invocado.
                  default: getSignaturesForAddress
                params:
                  type: array
                  description: >-
                    Array contendo o endereço de conta obrigatório e um objeto
                    de configuração opcional.
                  default:
                    - Vote111111111111111111111111111111111111111
                  items:
                    oneOf:
                      - type: string
                        description: >-
                          Endereço da conta Solana para recuperar histórico de
                          transações (carteira, token, programa, NFT, etc.).
                        example: Vote111111111111111111111111111111111111111
                      - type: object
                        description: >-
                          Configuração de consulta avançada para personalizar a
                          recuperação de histórico de transações.
                        properties:
                          commitment:
                            type: string
                            description: >-
                              O nível de comprometimento para a solicitação. O
                              comprometimento `processed` não é suportado.
                            enum:
                              - confirmed
                              - finalized
                            example: finalized
                          minContextSlot:
                            type: integer
                            description: >-
                              O slot mínimo em que a solicitação pode ser
                              avaliada.
                            example: 1000
                          limit:
                            type: integer
                            description: >-
                              Número máximo de assinaturas de transações a serem
                              retornadas em uma única solicitação (1-1.000).
                            example: 1000
                          before:
                            type: string
                            description: >-
                              Parâmetro de paginação para obter transações antes
                              desta assinatura (mais cedo no tempo).
                            example: >-
                              5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
                          until:
                            type: string
                            description: >-
                              Obter transações até que esta assinatura seja
                              alcançada, útil para intervalos de tempo
                              específicos.
                            example: >-
                              3jweEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
      responses:
        '200':
          description: Assinaturas recuperadas com sucesso para o endereço especificado.
          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: array
                    description: Lista de informações de assinatura de transações.
                    items:
                      type: object
                      description: Detalhes para cada assinatura de transação.
                      properties:
                        signature:
                          type: string
                          description: >-
                            Assinatura da transação como uma string codificada
                            em base-58.
                          example: >-
                            5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
                        slot:
                          type: integer
                          description: O slot que contém o bloco com a transação.
                          example: 114
                        err:
                          oneOf:
                            - type: object
                              description: Erro se a transação falhou.
                            - type: 'null'
                          description: Erro se a transação falhou, ou null se bem-sucedida.
                          example: null
                        memo:
                          oneOf:
                            - type: string
                              description: Memo associado à transação.
                            - type: 'null'
                          description: Memo associado à transação, ou null se não houver.
                          example: null
                        blockTime:
                          oneOf:
                            - type: integer
                              description: Tempo estimado de produção como timestamp Unix.
                            - type: 'null'
                          description: >-
                            Tempo estimado de produção como timestamp Unix
                            (segundos desde a época), ou null se não disponível.
                          example: null
                        confirmationStatus:
                          oneOf:
                            - type: string
                              enum:
                                - processed
                                - confirmed
                                - finalized
                              description: Status de confirmação do cluster da transação.
                            - type: 'null'
                          description: Status de confirmação do cluster da transação.
                          example: finalized
              examples:
                response:
                  value:
                    jsonrpc: '2.0'
                    id: 1
                    result:
                      - signature: >-
                          5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
                        slot: 114
                        err: null
                        memo: null
                        blockTime: null
                        confirmationStatus: finalized
            application/json; schema=examples/request:
              example:
                jsonrpc: '2.0'
                id: 1
                method: getSignaturesForAddress
                params:
                  - Vote111111111111111111111111111111111111111
                  - limit: 1
        '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: Invalid params
                id: '1'
        '401':
          description: Não autorizado - Chave API inválida ou ausente.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32001
                  message: Unauthorized
                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: Too many requests
                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: Internal error
                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: Service unavailable
                id: '1'
        '504':
          description: Tempo Limite do Gateway - A solicitação expirou.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32003
                  message: Gateway timeout
                id: '1'
      security:
        - ApiKeyQuery: []
components:
  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).

````