HyperFlow API Documentation

Auto-generated documentation for the HyperFlow GraphQL API.

Contact

HyperFlow

https://hyperflow.finance

API Endpoints
https://api.hyperflow.finance/ethereum/graphql

Queries

balance

Description

Get balance of an address at a specific block

Response

Returns a BalanceResult

Arguments
Name Description
address - String!
blockNumber - Int Default = null

Example

Query
query balance(
  $address: String!,
  $blockNumber: Int
) {
  balance(
    address: $address,
    blockNumber: $blockNumber
  ) {
    hex
    wei
    decimals
    decimal
  }
}
Variables
{"address": "abc123", "blockNumber": null}
Response
{
  "data": {
    "balance": {
      "hex": "xyz789",
      "wei": "xyz789",
      "decimals": 123,
      "decimal": "abc123"
    }
  }
}
Queries

blocks

Description

Query blocks with filtering, pagination, and ordering

Response

Returns a BlockConnection

Arguments
Name Description
queryInput - BlockQueryInput Default = null

Example

Query
query blocks($queryInput: BlockQueryInput) {
  blocks(queryInput: $queryInput) {
    items {
      ...BlockFragment
    }
    pageInfo {
      ...BlockPageInfoFragment
    }
  }
}
Variables
{"queryInput": null}
Response
{
  "data": {
    "blocks": {
      "items": [Block],
      "pageInfo": BlockPageInfo
    }
  }
}
Queries

dbSyncStatus

Description

Get DB synchronization status with node

Response

Returns a DbSyncResponse!

Example

Query
query dbSyncStatus {
  dbSyncStatus {
    nodeMetadata {
      ...NodeMetadataFragment
    }
    dbSyncStatus {
      ...DbSyncStatusFragment
    }
  }
}
Response
{
  "data": {
    "dbSyncStatus": {
      "nodeMetadata": NodeMetadata,
      "dbSyncStatus": DbSyncStatus
    }
  }
}
Queries

erc20Token

Description

Get ERC-20 token by contract address

Response

Returns an ERC20Token!

Arguments
Name Description
address - String!

Example

Query
query erc20Token($address: String!) {
  erc20Token(address: $address) {
    address
    erc20TotalSupply
    erc20BalanceOf {
      ...BalanceResultFragment
    }
    erc20Transfers {
      ...ERC20TokenTransferFragment
    }
    erc20Approvals {
      ...ERC20TokenApprovalFragment
    }
    erc20Holders {
      ...ERC20TokenHolderFragment
    }
  }
}
Variables
{"address": "xyz789"}
Response
{
  "data": {
    "erc20Token": {
      "address": "xyz789",
      "erc20TotalSupply": "abc123",
      "erc20BalanceOf": BalanceResult,
      "erc20Transfers": [ERC20TokenTransfer],
      "erc20Approvals": [ERC20TokenApproval],
      "erc20Holders": [ERC20TokenHolder]
    }
  }
}
Queries

erc20TokenApprovals

Description

Query ERC-20 Approval events with filtering, pagination, and ordering

Response

Returns an ERC20TokenApprovalConnection

Arguments
Name Description
input - ERC20TokenApprovalQueryInput Default = null

Example

Query
query erc20TokenApprovals($input: ERC20TokenApprovalQueryInput) {
  erc20TokenApprovals(input: $input) {
    items {
      ...ERC20TokenApprovalFragment
    }
    pageInfo {
      ...PageInfoFragment
    }
  }
}
Variables
{"input": null}
Response
{
  "data": {
    "erc20TokenApprovals": {
      "items": [ERC20TokenApproval],
      "pageInfo": PageInfo
    }
  }
}
Queries

erc20TokenSwapEvents

Description

Query Uniswap V2 Swap events with filtering, pagination, and ordering

Response

Returns an ERC20TokenSwapEventConnection

Arguments
Name Description
input - ERC20TokenSwapEventQueryInput Default = null

Example

Query
query erc20TokenSwapEvents($input: ERC20TokenSwapEventQueryInput) {
  erc20TokenSwapEvents(input: $input) {
    items {
      ...ERC20TokenSwapEventFragment
    }
    pageInfo {
      ...PageInfoFragment
    }
  }
}
Variables
{"input": null}
Response
{
  "data": {
    "erc20TokenSwapEvents": {
      "items": [ERC20TokenSwapEvent],
      "pageInfo": PageInfo
    }
  }
}
Queries

erc20TokenTransfers

Description

Query ERC-20 Transfer events with filtering, pagination, and ordering

Response

Returns an ERC20TokenTransferConnection

Arguments
Name Description
input - ERC20TokenTransferQueryInput Default = null

Example

Query
query erc20TokenTransfers($input: ERC20TokenTransferQueryInput) {
  erc20TokenTransfers(input: $input) {
    items {
      ...ERC20TokenTransferFragment
    }
    pageInfo {
      ...PageInfoFragment
    }
  }
}
Variables
{"input": null}
Response
{
  "data": {
    "erc20TokenTransfers": {
      "items": [ERC20TokenTransfer],
      "pageInfo": PageInfo
    }
  }
}
Queries

estimateGas

Description

Estimate gas required for a transaction without executing it

Response

Returns an EstimateGasResult!

Arguments
Name Description
input - EstimateGasInput!

Example

Query
query estimateGas($input: EstimateGasInput!) {
  estimateGas(input: $input) {
    gas
    gasDecimal
  }
}
Variables
{"input": EstimateGasInput}
Response
{
  "data": {
    "estimateGas": {
      "gas": "xyz789",
      "gasDecimal": 987
    }
  }
}
Queries

ethCall

Description

Execute a call transaction without creating a transaction on chain

Response

Returns an EthCallResult!

Arguments
Name Description
input - EthCallInput!

Example

Query
query ethCall($input: EthCallInput!) {
  ethCall(input: $input) {
    data
  }
}
Variables
{"input": EthCallInput}
Response
{"data": {"ethCall": {"data": "abc123"}}}
Queries

ethGetCode

Description

Returns the bytecode at a given contract address. Equivalent to eth_getCode RPC method. Returns '0x' for non-contract addresses.

Response

Returns a String!

Arguments
Name Description
address - String!
blockNumber - Int Default = null

Example

Query
query ethGetCode(
  $address: String!,
  $blockNumber: Int
) {
  ethGetCode(
    address: $address,
    blockNumber: $blockNumber
  )
}
Variables
{"address": "xyz789", "blockNumber": null}
Response
{"data": {"ethGetCode": "xyz789"}}
Queries

ethGetTransactionCount

Description

Get the number of transactions sent from an address (nonce)

Response

Returns a TransactionCountResult!

Arguments
Name Description
input - GetTransactionCountInput!

Example

Query
query ethGetTransactionCount($input: GetTransactionCountInput!) {
  ethGetTransactionCount(input: $input) {
    hex
    count
  }
}
Variables
{"input": GetTransactionCountInput}
Response
{
  "data": {
    "ethGetTransactionCount": {
      "hex": "abc123",
      "count": "abc123"
    }
  }
}
Queries

