Skip to content
/
Transaction History
Last updated

Transaction History

Build comprehensive transaction history interfaces that track transfers, cross-chain movements, and account activity over time.

Transfers: Account Transaction History

Track all transfer activity for any account including incoming, outgoing, and cross-chain transfers with full transaction details.

query Transfers(
  $accountName: String
  $first: Int
  $last: Int
  $chainId: String
) {
  transfers(
    accountName: $accountName
    first: $first
    last: $last
    chainId: $chainId
  ) {
    edges {
      node {
        amount
        senderAccount
        receiverAccount
        crossChainTransfer {
          receiverAccount
          senderAccount
          block {
            chainId
            height
          }
        }
        requestKey
        creationTime
        block {
          height
          chainId
        }
      }
    }
  }
}

Variables (Recent Transfers)

{
  "accountName": "k:fc0c4b9e0b1c2df1a50694f5dbeb2faf7e637018e74f6046da1eb7e8e32e3d30",
  "first": 1
}

Response (Most Recent)

{
  "data": {
    "transfers": {
      "edges": [
        {
          "node": {
            "amount": "0.277",
            "senderAccount": "k:03f7f0029bd3abbda30d928f4ed49f9704238d93119bdd53166b8dd5cb49c667",
            "receiverAccount": "k:fc0c4b9e0b1c2df1a50694f5dbeb2faf7e637018e74f6046da1eb7e8e32e3d30",
            "crossChainTransfer": null,
            "requestKey": "TRuUdncV-2Y_5LxHyUhNl0X1sp58KX1HvK0Hg9UZqCU",
            "creationTime": "2025-08-19T02:38:15.321Z",
            "block": {
              "height": 6102691,
              "chainId": 1
            }
          }
        }
      ]
    }
  }
}

Variables (Historical Transfers)

{
  "accountName": "k:fc0c4b9e0b1c2df1a50694f5dbeb2faf7e637018e74f6046da1eb7e8e32e3d30",
  "last": 1
}

Response (Oldest Transaction)

{
  "data": {
    "transfers": {
      "edges": [
        {
          "node": {
            "amount": "63.030529544427",
            "senderAccount": "k:cf415c73edb4666a967933bddc2e6c4a6e13b8ec0566e612b9f3cbe4a4d8506e",
            "receiverAccount": "k:fc0c4b9e0b1c2df1a50694f5dbeb2faf7e637018e74f6046da1eb7e8e32e3d30",
            "crossChainTransfer": null,
            "requestKey": "qMZtzZ9m8-Ao5B8jY09OWA88H2c2d6utE2RvzaE_QOQ",
            "creationTime": "2023-04-17T09:56:56.000Z",
            "block": {
              "height": 3643154,
              "chainId": 1
            }
          }
        }
      ]
    }
  }
}

Use Cases

  • Recent activity dashboards (use first)
  • Historical transaction analysis (use last)
  • Account audit trails
  • Cross-chain transfer monitoring

Notes

  • first: N - Returns most recent N transfers (newest first)
  • last: N - Returns oldest N transfers from account history
  • chainId - Filter transfers for specific chain only
  • crossChainTransfer - Contains data for cross-chain transfers, null for same-chain
  • Use pagination for large transfer histories

Transfers: Enhanced Token Transfer History

Advanced transfer tracking with full pagination, token module information, and cross-chain support for comprehensive transaction analysis.

query Transfers(
  $accountName: String
  $chainId: String
  $after: String
  $before: String
  $first: Int
  $last: Int
) {
  transfers(
    accountName: $accountName
    chainId: $chainId
    after: $after
    before: $before
    first: $first
    last: $last
  ) {
    totalCount
    pageInfo {
      endCursor
      hasNextPage
      hasPreviousPage
      startCursor
    }
    edges {
      cursor
      node {
        amount
        block {
          chainId
          height
        }
        creationTime
        moduleName
        receiverAccount
        senderAccount
        requestKey
        crossChainTransfer {
          senderAccount
          receiverAccount
        }
      }
    }
  }
}

Variables

{
  "accountName": "k:fc0c4b9e0b1c2df1a50694f5dbeb2faf7e637018e74f6046da1eb7e8e32e3d30",
  "first": 10,
  "last": null
}

Response

{
  "data": {
    "transfers": {
      "totalCount": 4770,
      "pageInfo": {
        "endCursor": "MTc1MjU5OTYyNy43MjE6NzMxMjU4",
        "hasNextPage": true,
        "hasPreviousPage": false,
        "startCursor": "MTc1NTU3MTA5NS4zMjE6MzgyMDYwMTA1"
      },
      "edges": [
        {
          "cursor": "MTc1NTU3MTA5NS4zMjE6MzgyMDYwMTA1",
          "node": {
            "amount": "0.277",
            "block": {
              "chainId": 1,
              "height": 6102691
            },
            "creationTime": "2025-08-19T02:38:15.321Z",
            "moduleName": "coin",
            "receiverAccount": "k:fc0c4b9e0b1c2df1a50694f5dbeb2faf7e637018e74f6046da1eb7e8e32e3d30",
            "senderAccount": "k:03f7f0029bd3abbda30d928f4ed49f9704238d93119bdd53166b8dd5cb49c667",
            "requestKey": "TRuUdncV-2Y_5LxHyUhNl0X1sp58KX1HvK0Hg9UZqCU",
            "crossChainTransfer": null
          }
        },
        {
          "cursor": "MTc1MjU5OTYyNy43MjE6NzMxMjI1",
          "node": {
            "amount": "1",
            "block": {
              "chainId": 1,
              "height": 6003759
            },
            "creationTime": "2025-07-15T17:16:53.238Z",
            "moduleName": "n_ebe54249b2e9d68f5060961f3c419f8288d18dc2.unitt",
            "receiverAccount": "",
            "senderAccount": "k:fc0c4b9e0b1c2df1a50694f5dbeb2faf7e637018e74f6046da1eb7e8e32e3d30",
            "requestKey": "lEt8g3ULQRud23LHS3NLPeae-IADznmMtUpSAW_4ncs",
            "crossChainTransfer": {
              "senderAccount": "",
              "receiverAccount": "k:03f7f0029bd3abbda30d928f4ed49f9704238d93119bdd53166b8dd5cb49c667"
            }
          }
        }
      ]
    }
  }
}

