HyperFlow API Documentation

Documentation / Overview
✦ AI-Native · Enterprise Grade · v0.1.16

Hyperflow: The AI-Native
Intelligence Layer for Blockchain

Transform raw on-chain chaos into actionable enterprise intelligence. Access structured datasets via unified GraphQL or our secure AI analytical engine.

API Reference
GRAPHQL API
Unified Query Interface
Single GraphQL endpoint for blocks, transactions, logs, ERC-20 tokens, and more — across all supported chains.
REAL-TIME
Live Blockchain Data
Sub-second indexing with powerful filtering, pagination, and ordering. Query by any field with full-text search.
MULTI-CHAIN
Cross-Chain Intelligence
Ethereum, Arbitrum, Base, Optimism, Polygon, BNB Chain, and Avalanche — with more chains on the roadmap.
Contact

HyperFlow

https://hyperflow.finance

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

Queries

balance

Description

Native coin balance (ETH/COTI) for a wallet. Calculated from on-chain transactions, internal transfers, mining rewards and withdrawals (db)

Response

Returns a BalanceResult

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

Example

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

blocks

Description

Query blocks with filtering, pagination, and ordering (db)

Response

Returns a BlockConnection

Arguments
Name Description
queryInput - BlockQueryInput Default = null

Example

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

dbSyncStatus

Description

Get DB synchronization status with node (db, rpc)

Response

Returns a DbSyncResponse!

Example

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

delegateStakeChangedEvents

Description

Query DelegateStakeChanged events with filtering, pagination, and ordering (db). Topic0: 0x52db726bc1b1643b24886ed6f0194a41de9abac79d1c12108aca494e5b2bda6b

Response

Returns a DelegateStakeChangedConnection

Arguments
Name Description
input - DelegateStakeChangedQueryInput Default = null

Example

Query
query delegateStakeChangedEvents($input: DelegateStakeChangedQueryInput) {
  delegateStakeChangedEvents(input: $input) {
    items {
      ...DelegateStakeChangedEventFragment
    }
    pageInfo {
      ...PageInfoFragment
    }
  }
}
Variables
{"input": null}
Response
{
  "data": {
    "delegateStakeChangedEvents": {
      "items": [DelegateStakeChangedEvent],
      "pageInfo": PageInfo
    }
  }
}
Queries

delegatedEvents

Description

Query Delegated events with filtering, pagination, and ordering (db). Topic0: 0x4bc154dd35d6a5cb9206482ecb473cdbf2473006d6bce728b9cc0741bcc59ea2

Response

Returns a DelegatedConnection

Arguments
Name Description
input - DelegatedQueryInput Default = null

Example

Query
query delegatedEvents($input: DelegatedQueryInput) {
  delegatedEvents(input: $input) {
    items {
      ...DelegatedEventFragment
    }
    pageInfo {
      ...PageInfoFragment
    }
  }
}
Variables
{"input": null}
Response
{
  "data": {
    "delegatedEvents": {
      "items": [DelegatedEvent],
      "pageInfo": PageInfo
    }
  }
}
Queries

erc20Token

Description

ERC-20 token by contract address. Provides token balance, total supply and holder list. Balances calculated from Transfer event logs (db, rpc)

Response

Returns an ERC20Token!

Arguments
Name Description
tokenAddress - String!

Example

Query
query erc20Token($tokenAddress: String!) {
  erc20Token(tokenAddress: $tokenAddress) {
    tokenAddress
    erc20TotalSupply
    erc20BalanceOf {
      ...BalanceResultFragment
    }
    erc20Holders {
      ...ERC20TokenHolderFragment
    }
  }
}
Variables
{"tokenAddress": "xyz789"}
Response
{
  "data": {
    "erc20Token": {
      "tokenAddress": "abc123",
      "erc20TotalSupply": "abc123",
      "erc20BalanceOf": BalanceResult,
      "erc20Holders": [ERC20TokenHolder]
    }
  }
}
Queries

erc20TokenApprovals

Description

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

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 (db)

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 (db)

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

erc721Transfers

Description

Query ERC-721 NFT Transfer events with filtering, pagination, and ordering (db)

Response

Returns an ERC721TransferConnection

Arguments
Name Description
input - ERC721TransferQueryInput Default = null

Example

Query
query erc721Transfers($input: ERC721TransferQueryInput) {
  erc721Transfers(input: $input) {
    items {
      ...ERC721TransferFragment
    }
    pageInfo {
      ...PageInfoFragment
    }
  }
}
Variables
{"input": null}
Response
{
  "data": {
    "erc721Transfers": {
      "items": [ERC721Transfer],
      "pageInfo": PageInfo
    }
  }
}
Queries

estimateGas

Description

Estimate gas required for a transaction without executing it (rpc)

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": "abc123",
      "gasDecimal": 987
    }
  }
}
Queries

ethCall

Description

Execute a call transaction without creating a transaction on chain (rpc)

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": "xyz789"}}}
Queries

ethGetCode

Description

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

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": "abc123", "blockNumber": null}
Response
{"data": {"ethGetCode": "abc123"}}
Queries

ethGetTransactionCount

Description

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

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

Description

Ethereum sync status (rpc)

Response

Returns a JSON

Example

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

getStorageAt

Description

Get contract storage value at a specific position (rpc)

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": "abc123"}
  }
}
Queries

logs

Description

Query logs with filtering, pagination, and ordering (db)

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": "xyz789",
      "netVersion": "abc123",
      "netListening": true,
      "netPeerCount": "xyz789",
      "ethSyncing": {},
      "ethMining": true,
      "ethHashrate": "abc123",
      "ethProtocolVersion": "xyz789",
      "ethBlockNumber": "xyz789",
      "ethGasPrice": "xyz789"
    }
  }
}
Queries

transactions

Description

Query transactions with filtering, pagination, and ordering (db)

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) (mock)

Response

Returns an Effectiveness!

Example

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

web3Sha3

Description

Keccak-256 hash of the given message (local)

Response

Returns a String!

Arguments
Name Description
message - String!

Example

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

Mutations

sendRawTransaction

Description

Send a signed transaction to the blockchain (rpc)

Response

Returns a String!

Arguments
Name Description
signedTx - String!

Example

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

sendTransaction

Description

Build and send a signed transaction to the blockchain (rpc)

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

Description

Build a signed raw transaction without broadcasting (local)

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": "abc123"}}

