getTransfers

查詢您在 Akashic 上的交易

此函式 (function) 使用一組可選參數，以取得更特定的交易子集

• page & limit 用於分頁。頁面為零索引。允許的限制值有 10、25、50 和 100。

• layer 限制結果為第一層或第二層交易

• status 將結果限制為僅 「待定」、「已確認」 或 「已失敗」 的交易

• transactionType 將結果限制為進/出交易。「存款 」或 「提款」

• startDate 和 endDate 依時間限制結果

• hideSmallTransactions 設為 true 可排除價值低於 1 美元的交易

注意: l2Txnhash (「L2-hash」) 應該始終用作交易的唯一識別碼 (identifier)。這是 AkashicChain 上任何交易的唯一交易哈希 (transaction-hash)。它存在於已確認的存款和待定/已確認的付款中。這對於第二層交易尤其重要，因為第二層交易沒有第一層哈希值 (txHash)

注意：internalFee 是指在 AkashicChain 上交易的 L2 相關費用。

範例

TypeScript

const transactions = await akashicPay.getTransfers({
    page: 0,
    limit: 10,
    layer: TransactionLayer.L1,
    status: TransactionStatus.CONFIRMED,
    startDate: new Date('2024-01-01'),
    endDate: new Date('2025-01-01'),
    hideSmallTransactions: true
});

PHP