ethSyncing

Response

Returns a JSON

Example

Query
query ethSyncing {
  ethSyncing
}
Response
{"data": {"ethSyncing": {}}}
Queries

getStorageAt

Description

Get contract storage value at a specific position

Response

Returns a StorageAtResult!

Arguments
Name Description
input - StorageAtInput!

Example

Query
query getStorageAt($input: StorageAtInput!) {
  getStorageAt(input: $input) {
    value
  }
}
Variables
{"input": StorageAtInput}
Response
{
  "data": {
    "getStorageAt": {"value": "xyz789"}
  }
}
Queries

logs

Description

Query logs with filtering, pagination, and ordering

Response

Returns a LogConnection

Arguments
Name Description
input - LogQueryInput Default = null

Example

Query
query logs($input: LogQueryInput) {
  logs(input: $input) {
    items {
      ...LogFragment
    }
    pageInfo {
      ...PageInfoFragment
    }
  }
}
Variables
{"input": null}
Response
{
  "data": {
    "logs": {
      "items": [Log],
      "pageInfo": PageInfo
    }
  }
}
Queries

metadata

Response

Returns a Metadata!

Example

Query
query metadata {
  metadata {
    clientVersion
    chainId
    netVersion
    netListening
    netPeerCount
    ethSyncing
    ethMining
    ethHashrate
    ethProtocolVersion
    ethBlockNumber
    ethGasPrice
  }
}
Response
{
  "data": {
    "metadata": {
      "clientVersion": "xyz789",
      "chainId": "abc123",
      "netVersion": "xyz789",
      "netListening": true,
      "netPeerCount": "xyz789",
      "ethSyncing": {},
      "ethMining": false,
      "ethHashrate": "abc123",
      "ethProtocolVersion": "abc123",
      "ethBlockNumber": "xyz789",
      "ethGasPrice": "abc123"
    }
  }
}
Queries

transactions

Description

Query transactions with filtering, pagination, and ordering

Response

Returns a TransactionConnection

Arguments
Name Description
input - TransactionQueryInput Default = null

Example

Query
query transactions($input: TransactionQueryInput) {
  transactions(input: $input) {
    items {
      ...TransactionFragment
    }
    pageInfo {
      ...PageInfoFragment
    }
  }
}
Variables
{"input": null}
Response
{
  "data": {
    "transactions": {
      "items": [Transaction],
      "pageInfo": PageInfo
    }
  }
}
Queries

usageStat

Description

Returns usage statistics (currently returns mock data)

Response

Returns an Effectiveness!

Example

Query
query usageStat {
  usageStat {
    effectiveness
    jsonrpcRatio
  }
}
Response
{"data": {"usageStat": {"effectiveness": 987.65, "jsonrpcRatio": 987.65}}}
Queries

web3Sha3

Response

Returns a String!

Arguments
Name Description
message - String!

Example

Query
query web3Sha3($message: String!) {
  web3Sha3(message: $message)
}
Variables
{"message": "xyz789"}
Response
{"data": {"web3Sha3": "abc123"}}

Mutations

sendRawTransaction

Response

Returns a String!

Arguments
Name Description
signedTx - String!

Example

Query
mutation sendRawTransaction($signedTx: String!) {
  sendRawTransaction(signedTx: $signedTx)
}
Variables
{"signedTx": "abc123"}
Response
{"data": {"sendRawTransaction": "abc123"}}
Mutations

sendTransaction

Response

Returns a String!

Arguments
Name Description
txData - BuildTransactionInput!
signature - SignatureInput!

Example

Query
mutation sendTransaction(
  $txData: BuildTransactionInput!,
  $signature: SignatureInput!
) {
  sendTransaction(
    txData: $txData,
    signature: $signature
  )
}
Variables
{
  "txData": BuildTransactionInput,
  "signature": SignatureInput
}
Response
{"data": {"sendTransaction": "xyz789"}}
Mutations

signTransaction

Response

Returns a String!

Arguments
Name Description
txData - BuildTransactionInput!
signature - SignatureInput!

Example

Query
mutation signTransaction(
  $txData: BuildTransactionInput!,
  $signature: SignatureInput!
) {
  signTransaction(
    txData: $txData,
    signature: $signature
  )
}
Variables
{
  "txData": BuildTransactionInput,
  "signature": SignatureInput
}
Response
{"data": {"signTransaction": "xyz789"}}

Types

BalanceResult

Fields
Field Name Description
hex - String!
wei - String!
decimals - Int!
decimal - String!
Example
{
  "hex": "abc123",
  "wei": "abc123",
  "decimals": 987,
  "decimal": "abc123"
}
Types

BigInt

Description

Large integer that can exceed 32-bit range, serialized as string

Example
{}
Types

BigIntFilter

Description

Filter for large integer fields (UInt256)

Fields
Input Field Description
eq - String Equals (as string for large numbers). Default = null
ne - String Not equals. Default = null
gt - String Greater than. Default = null
gte - String Greater than or equal. Default = null
lt - String Less than. Default = null
lte - String Less than or equal. Default = null
in - [String!] In list of values. Default = null
notIn - [String!] Not in list of values. Default = null
isNull - Boolean Is null check. Default = null
Example
{
  "eq": "abc123",
  "ne": "abc123",
  "gt": "xyz789",
  "gte": "abc123",
  "lt": "xyz789",
  "lte": "abc123",
  "in": ["abc123"],
  "notIn": ["xyz789"],
  "isNull": true
}
Types

Block

Description

Ethereum block

Fields
Field Name Description
number - String! Block number
hash - String! Block hash
parentHash - String Parent block hash
timestamp - String Unix timestamp of block creation
miner - String Address of the miner
gasUsed - String Total gas used by all transactions
gasLimit - String Maximum gas allowed in this block
baseFee - String Base fee per gas (EIP-1559)
difficulty - String Difficulty for this block
totalDifficulty - String Total difficulty of the chain until this block
size - String Block size in bytes
txCount - String Number of transactions in the block
stateRoot - String Root of the state trie
txRoot - String Root of the transaction trie
receiptRoot - String Root of the receipts trie
nonce - String Block nonce
mixDigest - String Mix hash for PoW verification
uncleHash - String SHA3 of the uncles data
uncles - [String!] Array of uncle hashes
uncleCount - String Number of uncles
withdrawalsHash - String Root hash of withdrawals (EIP-4895)
withdrawalCount - String Number of withdrawals
blobGasUsed - String Total blob gas used (EIP-4844)
excessBlobGas - String Excess blob gas (EIP-4844)
logsBloom - String Bloom filter for logs
extraData - String Extra data field
parentBeaconRoot - String Parent beacon block root (EIP-4788)
requestsHash - String Root hash of requests (EIP-7685)
baseTxId - String Base transaction ID
createdAt - String Creation timestamp
transactions - [Transaction!]! Block transactions
Example
{
  "number": "xyz789",
  "hash": "xyz789",
  "parentHash": "xyz789",
  "timestamp": "xyz789",
  "miner": "xyz789",
  "gasUsed": "abc123",
  "gasLimit": "abc123",
  "baseFee": "xyz789",
  "difficulty": "abc123",
  "totalDifficulty": "abc123",
  "size": "abc123",
  "txCount": "abc123",
  "stateRoot": "xyz789",
  "txRoot": "xyz789",
  "receiptRoot": "xyz789",
  "nonce": "xyz789",
  "mixDigest": "xyz789",
  "uncleHash": "abc123",
  "uncles": ["xyz789"],
  "uncleCount": "abc123",
  "withdrawalsHash": "xyz789",
  "withdrawalCount": "xyz789",
  "blobGasUsed": "abc123",
  "excessBlobGas": "abc123",
  "logsBloom": "abc123",
  "extraData": "abc123",
  "parentBeaconRoot": "abc123",
  "requestsHash": "abc123",
  "baseTxId": "xyz789",
  "createdAt": "xyz789",
  "transactions": [Transaction]
}
Types

