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

> getSignaturesForAddress возвращает подтвержденные подписи транзакций, содержащих адрес Solana в accountKeys, в обратном хронологическом порядке, начиная с самого последнего блока.

<Tip>
  Для расширенной фильтрации, сортировки и просмотра истории токен-аккаунта используйте вместо этого [`getTransactionsForAddress`](/docs/ru/rpc/gettransactionsforaddress). Обратите внимание, что `getSignaturesForAddress` не включает транзакции, связанные с ассоциированными токен-аккаунтами.
</Tip>

## Параметры запроса

<ParamField body="address" type="string" required>
  Адрес аккаунта Solana, для которого нужно получить историю транзакций (кошелек, токен, программа, NFT и т. д.).
</ParamField>

<ParamField body="commitment" type="string">
  Уровень подтверждения для запроса. Уровень подтверждения `processed` не поддерживается.

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

<ParamField body="minContextSlot" type="number">
  Минимальный слот, на котором может быть обработан запрос.
</ParamField>

<ParamField body="limit" type="number">
  Максимальное количество подписей транзакций, возвращаемых в одном запросе (1–1 000).
</ParamField>

<ParamField body="before" type="string">
  Параметр пагинации для получения транзакций до этой подписи (более ранних по времени).
</ParamField>

<ParamField body="until" type="string">
  Получать транзакции до достижения этой подписи. Это удобно для указания определенных временных диапазонов.
</ParamField>


## OpenAPI

````yaml ru/openapi/rpc-http/getSignaturesForAddress.yaml POST /
openapi: 3.1.0
info:
  title: Solana RPC API
  version: 1.0.0
  description: >-
    Комплексный API истории транзакций Solana для получения и анализа
    исторической активности в блокчейне, связанной с любым адресом кошелька или
    программой.
  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: Конечная точка RPC тестовой сети Devnet
security: []
paths:
  /:
    post:
      tags:
        - RPC
      summary: getSignaturesForAddress
      description: >
        Получайте подписи транзакций для операций, связанных с определенным
        адресом Solana, с расширенными возможностями пагинации.

        Этот важный API предоставляет историю транзакций для любого адреса
        кошелька, токена, программы или NFT в Solana,

        возвращая подписи транзакций в хронологическом порядке вместе с их
        статусом, временем и результатами выполнения.

        Идеально подходит для создания истории транзакций кошелька, мониторинга
        активности программ, анализа адресов

        и любых приложений, которым требуется отслеживать исторические операции
        в блокчейне Solana.

        Поддерживает гибкую пагинацию для доступа к полной истории транзакций.
      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: Версия протокола JSON-RPC.
                  default: '2.0'
                id:
                  type: string
                  example: '1'
                  description: Уникальный идентификатор запроса.
                  default: '1'
                method:
                  type: string
                  enum:
                    - getSignaturesForAddress
                  example: getSignaturesForAddress
                  description: Имя вызываемого метода RPC.
                  default: getSignaturesForAddress
                params:
                  type: array
                  description: >-
                    Массив, содержащий обязательный адрес учетной записи и
                    необязательный объект конфигурации.
                  default:
                    - Vote111111111111111111111111111111111111111
                  items:
                    oneOf:
                      - type: string
                        description: >-
                          Адрес учетной записи Solana, для которого требуется
                          получить историю транзакций (кошелек, токен,
                          программа, NFT и т. д.).
                        example: Vote111111111111111111111111111111111111111
                      - type: object
                        description: >-
                          Расширенная конфигурация запроса для настройки
                          получения истории транзакций.
                        properties:
                          commitment:
                            type: string
                            description: >-
                              Уровень подтверждения для запроса. Уровень
                              подтверждения `processed` не поддерживается.
                            enum:
                              - confirmed
                              - finalized
                            example: finalized
                          minContextSlot:
                            type: integer
                            description: >-
                              Минимальный слот, в котором может быть обработан
                              запрос.
                            example: 1000
                          limit:
                            type: integer
                            description: >-
                              Максимальное количество подписей транзакций,
                              возвращаемых за один запрос (1–1 000).
                            example: 1000
                          before:
                            type: string
                            description: >-
                              Параметр пагинации для получения транзакций,
                              предшествующих этой подписи (более ранних по
                              времени).
                            example: >-
                              5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
                          until:
                            type: string
                            description: >-
                              Получайте транзакции до достижения этой подписи.
                              Это удобно для указания определенных временных
                              диапазонов.
                            example: >-
                              3jweEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
      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: array
                    description: Список сведений о подписях транзакций.
                    items:
                      type: object
                      description: Подробные сведения о каждой подписи транзакции.
                      properties:
                        signature:
                          type: string
                          description: Подпись транзакции в виде строки в кодировке base58.
                          example: >-
                            5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
                        slot:
                          type: integer
                          description: Слот, содержащий блок с транзакцией.
                          example: 114
                        err:
                          oneOf:
                            - type: object
                              description: Ошибка, если транзакция завершилась неудачно
                            - type: 'null'
                          description: >-
                            Ошибка, если транзакция завершилась неудачно, или
                            null в случае успеха.
                          example: null
                        memo:
                          oneOf:
                            - type: string
                              description: Примечание, связанное с транзакцией
                            - type: 'null'
                          description: >-
                            Примечание, связанное с транзакцией, или null, если
                            оно отсутствует.
                          example: null
                        blockTime:
                          oneOf:
                            - type: integer
                              description: >-
                                Расчетное время создания в виде временной метки
                                Unix
                            - type: 'null'
                          description: >-
                            Расчетное время создания в виде временной метки Unix
                            (в секундах с начала эпохи) или null, если оно
                            недоступно.
                          example: null
                        confirmationStatus:
                          oneOf:
                            - type: string
                              enum:
                                - processed
                                - confirmed
                                - finalized
                              description: Статус подтверждения транзакции кластером
                            - type: 'null'
                          description: Статус подтверждения транзакции кластером.
                          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: >-
            Некорректный запрос — недопустимые параметры запроса или неверный
            формат запроса.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32602
                  message: Invalid params
                id: '1'
        '401':
          description: Не авторизовано — ключ API недействителен или отсутствует.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32001
                  message: Unauthorized
                id: '1'
        '429':
          description: Слишком много запросов — превышено ограничение частоты запросов.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32005
                  message: Too many requests
                id: '1'
        '500':
          description: Внутренняя ошибка сервера — на сервере произошла ошибка.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32603
                  message: Internal error
                id: '1'
        '503':
          description: Сервис недоступен — сервис временно недоступен.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32002
                  message: Service unavailable
                id: '1'
        '504':
          description: Истекло время ожидания шлюза — превышено время ожидания запроса.
          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: Версия протокола 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: >-
        Ваш ключ API Helius. Его можно бесплатно получить на [панели
        управления](https://dashboard.helius.dev/api-keys).

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.