> ## 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 trả về các chữ ký giao dịch đã xác nhận có chứa một địa chỉ Solana trong accountKeys, theo thứ tự ngược thời gian từ khối gần đây nhất.

<Tip>
  Để lọc, sắp xếp nâng cao và xem lịch sử tài khoản token, hãy sử dụng [`getTransactionsForAddress`](/docs/vi/rpc/gettransactionsforaddress). Lưu ý rằng `getSignaturesForAddress` không bao gồm các giao dịch liên quan đến tài khoản token liên kết.
</Tip>

## Tham số yêu cầu

<ParamField body="address" type="string" required>
  Địa chỉ tài khoản Solana cần truy xuất lịch sử giao dịch (ví, token, chương trình, NFT, v.v.).
</ParamField>

<ParamField body="commitment" type="string">
  Mức độ cam kết cho yêu cầu. Mức cam kết `processed` không được hỗ trợ.

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

<ParamField body="minContextSlot" type="number">
  Slot tối thiểu mà tại đó yêu cầu có thể được đánh giá.
</ParamField>

<ParamField body="limit" type="number">
  Số lượng chữ ký giao dịch tối đa được trả về trong một yêu cầu (1-1.000).
</ParamField>

<ParamField body="before" type="string">
  Tham số phân trang để lấy các giao dịch trước chữ ký này (sớm hơn theo thời gian).
</ParamField>

<ParamField body="until" type="string">
  Lấy các giao dịch cho đến khi gặp chữ ký này, hữu ích khi truy vấn các khoảng thời gian cụ thể.
</ParamField>


## OpenAPI

````yaml vi/openapi/rpc-http/getSignaturesForAddress.yaml POST /
openapi: 3.1.0
info:
  title: API RPC Solana
  version: 1.0.0
  description: >-
    API lịch sử giao dịch Solana toàn diện để truy xuất và phân tích các hoạt
    động blockchain trong quá khứ liên quan đến bất kỳ địa chỉ ví hoặc chương
    trình nào.
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
  - url: https://mainnet.helius-rpc.com
    description: Điểm cuối RPC Mainnet
  - url: https://devnet.helius-rpc.com
    description: Điểm cuối RPC Devnet