$transactions = akashicPay.getTransfers([
    "page" => 0,
    "limit" => 10,
    "layer" => "L1Transaction",
    "status" => "Confirmed",
    "startDate" => date('2024-01-01),
    "endDate" => date('2025-01-01'),
    "hideSmallTransactions" => True
]);

Java

APTransactionsParam param = APTransactionsParam.builder(0, 10, new Date(2024,1,1), new Date(2025,1,1), APTransactionLayer.L1Transaction, APTransactionStatus.Confirmed, true).build();

APTransfersResult result = akashicPay.getTransfers(l2Address, param);

C#

var param = new ApTransactionsParam(0, 10, new DateTime(2024, 1, 1), new DateTime(2025, 1, 1), APTransactionLayer.L1Transaction, APTransactionStatus.Confirmed, true);

var result = await akashicPay.GetTransfersAsync(param);

回調範例

TypeScript

[
    {
      "fromAddress": "TTVkK6hGoAFhALG9NTkUDHjcFFXKmWcScU",
      "toAddress": "TQH8ygbS8BAnzSQ9uxR9vXHJYMQVRvbgPg",
      "layer": TransactionLayer.L1,
      "date": "2024-08-19T10:03:58.649Z",
      "amount": "1.000000",
      "coinSymbol": NetworkSymbol.Tron_Shasta,
      "status": TransactionStatus.CONFIRMED,
      "txHash": "28a9880ad2ef3b7be1c40763128ec9630ab74e4749a3c81037c3501e4209bfcc",
      "internalFee": {
        "deposit": "0.100000"
      },
      "l2TxnHash": "ASe7eb1cb8193787040fcffa02a224a6ced7415ff2205343c0ab661e898e8d6eef",
    },
    {
      "fromAddress": "TQH8ygbS8BAnzSQ9uxR9vXHJYMQVRvbgPg",
      "toAddress": "TTVkK6hGoAFhALG9NTkUDHjcFFXKmWcScU",
      "layer": TransactionLayer.L1,
      "date": "2024-08-19T10:03:58.649Z",
      "amount": "100.000000",
      "coinSymbol": NetworkSymbol.Tron_Shasta,
      "status": TransactionStatus.CONFIRMED,
      "txHash": "28a9880ad2ef3b7be1c40763128ec9630ab74e4749a3c81037c3501e4209bfcc",
      "internalFee": {
        "deposit": "0.100000"
      },
      "feesPaid": "14.123456",
      "l2TxnHash": "ASe7eb1cb8193787040fcffa02a224a6ced7415ff2205343c0ab661e898e8d6eef",
    },
]

PHP

[
    {
      "fromAddress": "TTVkK6hGoAFhALG9NTkUDHjcFFXKmWcScU",
      "toAddress": "TQH8ygbS8BAnzSQ9uxR9vXHJYMQVRvbgPg",
      "layer": "L1Transaction",
      "date": "2024-08-19T10:03:58.649Z",
      "amount": "1.000000",
      "coinSymbol": NetworkSymbol::TRON_SHASTA,
      "status": "Confirmed",
      "txHash": "28a9880ad2ef3b7be1c40763128ec9630ab74e4749a3c81037c3501e4209bfcc",
      "internalFee": {
        "deposit": "0.100000"
      },
      "l2TxnHash": "ASe7eb1cb8193787040fcffa02a224a6ced7415ff2205343c0ab661e898e8d6eef",
    },
    {
      "fromAddress": "TQH8ygbS8BAnzSQ9uxR9vXHJYMQVRvbgPg",
      "toAddress": "TTVkK6hGoAFhALG9NTkUDHjcFFXKmWcScU",
      "layer": "L1Transaction",
      "date": "2024-08-19T10:03:58.649Z",
      "amount": "100.000000",
      "coinSymbol": NetworkSymbol::TRON_SHASTA,
      "status": "Confirmed",
      "txHash": "28a9880ad2ef3b7be1c40763128ec9630ab74e4749a3c81037c3501e4209bfcc",
      "internalFee": {
        "deposit": "0.100000"
      },
      "feesPaid": "14.123456",
      "l2TxnHash": "ASe7eb1cb8193787040fcffa02a224a6ced7415ff2205343c0ab661e898e8d6eef",
    },
]

Java

[
    {
      "fromAddress": "TTVkK6hGoAFhALG9NTkUDHjcFFXKmWcScU",
      "toAddress": "TQH8ygbS8BAnzSQ9uxR9vXHJYMQVRvbgPg",
      "layer": APTransactionLayer.L1Transaction,
      "date": "2024-08-19T10:03:58.649Z",
      "amount": "1.000000",
      "coinSymbol": APNetworkSymbol.TRX_SHASTA,
      "status": APTransactionStatus.Confirmed,
      "txHash": "28a9880ad2ef3b7be1c40763128ec9630ab74e4749a3c81037c3501e4209bfcc",
      "internalFee": {
        "deposit": "0.100000"
      },
      "l2TxnHash": "ASe7eb1cb8193787040fcffa02a224a6ced7415ff2205343c0ab661e898e8d6eef",
    },
    {
      "fromAddress": "TQH8ygbS8BAnzSQ9uxR9vXHJYMQVRvbgPg",
      "toAddress": "TTVkK6hGoAFhALG9NTkUDHjcFFXKmWcScU",
      "layer": APTransactionLayer.L1Transaction,
      "date": "2024-08-19T10:03:58.649Z",
      "amount": "100.000000",
      "coinSymbol": APNetworkSymbol.TRX_SHASTA,
      "status": APTransactionStatus.Confirmed,
      "txHash": "28a9880ad2ef3b7be1c40763128ec9630ab74e4749a3c81037c3501e4209bfcc",
      "internalFee": {
        "deposit": "0.100000"
      },
      "feesPaid": "14.123456",
      "l2TxnHash": "ASe7eb1cb8193787040fcffa02a224a6ced7415ff2205343c0ab661e898e8d6eef",
    },
]

C#

{
  "TransactionCount": 2841,
  "Transactions": [
    {
      "FromAddress": "TXHGwWiCUgiKjSNC3HtWCmiABAcmQgkQ7P",
      "ToAddress": "TF97xibDz9ba4bGm6SNBYDSXA4mbeBK6JW",
      "Layer": ApTransactionLayer.L1Transaction,
      "Date": "2024-09-12T14:03:57.548Z",
      "Amount": "1.000000",
      "NetworkSymbol": TronShastaNetworkSymbol,
      "Status": ApTransactionStatus.Confirmed,
      "L2TxnHash": "AS7376bfa5e3152ea6a6027e6f0bdf35e013979394448b4516298a54355c3555aa",
      "TokenSymbol": ApTokenSymbol.Usdt,
      "InternalFee": {
        "Deposit": null,
        "Withdraw": "1.000000"
      },
      "Identifier": "testuser",
      "TxHash": "9970322d75146f8c439d943d367e894059b8118453285906b42ea67a61915ac5"
    },
    {
      "FromAddress": "TR6vZK9Nvq2ZBETWGzU5VEgGQ2ZEH2NYcp",
      "ToAddress": "TF97xibDz9ba4bGm6SNBYDSXA4mbeBK6JW",
      "Layer": ApTransactionLayer.L1Transaction,
      "Date": "2024-09-12T14:02:57.652Z",
      "Amount": "1.000000",
      "NetworkSymbol": TronShastaNetworkSymbol,
      "Status": ApTransactionStatus.Confirmed,
      "L2TxnHash": "AS2612edced26e031ab1be08daf062dd195ce306a8d4e4eed9477b1c97c3e12448",
      "TokenSymbol": ApTokenSymbol.Usdt,
      "InternalFee": {
        "Deposit": null,
        "Withdraw": "1.000000"
      },
      "Identifier": "testuser",
      "TxHash": "645a42038b52ccec75b9edcdf7c8bf6ffeadc578975ec886abf9cadf5f350ce1"
    }
  ]
}