BlockConnection

Description

Paginated block response

Fields
Field Name Description
items - [Block!]! List of blocks in this page
pageInfo - BlockPageInfo! Pagination information
Example
{
  "items": [Block],
  "pageInfo": BlockPageInfo
}
Types

BlockFilterInput

Description

Filter query_input for blocks with logical operators

Fields
Input Field Description
hash - StringFilter Filter by block hash. Default = null
parentHash - StringFilter Filter by parent block hash. Default = null
miner - StringFilter Filter by miner address. Default = null
nonce - StringFilter Filter by block nonce. Default = null
stateRoot - StringFilter Filter by state root. Default = null
txRoot - StringFilter Filter by transaction root. Default = null
receiptRoot - StringFilter Filter by receipt root. Default = null
mixDigest - StringFilter Filter by mix digest. Default = null
uncleHash - StringFilter Filter by uncle hash. Default = null
extraData - StringFilter Filter by extra data. Default = null
logsBloom - StringFilter Filter by logs bloom. Default = null
withdrawalsHash - StringFilter Filter by withdrawals hash. Default = null
parentBeaconRoot - StringFilter Filter by parent beacon root. Default = null
requestsHash - StringFilter Filter by requests hash. Default = null
number - IntFilter Filter by block number. Default = null
gasLimit - BigIntFilter Filter by gas limit. Default = null
gasUsed - BigIntFilter Filter by gas used. Default = null
timestamp - IntFilter Filter by timestamp. Default = null
difficulty - BigIntFilter Filter by difficulty. Default = null
totalDifficulty - BigIntFilter Filter by total difficulty. Default = null
size - IntFilter Filter by block size. Default = null
baseFee - BigIntFilter Filter by base fee per gas (EIP-1559). Default = null
txCount - IntFilter Filter by transaction count. Default = null
uncleCount - IntFilter Filter by uncle count. Default = null
withdrawalCount - IntFilter Filter by withdrawal count. Default = null
blobGasUsed - BigIntFilter Filter by blob gas used. Default = null
excessBlobGas - BigIntFilter Filter by excess blob gas. Default = null
baseTxId - BigIntFilter Filter by base transaction ID. Default = null
and - [BlockFilterInput!] Combine multiple filters with AND logic. Default = null
or - [BlockFilterInput!] Combine multiple filters with OR logic. Default = null
not - BlockFilterInput Negate the filter conditions. Default = null
Example
{
  "hash": StringFilter,
  "parentHash": StringFilter,
  "miner": StringFilter,
  "nonce": StringFilter,
  "stateRoot": StringFilter,
  "txRoot": StringFilter,
  "receiptRoot": StringFilter,
  "mixDigest": StringFilter,
  "uncleHash": StringFilter,
  "extraData": StringFilter,
  "logsBloom": StringFilter,
  "withdrawalsHash": StringFilter,
  "parentBeaconRoot": StringFilter,
  "requestsHash": StringFilter,
  "number": IntFilter,
  "gasLimit": BigIntFilter,
  "gasUsed": BigIntFilter,
  "timestamp": IntFilter,
  "difficulty": BigIntFilter,
  "totalDifficulty": BigIntFilter,
  "size": IntFilter,
  "baseFee": BigIntFilter,
  "txCount": IntFilter,
  "uncleCount": IntFilter,
  "withdrawalCount": IntFilter,
  "blobGasUsed": BigIntFilter,
  "excessBlobGas": BigIntFilter,
  "baseTxId": BigIntFilter,
  "and": [BlockFilterInput],
  "or": [BlockFilterInput],
  "not": BlockFilterInput
}
Types

BlockOrderByInput

Description

Block ordering parameters

Fields
Input Field Description
field - BlockOrderField! Field to order by. Default = NUMBER
direction - SortDirection! Sort direction. Default = DESC
Example
{"field": "NUMBER", "direction": "ASC"}
Types

BlockOrderField

Description

Block fields available for ordering

Values
Enum Value Description

NUMBER

HASH

TIMESTAMP

GAS_USED

GAS_LIMIT

MINER

DIFFICULTY

SIZE
Example
"NUMBER"
Types

BlockPageInfo

Description

Pagination info for cursor-based navigation

Fields
Field Name Description
hasNextPage - Boolean! Whether there are more items after this page
hasPreviousPage - Boolean! Whether there are items before this page
totalCount - Int! Total number of items
currentPage - Int! Current page number (1-based)
totalPages - Int! Total number of pages
Example
{
  "hasNextPage": false,
  "hasPreviousPage": true,
  "totalCount": 987,
  "currentPage": 123,
  "totalPages": 123
}
Types

BlockQueryInput

Description

Input for querying blocks with filters

Fields
Input Field Description
filters - BlockFilterInput Filter conditions for blocks. Default = null
pagination - PaginationInput Pagination settings. Default = null
orderBy - [BlockOrderByInput!] Ordering settings (multiple fields supported). Default = null
Example
{
  "filters": BlockFilterInput,
  "pagination": PaginationInput,
  "orderBy": [BlockOrderByInput]
}
Types

BlockSyncStatus

Description

Block sync status between DB and node

Fields
Field Name Description
nodeLastBlock - BigInt! Last block from node
dbMaxBlock - BigInt! Max block number in DB
dbActualCount - BigInt! Actual block count in DB
expected - BigInt! Expected count (nodeLastBlock + 1)
actual - BigInt! Actual count
isSynced - Boolean! Whether blocks are synced
status - SyncStatusEnum! Sync status
message - String Status description
Example
{
  "nodeLastBlock": {},
  "dbMaxBlock": {},
  "dbActualCount": {},
  "expected": {},
  "actual": {},
  "isSynced": true,
  "status": "SYNCED",
  "message": "abc123"
}
Types

BoolFilter

Description

Filter for boolean fields (UInt8 0/1)

Fields
Input Field Description
eq - Boolean Equals. Default = null
isNull - Boolean Is null check. Default = null
Example
{"eq": true, "isNull": false}
Types

Boolean

Description

The Boolean scalar type represents true or false.

Types

BuildTransactionInput

Description

Complete transaction data with all required fields for building and sending signed transaction

