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

# nft/transfers | TON v3

> The nft/transfers endpoint retrieves a list of NFT (Non-Fungible Token) transfers from the TON blockchain. Chainstack TON v3 reference.

The `nft/transfers` endpoint retrieves a list of NFT (Non-Fungible Token) transfers from the TON blockchain. This endpoint allows you to fetch information about NFT transfer activities and provides options for filtering, pagination, and sorting.

<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

* `direction` (string, required) — The direction of transfers to retrieve. Possible values: `in`, `out`, or `both`. Default: `both`.
* `limit` (integer, optional) — The maximum number of transfers to return. Default: `128`.
* `offset` (integer, optional) — The number of transfers to skip before starting to return results. Default: `0`.
* `sort` (string, optional) — The sorting order of the transfers. Possible values: `asc` (ascending) or `desc` (descending). Default: `desc`.

## Response

* `transfers` (array) — An array of NFT transfer objects, each containing:
  * `nft` (object) — Information about the transferred NFT:
    * `address` (string) — The address of the NFT item.
    * `collection` (object) — Information about the collection:
      * `address` (string) — The address of the collection.
  * `from` (object) — Information about the sender:
    * `address` (string) — The address of the sender.
  * `to` (object) — Information about the recipient:
    * `address` (string) — The address of the recipient.
  * `transaction` (object) — Information about the transaction:
    * `hash` (string) — The hash of the transaction.
    * `time` (integer) — The timestamp of the transaction.
  * `value` (string) — The value of the transfer (if any).

## Use case

The `nft/transfers` endpoint is useful for various applications that need to track or analyze NFT transfer activities on the TON blockchain:

1. NFT marketplaces can use this to display recent sales or transfers of NFTs.
2. Wallet applications can show users their history of NFT acquisitions and disposals.
3. Analytics platforms can track NFT transfer patterns, popular collections, and market trends.
4. Developers can use this endpoint to build notification systems for NFT transfers.
5. Collectors can monitor transfers of specific NFTs or within particular collections.
6. Compliance tools can use this data to track the provenance of NFTs.


## OpenAPI

````yaml openapi/ton_node_api/v3/getNFTTransfers.json GET /nft/transfers
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:
  /nft/transfers:
    get:
      tags:
        - NFT
      summary: Get NFT Transfers
      description: Retrieves a list of NFT transfers from the TON blockchain
      operationId: getNFTTransfers
      parameters:
        - name: direction
          in: query
          description: The direction of transfers to retrieve
          required: true
          schema:
            type: string
            enum:
              - in
              - out
              - both
            default: both
        - name: limit
          in: query
          description: The maximum number of transfers to return
          required: false
          schema:
            type: integer
            default: 128
        - name: offset
          in: query
          description: The number of transfers to skip before starting to return results
          required: false
          schema:
            type: integer
            default: 0
        - name: sort
          in: query
          description: The sorting order of the transfers
          required: false
          schema:
            type: string
            enum:
              - asc
              - desc
            default: desc
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: object
                properties:
                  transfers:
                    type: array
                    items:
                      type: object
                      properties:
                        nft:
                          type: object
                          properties:
                            address:
                              type: string
                              description: The address of the NFT item
                            collection:
                              type: object
                              properties:
                                address:
                                  type: string
                                  description: The address of the collection
                        from:
                          type: object
                          properties:
                            address:
                              type: string
                              description: The address of the sender
                        to:
                          type: object
                          properties:
                            address:
                              type: string
                              description: The address of the recipient
                        transaction:
                          type: object
                          properties:
                            hash:
                              type: string
                              description: The hash of the transaction
                            time:
                              type: integer
                              description: The timestamp of the transaction
                        value:
                          type: string
                          description: The value of the transfer (if any)

````