Subscriptions

newBlocks

Response

Returns a Block!

Arguments
Name Description
criteria - BlockFilterInput Default = null
fromStart - Boolean! Default = false

Example

Query
subscription newBlocks(
  $criteria: BlockFilterInput,
  $fromStart: Boolean!
) {
  newBlocks(
    criteria: $criteria,
    fromStart: $fromStart
  ) {
    number
    hash
    parentHash
    timestamp
    miner
    gasUsed
    gasLimit
    baseFee
    difficulty
    totalDifficulty
    size
    txCount
    stateRoot
    txRoot
    receiptRoot
    nonce
    mixDigest
    uncleHash
    uncles
    uncleCount
    withdrawalsHash
    withdrawalCount
    blobGasUsed
    excessBlobGas
    logsBloom
    extraData
    parentBeaconRoot
    requestsHash
    baseTxId
    createdAt
    transactions {
      ...TransactionFragment
    }
  }
}
Variables
{"criteria": null, "fromStart": false}
Response
{
  "data": {
    "newBlocks": {
      "number": "xyz789",
      "hash": "xyz789",
      "parentHash": "abc123",
      "timestamp": "xyz789",
      "miner": "xyz789",
      "gasUsed": "abc123",
      "gasLimit": "xyz789",
      "baseFee": "abc123",
      "difficulty": "xyz789",
      "totalDifficulty": "abc123",
      "size": "abc123",
      "txCount": "abc123",
      "stateRoot": "abc123",
      "txRoot": "abc123",
      "receiptRoot": "xyz789",
      "nonce": "xyz789",
      "mixDigest": "xyz789",
      "uncleHash": "xyz789",
      "uncles": ["abc123"],
      "uncleCount": "abc123",
      "withdrawalsHash": "xyz789",
      "withdrawalCount": "abc123",
      "blobGasUsed": "abc123",
      "excessBlobGas": "xyz789",
      "logsBloom": "xyz789",
      "extraData": "xyz789",
      "parentBeaconRoot": "abc123",
      "requestsHash": "abc123",
      "baseTxId": "xyz789",
      "createdAt": "xyz789",
      "transactions": [Transaction]
    }
  }
}
Subscriptions

newLogs

Response

Returns a Log!

Arguments
Name Description
criteria - LogFilterInput Default = null
fromStart - Boolean! Default = false

Example

Query
subscription newLogs(
  $criteria: LogFilterInput,
  $fromStart: Boolean!
) {
  newLogs(
    criteria: $criteria,
    fromStart: $fromStart
  ) {
    blockNumber
    txIndex
    logIndex
    txHash
    blockHash
    address
    topic0
    topic1
    topic2
    topic3
    data
    removed
    createdAt
    topics
    transaction {
      ...EmbeddedTransactionFragment
    }
  }
}
Variables
{"criteria": null, "fromStart": false}
Response
{
  "data": {
    "newLogs": {
      "blockNumber": "abc123",
      "txIndex": "abc123",
      "logIndex": "abc123",
      "txHash": "abc123",
      "blockHash": "xyz789",
      "address": "xyz789",
      "topic0": "abc123",
      "topic1": "abc123",
      "topic2": "xyz789",
      "topic3": "xyz789",
      "data": "abc123",
      "removed": false,
      "createdAt": "abc123",
      "topics": ["abc123"],
      "transaction": EmbeddedTransaction
    }
  }
}
Subscriptions

newPendingTransactions

Response

Returns a Transaction!

Example

Query
subscription newPendingTransactions {
  newPendingTransactions {
    blockNumber
    txIndex
    hash
    fromAddress
    toAddress
    valueWei
    gas
    gasPrice
    gasUsed
    nonce
    txType
    maxFeePerGas
    maxPriorityFeePerGas
    input
    v
    r
    s
    size
    success
    logsCount
    createdAt
    logs {
      ...EmbeddedLogFragment
    }
    internalTransactions {
      ...InternalTransactionFragment
    }
  }
}
Response
{
  "data": {
    "newPendingTransactions": {
      "blockNumber": "abc123",
      "txIndex": "abc123",
      "hash": "abc123",
      "fromAddress": "xyz789",
      "toAddress": "abc123",
      "valueWei": "xyz789",
      "gas": "abc123",
      "gasPrice": "abc123",
      "gasUsed": "xyz789",
      "nonce": "abc123",
      "txType": "xyz789",
      "maxFeePerGas": "abc123",
      "maxPriorityFeePerGas": "abc123",
      "input": "xyz789",
      "v": "abc123",
      "r": "abc123",
      "s": "xyz789",
      "size": "xyz789",
      "success": false,
      "logsCount": "abc123",
      "createdAt": "xyz789",
      "logs": [EmbeddedLog],
      "internalTransactions": [InternalTransaction]
    }
  }
}
Subscriptions

newTransactions

Response

Returns a Transaction!

Arguments
Name Description
criteria - TransactionFilterInput Default = null
fromStart - Boolean! Default = false

Example

Query
subscription newTransactions(
  $criteria: TransactionFilterInput,
  $fromStart: Boolean!
) {
  newTransactions(
    criteria: $criteria,
    fromStart: $fromStart
  ) {
    blockNumber
    txIndex
    hash
    fromAddress
    toAddress
    valueWei
    gas
    gasPrice
    gasUsed
    nonce
    txType
    maxFeePerGas
    maxPriorityFeePerGas
    input
    v
    r
    s
    size
    success
    logsCount
    createdAt
    logs {
      ...EmbeddedLogFragment
    }
    internalTransactions {
      ...InternalTransactionFragment
    }
  }
}
Variables
{"criteria": null, "fromStart": false}
Response
{
  "data": {
    "newTransactions": {
      "blockNumber": "xyz789",
      "txIndex": "xyz789",
      "hash": "xyz789",
      "fromAddress": "xyz789",
      "toAddress": "xyz789",
      "valueWei": "abc123",
      "gas": "abc123",
      "gasPrice": "xyz789",
      "gasUsed": "xyz789",
      "nonce": "xyz789",
      "txType": "xyz789",
      "maxFeePerGas": "abc123",
      "maxPriorityFeePerGas": "abc123",
      "input": "abc123",
      "v": "abc123",
      "r": "xyz789",
      "s": "abc123",
      "size": "xyz789",
      "success": false,
      "logsCount": "abc123",
      "createdAt": "xyz789",
      "logs": [EmbeddedLog],
      "internalTransactions": [InternalTransaction]
    }
  }
}

