> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chainstack.com/llms.txt
> Use this file to discover all available pages before exploring further.

# pendingTransactions | TON v3

> The pendingTransactions endpoint retrieves transactions that are pending finalization in the TON blockchain. TON v3 via Chainstack.

# Pending Transactions

The `pendingTransactions` endpoint retrieves transactions that are pending finalization in the TON blockchain. These are transactions that have been included in a block but may not yet be fully confirmed.

<Note>
  **TON billing: full (1 RU)**

  This method is always billed as full. See [Request units — TON method scope](/docs/request-units#ton-method-scope).
</Note>

## Parameters

* `account` (string, optional) — Filter by account address.
* `limit` (integer, optional) — Maximum number of transactions to return. Default: `10`.
* `offset` (integer, optional) — Number of transactions to skip for pagination. Default: `0`.

## Response

* `transactions` (array) — Array of pending transaction objects:
  * `account` (string) — Account address.
  * `hash` (string) — Transaction hash.
  * `lt` (integer) — Logical time.
  * `now` (integer) — Unix timestamp.
  * `mc_block_seqno` (integer) — Masterchain block sequence number.
  * `trace_id` (string) — Associated trace ID.

* `address_book` (object) — Address book mapping.

## Use case

The `pendingTransactions` endpoint is useful for monitoring real-time transaction status:

1. Wallet applications showing recently submitted transactions before full confirmation.
2. Trading bots tracking order execution in real-time.
3. Payment systems providing instant feedback on transaction status.
4. Block explorers showing live transaction feeds.
5. Monitoring systems tracking specific account activity.

Here's an example of getting pending transactions:

<CodeGroup>
  ```shell shell theme={"system"}
  curl -X GET \
    'https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v3/pendingTransactions?limit=5' \
    -H 'accept: application/json'
  ```
</CodeGroup>

<Tip>
  Pending transactions will eventually move to the regular [transactions](/reference/ton-transactions-v3) endpoint once fully confirmed. Use this endpoint for real-time monitoring.
</Tip>


## OpenAPI

````yaml openapi/ton_node_api/v3/getPendingTransactions.json GET /pendingTransactions
openapi: 3.0.0
info:
  title: TON API
  version: 3.0.0
  description: API for interacting with The Open Network (TON) blockchain
servers:
  - url: >-
      https://ton-mainnet.core.chainstack.com/f2a2411bce1e54a2658f2710cd7969c3/api/v3
security: []
paths:
  /pendingTransactions:
    get:
      tags:
        - Transactions
      summary: Get Pending Transactions
      description: Get transactions that are pending finalization
      operationId: getPendingTransactions
      parameters:
        - name: account
          in: query
          description: Filter by account address
          schema:
            type: string
        - name: limit
          in: query
          description: Maximum number of transactions to return
          schema:
            type: integer
            default: 10
        - name: offset
          in: query
          description: Number of transactions to skip
          schema:
            type: integer
            default: 0
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  transactions:
                    type: array
                    items:
                      type: object
                      properties:
                        account:
                          type: string
                          description: Account address
                        hash:
                          type: string
                          description: Transaction hash
                        lt:
                          type: integer
                          description: Logical time
                        now:
                          type: integer
                          description: Unix timestamp
                        mc_block_seqno:
                          type: integer
                          description: Masterchain block sequence number
                        trace_id:
                          type: string
                          description: Associated trace ID
                  address_book:
                    type: object
                    description: Address book mapping

````