Validate transfer of fungible tokens

The endpoint checks whether the player's transfer of fungible 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

Request params for the endpoint `/tx/examine/player_transfer/fungible`.

transfer

object (ExaminedTransferFungible)

required

Player transfer to examine

sender

string

Sender

required

A regular blockchain address with a private key.

>= 47 characters<= 49 characters

Match pattern:

^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{47,49}$

recipient

string

Recipient

required

Blockchain address.

>= 47 characters<= 49 characters

Match pattern:

^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{47,49}$

fungible_id

integer

Fungible Id

required

ID of the fungible token.

>= 0<= 4294967295

amount

Amount

required

Amount of fungible token to transfer.

Example

{
    "transfer": {
        "sender": "ttmLfYytQ5CgTCrwrCZYUXRN6R4sJeDzSxmAqGAgRnhmeBCzB",
        "recipient": "ttnLgcprucb6wZXzugFfrE52QfPfmQdeG9z1Su1jjs5AizBno",
        "fungible_id": 32,
        "amount": 123000000000000
    }
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Successful Response

Body

Response schema for the endpoint `/tx/examine/player_transfer/fungible`.

metadata

object (ResponseMetadata)

required

Metadata for the generated response.

request_context

object (ResponseBlockId)

required

For the endpoints with historical data: the last block, the data from which is included in the response. For the endpoints with blockchain state data: the block whose state is provided in the response. Request context remains the same for all data pages in the series for the initial request.

blockchain_head

object (ResponseBlockId)

required

The latest blockchain block currently available.

data

object (PlayerTransferFungibleExaminationInfo)

required

Examination info for the player transfer of fungible token.

acceptance

boolean

Acceptance

required

true if the transaction will be accepted by the blockchain.

rejection_details

Rejection Details

required

Description of rejection details.

fee

Fee

required

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