Types

BalanceResult

Description

Balance in multiple representations

Fields
Field Name Description
hex - String! Balance as 0x-prefixed hex string (e.g. '0xde0b6b3a7640000')
wei - String! Balance as decimal string in wei (e.g. '1000000000000000000')
decimals - Int! Decimal places used for conversion (18 for native ETH/COTI, token-specific for ERC-20)
decimal - String! Human-readable balance with decimals applied (e.g. '1.0' = 1 ETH)
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": "xyz789",
  "lt": "abc123",
  "lte": "abc123",
  "in": ["abc123"],
  "notIn": ["xyz789"],
  "isNull": true
}
Types

Block

Description

Ethereum block

Fields
Field Name Description
number - String! Block number, decimal string (db)
hash - String! Block hash, 0x-prefixed 32-byte hex (db)
parentHash - String Parent block hash, 0x-prefixed 32-byte hex (db)
timestamp - String Unix timestamp (seconds since epoch), decimal string (db)
miner - String Miner/validator address, checksummed EIP-55 (db)
gasUsed - String Total gas used by all transactions, decimal string (db)
gasLimit - String Block gas limit, decimal string (db)
baseFee - String Base fee per gas in wei, decimal string; '0' for pre-EIP-1559 blocks (db)
difficulty - String Block difficulty, decimal string; '0' post-Merge (db)
totalDifficulty - String Cumulative chain difficulty, decimal string (db)
size - String Block size in bytes, decimal string (db)
txCount - String Transaction count in the block, decimal string (db)
stateRoot - String State trie root, 0x-prefixed 32-byte hex (db)
txRoot - String Transaction trie root, 0x-prefixed 32-byte hex (db)
receiptRoot - String Receipts trie root, 0x-prefixed 32-byte hex (db)
nonce - String Block nonce (PoW), decimal string; '0' post-Merge (db)
mixDigest - String Mix hash for PoW, 0x-prefixed 32-byte hex (db)
uncleHash - String SHA3 of uncles list, 0x-prefixed 32-byte hex (db)
uncles - [String!] Uncle block hashes, each 0x-prefixed 32-byte hex (db)
uncleCount - String Number of uncle blocks, decimal string (db)
withdrawalsHash - String Withdrawals trie root, 0x-prefixed 32-byte hex (EIP-4895) (db)
withdrawalCount - String Number of validator withdrawals, decimal string (db)
blobGasUsed - String Blob gas consumed, decimal string (EIP-4844) (db)
excessBlobGas - String Excess blob gas for pricing, decimal string (EIP-4844) (db)
logsBloom - String Bloom filter for log lookup, 0x-prefixed 256-byte hex (db)
extraData - String Arbitrary data set by the miner, 0x-prefixed hex (db)
parentBeaconRoot - String Parent beacon block root, 0x-prefixed 32-byte hex (EIP-4788) (db)
requestsHash - String Requests trie root, 0x-prefixed 32-byte hex (EIP-7685) (db)
baseTxId - String Base transaction ID for indexer range, decimal string (db)
createdAt - String Indexer ingestion timestamp, ISO 8601 (db)
transactions - [Transaction!]! Block transactions (db)
Example
{
  "number": "xyz789",
  "hash": "abc123",
  "parentHash": "abc123",
  "timestamp": "xyz789",
  "miner": "xyz789",
  "gasUsed": "xyz789",
  "gasLimit": "xyz789",
  "baseFee": "xyz789",
  "difficulty": "xyz789",
  "totalDifficulty": "abc123",
  "size": "xyz789",
  "txCount": "abc123",
  "stateRoot": "xyz789",
  "txRoot": "xyz789",
  "receiptRoot": "abc123",
  "nonce": "xyz789",
  "mixDigest": "xyz789",
  "uncleHash": "xyz789",
  "uncles": ["abc123"],
  "uncleCount": "xyz789",
  "withdrawalsHash": "abc123",
  "withdrawalCount": "xyz789",
  "blobGasUsed": "abc123",
  "excessBlobGas": "xyz789",
  "logsBloom": "abc123",
  "extraData": "abc123",
  "parentBeaconRoot": "xyz789",
  "requestsHash": "xyz789",
  "baseTxId": "abc123",
  "createdAt": "xyz789",
  "transactions": [Transaction]
}
Types

BlockConnection

Description

Paginated block response

Fields
Field Name Description
items - [Block!]! List of blocks in this page
pageInfo - PageInfo! Pagination information
Example
{
  "items": [Block],
  "pageInfo": PageInfo
}
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

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 (rpc)
dbMaxBlock - BigInt! Max block number in DB (db)
dbActualCount - BigInt! Actual block count in DB (db)
expected - BigInt! Expected count (nodeLastBlock + 1) (rpc)
actual - BigInt! Actual count (db)
isSynced - Boolean! Whether blocks are synced (db, rpc)
status - SyncStatusEnum! Sync status (db, rpc)
message - String Status description (db, rpc)
Example
{
  "nodeLastBlock": {},
  "dbMaxBlock": {},
  "dbActualCount": {},
  "expected": {},
  "actual": {},
  "isSynced": true,
  "status": "SYNCED",
  "message": "xyz789"
}
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": "xyz789",
  "value": "abc123",
  "gas": "abc123",
  "nonce": "xyz789",
  "data": "abc123",
  "chainId": "xyz789",
  "gasPrice": "xyz789",
  "maxFeePerGas": "abc123",
  "maxPriorityFeePerGas": "xyz789",
  "type": "abc123"
}
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": false
}
Types

DbSyncResponse

Description

DB sync response with node metadata

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

DbSyncStatus

Description

Overall DB sync status

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

DelegateStakeChangedConnection

Description

Connection type for paginated DelegateStakeChanged events

Fields
Field Name Description
items - [DelegateStakeChangedEvent!]! List of DelegateStakeChanged events
pageInfo - PageInfo! Pagination information
Example
{
  "items": [DelegateStakeChangedEvent],
  "pageInfo": PageInfo
}
Types

DelegateStakeChangedEvent

Description

DelegateStakeChanged event — emitted when delegation stakes are updated in a PoS staking protocol. Topic0: 0x52db726bc1b1643b24886ed6f0194a41de9abac79d1c12108aca494e5b2bda6b