Fields
Input Field Description
to - String! Recipient address (20 bytes hex with 0x prefix)
value - String! Value in Wei (hex string with 0x prefix or decimal string)
gas - String! Gas limit (hex string with 0x prefix or decimal string)
nonce - String! Transaction nonce (hex string with 0x prefix or decimal string)
data - String! Contract call data (hex string with 0x prefix, use '0x' for empty data)
chainId - String! Chain ID (hex string with 0x prefix or decimal string)
gasPrice - String Gas price in Wei for legacy transactions (hex string with 0x prefix or decimal string, optional). Default = null
maxFeePerGas - String Maximum fee per gas for EIP-1559 transactions (hex string with 0x prefix or decimal string, optional). Default = null
maxPriorityFeePerGas - String Maximum priority fee per gas for EIP-1559 transactions (hex string with 0x prefix or decimal string, optional). Default = null
type - String Transaction type: '0' for legacy, '2' for EIP-1559 (hex string with 0x prefix or decimal string, optional). Default = null
Example
{
  "to": "abc123",
  "value": "abc123",
  "gas": "abc123",
  "nonce": "abc123",
  "data": "abc123",
  "chainId": "xyz789",
  "gasPrice": "abc123",
  "maxFeePerGas": "abc123",
  "maxPriorityFeePerGas": "abc123",
  "type": "xyz789"
}
Types

DateTime

Description

Date with time (isoformat)

Example
"2007-12-03T10:15:30Z"
Types

DateTimeFilter

Description

Filter for datetime fields

Fields
Input Field Description
eq - DateTime Equals. Default = null
ne - DateTime Not equals. Default = null
gt - DateTime After. Default = null
gte - DateTime On or after. Default = null
lt - DateTime Before. Default = null
lte - DateTime On or before. Default = null
between - [DateTime!] Between two dates [start, end]. Default = null
isNull - Boolean Is null check. Default = null
Example
{
  "eq": "2007-12-03T10:15:30Z",
  "ne": "2007-12-03T10:15:30Z",
  "gt": "2007-12-03T10:15:30Z",
  "gte": "2007-12-03T10:15:30Z",
  "lt": "2007-12-03T10:15:30Z",
  "lte": "2007-12-03T10:15:30Z",
  "between": ["2007-12-03T10:15:30Z"],
  "isNull": true
}
Types

DbSyncResponse

Description

DB sync response with node metadata

Fields
Field Name Description
nodeMetadata - NodeMetadata! Node metadata from RPC
dbSyncStatus - DbSyncStatus! DB sync status details
Example
{
  "nodeMetadata": NodeMetadata,
  "dbSyncStatus": DbSyncStatus
}
Types

DbSyncStatus

Description

Overall DB sync status

Fields
Field Name Description
blocks - BlockSyncStatus! Block sync status
transactions - TransactionSyncStatus! Transaction sync status
logs - LogSyncStatus! Log sync status
overallStatus - SyncStatusEnum! Overall status (worst of three)
syncPercentage - Float! Sync percentage (0-100%)
suggestedAction - String Suggested action: NONE | RESET_AND_RESYNC | INVESTIGATE
lastSyncCheck - DateTime! Time of last sync check
diagnosticMessage - String Detailed diagnostic information
Example
{
  "blocks": BlockSyncStatus,
  "transactions": TransactionSyncStatus,
  "logs": LogSyncStatus,
  "overallStatus": "SYNCED",
  "syncPercentage": 987.65,
  "suggestedAction": "abc123",
  "lastSyncCheck": "2007-12-03T10:15:30Z",
  "diagnosticMessage": "xyz789"
}
Types

ERC20Token

Description

ERC-20 token

Fields
Field Name Description
address - String! Token contract address
erc20TotalSupply - String! Total supply of tokens (from DB logs)
erc20BalanceOf - BalanceResult! Token balance for a specific holder (from DB logs)
Arguments
holder - String!
erc20Transfers - [ERC20TokenTransfer!]! Transfer events for this token
Arguments
fromAddress - String
toAddress - String
fromBlock - Int
toBlock - Int
limit - Int!
offset - Int!
erc20Approvals - [ERC20TokenApproval!]! Approval events for this token
Arguments
owner - String
spender - String
fromBlock - Int
toBlock - Int
limit - Int!
offset - Int!
erc20Holders - [ERC20TokenHolder!]! Get list of token holders with balances
Arguments
minBalance - String!
limit - Int!
offset - Int!
Example
{
  "address": "xyz789",
  "erc20TotalSupply": "xyz789",
  "erc20BalanceOf": BalanceResult,
  "erc20Transfers": [ERC20TokenTransfer],
  "erc20Approvals": [ERC20TokenApproval],
  "erc20Holders": [ERC20TokenHolder]
}
Types

ERC20TokenApproval

Description

ERC-20 Approval event from logs

Fields
Field Name Description
owner - String! Token owner address
spender - String! Approved spender address
value - String! Approved amount (hex string)
blockNumber - Int! Block number
txHash - String! Transaction hash
logIndex - Int! Log index in transaction
tokenAddress - String! Token contract address
Example
{
  "owner": "xyz789",
  "spender": "abc123",
  "value": "xyz789",
  "blockNumber": 987,
  "txHash": "abc123",
  "logIndex": 123,
  "tokenAddress": "xyz789"
}
Types

ERC20TokenApprovalConnection

Description

Connection type for paginated ERC-20 Approval events

Fields
Field Name Description
items - [ERC20TokenApproval!]! List of Approval events in this page
pageInfo - PageInfo! Pagination information
Example
{
  "items": [ERC20TokenApproval],
  "pageInfo": PageInfo
}
Types

ERC20TokenApprovalFilterInput

Description

Filter input for ERC-20 Token Approval events

Fields
Input Field Description
tokenAddress - StringFilter Filter by token contract address. Default = null
owner - StringFilter Filter by token owner address. Default = null
spender - StringFilter Filter by approved spender address. Default = null
value - StringFilter Filter by approved amount (hex string). Default = null
txHash - StringFilter Filter by transaction hash. Default = null
blockNumber - IntFilter Filter by block number. Default = null
logIndex - IntFilter Filter by log index. Default = null
and - [ERC20TokenApprovalFilterInput!] Combine multiple filters with AND logic. Default = null
or - [ERC20TokenApprovalFilterInput!] Combine multiple filters with OR logic. Default = null
not - ERC20TokenApprovalFilterInput Negate the filter conditions. Default = null
Example
{
  "tokenAddress": StringFilter,
  "owner": StringFilter,
  "spender": StringFilter,
  "value": StringFilter,
  "txHash": StringFilter,
  "blockNumber": IntFilter,
  "logIndex": IntFilter,
  "and": [ERC20TokenApprovalFilterInput],
  "or": [ERC20TokenApprovalFilterInput],
  "not": ERC20TokenApprovalFilterInput
}
Types

ERC20TokenApprovalOrderByInput

Description

ERC-20 Token Approval ordering parameters

Fields
Input Field Description
field - ERC20TokenApprovalOrderField! Field to order by. Default = BLOCK_NUMBER
direction - SortDirection! Sort direction. Default = DESC
Example
{"field": "BLOCK_NUMBER", "direction": "ASC"}
Types

