getTransfers

查詢您在 Akashic 上的交易

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

page & limit 用於分頁。頁面為零索引。允許的限制值有 10、25、50 和 100。
layer 限制結果為第一層或第二層交易
status 將結果限制為僅「待定」、「已確認」或「已失敗」的交易
transactionType 將結果限制為進/出交易。「存款」或「提款」
startDate 和 endDate 依時間限制結果
hideSmallTransactions 設為 true 可排除價值低於 1 美元的交易
identifier 依 identifier 篩選結果
referenceId 依 referenceId 篩選結果

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

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

範例

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,
});

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

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);

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);

transactions, err := ap.GetTransfers(akashicpay.IGetTransactions{
    Page:                  0,
    Limit:                 10,
    Layer:                 akashicpay.L1,
    Status:                akashicpay.CONFIRMED,
    StartDate:             time.Date(2024, 1, 1, 0, 0, 0, 0, time.UTC),
    EndDate:               time.Date(2025, 1, 1, 0, 0, 0, 0, time.UTC),
    HideSmallTransactions: true,
})

回調範例

[
    {
      "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",
    },
]

[
    {
      "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",
    },
]

[
    {
      "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",
    },
]

{
  "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"
    }
  ]
}

[
    {
      FromAddress: "TTVkK6hGoAFhALG9NTkUDHjcFFXKmWcScU",
      ToAddress: "TQH8ygbS8BAnzSQ9uxR9vXHJYMQVRvbgPg",
      Layer: akashicpay.L1,
      InitiatedAt: "2024-08-19T10:03:58.649Z",
      ConfirmedAt: "2024-08-19T10:05:23.231Z",
      Amount: "1.000000",
      CoinSymbol:akashicpay.TRX_SHASTA,
      TokenSymbol: "",
      Status: akashicpay.CONFIRMED,
      TxHash: "28a9880ad2ef3b7be1c40763128ec9630ab74e4749a3c81037c3501e4209bfcc",
      InternalFee: {
        Deposit: "0.100000"
      },
      DepositRequest: akashicPay.DepositRequest{}, // Populated if deposit requested with referenceId
      ReceiverInfo: akashicPay.UserInfo{Identity: "AS4850e9d8519ebe1f1979096f89b90b6efd0aa62535354965c5fbce94f54422c8"},
      SenderInfo: akashicPay.UserInfo{}, // Populated if a deposit
      L2TxnHash: "ASe7eb1cb8193787040fcffa02a224a6ced7415ff2205343c0ab661e898e8d6eef",
    },
    {
      FromAddress: "TQH8ygbS8BAnzSQ9uxR9vXHJYMQVRvbgPg",
      ToAddress: "TTVkK6hGoAFhALG9NTkUDHjcFFXKmWcScU",
      Layer: akashicpay.L1,
      InitiatedAt: "2024-08-19T10:03:58.649Z",
      ConfirmedAt: "2024-08-19T10:05:23.231Z",
      Amount: "100.000000",
      CoinSymbol: akashicpay.TRX_SHASTA,
      TokenSymbol: akashicpay.USDT,
      Status: akashicpay.CONFIRMED,
      TxHash: "28a9880ad2ef3b7be1c40763128ec9630ab74e4749a3c81037c3501e4209bfcc",
      InternalFee: {
        Withdraw: "0.100000"
      },
      DepositRequest: akashicPay.DepositRequest{}, // Populated if deposit requested with referenceId
      SenderInfo: akashicPay.UserInfo{Identity: "AS4850e9d8519ebe1f1979096f89b90b6efd0aa62535354965c5fbce94f54422c8"},
      ReceiverInfo: akashicPay.UserInfo{}, // Populated if a deposit
      FeeIsDelegated: false,
      FeesPaid: "14.123456",
      L2TxnHash: "ASe7eb1cb8193787040fcffa02a224a6ced7415ff2205343c0ab661e898e8d6eef",
    },
]

Previous提款/提幣 (payout)NextgetBalance

Last updated 4 months ago

Was this helpful?