Fields
Field Name Description
contractAddress - String! Staking contract address that emitted the event (db)
delegator - String! Delegator address — indexed topic1 (db)
guardian - String! Guardian address — indexed topic2 (db)
selfDelegatedStake - StakeAmount! Delegate's own stake (db)
delegatedStake - StakeAmount! Total delegated stake from other delegators (db)
totalStake - StakeAmount! Total guardian stake (self + delegated) (db)
blockNumber - Int! Block number (db)
txHash - String! Transaction hash (db)
logIndex - Int! Log index within the block (db)
tokenAddress - String ERC-20 token address resolved from the first Transfer event in the same transaction. Null if the operation didn't move tokens (e.g. unstake/delegate/restake — pure internal state changes) (db)
block - Block Block that contains this event (db)
transaction - Transaction Transaction that emitted this event (db)
log - Log Log entry for this event (db)
token - ERC20Token ERC-20 token used for staking. Null when the transaction didn't emit any Transfer event (unstake/delegate/restake)
delegatedEvents - [DelegatedEvent!]! All Delegated events for this delegator address. Shows delegation history (which guardians the delegator has delegated to)
Example
{
  "contractAddress": "abc123",
  "delegator": "abc123",
  "guardian": "abc123",
  "selfDelegatedStake": StakeAmount,
  "delegatedStake": StakeAmount,
  "totalStake": StakeAmount,
  "blockNumber": 987,
  "txHash": "abc123",
  "logIndex": 123,
  "tokenAddress": "xyz789",
  "block": Block,
  "transaction": Transaction,
  "log": Log,
  "token": ERC20Token,
  "delegatedEvents": [DelegatedEvent]
}
Types

DelegateStakeChangedFilterInput

Description

Filter input for DelegateStakeChanged events

Fields
Input Field Description
contractAddress - StringFilter Filter by contract address that emitted the event. Default = null
delegator - StringFilter Filter by delegator address (topic1). Default = null
guardian - StringFilter Filter by guardian address (topic2). 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 - [DelegateStakeChangedFilterInput!] Combine with AND logic. Default = null
or - [DelegateStakeChangedFilterInput!] Combine with OR logic. Default = null
not - DelegateStakeChangedFilterInput Negate conditions. Default = null
Example
{
  "contractAddress": StringFilter,
  "delegator": StringFilter,
  "guardian": StringFilter,
  "txHash": StringFilter,
  "blockNumber": IntFilter,
  "logIndex": IntFilter,
  "and": [DelegateStakeChangedFilterInput],
  "or": [DelegateStakeChangedFilterInput],
  "not": DelegateStakeChangedFilterInput
}
Types

DelegateStakeChangedOrderByInput

Description

DelegateStakeChanged event ordering parameters

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

DelegateStakeChangedOrderField

Description

DelegateStakeChanged event fields available for ordering

Values
Enum Value Description

BLOCK_NUMBER

LOG_INDEX
Example
"BLOCK_NUMBER"
Types

DelegateStakeChangedQueryInput

Description

Input for querying DelegateStakeChanged events

Fields
Input Field Description
filters - DelegateStakeChangedFilterInput Filter conditions. Default = null
pagination - PaginationInput Pagination settings. Default = null
orderBy - [DelegateStakeChangedOrderByInput!] Ordering. Default = null
Example
{
  "filters": DelegateStakeChangedFilterInput,
  "pagination": PaginationInput,
  "orderBy": [DelegateStakeChangedOrderByInput]
}
Types

DelegatedConnection

Description

Connection type for paginated Delegated events

Fields
Field Name Description
items - [DelegatedEvent!]! List of Delegated events
pageInfo - PageInfo! Pagination information
Example
{
  "items": [DelegatedEvent],
  "pageInfo": PageInfo
}
Types

DelegatedEvent

Description

Delegated event — emitted when a delegator delegates to a guardian in a PoS staking protocol. Topic0: 0x4bc154dd35d6a5cb9206482ecb473cdbf2473006d6bce728b9cc0741bcc59ea2

Fields
Field Name Description
contractAddress - String! Staking contract address that emitted the event (db)
delegator - String! Delegator address — indexed topic1 (db)
guardian - String! Guardian address — indexed topic2 (db)
blockNumber - Int! Block number (db)
txHash - String! Transaction hash (db)
logIndex - Int! Log index within the block (db)
tokenAddress - String ERC-20 token address resolved from the first Transfer event in the same transaction. Null if the operation didn't move tokens (e.g. unstake/delegate/restake — pure internal state changes) (db)
block - Block Block that contains this event (db)
transaction - Transaction Transaction that emitted this event (db)
log - Log Log entry for this event (db)
token - ERC20Token ERC-20 token used for staking. Null when the transaction didn't emit any Transfer event (unstake/delegate/restake)
Example
{
  "contractAddress": "xyz789",
  "delegator": "xyz789",
  "guardian": "xyz789",
  "blockNumber": 987,
  "txHash": "abc123",
  "logIndex": 987,
  "tokenAddress": "abc123",
  "block": Block,
  "transaction": Transaction,
  "log": Log,
  "token": ERC20Token
}
Types

DelegatedFilterInput

Description

Filter input for Delegated events

Fields
Input Field Description
contractAddress - StringFilter Filter by contract address that emitted the event. Default = null
delegator - StringFilter Filter by delegator address (topic1). Default = null
guardian - StringFilter Filter by guardian address (topic2). 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 - [DelegatedFilterInput!] Combine with AND logic. Default = null
or - [DelegatedFilterInput!] Combine with OR logic. Default = null
not - DelegatedFilterInput Negate conditions. Default = null
Example
{
  "contractAddress": StringFilter,
  "delegator": StringFilter,
  "guardian": StringFilter,
  "txHash": StringFilter,
  "blockNumber": IntFilter,
  "logIndex": IntFilter,
  "and": [DelegatedFilterInput],
  "or": [DelegatedFilterInput],
  "not": DelegatedFilterInput
}
Types

DelegatedOrderByInput

Description

Delegated event ordering parameters

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

DelegatedOrderField

Description

Delegated event fields available for ordering

Values
Enum Value Description

BLOCK_NUMBER

LOG_INDEX
Example
"BLOCK_NUMBER"
Types

DelegatedQueryInput

Description

Input for querying Delegated events

