# Transaction Monitoring

Build transaction feeds and monitoring tools to track network activity and gas price trends.

## AverageGasPrice: Recent Transaction Fees

Retrieve recent transactions with gas prices to calculate network gas price averages.


```graphql
query AverageGasPrice($first: Int) {
  transactions(first: $first) {
    edges {
      node {
        hash
        cmd {
          meta {
            creationTime
            gasPrice
          }
        }
      }
    }
  }
}
```

**Variables**


```json
{
  "first": 5
}
```

**Response**


```json
{
  "data": {
    "transactions": {
      "edges": [
        {
          "node": {
            "hash": "gq15uXrm6W2cPCsNdJC66yk9Do_rh3Jxt876PY0cmWU",
            "cmd": {
              "meta": {
                "creationTime": "2025-09-25T18:56:31.000Z",
                "gasPrice": "0.0000001"
              }
            }
          }
        },
        {
          "node": {
            "hash": "7eYzJkSqr9RgulG70PNGlGka9DwaJVWXzdkNzwh21oE",
            "cmd": {
              "meta": {
                "creationTime": "2025-09-25T18:56:29.000Z",
                "gasPrice": "0.0000001"
              }
            }
          }
        },
        {
          "node": {
            "hash": "3zFdjqFCvV5L6ME8lTHew-Ycy9QQiKPMRMlbYPi0LAY",
            "cmd": {
              "meta": {
                "creationTime": "2025-09-25T18:56:18.000Z",
                "gasPrice": "0.000001"
              }
            }
          }
        },
        {
          "node": {
            "hash": "tjVSlGMLH1yZvbgBVQb0uH0RfFbewzq2KPu9QVhAqJg",
            "cmd": {
              "meta": {
                "creationTime": "2025-09-25T18:56:10.000Z",
                "gasPrice": "0.000001"
              }
            }
          }
        },
        {
          "node": {
            "hash": "5e3G9qOr9LwasxCjAlL-HPt13fnwJu8IRLRHpIW2nOI",
            "cmd": {
              "meta": {
                "creationTime": "2025-09-25T18:56:10.000Z",
                "gasPrice": "0.000001"
              }
            }
          }
        }
      ]
    }
  }
}
```

**Use Cases**

- Wallet gas price estimation
- DeFi transaction cost calculation
- Network fee analytics
- Gas optimization tools


**Notes**
Most transactions use 0.0000001 KDA/gas. Higher prices like 0.000001 indicate priority transactions. Increase first parameter for larger samples.

## HomeTxListInit: Detailed Transaction Feed

Enhanced transaction monitoring with chain info, sender details, and gas consumption for comprehensive analytics.


```graphql
query HomeTxListInit($first: Int) {
  transactions(first: $first) {
    totalCount
    edges {
      node {
        hash
        cmd {
          meta {
            chainId
            creationTime
            gasPrice
            sender
          }
        }
        result {
          ... on TransactionResult {
            gas
            block {
              height
            }
          }
        }
      }
    }
  }
}
```

**Variables**


```json
{
  "first": 5
}
```

**Response**


```json
{
  "data": {
    "transactions": {
      "totalCount": 208356741,
      "edges": [
        {
          "node": {
            "hash": "zYrj6giDW0refZKyQK8nIrkk71nJVv7aQ4f_AF9fWoE",
            "cmd": {
              "meta": {
                "chainId": 2,
                "creationTime": "2025-09-25T18:59:18.000Z",
                "gasPrice": "0.00000001",
                "sender": "c:EX0XSNfVxsm906AyVouFPXiLZPYObybqBCCtOpbb3HQ"
              }
            },
            "result": {
              "gas": "68445",
              "block": {
                "height": 6211154
              }
            }
          }
        },
        {
          "node": {
            "hash": "_R-shRvyX_H11cGn7zGbhLLmjDJxRMeaBFxdX5wCrxo",
            "cmd": {
              "meta": {
                "chainId": 2,
                "creationTime": "2025-09-25T18:59:16.000Z",
                "gasPrice": "0.00000001",
                "sender": "k:8f91974d0543d8c132bc4796a64d83eaf808a6c3fcd2ef2d66acaa593e8b44e6"
              }
            },
            "result": {
              "gas": "122",
              "block": {
                "height": 6211154
              }
            }
          }
        },
        {
          "node": {
            "hash": "noc-T-EMb7h-HjkC_hbm209ClhunGzmRN0X-0dwPN-w",
            "cmd": {
              "meta": {
                "chainId": 0,
                "creationTime": "2025-09-25T18:58:43.000Z",
                "gasPrice": "0.0000001",
                "sender": "k:9fb0ee6136b8d711d55b48f582bb56caeaa48f3655bfa1e039c23d925f67d16f"
              }
            },
            "result": {
              "gas": "206",
              "block": {
                "height": 6211154
              }
            }
          }
        },
        {
          "node": {
            "hash": "Er829CmYSSXP6XFhqm2i-5QYPZj3MM6WloX5V2ezY-U",
            "cmd": {
              "meta": {
                "chainId": 0,
                "creationTime": "2025-09-25T18:58:41.000Z",
                "gasPrice": "0.0000001",
                "sender": "k:62027e3a518fa8dac8dd1a9647a69206b1c62dabd44511b6635abd438ec7f56a"
              }
            },
            "result": {
              "gas": "797",
              "block": {
                "height": 6211154
              }
            }
          }
        },
        {
          "node": {
            "hash": "hkx47EhAzOaEUAy3pEgiamuu_LYGRBk2c8y1n7IPfk8",
            "cmd": {
              "meta": {
                "chainId": 0,
                "creationTime": "2025-09-25T18:58:41.000Z",
                "gasPrice": "0.000001",
                "sender": "k:7c51dd668165d5cd8b0a7a11141bc1ec981f3fed008f554c67174c04b87b7a9c"
              }
            },
            "result": {
              "gas": "206",
              "block": {
                "height": 6211154
              }
            }
          }
        }
      ]
    }
  }
}
```

