openapi: 3.0.3
info:
  title: Transactions API - Account History
  version: 3.0.3
  description: Fetch account transaction history with optional filters for signer, success status, and sort order.
paths:
  /v0/account:
    post:
      description: Fetch account transaction history with optional filters for signer, success status, and sort order.
      operationId: get_account
      requestBody:
        content:
          application/json:
            example:
              account_id: intents.near
              desc: true
              is_real_signer: true
              is_success: true
              limit: 50
            schema:
              $ref: "#/components/schemas/AccountInput"
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AccountResponse"
          description: Account history result set
        "400":
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApiError"
          description: Bad request
        "500":
          content:
            application/json:
              schema:
                type: string
          description: ClickHouse query failure
      summary: Fetch account transaction history
      tags:
        - account
servers:
  - description: Mainnet
    url: https://tx.main.fastnear.com
  - description: Testnet
    url: https://tx.test.fastnear.com
components:
  schemas:
    AccountInput:
      additionalProperties: false
      properties:
        account_id:
          description: NEAR account to query transactions for (may be a signer, predecessor, receiver, or related party).
          type: string
        desc:
          description: Sort newest-first when true; oldest-first when false or omitted.
          nullable: true
          type: boolean
        from_tx_block_height:
          description: Inclusive lower bound on the transaction's block height.
          format: uint64
          minimum: 0
          nullable: true
          type: integer
        is_action_arg:
          description: Restrict to transactions where this account appeared in action arguments.
          nullable: true
          type: boolean
        is_any_signer:
          description: Restrict to transactions where this account signed either the top-level transaction or a delegated action.
          nullable: true
          type: boolean
        is_delegated_signer:
          description: Restrict to transactions where this account signed a delegated action.
          nullable: true
          type: boolean
        is_event_log:
          description: Restrict to transactions where this account appeared in a JSON event log.
          nullable: true
          type: boolean
        is_explicit_refund_to:
          description: Restrict to transactions where this account was the explicit `refund_to` target of an action receipt.
          nullable: true
          type: boolean
        is_function_call:
          description: Restrict to transactions where this account was the target of a function-call action.
          nullable: true
          type: boolean
        is_predecessor:
          description: Restrict to transactions where this account was the predecessor of a receipt.
          nullable: true
          type: boolean
        is_real_receiver:
          description: Restrict to transactions where this account was the real receiver — excluding relayer receivers and gas refunds.
          nullable: true
          type: boolean
        is_real_signer:
          description: Restrict to transactions where this account was the real signer — direct or delegated, excluding relayer signers.
          nullable: true
          type: boolean
        is_receiver:
          description: Restrict to transactions where this account received a receipt.
          nullable: true
          type: boolean
        is_signer:
          description: Restrict to transactions where this account signed the top-level transaction.
          nullable: true
          type: boolean
        is_success:
          description: Restrict to transactions whose execution succeeded (true) or failed/pending (false).
          nullable: true
          type: boolean
        limit:
          description: Maximum rows to return in one page (1–200).
          format: uint
          maximum: 200
          minimum: 1
          nullable: true
          type: integer
        resume_token:
          default: null
          description: Opaque pagination token returned on a prior page; omit for the first page.
          nullable: true
          type: string
        to_tx_block_height:
          description: Exclusive upper bound on the transaction's block height.
          format: uint64
          minimum: 0
          nullable: true
          type: integer
      required:
        - account_id
      type: object
    AccountResponse:
      additionalProperties: false
      properties:
        account_txs:
          items:
            $ref: "#/components/schemas/AccountTxRow"
          type: array
        resume_token:
          type: string
        txs_count:
          format: uint64
          minimum: 0
          type: integer
      required:
        - account_txs
        - resume_token
        - txs_count
      type: object
    AccountTxRow:
      additionalProperties: false
      properties:
        account_id:
          type: string
        is_action_arg:
          type: boolean
        is_any_signer:
          type: boolean
        is_delegated_signer:
          type: boolean
        is_event_log:
          type: boolean
        is_explicit_refund_to:
          type: boolean
        is_function_call:
          type: boolean
        is_predecessor:
          type: boolean
        is_real_receiver:
          type: boolean
        is_real_signer:
          type: boolean
        is_receiver:
          type: boolean
        is_signer:
          type: boolean
        is_success:
          type: boolean
        transaction_hash:
          type: string
        tx_block_height:
          format: uint64
          minimum: 0
          type: integer
        tx_block_timestamp:
          type: string
        tx_index:
          format: uint32
          minimum: 0
          type: integer
      required:
        - account_id
        - transaction_hash
        - tx_block_height
        - tx_block_timestamp
        - tx_index
        - is_signer
        - is_delegated_signer
        - is_real_signer
        - is_any_signer
        - is_predecessor
        - is_explicit_refund_to
        - is_receiver
        - is_real_receiver
        - is_function_call
        - is_action_arg
        - is_event_log
        - is_success
      type: object
    ApiError:
      additionalProperties: false
      properties:
        error:
          type: string
        message:
          type: string
      required:
        - error
        - message
      type: object