Fields
Input Field Description
filters - DelegatedFilterInput Filter conditions. Default = null
pagination - PaginationInput Pagination settings. Default = null
orderBy - [DelegatedOrderByInput!] Ordering. Default = null
Example
{
  "filters": DelegatedFilterInput,
  "pagination": PaginationInput,
  "orderBy": [DelegatedOrderByInput]
}
Types

ERC20Token

Description

ERC-20 token

Fields
Field Name Description
tokenAddress - String! ERC-20 token smart contract address
erc20TotalSupply - String! Total supply calculated from Transfer events: mints (from 0x0) minus burns (to 0x0) (db)
erc20BalanceOf - BalanceResult! ERC-20 token balance for a wallet. Calculated from Transfer events: received minus sent (db, rpc)
Arguments
walletAddress - String!
erc20Holders - [ERC20TokenHolder!]! List of token holders with non-zero balances, sorted by balance descending (db, rpc)
Arguments
minBalance - String!
limit - Int!
offset - Int!
Example
{
  "tokenAddress": "abc123",
  "erc20TotalSupply": "abc123",
  "erc20BalanceOf": BalanceResult,
  "erc20Holders": [ERC20TokenHolder]
}
Types

ERC20TokenApproval

Description

ERC-20 Approval event — emitted when an owner approves a spender to transfer tokens on their behalf

Fields
Field Name Description
tokenAddress - String! Token contract address that emitted the event (db)
owner - String! Token owner granting the approval (db)
spender - String! Address approved to spend tokens on owner's behalf (db)
value - String! Approved allowance as hex string; '0x00' = revoked, '0xffff...ffff' = unlimited; use parsedApproval.amountFormatted for human-readable value (db)
blockNumber - Int! Block number in which this event was emitted (db)
txHash - String! Transaction hash (db)
txIndex - Int! Transaction index within the block (db)
logIndex - Int! Log index within the transaction (db)
parsedApproval - ParsedTokenAmount Parsed approval with token decimals and human-readable approved amount (db+rpc)
Example
{
  "tokenAddress": "abc123",
  "owner": "abc123",
  "spender": "abc123",
  "value": "xyz789",
  "blockNumber": 123,
  "txHash": "abc123",
  "txIndex": 123,
  "logIndex": 987,
  "parsedApproval": ParsedTokenAmount
}
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
walletAddress - String! Holder wallet address (checksummed EIP-55)
balance - BalanceResult! ERC-20 token balance of this holder
Example
{
  "walletAddress": "abc123",
  "balance": BalanceResult
}
Types

ERC20TokenSwapEvent

Description

Uniswap V2 Swap event — emitted on every token swap within a pair contract

Fields
Field Name Description
pairAddress - String! Uniswap V2 pair contract address (db)
sender - String! Address that called swap() on the pair (msg.sender) (db)
to - String! Recipient address for the output tokens (db)
amount0In - String! Amount of token0 sent into the pair (hex); non-zero when token0 is tokenIn (db)
amount1In - String! Amount of token1 sent into the pair (hex); non-zero when token1 is tokenIn (db)
amount0Out - String! Amount of token0 received from the pair (hex); non-zero when token0 is tokenOut (db)
amount1Out - String! Amount of token1 received from the pair (hex); non-zero when token1 is tokenOut (db)
blockNumber - Int! Block number in which this event was emitted (db)
txHash - String! Transaction hash (db)
txIndex - Int! Transaction index within the block (db)
logIndex - Int! Log index within the transaction (db)
parsedSwap - ParsedSwap Parsed swap with tokenIn/tokenOut, addresses, decimals, and formatted amounts (db+rpc)
Example
{
  "pairAddress": "abc123",
  "sender": "abc123",
  "to": "abc123",
  "amount0In": "xyz789",
  "amount1In": "xyz789",
  "amount0Out": "abc123",
  "amount1Out": "abc123",
  "blockNumber": 123,
  "txHash": "abc123",
  "txIndex": 987,
  "logIndex": 123,
  "parsedSwap": ParsedSwap
}
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 — emitted on every token transfer between addresses

Fields
Field Name Description
tokenAddress - String! Token contract address that emitted the event (db)
fromAddress - String! Sender address; zero address (0x000...000) for mint events (db)
toAddress - String! Recipient address; zero address (0x000...000) for burn events (db)
value - String! Amount transferred as hex string; use parsedTransfer.amountFormatted for human-readable value (db)
blockNumber - Int! Block number in which this event was emitted (db)
txHash - String! Transaction hash (db)
txIndex - Int! Transaction index within the block (db)
logIndex - Int! Log index within the transaction (db)
parsedTransfer - ParsedTokenAmount Parsed transfer with token decimals and human-readable amount (db+rpc)
Example
{
  "tokenAddress": "xyz789",
  "fromAddress": "abc123",
  "toAddress": "xyz789",
  "value": "abc123",
  "blockNumber": 987,
  "txHash": "abc123",
  "txIndex": 123,
  "logIndex": 123,
  "parsedTransfer": ParsedTokenAmount
}
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

ERC721Transfer

Description

ERC-721 NFT Transfer event — emitted on every NFT transfer between addresses

Fields
Field Name Description
tokenAddress - String! NFT contract address that emitted the event (db)
fromAddress - String! Sender address; zero address (0x000...000) for mint events (db)
toAddress - String! Recipient address; zero address (0x000...000) for burn events (db)
tokenId - String! NFT token ID as hex string (0x-prefixed, 64-char padded from topic3) (db)
blockNumber - Int! Block number in which this event was emitted (db)
txHash - String! Transaction hash (db)
txIndex - Int! Transaction index within the block (db)
logIndex - Int! Log index within the transaction (db)
Example
{
  "tokenAddress": "xyz789",
  "fromAddress": "abc123",
  "toAddress": "xyz789",
  "tokenId": "xyz789",
  "blockNumber": 123,
  "txHash": "abc123",
  "txIndex": 987,
  "logIndex": 123
}
Types

ERC721TransferConnection

Description

Connection type for paginated ERC-721 NFT Transfer events

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

ERC721TransferFilterInput

Description

Filter input for ERC-721 NFT Transfer events

