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

> 주어진 주소를 `accountKeys` 목록에 포함하는 확인된 거래에 대한 서명을 반환합니다. 제공된 서명 또는 가장 최근의 확인된 블록부터 시간을 거슬러 올라가면서 서명을 반환합니다.

<Tip>
  고급 필터링, 정렬 및 토큰 계정 기록을 위해 [`getTransactionsForAddress`](/docs/ko/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 ko/openapi/rpc-http/getSignaturesForAddress.yaml POST /
openapi: 3.1.0
info:
  title: Solana RPC API
  version: 1.0.0
  description: 모든 지갑 주소나 프로그램과 관련된 과거 블록체인 활동을 검색하고 분석할 수 있는 종합적인 Solana 거래 내역 API입니다.
  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: Devnet RPC 엔드포인트
security: []
paths:
  /:
    post:
      tags:
        - RPC
      summary: getSignaturesForAddress
      description: >
        특정 Solana 주소와 관련된 활동에 대한 거래 서명을 검색합니다. 강력한 페이지 매김을 제공합니다.

        이 필수 API는 모든 Solana 지갑, 토큰, 프로그램, NFT 주소에 대한 거래 내역을 제공하며,

        서명 상태, 시간, 실행 결과와 함께 연대순으로 거래 서명을 반환합니다.

        지갑 거래 내역 빌드, 프로그램 활동 모니터링, 주소 분석 및 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: 거래 서명(베이스-58 인코딩 문자열).
                          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: >-
        귀하의 Helius API 키입니다.
        [dashboard](https://dashboard.helius.dev/api-keys)에서 무료로 얻을 수 있습니다.

````