applications/api/toncenter/v3/nfts/get-nft-transfers

Query Parameters

owner_address?array<string>

Address of NFT owner in any form. Max 1000

item_address?array<string>

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

collection_address?string

Collection address in any form.

direction?string

Direction of transfer.

Value in"in" | "out"

start_utime?integer

Query transactions with generation UTC timestamp after given timestamp.

Formatint32

Range0 <= value

end_utime?integer

Query transactions with generation UTC timestamp before given timestamp.

Formatint32

Range0 <= value

start_lt?integer

Query transactions with lt >= start_lt.

Formatint64

Range0 <= value

end_lt?integer

Query transactions with lt <= end_lt.

Formatint64

Range0 <= value

limit?integer

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

Default10

Formatint32

Range1 <= value <= 1000

offset?integer

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

Default0

Formatint32

Range0 <= value

sort?string

Sort transactions by lt.

Default"desc"

Value in"asc" | "desc"

Response Body

`application/json`

curl -X GET "https://example.com/api/v3/nft/transfers"

{
  "address_book": {
    "property1": {
      "domain": "string",
      "interfaces": [
        "string"
      ],
      "user_friendly": "string"
    },
    "property2": {
      "domain": "string",
      "interfaces": [
        "string"
      ],
      "user_friendly": "string"
    }
  },
  "metadata": {
    "property1": {
      "is_indexed": true,
      "token_info": [
        {
          "description": "string",
          "extra": {},
          "image": "string",
          "name": "string",
          "nft_index": "string",
          "symbol": "string",
          "type": "string",
          "valid": true
        }
      ]
    },
    "property2": {
      "is_indexed": true,
      "token_info": [
        {
          "description": "string",
          "extra": {},
          "image": "string",
          "name": "string",
          "nft_index": "string",
          "symbol": "string",
          "type": "string",
          "valid": true
        }
      ]
    }
  },
  "nft_transfers": [
    {
      "custom_payload": "string",
      "decoded_custom_payload": [
        0
      ],
      "decoded_forward_payload": [
        0
      ],
      "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": 0
    }
  ]
}

{
  "code": 0,
  "error": "string"
}

applications/api/toncenter/v3/nfts/get-nft-transfers

Query Parameters

Response Body

200application/json

400application/json

`application/json`

`application/json`