security: []
paths:
  /:
    post:
      tags:
        - RPC
      summary: getSignaturesForAddress
      description: >
        Truy xuất chữ ký giao dịch cho hoạt động liên quan đến một địa chỉ
        Solana cụ thể với khả năng phân trang mạnh mẽ.

        API thiết yếu này cung cấp lịch sử giao dịch cho bất kỳ địa chỉ ví,
        token, chương trình hoặc NFT Solana nào,

        trả về các chữ ký giao dịch theo trình tự thời gian cùng trạng thái,
        thời điểm và kết quả thực thi.

        Lý tưởng để xây dựng lịch sử giao dịch ví, giám sát hoạt động chương
        trình, phân tích địa chỉ

        và mọi ứng dụng cần theo dõi các hoạt động trong quá khứ trên blockchain
        Solana.

        Hỗ trợ phân trang linh hoạt để truy cập toàn bộ lịch sử giao dịch.
      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: Phiên bản giao thức JSON-RPC.
                  default: '2.0'
                id:
                  type: string
                  example: '1'
                  description: Mã định danh duy nhất cho yêu cầu.
                  default: '1'
                method:
                  type: string
                  enum:
                    - getSignaturesForAddress
                  example: getSignaturesForAddress
                  description: Tên của phương thức RPC cần gọi.
                  default: getSignaturesForAddress
                params:
                  type: array
                  description: >-
                    Mảng chứa địa chỉ tài khoản bắt buộc và đối tượng cấu hình
                    tùy chọn.
                  default:
                    - Vote111111111111111111111111111111111111111
                  items:
                    oneOf:
                      - type: string
                        description: >-
                          Địa chỉ tài khoản Solana cần truy xuất lịch sử giao
                          dịch (ví, token, chương trình, NFT, v.v.).
                        example: Vote111111111111111111111111111111111111111
                      - type: object
                        description: >-
                          Cấu hình truy vấn nâng cao để tùy chỉnh việc truy xuất
                          lịch sử giao dịch.
                        properties:
                          commitment:
                            type: string
                            description: >-
                              Mức cam kết cho yêu cầu. Mức cam kết `processed`
                              không được hỗ trợ.
                            enum:
                              - confirmed
                              - finalized
                            example: finalized
                          minContextSlot:
                            type: integer
                            description: >-
                              Slot tối thiểu mà tại đó yêu cầu có thể được đánh
                              giá.
                            example: 1000
                          limit:
                            type: integer
                            description: >-
                              Số chữ ký giao dịch tối đa được trả về trong một
                              yêu cầu (1-1.000).
                            example: 1000
                          before:
                            type: string
                            description: >-
                              Tham số phân trang để lấy các giao dịch trước chữ
                              ký này (sớm hơn về thời gian).
                            example: >-
                              5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
                          until:
                            type: string
                            description: >-
                              Lấy giao dịch cho đến khi gặp chữ ký này, hữu ích
                              cho các khoảng thời gian cụ thể.
                            example: >-
                              3jweEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
      responses:
        '200':
          description: Đã truy xuất thành công các chữ ký cho địa chỉ được chỉ định.
          content:
            application/json:
              schema:
                type: object
                properties:
                  jsonrpc:
                    type: string
                    description: Phiên bản giao thức JSON-RPC.
                    enum:
                      - '2.0'
                    example: '2.0'
                  id:
                    type: string
                    description: Mã định danh khớp với yêu cầu.
                    example: '1'
                  result:
                    type: array
                    description: Danh sách thông tin chữ ký giao dịch.
                    items:
                      type: object
                      description: Chi tiết của từng chữ ký giao dịch.
                      properties:
                        signature:
                          type: string
                          description: >-
                            Chữ ký giao dịch dưới dạng chuỗi được mã hóa
                            base-58.
                          example: >-
                            5h6xBEauJ3PK6SWCZ1PGjBvj8vDdWG3KpwATGy1ARAXFSDwt8GFXM7W5Ncn16wmqokgpiKRLuS83KUxyZyv2sUYv
                        slot:
                          type: integer
                          description: Slot chứa khối có giao dịch.
                          example: 114
                        err:
                          oneOf:
                            - type: object
                              description: Lỗi nếu giao dịch thất bại
                            - type: 'null'
                          description: Lỗi nếu giao dịch thất bại hoặc null nếu thành công.
                          example: null
                        memo:
                          oneOf:
                            - type: string
                              description: Ghi chú liên kết với giao dịch
                            - type: 'null'
                          description: >-
                            Ghi chú liên kết với giao dịch hoặc null nếu không
                            có.
                          example: null
                        blockTime:
                          oneOf:
                            - type: integer
                              description: >-
                                Thời gian tạo ước tính dưới dạng dấu thời gian
                                Unix
                            - type: 'null'
                          description: >-
                            Thời gian tạo ước tính dưới dạng dấu thời gian Unix
                            (số giây kể từ epoch) hoặc null nếu không có.
                          example: null
                        confirmationStatus:
                          oneOf:
                            - type: string
                              enum:
                                - processed
                                - confirmed
                                - finalized
                              description: Trạng thái xác nhận của cụm đối với giao dịch
                            - type: 'null'
                          description: Trạng thái xác nhận của cụm đối với giao dịch.
                          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: >-
            Yêu cầu không hợp lệ - Tham số yêu cầu không hợp lệ hoặc yêu cầu sai
            định dạng.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32602
                  message: Tham số không hợp lệ
                id: '1'
        '401':
          description: Không được phép - Khóa API không hợp lệ hoặc bị thiếu.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32001
                  message: Không được phép
                id: '1'
        '429':
          description: Quá nhiều yêu cầu - Đã vượt quá giới hạn tốc độ.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32005
                  message: Quá nhiều yêu cầu
                id: '1'
        '500':
          description: Lỗi máy chủ nội bộ - Đã xảy ra lỗi trên máy chủ.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32603
                  message: Lỗi nội bộ
                id: '1'
        '503':
          description: Dịch vụ không khả dụng - Dịch vụ tạm thời không khả dụng.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32002
                  message: Dịch vụ không khả dụng
                id: '1'
        '504':
          description: Hết thời gian chờ cổng kết nối - Yêu cầu đã hết thời gian chờ.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                jsonrpc: '2.0'
                error:
                  code: -32003
                  message: Hết thời gian chờ cổng kết nối
                id: '1'
      security:
        - ApiKeyQuery: []
components:
  schemas:
    ErrorResponse:
      type: object
      properties:
        jsonrpc:
          type: string
          description: Phiên bản giao thức JSON-RPC.
          enum:
            - '2.0'
          example: '2.0'
        error:
          type: object
          properties:
            code:
              type: integer
              description: Mã lỗi.
              example: -32602
            message:
              type: string
              description: Thông báo lỗi.
            data:
              type: object
              description: Dữ liệu bổ sung về lỗi.
        id:
          type: string
          description: Mã định danh khớp với yêu cầu.
          example: '1'
  securitySchemes:
    ApiKeyQuery:
      type: apiKey
      in: query
      name: api-key
      description: >-
        Khóa API Helius của bạn. Bạn có thể nhận khóa miễn phí trong [bảng điều
        khiển](https://dashboard.helius.dev/api-keys).

````