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

# pendingTraces | TON v3

> The pendingTraces endpoint retrieves traces that are pending completion in the TON blockchain. Available on TON v3 via Chainstack.

# Pending Traces

The `pendingTraces` endpoint retrieves traces that are pending completion in the TON blockchain. These represent transaction execution flows that have not yet fully propagated through all necessary contracts.

<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

* `trace_id` (string, optional) — Filter by specific trace ID.
* `limit` (integer, optional) — Maximum number of traces to return. Default: `10`.
* `offset` (integer, optional) — Number of traces to skip for pagination. Default: `0`.

## Response

* `traces` (array) — Array of pending trace objects:
  * `trace_id` (string) — Trace ID.
  * `external_hash` (string) — Hash of the external message.
  * `mc_seqno_start` (integer) — Start masterchain sequence number.
  * `start_lt` (integer) — Start logical time.
  * `start_utime` (integer) — Start unix timestamp.
  * `state` (string) — Trace state (e.g., `pending`).
  * `pending_edges` (integer) — Number of pending message edges.
  * `edges` (integer) — Total edges so far.
  * `nodes` (integer) — Total nodes so far.

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

## Use case

The `pendingTraces` endpoint is essential for tracking in-progress complex operations:

1. Monitoring multi-hop transactions that involve several contracts.
2. Tracking Jetton transfers waiting for completion across wallet contracts.
3. Debugging stuck transactions by identifying pending message edges.
4. Building real-time dashboards showing transaction progress.
5. Implementing timeout alerts for transactions taking too long.

Here's an example of getting pending traces:

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

<Tip>
  The `pending_edges` field indicates how many messages are still being processed. A trace completes when this reaches zero.
</Tip>


## OpenAPI

````yaml openapi/ton_node_api/v3/getPendingTraces.json GET /pendingTraces
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:
  /pendingTraces:
    get:
      tags:
        - Traces
      summary: Get Pending Traces
      description: Get traces that are pending completion
      operationId: getPendingTraces
      parameters:
        - name: trace_id
          in: query
          description: Filter by trace ID
          schema:
            type: string
        - name: limit
          in: query
          description: Maximum number of traces to return
          schema:
            type: integer
            default: 10
        - name: offset
          in: query
          description: Number of traces to skip
          schema:
            type: integer
            default: 0
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  traces:
                    type: array
                    items:
                      type: object
                      properties:
                        trace_id:
                          type: string
                          description: Trace ID
                        external_hash:
                          type: string
                          description: External message hash
                        mc_seqno_start:
                          type: integer
                          description: Start masterchain sequence number
                        start_lt:
                          type: integer
                          description: Start logical time
                        start_utime:
                          type: integer
                          description: Start unix timestamp
                        state:
                          type: string
                          description: Trace state (pending)
                        pending_edges:
                          type: integer
                          description: Number of pending message edges
                        edges:
                          type: integer
                          description: Total edges
                        nodes:
                          type: integer
                          description: Total nodes
                  address_book:
                    type: object
                    description: Address book mapping

````