Use Cases

  • Multi-token transfer dashboards
  • Paginated transaction interfaces
  • Cross-chain transfer tracking
  • Token activity analysis across protocols

Notes

  • totalCount - Shows total transfers for the account (4770 in example)
  • moduleName - Identifies token type ("coin" = KDA, others = custom tokens)
  • pageInfo - Complete pagination support with cursors
  • crossChainTransfer - Non-null for cross-chain transfers
  • Use cursors from pageInfo for efficient pagination

Transfers: NFT Transfer History

Track NFT (Non-Fungible Token) transfers specifically, including minting, sales, and ownership changes for digital collectibles.

query Transfers(
  $accountName: String
  $chainId: String
  $after: String
  $before: String
  $first: Int
  $last: Int
  $isNft: Boolean
) {
  transfers(
    accountName: $accountName
    chainId: $chainId
    after: $after
    before: $before
    first: $first
    last: $last
    isNFT: $isNft
  ) {
    totalCount
    pageInfo {
      endCursor
      hasNextPage
      hasPreviousPage
      startCursor
    }
    edges {
      cursor
      node {
        amount
        block {
          chainId
          height
        }
        creationTime
        moduleName
        receiverAccount
        senderAccount
        requestKey
        crossChainTransfer {
          senderAccount
          receiverAccount
        }
        tokenId
      }
    }
  }
}

Variables

{
  "accountName": "k:fc0c4b9e0b1c2df1a50694f5dbeb2faf7e637018e74f6046da1eb7e8e32e3d30",
  "first": 10,
  "last": null,
  "isNft": true
}

Response

{
  "data": {
    "transfers": {
      "totalCount": 9,
      "pageInfo": {
        "endCursor": "MTY4NjMwODMwODozODM3MjA4NjU=",
        "hasNextPage": false,
        "hasPreviousPage": false,
        "startCursor": "MTcxNjAyNTA1ODozODM2NTE4OTg="
      },
      "edges": [
        {
          "cursor": "MTcxNjAyNTA1ODozODM2NTE4OTg=",
          "node": {
            "amount": "1",
            "block": {
              "chainId": 8,
              "height": 4785830
            },
            "creationTime": "2024-05-18T09:37:38.000Z",
            "moduleName": "marmalade.ledger",
            "receiverAccount": "p:-aDmmc0HtdFzuPMeVlqmUmEJ6vf10WB6j_EJYzh1_YY:SALE",
            "senderAccount": "k:fc0c4b9e0b1c2df1a50694f5dbeb2faf7e637018e74f6046da1eb7e8e32e3d30",
            "requestKey": "-aDmmc0HtdFzuPMeVlqmUmEJ6vf10WB6j_EJYzh1_YY",
            "crossChainTransfer": null,
            "tokenId": "pit-bull-bushido #1911"
          }
        },
        {
          "cursor": "MTcxNTg1NTA3NDozODM2NTIwMTI=",
          "node": {
            "amount": "1",
            "block": {
              "chainId": 8,
              "height": 4780173
            },
            "creationTime": "2024-05-16T10:24:34.000Z",
            "moduleName": "marmalade.ledger",
            "receiverAccount": "k:fc0c4b9e0b1c2df1a50694f5dbeb2faf7e637018e74f6046da1eb7e8e32e3d30",
            "senderAccount": "",
            "requestKey": "53lvoWemioCXgMutfdgO_9_XATCAoZGAUSyJzBR06Yg",
            "crossChainTransfer": null,
            "tokenId": "pit-bull-bushido #1317"
          }
        },
        {
          "cursor": "MTcwNTU4NTgxNjozODM2NzM0MjY=",
          "node": {
            "amount": "1",
            "block": {
              "chainId": 8,
              "height": 4438115
            },
            "creationTime": "2024-01-18T13:50:16.000Z",
            "moduleName": "marmalade-v2.ledger",
            "receiverAccount": "k:fc0c4b9e0b1c2df1a50694f5dbeb2faf7e637018e74f6046da1eb7e8e32e3d30",
            "senderAccount": "",
            "requestKey": "PLSYnMAO246S8aHPC6v1quh3ccGdYrabwUkiajml7qY",
            "crossChainTransfer": null,
            "tokenId": "t:T790PCXmftc7KBbmdNtBL_OOEB6e8ZXGtEalVDvFGEI"
          }
        }
      ]
    }
  }
}

Use Cases

  • NFT collection tracking
  • Digital art ownership history
  • Gaming asset transfer logs
  • NFT marketplace activity monitoring

Notes

  • isNft: true - Filters for NFT transfers only
  • tokenId - Shows specific NFT identifier
  • moduleName - "marmalade.ledger" or "marmalade-v2.ledger" for NFTs
  • Empty senderAccount - Usually indicates minting/creation
  • :SALE suffix - Indicates marketplace/sale transactions
  • Amount is typically "1" for unique NFTs
Previous page
Next page