nft/transfers - Ton

nft/transfers. Retrieves a list of NFT transfer events.

nft/transfers - ton [Value: 100CU]
Retrieves a list of NFT transfer events.
Use cases

Use cases

  • Get data on specific NFT items
  • Analyze NFT item details
  • Audit NFT metadata
Constraints

Constraints

  • Requires valid item ID
  • Supports NFT Items V3 only
  • Depends on sync
Get started
Unlock Access to 50+ chains
Boost your app's speed and reliability with dRPC - get your access API key

Language

Request
Examples
curl --request GET \
     --url ' https://ton.drpc.org/rest/api/v3/nft/transfers?direction=both&limit=128&offset=0&sort=desc' \
     --header 'accept: application/json'
Copy
Response
200
{
    "ok": true,
    "result": [
        {
            "transfer_id": "0:abcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdef",
            "from": "EQD1Lp1KcmGHFpE8eIvL1mnHT83b4HdB8HJxuSfq6Rq4zGyN",
            "to": "EQDzSp9Qc6KcJXGJc7NkSVxj2pzLsmM4NdFpc8i2dZqjU9i9",
            "item_id": "0:abcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdef",
            "collection_id": "0:abcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdefabcdef",
            "timestamp": 1693527600,
            "amount": "1",
            "status": "completed",
            "message": "Gift transfer of TON Art #1"
        },
        {
            "transfer_id": "0:1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
            "from": "EQDtFpEwcFAEcRe5mLVh2N6C0x-_hJEM7W61_JLnSF74p4q2",
            "to": "EQC7VpEHw2DA9hxkdx_WXv9NSkb_v_KVQMY2Le4a4Fk9DUqQ",
            "item_id": "0:1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
            "collection_id": "0:1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
            "timestamp": 1693527500,
            "amount": "1",
            "status": "completed",
            "message": "Auction transfer of TON Sports #5"
        }
    ]
}
Copy

Request params

Parametersobject
object
directionstring
Required. The direction of transfers to retrieve. Possible values are 'in', 'out', or 'both'. Default is 'both'.
limitinteger
Optional. The maximum number of transfers to return. Default is 128.
offsetinteger
Optional. The number of transfers to skip before starting to return results. Default is 0.
sortstring
Optional. The sorting order of the transfers. Possible values are 'asc' for ascending or 'desc' for descending. Default is 'desc'.

Response

200

Response params

object
okboolean
Indicates if the request was successful.
resultarray
List of NFT transfer details.
object
transfer_idstring
Unique identifier of the NFT transfer.
fromstring
Address of the sender.
tostring
Address of the recipient.
item_idstring
Identifier of the specific NFT item being transferred.
collection_idstring
Identifier of the NFT collection to which the item belongs.
timestampinteger
Unix timestamp when the transfer occurred.
amountstring
Quantity of the NFT transferred.
statusstring
Status of the transfer (e.g., completed).
messagestring
Additional message associated with the transfer.
getTokenDatanft/items