ERC20TokenApprovalOrderField

Description

ERC-20 Token Approval event fields available for ordering

Values
Enum Value Description

BLOCK_NUMBER

LOG_INDEX

TOKEN_ADDRESS

OWNER

SPENDER

VALUE
Example
"BLOCK_NUMBER"
Types

ERC20TokenApprovalQueryInput

Description

Input for querying ERC-20 Token Approval events

Fields
Input Field Description
filters - ERC20TokenApprovalFilterInput Filter conditions for Approval events. Default = null
pagination - PaginationInput Pagination settings. Default = null
orderBy - [ERC20TokenApprovalOrderByInput!] Ordering settings (multiple fields supported). Default = null
Example
{
  "filters": ERC20TokenApprovalFilterInput,
  "pagination": PaginationInput,
  "orderBy": [ERC20TokenApprovalOrderByInput]
}
Types

ERC20TokenHolder

Description

ERC-20 token holder with balance

Fields
Field Name Description
holder - String! Holder wallet address
balance - BalanceResult! Token balance
Example
{
  "holder": "xyz789",
  "balance": BalanceResult
}
Types

ERC20TokenSwapEvent

Description

Uniswap V2 Swap event from logs

Fields
Field Name Description
pairAddress - String! Pair contract address
sender - String! Address that initiated the swap (msg.sender)
to - String! Recipient of output tokens
amount0In - String! Amount of token0 sent in (hex string)
amount1In - String! Amount of token1 sent in (hex string)
amount0Out - String! Amount of token0 received out (hex string)
amount1Out - String! Amount of token1 received out (hex string)
blockNumber - Int! Block number
txHash - String! Transaction hash
logIndex - Int! Log index in transaction
txIndex - Int! Transaction index in block
Example
{
  "pairAddress": "abc123",
  "sender": "xyz789",
  "to": "abc123",
  "amount0In": "abc123",
  "amount1In": "abc123",
  "amount0Out": "xyz789",
  "amount1Out": "abc123",
  "blockNumber": 123,
  "txHash": "xyz789",
  "logIndex": 123,
  "txIndex": 987
}
Types

ERC20TokenSwapEventConnection

Description

Connection type for paginated Uniswap V2 Swap events

Fields
Field Name Description
items - [ERC20TokenSwapEvent!]! List of Swap events in this page
pageInfo - PageInfo! Pagination information
Example
{
  "items": [ERC20TokenSwapEvent],
  "pageInfo": PageInfo
}
Types

ERC20TokenSwapEventFilterInput

Description

Filter input for Uniswap V2 Swap events

Fields
Input Field Description
pairAddress - StringFilter Filter by pair contract address. Default = null
sender - StringFilter Filter by swap sender address. Default = null
to - StringFilter Filter by swap recipient address. Default = null
txHash - StringFilter Filter by transaction hash. Default = null
blockNumber - IntFilter Filter by block number. Default = null
logIndex - IntFilter Filter by log index. Default = null
txIndex - IntFilter Filter by transaction index. Default = null
and - [ERC20TokenSwapEventFilterInput!] Combine multiple filters with AND logic. Default = null
or - [ERC20TokenSwapEventFilterInput!] Combine multiple filters with OR logic. Default = null
not - ERC20TokenSwapEventFilterInput Negate the filter conditions. Default = null
Example
{
  "pairAddress": StringFilter,
  "sender": StringFilter,
  "to": StringFilter,
  "txHash": StringFilter,
  "blockNumber": IntFilter,
  "logIndex": IntFilter,
  "txIndex": IntFilter,
  "and": [ERC20TokenSwapEventFilterInput],
  "or": [ERC20TokenSwapEventFilterInput],
  "not": ERC20TokenSwapEventFilterInput
}
Types

ERC20TokenSwapEventOrderByInput

Description

Uniswap V2 Swap event ordering parameters

Fields
Input Field Description
field - ERC20TokenSwapEventOrderField! Field to order by. Default = BLOCK_NUMBER
direction - SortDirection! Sort direction. Default = DESC
Example
{"field": "BLOCK_NUMBER", "direction": "ASC"}
Types

ERC20TokenSwapEventOrderField

Description

Uniswap V2 Swap event fields available for ordering

Values
Enum Value Description

BLOCK_NUMBER

LOG_INDEX

TX_INDEX

PAIR_ADDRESS
Example
"BLOCK_NUMBER"
Types

ERC20TokenSwapEventQueryInput

Description

Input for querying Uniswap V2 Swap events

Fields
Input Field Description
filters - ERC20TokenSwapEventFilterInput Filter conditions for Swap events. Default = null
pagination - PaginationInput Pagination settings. Default = null
orderBy - [ERC20TokenSwapEventOrderByInput!] Ordering settings (multiple fields supported). Default = null
Example
{
  "filters": ERC20TokenSwapEventFilterInput,
  "pagination": PaginationInput,
  "orderBy": [ERC20TokenSwapEventOrderByInput]
}
Types

ERC20TokenTransfer

Description

ERC-20 Transfer event from logs

Fields
Field Name Description
fromAddress - String! Sender address
toAddress - String! Recipient address
value - String! Amount transferred (hex string)
blockNumber - Int! Block number
txHash - String! Transaction hash
logIndex - Int! Log index in transaction
tokenAddress - String! Token contract address
Example
{
  "fromAddress": "xyz789",
  "toAddress": "abc123",
  "value": "xyz789",
  "blockNumber": 123,
  "txHash": "abc123",
  "logIndex": 987,
  "tokenAddress": "xyz789"
}
Types

ERC20TokenTransferConnection

Description

Connection type for paginated ERC-20 Transfer events

Fields
Field Name Description
items - [ERC20TokenTransfer!]! List of Transfer events in this page
pageInfo - PageInfo! Pagination information
Example
{
  "items": [ERC20TokenTransfer],
  "pageInfo": PageInfo
}
Types

ERC20TokenTransferFilterInput

Description

Filter input for ERC-20 Token Transfer events

Fields
Input Field Description
tokenAddress - StringFilter Filter by token contract address. Default = null
fromAddress - StringFilter Filter by sender address. Default = null
toAddress - StringFilter Filter by recipient address. Default = null
value - StringFilter Filter by transfer amount (hex string). Default = null
txHash - StringFilter Filter by transaction hash. Default = null
blockNumber - IntFilter Filter by block number. Default = null
logIndex - IntFilter Filter by log index. Default = null
and - [ERC20TokenTransferFilterInput!] Combine multiple filters with AND logic. Default = null
or - [ERC20TokenTransferFilterInput!] Combine multiple filters with OR logic. Default = null
not - ERC20TokenTransferFilterInput Negate the filter conditions. Default = null
Example
{
  "tokenAddress": StringFilter,
  "fromAddress": StringFilter,
  "toAddress": StringFilter,
  "value": StringFilter,
  "txHash": StringFilter,
  "blockNumber": IntFilter,
  "logIndex": IntFilter,
  "and": [ERC20TokenTransferFilterInput],
  "or": [ERC20TokenTransferFilterInput],
  "not": ERC20TokenTransferFilterInput
}
Types

