# 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.


```graphql
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)**


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

**Response (Most Recent)**


```json
{
  "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)**


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

**Response (Oldest Transaction)**


```json
{
  "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.


```graphql
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**


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

**Response**


```json
{
  "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.


```graphql
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**


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

**Response**


```json
{
  "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



```

```