Validate transfer of nft tokens

POST

https://api.trait.tech/tx/examine/player_transfer/nft

The endpoint checks whether the player's transfer of nft token
will be accepted by the blockchain and estimates the blockchain fee.

The endpoint performs all checks using the state of the blockchain for the specified finalised block.
The endpoint doesn't take into account any pending transactions.

Request

Body Params application/json

Example

{
    "transfer": {
        "sender": "ttmLfYytQ5CgTCrwrCZYUXRN6R4sJeDzSxmAqGAgRnhmeBCzB",
        "recipient": "ttnLgcprucb6wZXzugFfrE52QfPfmQdeG9z1Su1jjs5AizBno",
        "nft_collection_id": 17,
        "nft_item_id": 754266
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.trait.tech/tx/examine/player_transfer/nft' \
--header 'Content-Type: application/json' \
--data-raw '{
    "transfer": {
        "sender": "ttmLfYytQ5CgTCrwrCZYUXRN6R4sJeDzSxmAqGAgRnhmeBCzB",
        "recipient": "ttnLgcprucb6wZXzugFfrE52QfPfmQdeG9z1Su1jjs5AizBno",
        "nft_collection_id": 17,
        "nft_item_id": 754266
    }
}'

Responses

🟢200OK

application/json

Successful Response

Body

Example

{
    "metadata": {
        "request_context": {
            "block_hash": "0xab8006019066f080402ab43da043127b930ef0ffb3349a333222d67c0f542338",
            "block_index": 29702,
            "block_timestamp": 1727581488000
        },
        "blockchain_head": {
            "block_hash": "0xab8006019066f080402ab43da043127b930ef0ffb3349a333222d67c0f542338",
            "block_index": 29702,
            "block_timestamp": 1727581488000
        }
    },
    "data": {
        "acceptance": true,
        "rejection_details": null,
        "fee": {
            "tx_fee_mode": "NO_FEE__FREE_TRANSFER"
        }
    }
}

🟠422Parameter Error

Modified at 2024-11-21 18:59:09

Validate transfer of fungible tokens

Validate clearing transaction of an AppAgent