Fields
Input Field Description
tokenAddress - StringFilter Filter by NFT contract address. Default = null
fromAddress - StringFilter Filter by sender address. Default = null
toAddress - StringFilter Filter by recipient address. Default = null
tokenId - StringFilter Filter by token ID (hex string, 0x-prefixed, 64-char padded). 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 - [ERC721TransferFilterInput!] Combine multiple filters with AND logic. Default = null
or - [ERC721TransferFilterInput!] Combine multiple filters with OR logic. Default = null
not - ERC721TransferFilterInput Negate the filter conditions. Default = null
Example
{
  "tokenAddress": StringFilter,
  "fromAddress": StringFilter,
  "toAddress": StringFilter,
  "tokenId": StringFilter,
  "txHash": StringFilter,
  "blockNumber": IntFilter,
  "logIndex": IntFilter,
  "and": [ERC721TransferFilterInput],
  "or": [ERC721TransferFilterInput],
  "not": ERC721TransferFilterInput
}
Types

ERC721TransferOrderByInput

Description

ERC-721 NFT Transfer ordering parameters

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

ERC721TransferOrderField

Description

ERC-721 NFT Transfer event fields available for ordering

Values
Enum Value Description

BLOCK_NUMBER

LOG_INDEX

TOKEN_ADDRESS

FROM_ADDRESS

TO_ADDRESS

TOKEN_ID
Example
"BLOCK_NUMBER"
Types

ERC721TransferQueryInput

Description

Input for querying ERC-721 NFT Transfer events

Fields
Input Field Description
filters - ERC721TransferFilterInput Filter conditions for Transfer events. Default = null
pagination - PaginationInput Pagination settings. Default = null
orderBy - [ERC721TransferOrderByInput!] Ordering settings (multiple fields supported). Default = null
Example
{
  "filters": ERC721TransferFilterInput,
  "pagination": PaginationInput,
  "orderBy": [ERC721TransferOrderByInput]
}
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 (mock)
jsonrpcRatio - Float! JSON-RPC vs GraphQL. Average number of JSON-RPC requests sent in one GraphQL request over the last 7 days (mock)
Example
{"effectiveness": 987.65, "jsonrpcRatio": 123.45}
Types

EmbeddedLog

Description

Transaction log entry (embedded — no back-reference to transaction)

Fields
Field Name Description
blockNumber - String Block number, decimal string (db)
txIndex - String Transaction position in the block, decimal string (db)
logIndex - String Log position within the transaction, decimal string (db)
txHash - String Transaction hash, 0x-prefixed 32-byte hex (db)
blockHash - String Block hash, 0x-prefixed 32-byte hex (db)
address - String Contract address that emitted the log, checksummed EIP-55 (db)
topic0 - String! Event signature — keccak256 of event ABI, 0x-prefixed 32-byte hex (db)
topic1 - String! First indexed parameter, 0x-prefixed 32-byte hex; addresses are left-padded with zeros (db)
topic2 - String! Second indexed parameter, 0x-prefixed 32-byte hex (db)
topic3 - String! Third indexed parameter, 0x-prefixed 32-byte hex (db)
data - String Log data (non-indexed event parameters) (db)
removed - Boolean True if log was removed due to chain reorganization (db)
createdAt - String Creation timestamp (db)
topics - [String!] Log topics assembled from topic0-3 (event signature and indexed params)
Example
{
  "blockNumber": "abc123",
  "txIndex": "abc123",
  "logIndex": "xyz789",
  "txHash": "xyz789",
  "blockHash": "xyz789",
  "address": "xyz789",
  "topic0": "xyz789",
  "topic1": "xyz789",
  "topic2": "xyz789",
  "topic3": "xyz789",
  "data": "abc123",
  "removed": false,
  "createdAt": "abc123",
  "topics": ["abc123"]
}
Types

EmbeddedTransaction

Description

Ethereum transaction (embedded — no back-reference to logs)

Fields
Field Name Description
blockNumber - String Block number, decimal string (db)
txIndex - String Transaction position within the block, decimal string (db)
hash - String Transaction hash, 0x-prefixed 32-byte hex (db)
fromAddress - String Sender address, 0x-prefixed checksummed EIP-55 (db)
toAddress - String Recipient address, checksummed EIP-55; '0x' for contract creation (db)
valueWei - String Value in wei, decimal string (e.g. '1000000000000000000' = 1 ETH) (db)
gas - String Gas limit, decimal string (db)
gasPrice - String Gas price in wei, decimal string (db)
gasUsed - String Actual gas consumed, decimal string (db)
nonce - String Sender nonce, decimal string (db)
txType - String EIP-2718 transaction type: '0' legacy, '1' EIP-2930, '2' EIP-1559 (db)
maxFeePerGas - String Max fee per gas in wei, decimal string; '0' for legacy tx (EIP-1559) (db)
maxPriorityFeePerGas - String Max priority fee (tip) in wei, decimal string; '0' for legacy tx (EIP-1559) (db)
input - String Calldata, 0x-prefixed hex; '0x' for simple transfers (db)
v - String ECDSA recovery id (db)
r - String ECDSA signature r, 0x-prefixed hex (db)
s - String ECDSA signature s, 0x-prefixed hex (db)
size - String Transaction size in bytes, decimal string (db)
success - Boolean true if transaction succeeded (status=1) (db)
logsCount - String Number of event logs emitted, decimal string (db)
createdAt - String Indexer ingestion timestamp, ISO 8601 (db)
Example
{
  "blockNumber": "abc123",
  "txIndex": "xyz789",
  "hash": "xyz789",
  "fromAddress": "xyz789",
  "toAddress": "abc123",
  "valueWei": "abc123",
  "gas": "xyz789",
  "gasPrice": "xyz789",
  "gasUsed": "abc123",
  "nonce": "xyz789",
  "txType": "abc123",
  "maxFeePerGas": "xyz789",
  "maxPriorityFeePerGas": "xyz789",
  "input": "abc123",
  "v": "xyz789",
  "r": "abc123",
  "s": "abc123",
  "size": "xyz789",
  "success": true,
  "logsCount": "abc123",
  "createdAt": "xyz789"
}
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": "abc123",
  "fromAddress": "xyz789",
  "gas": "abc123",
  "gasPrice": "abc123",
  "maxFeePerGas": "abc123",
  "maxPriorityFeePerGas": "abc123",
  "value": "xyz789",
  "data": "xyz789",
  "blockIdentifier": "xyz789"
}
Types

EstimateGasResult