ERC20TokenTransferOrderByInput

Description

ERC-20 Token Transfer ordering parameters

Fields
Input Field Description
field - ERC20TokenTransferOrderField! Field to order by. Default = BLOCK_NUMBER
direction - SortDirection! Sort direction. Default = DESC
Example
{"field": "BLOCK_NUMBER", "direction": "ASC"}
Types

ERC20TokenTransferOrderField

Description

ERC-20 Token Transfer event fields available for ordering

Values
Enum Value Description

BLOCK_NUMBER

LOG_INDEX

TOKEN_ADDRESS

FROM_ADDRESS

TO_ADDRESS

VALUE
Example
"BLOCK_NUMBER"
Types

ERC20TokenTransferQueryInput

Description

Input for querying ERC-20 Token Transfer events

Fields
Input Field Description
filters - ERC20TokenTransferFilterInput Filter conditions for Transfer events. Default = null
pagination - PaginationInput Pagination settings. Default = null
orderBy - [ERC20TokenTransferOrderByInput!] Ordering settings (multiple fields supported). Default = null
Example
{
  "filters": ERC20TokenTransferFilterInput,
  "pagination": PaginationInput,
  "orderBy": [ERC20TokenTransferOrderByInput]
}
Types

Effectiveness

Fields
Field Name Description
effectiveness - Float! Hyperflow effectiveness on Base. The number of RPC requests over the past 7 days that didn't have to interact with RPC server
jsonrpcRatio - Float! JSON-RPC vs GraphQL. Average number of JSON-RPC requests sent in one GraphQL request over the last 7 days
Example
{"effectiveness": 123.45, "jsonrpcRatio": 123.45}
Types

EstimateGasInput

Fields
Input Field Description
to - String Recipient address (required for contract calls). Default = null
fromAddress - String Sender address (optional). Default = null
gas - String Gas limit (hex with 0x prefix, optional). Default = null
gasPrice - String Gas price in wei (hex with 0x prefix, optional, legacy). Default = null
maxFeePerGas - String Max fee per gas (hex with 0x prefix, EIP-1559). Default = null
maxPriorityFeePerGas - String Max priority fee per gas (hex with 0x prefix, EIP-1559). Default = null
value - String Value to send in wei (hex with 0x prefix, optional). Default = null
data - String Transaction data (hex with 0x prefix, required for contract calls). Default = null
blockIdentifier - String Optional block number (hex) or tag ("latest", "earliest", "pending"). Default = null
Example
{
  "to": "xyz789",
  "fromAddress": "xyz789",
  "gas": "xyz789",
  "gasPrice": "xyz789",
  "maxFeePerGas": "abc123",
  "maxPriorityFeePerGas": "xyz789",
  "value": "abc123",
  "data": "abc123",
  "blockIdentifier": "xyz789"
}
Types

EstimateGasResult

Fields
Field Name Description
gas - String! Estimated gas amount (hex string)
gasDecimal - Int! Estimated gas amount (decimal)
Example
{"gas": "abc123", "gasDecimal": 123}
Types

EthCallInput

Fields
Input Field Description
to - String Recipient address (required for contract calls). Default = null
fromAddress - String Sender address (optional). Default = null
gas - String Gas limit (hex with 0x prefix, optional). Default = null
gasPrice - String Gas price in wei (hex with 0x prefix, optional, legacy). Default = null
maxFeePerGas - String Max fee per gas (hex with 0x prefix, EIP-1559). Default = null
maxPriorityFeePerGas - String Max priority fee per gas (hex with 0x prefix, EIP-1559). Default = null
value - String Value to send in wei (hex with 0x prefix, optional). Default = null
data - String Transaction data (hex with 0x prefix, required for contract calls). Default = null
blockIdentifier - String! Block number (hex) or tag ("latest", "earliest", "pending"). Default = "latest"
Example
{
  "to": "abc123",
  "fromAddress": "xyz789",
  "gas": "xyz789",
  "gasPrice": "xyz789",
  "maxFeePerGas": "abc123",
  "maxPriorityFeePerGas": "xyz789",
  "value": "xyz789",
  "data": "abc123",
  "blockIdentifier": "xyz789"
}
Types

EthCallResult

Fields
Field Name Description
data - String! Hex-encoded return value of the executed contract call
Example
{"data": "abc123"}
Types

Float

Description

The Float scalar type represents signed double-precision fractional values as specified by IEEE 754.

Example
987.65
Types

GetTransactionCountInput

Fields
Input Field Description
address - String! Account address (20 bytes hex with 0x prefix)
blockIdentifier - String! Block number (hex) or tag ("latest", "earliest", "pending"). Default = "latest"
Example
{
  "address": "xyz789",
  "blockIdentifier": "abc123"
}
Types

Int

Description

The Int scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1.

Example
123
Types

IntFilter

Description

Filter for integer fields (UInt32, UInt64)

Fields
Input Field Description
eq - Int Equals. Default = null
ne - Int Not equals. Default = null
gt - Int Greater than. Default = null
gte - Int Greater than or equal. Default = null
lt - Int Less than. Default = null
lte - Int Less than or equal. Default = null
in - [Int!] In list of values. Default = null
notIn - [Int!] Not in list of values. Default = null
between - [Int!] Between two values [min, max]. Default = null
isNull - Boolean Is null check. Default = null
Example
{
  "eq": 987,
  "ne": 123,
  "gt": 987,
  "gte": 987,
  "lt": 987,
  "lte": 123,
  "in": [123],
  "notIn": [987],
  "between": [987],
  "isNull": false
}
Types

InternalTransaction

Description

Internal transaction (trace)

Fields
Field Name Description
blockNumber - String Block number
txHash - String Parent transaction hash
traceIndex - String Trace index within transaction
traceAddress - String Trace address path (e.g., '0.1.2' for nested calls)
fromAddress - String Sender address
toAddress - String Recipient address
valueWei - String Value transferred in wei
callType - String Call type: 'call', 'delegatecall', 'staticcall', 'create', 'create2'
gas - String Gas provided for the call
gasUsed - String Gas used by the call
input - String Input data for the call
output - String Output data from the call
error - String Error message if call failed
success - Boolean Whether the call was successful
createdAt - String Creation timestamp
Example
{
  "blockNumber": "xyz789",
  "txHash": "abc123",
  "traceIndex": "xyz789",
  "traceAddress": "abc123",
  "fromAddress": "abc123",
  "toAddress": "abc123",
  "valueWei": "abc123",
  "callType": "abc123",
  "gas": "abc123",
  "gasUsed": "abc123",
  "input": "xyz789",
  "output": "xyz789",
  "error": "xyz789",
  "success": true,
  "createdAt": "abc123"
}
Types

JSON

Description

The JSON scalar type represents JSON values as specified by ECMA-404.

Example
{}
Types

Log

Description

Transaction log entry