**Use Cases**

- Transaction monitoring dashboards
- Multi-chain analytics
- Real-time transaction feeds
- Gas consumption analysis


**Notes**
Use totalCount for pagination and chainId for multi-chain filtering. Gas consumption varies widely based on transaction complexity.

## Transactions: Advanced Transaction Filtering

Comprehensive transaction query with sophisticated filtering and pagination for advanced analytics and explorer interfaces.


```graphql
query Transactions(
  $first: Int,
  $last: Int,
  $after: String,
  $before: String,
  $chainId: String,
  $isCoinbase: Boolean,
  $minHeight: Int,
  $maxHeight: Int
) {
  transactions(
    first: $first,
    last: $last,
    after: $after,
    before: $before,
    chainId: $chainId,
    isCoinbase: $isCoinbase,
    minHeight: $minHeight,
    maxHeight: $maxHeight
  ) {
    totalCount
    pageInfo {
      endCursor
      hasNextPage
      hasPreviousPage
      startCursor
    }
    edges {
      node {
        hash
        cmd {
          meta {
            gasLimit
            chainId
            creationTime
            gasPrice
            sender
          }
          payload {
            ... on ExecutionPayload {
              code
            }
          }
        }
        result {
          ... on TransactionResult {
            badResult
            gas
            block {
              height
              canonical
            }
          }
        }
      }
      cursor
    }
  }
}
```

**Variables**


```json
{
  "first": 25,
  "chainId": "0",
  "minHeight": 6211700,
  "maxHeight": 6211750
}
```

**Response**


```json
{
  "data": {
    "transactions": {
      "totalCount": 208386561,
      "pageInfo": {
        "endCursor": "MTc1ODg0NDQ4MTozMjQyNjM1MTg=",
        "hasNextPage": true,
        "hasPreviousPage": false,
        "startCursor": "MTc1ODg0NDUwNTozMjQyNjM2MTI="
      },
      "edges": [
        {
          "node": {
            "hash": "QDwqR9KYpwol3AziEkUUAxFiCdU1bI0Bs2X_3IZdrtQ",
            "cmd": {
              "meta": {
                "gasLimit": "1000",
                "chainId": 0,
                "creationTime": "2025-09-25T23:55:05.000Z",
                "gasPrice": "0.0000001",
                "sender": "k:bb1e230f5c46c1a7f4324b30ebf481004f552bfcaab9db4c797a69615da8cd7c"
              },
              "payload": {
                "code": "\"(free.radio02.add-received-with-chain \\\"e45f01fffea36fb5\\\" ...)\""
              }
            },
            "result": {
              "badResult": null,
              "gas": "439",
              "block": {
                "height": 6211733,
                "canonical": true
              }
            }
          },
          "cursor": "MTc1ODg0NDUwNTozMjQyNjM2MTI="
        },
        {
          "node": {
            "hash": "ztf8uSqaomo8dAw180rkpEa9HE058QH1URM75q9e3kU",
            "cmd": {
              "meta": {
                "gasLimit": "1000",
                "chainId": 0,
                "creationTime": "2025-09-25T23:55:03.000Z",
                "gasPrice": "0.0000001",
                "sender": "k:72d964fcd2ce70cecf1897d66a8883668b86446f3c6278a2b52b3361e8b5ba2a"
              },
              "payload": {
                "code": "\"(free.radio02.add-received-with-chain \\\"0e3fa4fffe712783\\\" ...)\""
              }
            },
            "result": {
              "badResult": null,
              "gas": "206",
              "block": {
                "height": 6211733,
                "canonical": true
              }
            }
          },
          "cursor": "MTc1ODg0NDUwMzozMjQyNjM2MTA="
        }
      ]
    }
  }
}
```

**Use Cases**

- Advanced block explorer filtering interfaces
- Chain-specific transaction analysis
- Height range transaction auditing
- Coinbase transaction exclusion/inclusion
- High-performance paginated transaction lists


**Notes**
Use isCoinbase: false to exclude mining transactions. Combine minHeight/maxHeight for specific block ranges. Pagination via pageInfo cursors handles massive datasets efficiently.

**Onde colocar:** `analytics/transaction-monitoring.md` - adicionar como nova seção