Fields
Field Name Description
gas - String! Estimated gas amount (hex string) (rpc)
gasDecimal - Int! Estimated gas amount (decimal) (rpc)
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": "abc123",
  "gasPrice": "abc123",
  "maxFeePerGas": "abc123",
  "maxPriorityFeePerGas": "xyz789",
  "value": "abc123",
  "data": "xyz789",
  "blockIdentifier": "xyz789"
}
Types

EthCallResult

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

Float

Description

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

Example
123.45
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": "abc123",
  "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": 123,
  "ne": 987,
  "gt": 123,
  "gte": 123,
  "lt": 987,
  "lte": 123,
  "in": [987],
  "notIn": [987],
  "between": [987],
  "isNull": true
}
Types

InternalTransaction

Description

Internal transaction (trace)

Fields
Field Name Description
blockNumber - String Block number, decimal string (db)
txHash - String Parent transaction hash, 0x-prefixed 32-byte hex (db)
traceIndex - String Trace position within the transaction, decimal string (db)
traceAddress - String Trace address path (e.g. '0.1.2' for nested calls) (db)
fromAddress - String Caller address, checksummed EIP-55 (db)
toAddress - String Target address, checksummed EIP-55; null for CREATE (db)
valueWei - String Value transferred in wei, decimal string (db)
callType - String Call type: 'call', 'delegatecall', 'staticcall', 'create', 'create2' (db)
gas - String Gas provided for the call, decimal string (db)
gasUsed - String Gas consumed by the call, decimal string (db)
input - String Call input data, 0x-prefixed hex (db)
output - String Call return data, 0x-prefixed hex (db)
error - String Revert reason if call failed; null on success (db)
success - Boolean true if the internal call succeeded (db)
createdAt - String Indexer ingestion timestamp, ISO 8601 (db)
Example
{
  "blockNumber": "abc123",
  "txHash": "xyz789",
  "traceIndex": "xyz789",
  "traceAddress": "abc123",
  "fromAddress": "xyz789",
  "toAddress": "abc123",
  "valueWei": "xyz789",
  "callType": "xyz789",
  "gas": "xyz789",
  "gasUsed": "xyz789",
  "input": "xyz789",
  "output": "xyz789",
  "error": "abc123",
  "success": true,
  "createdAt": "xyz789"
}
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, decimal string (db)
txIndex - String Transaction position in the block, decimal string (db)
logIndex - String Log position within the transaction, decimal string (db)
txHash - String Transaction hash, 0x-prefixed 32-byte hex (db)
blockHash - String Block hash, 0x-prefixed 32-byte hex (db)
address - String Contract address that emitted the log, checksummed EIP-55 (db)
topic0 - String! Event signature — keccak256 of event ABI, 0x-prefixed 32-byte hex (db)
topic1 - String! First indexed parameter, 0x-prefixed 32-byte hex; addresses are left-padded with zeros (db)
topic2 - String! Second indexed parameter, 0x-prefixed 32-byte hex (db)
topic3 - String! Third indexed parameter, 0x-prefixed 32-byte hex (db)
data - String Log data (non-indexed event parameters) (db)
removed - Boolean True if log was removed due to chain reorganization (db)
createdAt - String Creation timestamp (db)
topics - [String!] Log topics assembled from topic0-3 (event signature and indexed params)
transaction - EmbeddedTransaction Transaction that emitted this log — no back-reference to logs (db)
Example
{
  "blockNumber": "abc123",
  "txIndex": "abc123",
  "logIndex": "xyz789",
  "txHash": "abc123",
  "blockHash": "abc123",
  "address": "abc123",
  "topic0": "abc123",
  "topic1": "abc123",
  "topic2": "xyz789",
  "topic3": "xyz789",
  "data": "xyz789",
  "removed": false,
  "createdAt": "xyz789",
  "topics": ["abc123"],
  "transaction": EmbeddedTransaction
}
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
topic0 - StringFilter Filter by topic0 (event signature). Default = null
topic1 - StringFilter Filter by topic1 (1st indexed param). Default = null
topic2 - StringFilter Filter by topic2 (2nd indexed param). Default = null
topic3 - StringFilter Filter by topic3 (3rd indexed param). 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,
  "topic0": StringFilter,
  "topic1": StringFilter,
  "topic2": StringFilter,
  "topic3": 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 (db)
actualCountInDb - BigInt! Actual log count in DB (db)
isSynced - Boolean! Whether logs are synced (db)
status - SyncStatusEnum! Sync status (db)
message - String Status description (db)
Example
{
  "sumOfLogCountersInTxs": {},
  "actualCountInDb": {},
  "isSynced": false,
  "status": "SYNCED",
  "message": "abc123"
}
Types

Metadata

Fields
Field Name Description
clientVersion - String Client version (rpc)
chainId - String Chain ID (rpc)
netVersion - String Network version (rpc)
netListening - Boolean Whether the node is listening for connections (rpc)
netPeerCount - String Number of connected peers (rpc)
ethSyncing - JSON Sync status of the node (rpc)
ethMining - Boolean Whether the node is mining (rpc)
ethHashrate - String Current hashrate (rpc)
ethProtocolVersion - String Ethereum protocol version (rpc)
ethBlockNumber - String Latest block number, 0x-prefixed hex (db)
ethGasPrice - String Current gas price in wei, 0x-prefixed hex (db)
Example
{
  "clientVersion": "xyz789",
  "chainId": "abc123",
  "netVersion": "abc123",
  "netListening": false,
  "netPeerCount": "abc123",
  "ethSyncing": {},
  "ethMining": false,
  "ethHashrate": "xyz789",
  "ethProtocolVersion": "xyz789",
  "ethBlockNumber": "abc123",
  "ethGasPrice": "xyz789"
}
Types

NodeMetadata

Description

Node metadata from RPC