Fields
Field Name Description
blockNumber - String Block number
txIndex - String Transaction index in block
logIndex - String Log index within transaction
txHash - String Transaction hash
blockHash - String Block hash
address - String Contract address that emitted the log
topics - [String!] Log topics (event signature and indexed params)
data - String Log data (non-indexed event parameters)
removed - Boolean True if log was removed due to chain reorganization
createdAt - String Creation timestamp
transaction - Transaction Transaction that emitted this log
Example
{
  "blockNumber": "abc123",
  "txIndex": "xyz789",
  "logIndex": "abc123",
  "txHash": "xyz789",
  "blockHash": "abc123",
  "address": "xyz789",
  "topics": ["abc123"],
  "data": "xyz789",
  "removed": true,
  "createdAt": "abc123",
  "transaction": Transaction
}
Types

LogConnection

Description

Paginated log response

Fields
Field Name Description
items - [Log!]! List of logs in this page
pageInfo - PageInfo! Pagination information
Example
{
  "items": [Log],
  "pageInfo": PageInfo
}
Types

LogFilterInput

Description

Filter input for logs with logical operators

Fields
Input Field Description
blockNumber - IntFilter Filter by block number. Default = null
txIndex - IntFilter Filter by transaction index. Default = null
logIndex - IntFilter Filter by log index. Default = null
txHash - StringFilter Filter by transaction hash. Default = null
blockHash - StringFilter Filter by block hash. Default = null
address - StringFilter Filter by contract address. Default = null
topics - StringFilter Filter by topics (event signature and indexed params). Default = null
data - StringFilter Filter by log data. Default = null
removed - BoolFilter Filter by removed status. Default = null
and - [LogFilterInput!] Combine multiple filters with AND logic. Default = null
or - [LogFilterInput!] Combine multiple filters with OR logic. Default = null
not - LogFilterInput Negate the filter conditions. Default = null
Example
{
  "blockNumber": IntFilter,
  "txIndex": IntFilter,
  "logIndex": IntFilter,
  "txHash": StringFilter,
  "blockHash": StringFilter,
  "address": StringFilter,
  "topics": StringFilter,
  "data": StringFilter,
  "removed": BoolFilter,
  "and": [LogFilterInput],
  "or": [LogFilterInput],
  "not": LogFilterInput
}
Types

LogOrderByInput

Description

Log ordering parameters

Fields
Input Field Description
field - LogOrderField! Field to order by. Default = LOG_INDEX
direction - SortDirection! Sort direction. Default = ASC
Example
{"field": "BLOCK_NUMBER", "direction": "ASC"}
Types

LogOrderField

Description

Log fields available for ordering

Values
Enum Value Description

BLOCK_NUMBER

TX_INDEX

LOG_INDEX

ADDRESS

CREATED_AT
Example
"BLOCK_NUMBER"
Types

LogQueryInput

Description

Input for querying logs with filters

Fields
Input Field Description
filters - LogFilterInput Filter conditions for logs. Default = null
pagination - PaginationInput Pagination settings. Default = null
orderBy - [LogOrderByInput!] Ordering settings (multiple fields supported). Default = null
Example
{
  "filters": LogFilterInput,
  "pagination": PaginationInput,
  "orderBy": [LogOrderByInput]
}
Types

LogSyncStatus

Description

Log sync status between DB and transactions

Fields
Field Name Description
sumOfLogCountersInTxs - BigInt! Sum of logs_count from all transactions
actualCountInDb - BigInt! Actual log count in DB
isSynced - Boolean! Whether logs are synced
status - SyncStatusEnum! Sync status
message - String Status description
Example
{
  "sumOfLogCountersInTxs": {},
  "actualCountInDb": {},
  "isSynced": false,
  "status": "SYNCED",
  "message": "abc123"
}
Types

Metadata

Fields
Field Name Description
clientVersion - String
chainId - String
netVersion - String
netListening - Boolean
netPeerCount - String
ethSyncing - JSON
ethMining - Boolean
ethHashrate - String
ethProtocolVersion - String
ethBlockNumber - String
ethGasPrice - String
Example
{
  "clientVersion": "xyz789",
  "chainId": "abc123",
  "netVersion": "abc123",
  "netListening": true,
  "netPeerCount": "xyz789",
  "ethSyncing": {},
  "ethMining": false,
  "ethHashrate": "abc123",
  "ethProtocolVersion": "abc123",
  "ethBlockNumber": "abc123",
  "ethGasPrice": "xyz789"
}
Types

NodeMetadata

Description

Node metadata from RPC

Fields
Field Name Description
lastBlockNumber - String! Last block number (HEX for EVM)
lastBlockHash - String! Last block hash
blockTimestamp - Int! Unix timestamp of the last block
networkId - String! Network ID
chainId - Int! Chain ID
lastQueryTime - DateTime! Time when data was fetched
Example
{
  "lastBlockNumber": "abc123",
  "lastBlockHash": "abc123",
  "blockTimestamp": 123,
  "networkId": "abc123",
  "chainId": 123,
  "lastQueryTime": "2007-12-03T10:15:30Z"
}
Types

PageInfo

Description

Pagination info for cursor-based navigation

Fields
Field Name Description
hasNextPage - Boolean! Whether there are more items after this page
hasPreviousPage - Boolean! Whether there are items before this page
totalCount - Int! Total number of items
currentPage - Int! Current page number (1-based)
totalPages - Int! Total number of pages
Example
{
  "hasNextPage": true,
  "hasPreviousPage": true,
  "totalCount": 987,
  "currentPage": 123,
  "totalPages": 123
}
Types

PaginationInput

Description

Pagination parameters

Fields
Input Field Description
limit - Int! Maximum number of items to return (max: 1000). Default = 50
offset - Int! Number of items to skip. Default = 0
Example
{"limit": 987, "offset": 987}
Types

SignatureInput

Description

Transaction signature components (ECDSA r, s, v)

Fields
Input Field Description
r - String! ECDSA signature r component (hex string with 0x prefix)
s - String! ECDSA signature s component (hex string with 0x prefix)
v - String! ECDSA signature v component (hex string with 0x prefix or integer string)
Example
{
  "r": "xyz789",
  "s": "xyz789",
  "v": "abc123"
}
Types

SortDirection

Description

Sort direction

Values
Enum Value Description

ASC

DESC
Example
"ASC"
Types

StorageAtInput

Fields
Input Field Description
address - String! Contract address (20 bytes hex with 0x prefix)
position - String! Storage position (hex with 0x prefix, e.g., '0x0')
blockIdentifier - String! Block number (hex) or tag ("latest", "earliest", "pending", "safe", "finalized"). Default = "latest"
Example
{
  "address": "abc123",
  "position": "abc123",
  "blockIdentifier": "abc123"
}
Types

StorageAtResult

Fields
Field Name Description
value - String! Storage value at the given position (32 bytes hex string)
Example
{"value": "xyz789"}
Types

String

Description

The String scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.

Example
"xyz789"
Types

StringFilter

Description

Filter for string fields