**Motivo:** Esta query é diferente das outras Transfers - não filtra por conta específica, filtra por token (fungibleName). É para análise de volume global de transferências de um token específico.

## Transfers: Global Token Transfer Volume

Monitor transfer volumes for specific tokens across the entire network without filtering by account.


```graphql
query Transfers($fungibleName: String, $first: Int) {
  transfers(fungibleName: $fungibleName, first: $first) {
    edges {
      node {
        amount
      }
    }
  }
}
```

**Variables**


```json
{
  "fungibleName": "coin",
  "first": 1
}
```

**Response**


```json
{
  "data": {
    "transfers": {
      "edges": [
        {
          "node": {
            "amount": "0.938634"
          }
        }
      ]
    }
  }
}
```

**Use Cases**

- Global transfer volume analysis
- Token activity monitoring
- Network-wide transaction flow tracking
- Market activity indicators


**Notes**
Use fungibleName "coin" for KDA transfers. Increase first parameter for larger sample sizes to calculate volume metrics.

Perfeito! Agora com a resposta real, vou atualizar a documentação:

## Transactions: Token-Filtered Transaction List

Filter transactions by specific token/module for focused transaction monitoring and analysis.


```graphql
query Transactions(
  $first: Int
  $last: Int
  $after: String
  $before: String
  $chainId: String
  $fungibleName: String
) {
  transactions(
    first: $first
    last: $last
    after: $after
    before: $before
    chainId: $chainId
    fungibleName: $fungibleName
  ) {
    pageInfo {
      endCursor
      hasNextPage
      hasPreviousPage
      startCursor
    }
    edges {
      node {
        hash
        cmd {
          meta {
            gasLimit
            chainId
            creationTime
            gasPrice
            sender
          }
          payload {
            ... on ExecutionPayload {
              code
            }
          }
        }
        result {
          ... on TransactionResult {
            badResult
            gas
            block {
              height
              canonical
            }
          }
        }
      }
      cursor
    }
  }
}
```

**Variables**


```json
{
  "first": 25,
  "chainId": "0",
  "fungibleName": "coin"
}
```

**Response**


```json
{
  "data": {
    "transactions": {
      "pageInfo": {
        "endCursor": "MTc1OTIzNTQzMjozMjUzMDAwMTI=",
        "hasNextPage": true,
        "hasPreviousPage": false,
        "startCursor": "MTc1OTIzNTQ3NDozMjUzMDAwNTI="
      },
      "edges": [
        {
          "node": {
            "hash": "LuzGbxsqYpJ0289JEKpAro2gbo5s2ALF1erSW4jZves",
            "cmd": {
              "meta": {
                "gasLimit": "15000",
                "chainId": 0,
                "creationTime": "2025-09-30T12:31:14.000Z",
                "gasPrice": "0.0000001",
                "sender": "k:db95bb27f743392abbefd67119281e78f2679cf5970da20bca704e447086db38"
              },
              "payload": {
                "code": "\"(free.radio02.close-send-receive \\\"k:f99185285730c5414c0a1ec68924598b175827890fad20c18548a9b27d79ce2a\\\" [{\\\"address\\\":\\\"k:dbe05f8ad7963277b60ed7ca548a44b7b4d0fcf49c2319c55a02e0c3a3e83758\\\",\\\"gatewayId\\\":\\\"e45f01fffe7db23a\\\",\\\"mic\\\":\\\"c05e1687\\\"}] [] )\""
              }
            },
            "result": {
              "badResult": null,
              "gas": "1734",
              "block": {
                "height": 6224775,
                "canonical": true
              }
            }
          },
          "cursor": "MTc1OTIzNTQ3NDozMjUzMDAwNTI="
        },
        {
          "node": {
            "hash": "qFgR_NaQUlDK4Jln-WCDBmEL4eCvAPxNTr-FxKh390Y",
            "cmd": {
              "meta": {
                "gasLimit": "3000",
                "chainId": 0,
                "creationTime": "2025-09-30T12:30:48.000Z",
                "gasPrice": "0.00001",
                "sender": "k:412695c549b11c7794ad1dbc901fe0be156db393b943464a03d1777cbd4e5392"
              },
              "payload": {
                "code": "\"(coin.transfer \\\"k:412695c549b11c7794ad1dbc901fe0be156db393b943464a03d1777cbd4e5392\\\" \\\"k:7cfe3761add000c3e711fdd3316d625365ab7b9ed97a8a814acabff0359d8e10\\\" 0.48336000)\""
              }
            },
            "result": {
              "badResult": null,
              "gas": "240",
              "block": {
                "height": 6224775,
                "canonical": true
              }
            }
          },
          "cursor": "MTc1OTIzNTQ0ODozMjUzMDAwMjQ="
        }
      ]
    }
  }
}
```

**Use Cases**

- Token-specific transaction monitoring
- KDA transfer analysis (fungibleName: "coin")
- Custom token activity tracking
- Chain-specific token transactions


**Notes**

- **Performance:** Avoid using `totalCount` field - it causes timeouts on large datasets
- Use `fungibleName: "coin"` for KDA transactions
- Combine with `chainId` for chain-specific filtering
- Use pagination cursors for efficient browsing