Fields
Field Name Description
lastBlockNumber - String! Last block number (HEX for EVM) (rpc)
lastBlockHash - String! Last block hash (rpc)
blockTimestamp - Int! Unix timestamp of the last block (rpc)
networkId - String! Network ID (rpc)
chainId - Int! Chain ID (rpc)
lastQueryTime - DateTime! Time when data was fetched (rpc)
Example
{
  "lastBlockNumber": "abc123",
  "lastBlockHash": "xyz789",
  "blockTimestamp": 987,
  "networkId": "xyz789",
  "chainId": 987,
  "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 - BigInt! Total number of items
currentPage - Int! Current page number (1-based)
totalPages - Int! Total number of pages
Example
{
  "hasNextPage": true,
  "hasPreviousPage": true,
  "totalCount": {},
  "currentPage": 987,
  "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": 123, "offset": 123}
Types

ParsedSwap

Description

Decoded Uniswap V2 swap: tokenIn and tokenOut with addresses, decimals, and formatted amounts

Fields
Field Name Description
tokenIn - SwapTokenInfo! Token that was sent into the pair (sold)
tokenOut - SwapTokenInfo! Token that was received from the pair (bought)
Example
{
  "tokenIn": SwapTokenInfo,
  "tokenOut": SwapTokenInfo
}
Types

ParsedTokenAmount

Description

Decoded token amount with raw hex, integer string, and human-readable formatted value

Fields
Field Name Description
tokenAddress - String! Token contract address (db)
decimals - Int Token decimals from decimals() RPC call; null if RPC unavailable (rpc, cached)
amount - String! Raw amount as hex string, as stored in the log (db)
amountRaw - String! Amount as unsigned integer string (e.g. '1000000' for 1 USDT) (db)
amountFormatted - String Human-readable amount with decimals applied (e.g. '1.0' for 1 USDT with 6 decimals); null if decimals unavailable (rpc, cached)
Example
{
  "tokenAddress": "abc123",
  "decimals": 987,
  "amount": "abc123",
  "amountRaw": "xyz789",
  "amountFormatted": "xyz789"
}
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": "abc123",
  "s": "xyz789",
  "v": "xyz789"
}
Types

SortDirection

Description

Sort direction

Values
Enum Value Description

ASC

DESC
Example
"ASC"
Types

StakeAmount

Description

Stake amount in multiple representations: hex, integer string, and human-readable decimal

Fields
Field Name Description
hex - String! Stake as 0x-prefixed hex string, raw from event data (db)
wei - String! Stake as unsigned integer string in wei (db)
decimals - Int! Decimal places (18 for standard ERC-20 staking tokens)
decimal - String! Human-readable stake with decimals applied (e.g. '1500.0')
Example
{
  "hex": "xyz789",
  "wei": "abc123",
  "decimals": 987,
  "decimal": "xyz789"
}
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": "xyz789",
  "position": "xyz789",
  "blockIdentifier": "xyz789"
}
Types

StorageAtResult

Fields
Field Name Description
value - String! Storage value at the given position (32 bytes hex string) (rpc)
Example
{"value": "abc123"}
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
"abc123"
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": "xyz789",
  "ne": "xyz789",
  "contains": "abc123",
  "notContains": "xyz789",
  "startsWith": "abc123",
  "endsWith": "xyz789",
  "regex": "abc123",
  "notRegex": "xyz789",
  "in": ["abc123"],
  "notIn": ["xyz789"],
  "isNull": false
}
Types

SwapTokenInfo

Description

Decoded token side of a swap — address, amounts, and decimals for one direction

Fields
Field Name Description
side - String! Position in pair: 'token0' or 'token1'
address - String Token contract address resolved from pair via RPC; null if RPC unavailable (rpc, cached)
amount - String! Raw amount as hex string from the Swap event (db)
amountRaw - String! Amount as unsigned integer string (db)
decimals - Int Token decimals from decimals() RPC call; null if RPC unavailable (rpc, cached)
amountFormatted - String Human-readable amount with decimals applied; null if decimals unavailable (rpc, cached)
Example
{
  "side": "xyz789",
  "address": "xyz789",
  "amount": "xyz789",
  "amountRaw": "abc123",
  "decimals": 987,
  "amountFormatted": "abc123"
}
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, decimal string (db)
txIndex - String Transaction position within the block, decimal string (db)
hash - String Transaction hash, 0x-prefixed 32-byte hex (db)
fromAddress - String Sender address, 0x-prefixed checksummed EIP-55 (db)
toAddress - String Recipient address, checksummed EIP-55; '0x' for contract creation (db)
valueWei - String Value in wei, decimal string (e.g. '1000000000000000000' = 1 ETH) (db)
gas - String Gas limit, decimal string (db)
gasPrice - String Gas price in wei, decimal string (db)
gasUsed - String Actual gas consumed, decimal string (db)
nonce - String Sender nonce, decimal string (db)
txType - String EIP-2718 transaction type: '0' legacy, '1' EIP-2930, '2' EIP-1559 (db)
maxFeePerGas - String Max fee per gas in wei, decimal string; '0' for legacy tx (EIP-1559) (db)
maxPriorityFeePerGas - String Max priority fee (tip) in wei, decimal string; '0' for legacy tx (EIP-1559) (db)
input - String Calldata, 0x-prefixed hex; '0x' for simple transfers (db)
v - String ECDSA recovery id (db)
r - String ECDSA signature r, 0x-prefixed hex (db)
s - String ECDSA signature s, 0x-prefixed hex (db)
size - String Transaction size in bytes, decimal string (db)
success - Boolean true if transaction succeeded (status=1) (db)
logsCount - String Number of event logs emitted, decimal string (db)
createdAt - String Indexer ingestion timestamp, ISO 8601 (db)
logs - [EmbeddedLog!]! Transaction logs (events) — no back-reference to transaction (db)
internalTransactions - [InternalTransaction!]! Internal transactions (traces) (db)
Example
{
  "blockNumber": "xyz789",
  "txIndex": "abc123",
  "hash": "abc123",
  "fromAddress": "xyz789",
  "toAddress": "xyz789",
  "valueWei": "abc123",
  "gas": "abc123",
  "gasPrice": "abc123",
  "gasUsed": "xyz789",
  "nonce": "xyz789",
  "txType": "abc123",
  "maxFeePerGas": "abc123",
  "maxPriorityFeePerGas": "xyz789",
  "input": "abc123",
  "v": "xyz789",
  "r": "abc123",
  "s": "xyz789",
  "size": "abc123",
  "success": false,
  "logsCount": "abc123",
  "createdAt": "abc123",
  "logs": [EmbeddedLog],
  "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) (db)
count - String! Transaction count (decimal string) (db)
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 (db)
actualCountInDb - BigInt! Actual transaction count in DB (db)
isSynced - Boolean! Whether transactions are synced (db)
status - SyncStatusEnum! Sync status (db)
message - String Status description (db)
Example
{
  "sumOfTxCountersInBlocks": {},
  "actualCountInDb": {},
  "isSynced": true,
  "status": "SYNCED",
  "message": "xyz789"
}