/getTransactionByToken

1 min

POST

Retrieve the current status of a transaction (including its details) using a transaction token.

Note: To retrieve replace by fee transaction data, the transactionToken parameter must include the index and the postfix "

". The format is: transactionToken + ":" + std::to_string(index) + "

", for example: "85ff3024c19f2a61d6b6eb27f5b30ef38406210d9b1a7665471eb804fa0587c0:5

This endpoint returns information in Transaction Format V2 by default.

If you need Transaction Format V1, please specify that when running the command. This format is deprecated from Version 19 and will be removed in a later API version. This function is part of the transaction flow detailed at https://docs.gk8.io/api-v19/sending-transactions-from-the-api. See the linked article for more details.

return: JSON object containing the transaction details.

 -------------------- Request --------------------

   getTransactionByToken(
      transactionToken="251c6b2608a0cc64164598727a292711d284f7a9215ba064efc361d03f5033a5",
      coin_type="ETH",
      transaction_format_version=TransactionFormatVersion.V2
    )

  -------------------- Response --------------------

{
"FunctionData": {
      {
  "AdditionalDepositTransactionData": null,
  "AdditionalWithdrawalTransactionData": {
      "AccountId": 1,
      "AdditionalStatusInformation": "Transaction sent to the Blockchain",
      "ApprovalRequestId": "b38...22b",
      "ContractData": null,
      "DataSigningInformation": null,
      "Expiration": null,
      "InitiatingSystem": "GK8",
      "Machine": 1,
      "ReplaceByFeeUserId": null,
      "StatusId": 4,
      "TokenReplacedByFee": null,
      "TokenizationConfiguration": null,
      "TransactionDescription": null,
      "TransactionToken": "62bd...8cd",
      "UserId": "[email protected]",
      "UserName": "Danny Cohen"
  },
  "BlockNumber": "2319857",
  "Confirmations": "1",
  "Destinations": [
      {
          "AccountId": 1,
          "Address": "0x875...Dec",
          "Amount": "3000000000000000000",
          "ContactName": "Account Main Account: Cold Wallet",
          "CustomerId": null,
          "DepositAddressIndex": null,
          "Machine": 0,
          "WalletId": null,
          "WalletName": null
      }
  ],
  "Fees": {
      "FeeActuallyPaid": "7669406850000",
      "GasLimit": "21000",
      "GasPrice": "365209850",
      "GasUsed": "21000",
      "MaxGasPrice": "2000000000",
      "MaxPriorityFee": "365209842",
      "MaxTotalFee": "42000000000000"
  },
  "Nonce": "241",
  "RawTransaction": "02f8...a10",
  "SourceMemo": "",
  "Sources": [
      {
          "Address": "0x19d...09e",
          "ContactName": "Account Main Account: Hot Wallet",
          "CustomerId": null,
          "WalletId": null,
          "WalletName": null
      }
  ],
  "Symbol": "ETH",
  "Timestamp": "1726130640000",
  "TransactionErrorInBlock": false,
  "TransactionFormatVersion": 2,
  "TransactionRiskAssessmentStatus": {
                    "Assessment": "No Risk Found",
                    "BalanceChanges": {
                      "Receive": [],
                      "Send": [
                        {
                          "Amount": "9155220817253021",
                          "Chain": "POL",
                          "ChainId": 137,
                          "KnowChain": true,
                          "TokenSymbol": "POL",
                          "UsdValue": "0.001105996450828251"
                        },
                        {
                          "Address": "0xE0339c80fFDE91F3e20494Df88d4206D86024cdF",
                          "Amount": "1000000000000000000000000",
                          "Chain": "Dogelon (PoS)",
                          "KnowChain": true,
                          "TokenSymbol": "ELON_POL",
                          "UsdValue": "0.053726000000000003"
                        }
                      ]
                    },
  "TransactionId": "0x1c2...893",
  "Type": 1
}

transactionTokenstringThe token provided during transaction creation.

coin_typestringThe type of coin for the transaction.

transaction_format_versionobject<p>Specifies the format version of the transaction, can be TransactionFormatVersion.V0 or TransactionFormatVersion.V2. V0 is the default and returns results using the legacy format. V2 returns results using a new, easier-to-parse structure.</p>

acceptstringGenerated from available response content types

bodyobjectRequest data for a transaction token operation.

200success

curl --request POST \
     --url '/getTransactionByToken?transactionToken=85ff3024c19f2a61d6b6eb27f5b30ef38406210d9b1a7665471eb804fa0587c0&coin_type=BTC&transaction_format_version=object' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{
     "CoinType": "BTC",
     "RemoveDuplicates": "false",
     "TransactionToken": "85ff3024c19f2a61d6b6eb27f5b30ef38406210d9b1a7665471eb804fa0587c0",
     "Meta": {
     "FunctionName": "getTransactionByToken",
     "RandomData": "288cd49d4b8bf00e7d6114b78d5668d5581d6b953fafef779133caa844cd4229",
     "Destination": "b9cb8afe52f1d52521cf2b62dfe12146156ad5328f83c62c20c7da81b263356a61340de745c858998544c041798b01c2f4fac31bebe52a19280a32cd57d6d374ea",
     "Time": "2021-02-07T18:37:46.948Z",
     "Source": "048b99461a70a49abe63fd585cb224177a22a92d2e9e4ddfbc0027887bee9d1843388f42a3eb2e740565e115ad8b7981abf59e3b03b771f4b063b53c517d7a9d99",
     "AccessToken": "51311c84d2c8fd2fafbe56ceb1fb30a99d3417abfc55769577338ab286798087"
     }
     }'