Skip to main content
GET
/
api
/
v3
/
nft
/
transfers
Get NFT Transfers
curl --request GET \
  --url https://toncenter.com/api/v3/nft/transfers
{
  "address_book": {},
  "metadata": {},
  "nft_transfers": [
    {
      "custom_payload": "<string>",
      "decoded_custom_payload": {},
      "decoded_forward_payload": {},
      "forward_amount": "<string>",
      "forward_payload": "<string>",
      "new_owner": "<string>",
      "nft_address": "<string>",
      "nft_collection": "<string>",
      "old_owner": "<string>",
      "query_id": "<string>",
      "response_destination": "<string>",
      "trace_id": "<string>",
      "transaction_aborted": true,
      "transaction_hash": "<string>",
      "transaction_lt": "0",
      "transaction_now": 123
    }
  ]
}

​
SDK Usage

import asyncio

from toncenter.rest import ToncenterRestClient
from toncenter.types import Network

COLLECTION_ADDRESS = "EQC3dNlesgVD8YbAazcauIrXBPfiVhMMr5YYk2in0Mtsz0Bz"


async def main() -> None:
    async with ToncenterRestClient(network=Network.MAINNET) as client:
        result = await client.v3.nfts.get_nft_transfers(
            collection_address=COLLECTION_ADDRESS,
        )
        print(result.model_dump_json(indent=4))


if __name__ == "__main__":
    asyncio.run(main())

Query Parameters

​
owner_address
string[]

Address of NFT owner in any form. Max 1000

​
item_address
string[]

Address of NFT item in any form. Max: 1000.

​
collection_address
string

Collection address in any form.

​
direction
enum<string>

Direction of transfer.

Available options:
in,
out
​
start_utime
integer

Query transactions with generation UTC timestamp after given timestamp.

​
end_utime
integer

Query transactions with generation UTC timestamp before given timestamp.

​
start_lt
integer

Query transactions with lt >= start_lt.

​
end_lt
integer

Query transactions with lt <= end_lt.

​
limit
integer
default:10

Limit number of queried rows. Use with offset to batch read.

​
offset
integer
default:0

Skip first N rows. Use with limit to batch read.

​
sort
enum<string>
default:desc

Sort transactions by lt.

Available options:
asc,
desc

Response

OK

​
address_book
object
​
metadata
object
​
nft_transfers
object[]