Fields
Input Field Description
eq - String Equals. Default = null
ne - String Not equals. Default = null
contains - String Contains substring (case-sensitive). Default = null
notContains - String Does not contain substring. Default = null
startsWith - String Starts with. Default = null
endsWith - String Ends with. Default = null
regex - String Matches regular expression pattern (re2 syntax). Default = null
notRegex - String Does not match regular expression pattern. Default = null
in - [String!] In list of values. Default = null
notIn - [String!] Not in list of values. Default = null
isNull - Boolean Is null check. Default = null
Example
{
  "eq": "abc123",
  "ne": "abc123",
  "contains": "xyz789",
  "notContains": "abc123",
  "startsWith": "abc123",
  "endsWith": "xyz789",
  "regex": "abc123",
  "notRegex": "abc123",
  "in": ["abc123"],
  "notIn": ["xyz789"],
  "isNull": false
}
Types

SyncStatusEnum

Values
Enum Value Description

SYNCED

PARTIALLY_SYNCED

DESYNCHRONIZED

OUT_OF_SYNC

ERROR
Example
"SYNCED"
Types

Transaction

Description

Ethereum transaction

Fields
Field Name Description
blockNumber - String Block number of the transaction
txIndex - String Transaction index in the block
hash - String Transaction hash
fromAddress - String Sender address
toAddress - String Recipient address
valueWei - String Transaction value in wei
gas - String Gas limit
gasPrice - String Gas price in wei
gasUsed - String Actual gas used
nonce - String Transaction nonce
txType - String Transaction type
maxFeePerGas - String Max fee per gas (EIP-1559)
maxPriorityFeePerGas - String Max priority fee per gas (EIP-1559)
input - String Transaction input data (calldata)
v - String ECDSA recovery id
r - String ECDSA signature r
s - String ECDSA signature s
size - String Transaction size in bytes
success - Boolean Transaction status
logsCount - String Number of logs
createdAt - String Creation timestamp
logs - [Log!]! Transaction logs (events)
internalTransactions - [InternalTransaction!]! Internal transactions (traces)
Example
{
  "blockNumber": "abc123",
  "txIndex": "xyz789",
  "hash": "abc123",
  "fromAddress": "xyz789",
  "toAddress": "abc123",
  "valueWei": "abc123",
  "gas": "abc123",
  "gasPrice": "abc123",
  "gasUsed": "xyz789",
  "nonce": "abc123",
  "txType": "xyz789",
  "maxFeePerGas": "abc123",
  "maxPriorityFeePerGas": "abc123",
  "input": "xyz789",
  "v": "abc123",
  "r": "abc123",
  "s": "abc123",
  "size": "abc123",
  "success": true,
  "logsCount": "xyz789",
  "createdAt": "abc123",
  "logs": [Log],
  "internalTransactions": [InternalTransaction]
}
Types

TransactionConnection

Description

Paginated transaction response

Fields
Field Name Description
items - [Transaction!]! List of transactions in this page
pageInfo - PageInfo! Pagination information
Example
{
  "items": [Transaction],
  "pageInfo": PageInfo
}
Types

TransactionCountResult

Fields
Field Name Description
hex - String! Transaction count (hex string)
count - String! Transaction count (decimal string)
Example
{
  "hex": "xyz789",
  "count": "xyz789"
}
Types

TransactionFilterInput

Description

Filter query_input for transactions with logical operators

Fields
Input Field Description
hash - StringFilter Filter by transaction hash. Default = null
fromAddress - StringFilter Filter by sender address. Default = null
toAddress - StringFilter Filter by recipient address. Default = null
input - StringFilter Filter by input data (calldata). Default = null
blockNumber - IntFilter Filter by block number. Default = null
txIndex - IntFilter Filter by transaction index in block. Default = null
nonce - IntFilter Filter by nonce. Default = null
txType - IntFilter Filter by transaction type. Default = null
logsCount - IntFilter Filter by number of logs. Default = null
valueWei - BigIntFilter Filter by value in wei. Default = null
gas - BigIntFilter Filter by gas limit. Default = null
gasPrice - BigIntFilter Filter by gas price. Default = null
gasUsed - BigIntFilter Filter by gas used. Default = null
maxFeePerGas - BigIntFilter Filter by max fee per gas (EIP-1559). Default = null
maxPriorityFeePerGas - BigIntFilter Filter by max priority fee per gas (EIP-1559). Default = null
success - BoolFilter Filter by transaction success status. Default = null
createdAt - DateTimeFilter Filter by creation timestamp. Default = null
and - [TransactionFilterInput!] Combine multiple filters with AND logic. Default = null
or - [TransactionFilterInput!] Combine multiple filters with OR logic. Default = null
not - TransactionFilterInput Negate the filter conditions. Default = null
Example
{
  "hash": StringFilter,
  "fromAddress": StringFilter,
  "toAddress": StringFilter,
  "input": StringFilter,
  "blockNumber": IntFilter,
  "txIndex": IntFilter,
  "nonce": IntFilter,
  "txType": IntFilter,
  "logsCount": IntFilter,
  "valueWei": BigIntFilter,
  "gas": BigIntFilter,
  "gasPrice": BigIntFilter,
  "gasUsed": BigIntFilter,
  "maxFeePerGas": BigIntFilter,
  "maxPriorityFeePerGas": BigIntFilter,
  "success": BoolFilter,
  "createdAt": DateTimeFilter,
  "and": [TransactionFilterInput],
  "or": [TransactionFilterInput],
  "not": TransactionFilterInput
}
Types

TransactionOrderByInput

Description

Transaction ordering parameters

Fields
Input Field Description
field - TransactionOrderField! Field to order by. Default = BLOCK_NUMBER
direction - SortDirection! Sort direction. Default = DESC
Example
{"field": "BLOCK_NUMBER", "direction": "ASC"}
Types

TransactionOrderField

Description

Transaction fields available for ordering

Values
Enum Value Description

BLOCK_NUMBER

TX_INDEX

HASH

FROM_ADDRESS

TO_ADDRESS

VALUE_WEI

GAS

GAS_PRICE

GAS_USED

NONCE

CREATED_AT
Example
"BLOCK_NUMBER"
Types

TransactionQueryInput

Description

Input for querying transactions with filters

Fields
Input Field Description
filters - TransactionFilterInput Filter conditions for transactions. Default = null
pagination - PaginationInput Pagination settings. Default = null
orderBy - [TransactionOrderByInput!] Ordering settings (multiple fields supported). Default = null
Example
{
  "filters": TransactionFilterInput,
  "pagination": PaginationInput,
  "orderBy": [TransactionOrderByInput]
}
Types

TransactionSyncStatus

Description

Transaction sync status between DB and blocks

Fields
Field Name Description
sumOfTxCountersInBlocks - BigInt! Sum of tx_count from all blocks
actualCountInDb - BigInt! Actual transaction count in DB
isSynced - Boolean! Whether transactions are synced
status - SyncStatusEnum! Sync status
message - String Status description
Example
{
  "sumOfTxCountersInBlocks": {},
  "actualCountInDb": {},
  "isSynced": true,
  "status": "SYNCED",
  "message": "abc123"
}
Documentation by Anvil SpectaQL