Keisu GraphQL API Reference

A GraphQL API for on-chain data.

API Endpoints
https://api.keisu.io/blockql
Headers
// Authorization Header
X-API-Key: (Your API Key)

Documentation directory

https://keisu.io/docs

Important Disclaimer

This API provides direct access to the underlying database for our Blockchain REST API. Much of the data is encoded and needs processing to be used. For most users, we recommend you use our simplified REST API instead

Queries

allBlocks

Description

Reads and enables pagination through a set of Block.

Response

Returns a BlocksConnection

Arguments
Name Description
first - Int Only read the first n values of the set.
last - Int Only read the last n values of the set.
offset - Int Skip the first n values from our after cursor, an alternative to cursor based pagination. May not be used with last.
before - Cursor Read all values in the set before (above) this cursor.
after - Cursor Read all values in the set after (below) this cursor.
orderBy - [BlocksOrderBy!] The method to use when ordering Block. Default = [PRIMARY_KEY_ASC]
condition - BlockCondition A condition to be used in determining which values should be returned by the collection.

Example

Query
query allBlocks(
  $first: Int,
  $last: Int,
  $offset: Int,
  $before: Cursor,
  $after: Cursor,
  $orderBy: [BlocksOrderBy!],
  $condition: BlockCondition
) {
  allBlocks(
    first: $first,
    last: $last,
    offset: $offset,
    before: $before,
    after: $after,
    orderBy: $orderBy,
    condition: $condition
  ) {
    nodes {
      ...BlockFragment
    }
    edges {
      ...BlocksEdgeFragment
    }
    pageInfo {
      ...PageInfoFragment
    }
    totalCount
  }
}
Variables
{
  "first": 123,
  "last": 123,
  "offset": 987,
  "before": Cursor,
  "after": Cursor,
  "orderBy": ["PRIMARY_KEY_ASC"],
  "condition": BlockCondition
}
Response
{
  "data": {
    "allBlocks": {
      "nodes": [Block],
      "edges": [BlocksEdge],
      "pageInfo": PageInfo,
      "totalCount": 123
    }
  }
}
Queries

allLogs

Description

Reads and enables pagination through a set of Log.

Response

Returns a LogsConnection

Arguments
Name Description
first - Int Only read the first n values of the set.
last - Int Only read the last n values of the set.
offset - Int Skip the first n values from our after cursor, an alternative to cursor based pagination. May not be used with last.
before - Cursor Read all values in the set before (above) this cursor.
after - Cursor Read all values in the set after (below) this cursor.
orderBy - [LogsOrderBy!] The method to use when ordering Log. Default = [PRIMARY_KEY_ASC]
condition - LogCondition A condition to be used in determining which values should be returned by the collection.

Example

Query
query allLogs(
  $first: Int,
  $last: Int,
  $offset: Int,
  $before: Cursor,
  $after: Cursor,
  $orderBy: [LogsOrderBy!],
  $condition: LogCondition
) {
  allLogs(
    first: $first,
    last: $last,
    offset: $offset,
    before: $before,
    after: $after,
    orderBy: $orderBy,
    condition: $condition
  ) {
    nodes {
      ...LogFragment
    }
    edges {
      ...LogsEdgeFragment
    }
    pageInfo {
      ...PageInfoFragment
    }
    totalCount
  }
}
Variables
{
  "first": 123,
  "last": 123,
  "offset": 123,
  "before": Cursor,
  "after": Cursor,
  "orderBy": ["PRIMARY_KEY_ASC"],
  "condition": LogCondition
}
Response
{
  "data": {
    "allLogs": {
      "nodes": [Log],
      "edges": [LogsEdge],
      "pageInfo": PageInfo,
      "totalCount": 123
    }
  }
}
Queries

allTokenTransfers

Description

Reads and enables pagination through a set of TokenTransfer.

Response

Returns a TokenTransfersConnection

Arguments
Name Description
first - Int Only read the first n values of the set.
last - Int Only read the last n values of the set.
offset - Int Skip the first n values from our after cursor, an alternative to cursor based pagination. May not be used with last.
before - Cursor Read all values in the set before (above) this cursor.
after - Cursor Read all values in the set after (below) this cursor.
orderBy - [TokenTransfersOrderBy!] The method to use when ordering TokenTransfer. Default = [PRIMARY_KEY_ASC]
condition - TokenTransferCondition A condition to be used in determining which values should be returned by the collection.

Example

Query
query allTokenTransfers(
  $first: Int,
  $last: Int,
  $offset: Int,
  $before: Cursor,
  $after: Cursor,
  $orderBy: [TokenTransfersOrderBy!],
  $condition: TokenTransferCondition
) {
  allTokenTransfers(
    first: $first,
    last: $last,
    offset: $offset,
    before: $before,
    after: $after,
    orderBy: $orderBy,
    condition: $condition
  ) {
    nodes {
      ...TokenTransferFragment
    }
    edges {
      ...TokenTransfersEdgeFragment
    }
    pageInfo {
      ...PageInfoFragment
    }
    totalCount
  }
}
Variables
{
  "first": 987,
  "last": 123,
  "offset": 123,
  "before": Cursor,
  "after": Cursor,
  "orderBy": ["PRIMARY_KEY_ASC"],
  "condition": TokenTransferCondition
}
Response
{
  "data": {
    "allTokenTransfers": {
      "nodes": [TokenTransfer],
      "edges": [TokenTransfersEdge],
      "pageInfo": PageInfo,
      "totalCount": 987
    }
  }
}
Queries

allTransactions

Description

Reads and enables pagination through a set of Transaction.

Response

Returns a TransactionsConnection

Arguments
Name Description
first - Int Only read the first n values of the set.
last - Int Only read the last n values of the set.
offset - Int Skip the first n values from our after cursor, an alternative to cursor based pagination. May not be used with last.
before - Cursor Read all values in the set before (above) this cursor.
after - Cursor Read all values in the set after (below) this cursor.
orderBy - [TransactionsOrderBy!] The method to use when ordering Transaction. Default = [PRIMARY_KEY_ASC]
condition - TransactionCondition A condition to be used in determining which values should be returned by the collection.

Example

Query
query allTransactions(
  $first: Int,
  $last: Int,
  $offset: Int,
  $before: Cursor,
  $after: Cursor,
  $orderBy: [TransactionsOrderBy!],
  $condition: TransactionCondition
) {
  allTransactions(
    first: $first,
    last: $last,
    offset: $offset,
    before: $before,
    after: $after,
    orderBy: $orderBy,
    condition: $condition
  ) {
    nodes {
      ...TransactionFragment
    }
    edges {
      ...TransactionsEdgeFragment
    }
    pageInfo {
      ...PageInfoFragment
    }
    totalCount
  }
}
Variables
{
  "first": 123,
  "last": 987,
  "offset": 987,
  "before": Cursor,
  "after": Cursor,
  "orderBy": ["PRIMARY_KEY_ASC"],
  "condition": TransactionCondition
}
Response
{
  "data": {
    "allTransactions": {
      "nodes": [Transaction],
      "edges": [TransactionsEdge],
      "pageInfo": PageInfo,
      "totalCount": 123
    }
  }
}
Queries

block

Description

Reads a single Block using its globally unique ID.

Response

Returns a Block

Arguments
Name Description
nodeId - ID! The globally unique ID to be used in selecting a single Block.

Example

Query
query block($nodeId: ID!) {
  block(nodeId: $nodeId) {
    nodeId
    number
    hash
    parentHash
    nonce
    sha3Uncles
    logsBloom
    transactionsRoot
    stateRoot
    receiptsRoot
    miner
    difficulty
    totalDifficulty
    size
    extraData
    gasLimit
    gasUsed
    timestamp
    transactionCount
    baseFeePerGas
  }
}
Variables
{"nodeId": 4}
Response
{
  "data": {
    "block": {
      "nodeId": 4,
      "number": {},
      "hash": "xyz789",
      "parentHash": "xyz789",
      "nonce": "abc123",
      "sha3Uncles": "xyz789",
      "logsBloom": "xyz789",
      "transactionsRoot": "xyz789",
      "stateRoot": "abc123",
      "receiptsRoot": "abc123",
      "miner": "xyz789",
      "difficulty": BigFloat,
      "totalDifficulty": BigFloat,
      "size": {},
      "extraData": "abc123",
      "gasLimit": {},
      "gasUsed": {},
      "timestamp": {},
      "transactionCount": {},
      "baseFeePerGas": {}
    }
  }
}
Queries

blockByHash

Response

Returns a Block

Arguments
Name Description
hash - String!

Example

Query
query blockByHash($hash: String!) {
  blockByHash(hash: $hash) {
    nodeId
    number
    hash
    parentHash
    nonce
    sha3Uncles
    logsBloom
    transactionsRoot
    stateRoot
    receiptsRoot
    miner
    difficulty
    totalDifficulty
    size
    extraData
    gasLimit
    gasUsed
    timestamp
    transactionCount
    baseFeePerGas
  }
}
Variables
{"hash": "abc123"}
Response
{
  "data": {
    "blockByHash": {
      "nodeId": "4",
      "number": {},
      "hash": "xyz789",
      "parentHash": "abc123",
      "nonce": "xyz789",
      "sha3Uncles": "xyz789",
      "logsBloom": "abc123",
      "transactionsRoot": "abc123",
      "stateRoot": "abc123",
      "receiptsRoot": "xyz789",
      "miner": "abc123",
      "difficulty": BigFloat,
      "totalDifficulty": BigFloat,
      "size": {},
      "extraData": "xyz789",
      "gasLimit": {},
      "gasUsed": {},
      "timestamp": {},
      "transactionCount": {},
      "baseFeePerGas": {}
    }
  }
}
Queries

log

Description

Reads a single Log using its globally unique ID.

Response

Returns a Log

Arguments
Name Description
nodeId - ID! The globally unique ID to be used in selecting a single Log.

Example

Query
query log($nodeId: ID!) {
  log(nodeId: $nodeId) {
    nodeId
    logIndex
    transactionHash
    transactionIndex
    address
    data
    topic0
    topic1
    topic2
    topic3
    blockNumber
    blockHash
    blockTimestamp
  }
}
Variables
{"nodeId": "4"}
Response
{
  "data": {
    "log": {
      "nodeId": "4",
      "logIndex": {},
      "transactionHash": "xyz789",
      "transactionIndex": {},
      "address": "xyz789",
      "data": "xyz789",
      "topic0": "xyz789",
      "topic1": "xyz789",
      "topic2": "xyz789",
      "topic3": "abc123",
      "blockNumber": {},
      "blockHash": "xyz789",
      "blockTimestamp": {}
    }
  }
}
Queries

logByTransactionHashAndLogIndex

Response

Returns a Log

Arguments
Name Description
transactionHash - String!
logIndex - BigInt!

Example

Query
query logByTransactionHashAndLogIndex(
  $transactionHash: String!,
  $logIndex: BigInt!
) {
  logByTransactionHashAndLogIndex(
    transactionHash: $transactionHash,
    logIndex: $logIndex
  ) {
    nodeId
    logIndex
    transactionHash
    transactionIndex
    address
    data
    topic0
    topic1
    topic2
    topic3
    blockNumber
    blockHash
    blockTimestamp
  }
}
Variables
{
  "transactionHash": "abc123",
  "logIndex": {}
}
Response
{
  "data": {
    "logByTransactionHashAndLogIndex": {
      "nodeId": 4,
      "logIndex": {},
      "transactionHash": "xyz789",
      "transactionIndex": {},
      "address": "xyz789",
      "data": "xyz789",
      "topic0": "abc123",
      "topic1": "xyz789",
      "topic2": "abc123",
      "topic3": "abc123",
      "blockNumber": {},
      "blockHash": "xyz789",
      "blockTimestamp": {}
    }
  }
}
Queries

node

Description

Fetches an object given its globally unique ID.

Response

Returns a Node

Arguments
Name Description
nodeId - ID! The globally unique ID.

Example

Query
query node($nodeId: ID!) {
  node(nodeId: $nodeId) {
    nodeId
  }
}
Variables
{"nodeId": 4}
Response
{"data": {"node": {"nodeId": "4"}}}
Queries

nodeId

Description

The root query type must be a Node to work well with Relay 1 mutations. This just resolves to query.

Response

Returns an ID!

Example

Query
query nodeId {
  nodeId
}
Response
{"data": {"nodeId": "4"}}
Queries

query

Description

Exposes the root query type nested one level down. This is helpful for Relay 1 which can only query top level fields if they are in a particular form.

Response

Returns a Query!

Example

Query
query query {
  query {
    query {
      ...QueryFragment
    }
    nodeId
    node {
      ...NodeFragment
    }
    allBlocks {
      ...BlocksConnectionFragment
    }
    allLogs {
      ...LogsConnectionFragment
    }
    allTokenTransfers {
      ...TokenTransfersConnectionFragment
    }
    allTransactions {
      ...TransactionsConnectionFragment
    }
    blockByHash {
      ...BlockFragment
    }
    logByTransactionHashAndLogIndex {
      ...LogFragment
    }
    tokenTransferByTransactionHashAndLogIndex {
      ...TokenTransferFragment
    }
    transactionByHash {
      ...TransactionFragment
    }
    block {
      ...BlockFragment
    }
    log {
      ...LogFragment
    }
    tokenTransfer {
      ...TokenTransferFragment
    }
    transaction {
      ...TransactionFragment
    }
  }
}
Response
{
  "data": {
    "query": {
      "query": Query,
      "nodeId": 4,
      "node": Node,
      "allBlocks": BlocksConnection,
      "allLogs": LogsConnection,
      "allTokenTransfers": TokenTransfersConnection,
      "allTransactions": TransactionsConnection,
      "blockByHash": Block,
      "logByTransactionHashAndLogIndex": Log,
      "tokenTransferByTransactionHashAndLogIndex": TokenTransfer,
      "transactionByHash": Transaction,
      "block": Block,
      "log": Log,
      "tokenTransfer": TokenTransfer,
      "transaction": Transaction
    }
  }
}
Queries

tokenTransfer

Description

Reads a single TokenTransfer using its globally unique ID.

Response

Returns a TokenTransfer

Arguments
Name Description
nodeId - ID! The globally unique ID to be used in selecting a single TokenTransfer.

Example

Query
query tokenTransfer($nodeId: ID!) {
  tokenTransfer(nodeId: $nodeId) {
    nodeId
    tokenAddress
    fromAddress
    toAddress
    value
    transactionHash
    logIndex
    blockNumber
    blockHash
    blockTimestamp
  }
}
Variables
{"nodeId": "4"}
Response
{
  "data": {
    "tokenTransfer": {
      "nodeId": "4",
      "tokenAddress": "xyz789",
      "fromAddress": "abc123",
      "toAddress": "xyz789",
      "value": BigFloat,
      "transactionHash": "xyz789",
      "logIndex": {},
      "blockNumber": {},
      "blockHash": "xyz789",
      "blockTimestamp": {}
    }
  }
}
Queries

tokenTransferByTransactionHashAndLogIndex

Response

Returns a TokenTransfer

Arguments
Name Description
transactionHash - String!
logIndex - BigInt!

Example

Query
query tokenTransferByTransactionHashAndLogIndex(
  $transactionHash: String!,
  $logIndex: BigInt!
) {
  tokenTransferByTransactionHashAndLogIndex(
    transactionHash: $transactionHash,
    logIndex: $logIndex
  ) {
    nodeId
    tokenAddress
    fromAddress
    toAddress
    value
    transactionHash
    logIndex
    blockNumber
    blockHash
    blockTimestamp
  }
}
Variables
{
  "transactionHash": "xyz789",
  "logIndex": {}
}
Response
{
  "data": {
    "tokenTransferByTransactionHashAndLogIndex": {
      "nodeId": "4",
      "tokenAddress": "abc123",
      "fromAddress": "xyz789",
      "toAddress": "xyz789",
      "value": BigFloat,
      "transactionHash": "abc123",
      "logIndex": {},
      "blockNumber": {},
      "blockHash": "abc123",
      "blockTimestamp": {}
    }
  }
}
Queries

transaction

Description

Reads a single Transaction using its globally unique ID.

Response

Returns a Transaction

Arguments
Name Description
nodeId - ID! The globally unique ID to be used in selecting a single Transaction.

Example

Query
query transaction($nodeId: ID!) {
  transaction(nodeId: $nodeId) {
    nodeId
    hash
    nonce
    blockHash
    blockNumber
    transactionIndex
    fromAddress
    toAddress
    value
    gas
    gasPrice
    input
    blockTimestamp
    maxFeePerGas
    maxPriorityFeePerGas
    transactionType
    receiptCumulativeGasUsed
    receiptGasUsed
    receiptContractAddress
    receiptRoot
    receiptStatus
    receiptEffectiveGasPrice
  }
}
Variables
{"nodeId": "4"}
Response
{
  "data": {
    "transaction": {
      "nodeId": 4,
      "hash": "abc123",
      "nonce": {},
      "blockHash": "xyz789",
      "blockNumber": {},
      "transactionIndex": {},
      "fromAddress": "abc123",
      "toAddress": "xyz789",
      "value": BigFloat,
      "gas": {},
      "gasPrice": {},
      "input": "xyz789",
      "blockTimestamp": {},
      "maxFeePerGas": {},
      "maxPriorityFeePerGas": {},
      "transactionType": {},
      "receiptCumulativeGasUsed": {},
      "receiptGasUsed": {},
      "receiptContractAddress": "abc123",
      "receiptRoot": "abc123",
      "receiptStatus": {},
      "receiptEffectiveGasPrice": {}
    }
  }
}
Queries

transactionByHash

Response

Returns a Transaction

Arguments
Name Description
hash - String!

Example

Query
query transactionByHash($hash: String!) {
  transactionByHash(hash: $hash) {
    nodeId
    hash
    nonce
    blockHash
    blockNumber
    transactionIndex
    fromAddress
    toAddress
    value
    gas
    gasPrice
    input
    blockTimestamp
    maxFeePerGas
    maxPriorityFeePerGas
    transactionType
    receiptCumulativeGasUsed
    receiptGasUsed
    receiptContractAddress
    receiptRoot
    receiptStatus
    receiptEffectiveGasPrice
  }
}
Variables
{"hash": "abc123"}
Response
{
  "data": {
    "transactionByHash": {
      "nodeId": 4,
      "hash": "xyz789",
      "nonce": {},
      "blockHash": "abc123",
      "blockNumber": {},
      "transactionIndex": {},
      "fromAddress": "abc123",
      "toAddress": "xyz789",
      "value": BigFloat,
      "gas": {},
      "gasPrice": {},
      "input": "abc123",
      "blockTimestamp": {},
      "maxFeePerGas": {},
      "maxPriorityFeePerGas": {},
      "transactionType": {},
      "receiptCumulativeGasUsed": {},
      "receiptGasUsed": {},
      "receiptContractAddress": "xyz789",
      "receiptRoot": "abc123",
      "receiptStatus": {},
      "receiptEffectiveGasPrice": {}
    }
  }
}

Types

BigFloat

Description

A floating point number that requires more precision than IEEE 754 binary 64

Example
BigFloat
Types

BigInt

Description

A signed eight-byte integer. The upper big integer values are greater than the max value for a JavaScript number. Therefore all big integers will be output as strings and not numbers.

Example
{}
Types

Block

Fields
Field Name Description
nodeId - ID! A globally unique identifier. Can be used in various places throughout the system to identify this single value.
number - BigInt
hash - String!
parentHash - String
nonce - String
sha3Uncles - String
logsBloom - String
transactionsRoot - String
stateRoot - String
receiptsRoot - String
miner - String
difficulty - BigFloat
totalDifficulty - BigFloat
size - BigInt
extraData - String
gasLimit - BigInt
gasUsed - BigInt
timestamp - BigInt
transactionCount - BigInt
baseFeePerGas - BigInt
Example
{
  "nodeId": 4,
  "number": {},
  "hash": "abc123",
  "parentHash": "xyz789",
  "nonce": "xyz789",
  "sha3Uncles": "xyz789",
  "logsBloom": "abc123",
  "transactionsRoot": "xyz789",
  "stateRoot": "xyz789",
  "receiptsRoot": "abc123",
  "miner": "xyz789",
  "difficulty": BigFloat,
  "totalDifficulty": BigFloat,
  "size": {},
  "extraData": "abc123",
  "gasLimit": {},
  "gasUsed": {},
  "timestamp": {},
  "transactionCount": {},
  "baseFeePerGas": {}
}
Types

BlockCondition

Description

A condition to be used against Block object types. All fields are tested for equality and combined with a logical ‘and.’

Fields
Input Field Description
number - BigInt

Checks for equality with the object’s number field.
hash - String

Checks for equality with the object’s hash field.
parentHash - String

Checks for equality with the object’s parentHash field.
nonce - String

Checks for equality with the object’s nonce field.
sha3Uncles - String

Checks for equality with the object’s sha3Uncles field.
logsBloom - String

Checks for equality with the object’s logsBloom field.
transactionsRoot - String

Checks for equality with the object’s transactionsRoot field.
stateRoot - String

Checks for equality with the object’s stateRoot field.
receiptsRoot - String

Checks for equality with the object’s receiptsRoot field.
miner - String

Checks for equality with the object’s miner field.
difficulty - BigFloat

Checks for equality with the object’s difficulty field.
totalDifficulty - BigFloat

Checks for equality with the object’s totalDifficulty field.
size - BigInt

Checks for equality with the object’s size field.
extraData - String

Checks for equality with the object’s extraData field.
gasLimit - BigInt

Checks for equality with the object’s gasLimit field.
gasUsed - BigInt

Checks for equality with the object’s gasUsed field.
timestamp - BigInt

Checks for equality with the object’s timestamp field.
transactionCount - BigInt

Checks for equality with the object’s transactionCount field.
baseFeePerGas - BigInt

Checks for equality with the object’s baseFeePerGas field.
Example
{
  "number": {},
  "hash": "abc123",
  "parentHash": "xyz789",
  "nonce": "abc123",
  "sha3Uncles": "abc123",
  "logsBloom": "xyz789",
  "transactionsRoot": "xyz789",
  "stateRoot": "abc123",
  "receiptsRoot": "abc123",
  "miner": "xyz789",
  "difficulty": BigFloat,
  "totalDifficulty": BigFloat,
  "size": {},
  "extraData": "abc123",
  "gasLimit": {},
  "gasUsed": {},
  "timestamp": {},
  "transactionCount": {},
  "baseFeePerGas": {}
}
Types

BlocksConnection

Description

A connection to a list of Block values.

Fields
Field Name Description
nodes - [Block]! A list of Block objects.
edges - [BlocksEdge!]! A list of edges which contains the Block and cursor to aid in pagination.
pageInfo - PageInfo! Information to aid in pagination.
totalCount - Int! The count of all Block you could get from the connection.
Example
{
  "nodes": [Block],
  "edges": [BlocksEdge],
  "pageInfo": PageInfo,
  "totalCount": 987
}
Types

BlocksEdge

Description

A Block edge in the connection.

Fields
Field Name Description
cursor - Cursor A cursor for use in pagination.
node - Block The Block at the end of the edge.
Example
{"cursor": Cursor, "node": Block}
Types

BlocksOrderBy

Description

Methods to use when ordering Block.

Values
Enum Value Description

NATURAL

NUMBER_ASC

NUMBER_DESC

HASH_ASC

HASH_DESC

PARENT_HASH_ASC

PARENT_HASH_DESC

NONCE_ASC

NONCE_DESC

SHA3_UNCLES_ASC

SHA3_UNCLES_DESC

LOGS_BLOOM_ASC

LOGS_BLOOM_DESC

TRANSACTIONS_ROOT_ASC

TRANSACTIONS_ROOT_DESC

STATE_ROOT_ASC

STATE_ROOT_DESC

RECEIPTS_ROOT_ASC

RECEIPTS_ROOT_DESC

MINER_ASC

MINER_DESC

DIFFICULTY_ASC

DIFFICULTY_DESC

TOTAL_DIFFICULTY_ASC

TOTAL_DIFFICULTY_DESC

SIZE_ASC

SIZE_DESC

EXTRA_DATA_ASC

EXTRA_DATA_DESC

GAS_LIMIT_ASC

GAS_LIMIT_DESC

GAS_USED_ASC

GAS_USED_DESC

TIMESTAMP_ASC

TIMESTAMP_DESC

TRANSACTION_COUNT_ASC

TRANSACTION_COUNT_DESC

BASE_FEE_PER_GAS_ASC

BASE_FEE_PER_GAS_DESC

PRIMARY_KEY_ASC

PRIMARY_KEY_DESC
Example
"NATURAL"
Types

Boolean

Description

The Boolean scalar type represents true or false.

Types

Cursor

Description

A location in a connection that can be used for resuming pagination.

Example
Cursor
Types

ID

Description

The ID scalar type represents a unique identifier, often used to refetch an object or as key for a cache. The ID type appears in a JSON response as a String; however, it is not intended to be human-readable. When expected as an input type, any string (such as "4") or integer (such as 4) input value will be accepted as an ID.

Example
"4"
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

Log

Fields
Field Name Description
nodeId - ID! A globally unique identifier. Can be used in various places throughout the system to identify this single value.
logIndex - BigInt!
transactionHash - String!
transactionIndex - BigInt
address - String
data - String
topic0 - String
topic1 - String
topic2 - String
topic3 - String
blockNumber - BigInt
blockHash - String
blockTimestamp - BigInt
Example
{
  "nodeId": "4",
  "logIndex": {},
  "transactionHash": "abc123",
  "transactionIndex": {},
  "address": "xyz789",
  "data": "xyz789",
  "topic0": "abc123",
  "topic1": "xyz789",
  "topic2": "abc123",
  "topic3": "abc123",
  "blockNumber": {},
  "blockHash": "xyz789",
  "blockTimestamp": {}
}
Types

LogCondition

Description

A condition to be used against Log object types. All fields are tested for equality and combined with a logical ‘and.’

Fields
Input Field Description
logIndex - BigInt

Checks for equality with the object’s logIndex field.
transactionHash - String

Checks for equality with the object’s transactionHash field.
transactionIndex - BigInt

Checks for equality with the object’s transactionIndex field.
address - String

Checks for equality with the object’s address field.
data - String

Checks for equality with the object’s data field.
topic0 - String

Checks for equality with the object’s topic0 field.
topic1 - String

Checks for equality with the object’s topic1 field.
topic2 - String

Checks for equality with the object’s topic2 field.
topic3 - String

Checks for equality with the object’s topic3 field.
blockNumber - BigInt

Checks for equality with the object’s blockNumber field.
blockHash - String

Checks for equality with the object’s blockHash field.
blockTimestamp - BigInt

Checks for equality with the object’s blockTimestamp field.
Example
{
  "logIndex": {},
  "transactionHash": "xyz789",
  "transactionIndex": {},
  "address": "xyz789",
  "data": "abc123",
  "topic0": "xyz789",
  "topic1": "xyz789",
  "topic2": "abc123",
  "topic3": "xyz789",
  "blockNumber": {},
  "blockHash": "abc123",
  "blockTimestamp": {}
}
Types

LogsConnection

Description

A connection to a list of Log values.

Fields
Field Name Description
nodes - [Log]! A list of Log objects.
edges - [LogsEdge!]! A list of edges which contains the Log and cursor to aid in pagination.
pageInfo - PageInfo! Information to aid in pagination.
totalCount - Int! The count of all Log you could get from the connection.
Example
{
  "nodes": [Log],
  "edges": [LogsEdge],
  "pageInfo": PageInfo,
  "totalCount": 123
}
Types

LogsEdge

Description

A Log edge in the connection.

Fields
Field Name Description
cursor - Cursor A cursor for use in pagination.
node - Log The Log at the end of the edge.
Example
{"cursor": Cursor, "node": Log}
Types

LogsOrderBy

Description

Methods to use when ordering Log.

Values
Enum Value Description

NATURAL

LOG_INDEX_ASC

LOG_INDEX_DESC

TRANSACTION_HASH_ASC

TRANSACTION_HASH_DESC

TRANSACTION_INDEX_ASC

TRANSACTION_INDEX_DESC

ADDRESS_ASC

ADDRESS_DESC

DATA_ASC

DATA_DESC

TOPIC0_ASC

TOPIC0_DESC

TOPIC1_ASC

TOPIC1_DESC

TOPIC2_ASC

TOPIC2_DESC

TOPIC3_ASC

TOPIC3_DESC

BLOCK_NUMBER_ASC

BLOCK_NUMBER_DESC

BLOCK_HASH_ASC

BLOCK_HASH_DESC

BLOCK_TIMESTAMP_ASC

BLOCK_TIMESTAMP_DESC

PRIMARY_KEY_ASC

PRIMARY_KEY_DESC
Example
"NATURAL"
Types

Node

Description

An object with a globally unique ID.

Fields
Field Name Description
nodeId - ID! A globally unique identifier. Can be used in various places throughout the system to identify this single value.
Possible Types
Node Types

Query

Block

Log

TokenTransfer

Transaction

Example
{"nodeId": "4"}
Types

PageInfo

Description

Information about pagination in a connection.

Fields
Field Name Description
hasNextPage - Boolean! When paginating forwards, are there more items?
hasPreviousPage - Boolean! When paginating backwards, are there more items?
startCursor - Cursor When paginating backwards, the cursor to continue.
endCursor - Cursor When paginating forwards, the cursor to continue.
Example
{
  "hasNextPage": true,
  "hasPreviousPage": true,
  "startCursor": Cursor,
  "endCursor": Cursor
}
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

TokenTransfer

Fields
Field Name Description
nodeId - ID! A globally unique identifier. Can be used in various places throughout the system to identify this single value.
tokenAddress - String
fromAddress - String
toAddress - String
value - BigFloat
transactionHash - String!
logIndex - BigInt!
blockNumber - BigInt
blockHash - String
blockTimestamp - BigInt
Example
{
  "nodeId": "4",
  "tokenAddress": "abc123",
  "fromAddress": "xyz789",
  "toAddress": "xyz789",
  "value": BigFloat,
  "transactionHash": "xyz789",
  "logIndex": {},
  "blockNumber": {},
  "blockHash": "xyz789",
  "blockTimestamp": {}
}
Types

TokenTransferCondition

Description

A condition to be used against TokenTransfer object types. All fields are tested for equality and combined with a logical ‘and.’

Fields
Input Field Description
tokenAddress - String

Checks for equality with the object’s tokenAddress field.
fromAddress - String

Checks for equality with the object’s fromAddress field.
toAddress - String

Checks for equality with the object’s toAddress field.
value - BigFloat

Checks for equality with the object’s value field.
transactionHash - String

Checks for equality with the object’s transactionHash field.
logIndex - BigInt

Checks for equality with the object’s logIndex field.
blockNumber - BigInt

Checks for equality with the object’s blockNumber field.
blockHash - String

Checks for equality with the object’s blockHash field.
blockTimestamp - BigInt

Checks for equality with the object’s blockTimestamp field.
Example
{
  "tokenAddress": "xyz789",
  "fromAddress": "abc123",
  "toAddress": "xyz789",
  "value": BigFloat,
  "transactionHash": "abc123",
  "logIndex": {},
  "blockNumber": {},
  "blockHash": "abc123",
  "blockTimestamp": {}
}
Types

TokenTransfersConnection

Description

A connection to a list of TokenTransfer values.

Fields
Field Name Description
nodes - [TokenTransfer]! A list of TokenTransfer objects.
edges - [TokenTransfersEdge!]! A list of edges which contains the TokenTransfer and cursor to aid in pagination.
pageInfo - PageInfo! Information to aid in pagination.
totalCount - Int! The count of all TokenTransfer you could get from the connection.
Example
{
  "nodes": [TokenTransfer],
  "edges": [TokenTransfersEdge],
  "pageInfo": PageInfo,
  "totalCount": 123
}
Types

TokenTransfersEdge

Description

A TokenTransfer edge in the connection.

Fields
Field Name Description
cursor - Cursor A cursor for use in pagination.
node - TokenTransfer The TokenTransfer at the end of the edge.
Example
{
  "cursor": Cursor,
  "node": TokenTransfer
}
Types

TokenTransfersOrderBy

Description

Methods to use when ordering TokenTransfer.

Values
Enum Value Description

NATURAL

TOKEN_ADDRESS_ASC

TOKEN_ADDRESS_DESC

FROM_ADDRESS_ASC

FROM_ADDRESS_DESC

TO_ADDRESS_ASC

TO_ADDRESS_DESC

VALUE_ASC

VALUE_DESC

TRANSACTION_HASH_ASC

TRANSACTION_HASH_DESC

LOG_INDEX_ASC

LOG_INDEX_DESC

BLOCK_NUMBER_ASC

BLOCK_NUMBER_DESC

BLOCK_HASH_ASC

BLOCK_HASH_DESC

BLOCK_TIMESTAMP_ASC

BLOCK_TIMESTAMP_DESC

PRIMARY_KEY_ASC

PRIMARY_KEY_DESC
Example
"NATURAL"
Types

Transaction

Fields
Field Name Description
nodeId - ID! A globally unique identifier. Can be used in various places throughout the system to identify this single value.
hash - String!
nonce - BigInt
blockHash - String
blockNumber - BigInt
transactionIndex - BigInt
fromAddress - String
toAddress - String
value - BigFloat
gas - BigInt
gasPrice - BigInt
input - String
blockTimestamp - BigInt
maxFeePerGas - BigInt
maxPriorityFeePerGas - BigInt
transactionType - BigInt
receiptCumulativeGasUsed - BigInt
receiptGasUsed - BigInt
receiptContractAddress - String
receiptRoot - String
receiptStatus - BigInt
receiptEffectiveGasPrice - BigInt
Example
{
  "nodeId": 4,
  "hash": "abc123",
  "nonce": {},
  "blockHash": "abc123",
  "blockNumber": {},
  "transactionIndex": {},
  "fromAddress": "abc123",
  "toAddress": "xyz789",
  "value": BigFloat,
  "gas": {},
  "gasPrice": {},
  "input": "abc123",
  "blockTimestamp": {},
  "maxFeePerGas": {},
  "maxPriorityFeePerGas": {},
  "transactionType": {},
  "receiptCumulativeGasUsed": {},
  "receiptGasUsed": {},
  "receiptContractAddress": "xyz789",
  "receiptRoot": "abc123",
  "receiptStatus": {},
  "receiptEffectiveGasPrice": {}
}
Types

TransactionCondition

Description

A condition to be used against Transaction object types. All fields are tested for equality and combined with a logical ‘and.’

Fields
Input Field Description
hash - String

Checks for equality with the object’s hash field.
nonce - BigInt

Checks for equality with the object’s nonce field.
blockHash - String

Checks for equality with the object’s blockHash field.
blockNumber - BigInt

Checks for equality with the object’s blockNumber field.
transactionIndex - BigInt

Checks for equality with the object’s transactionIndex field.
fromAddress - String

Checks for equality with the object’s fromAddress field.
toAddress - String

Checks for equality with the object’s toAddress field.
value - BigFloat

Checks for equality with the object’s value field.
gas - BigInt

Checks for equality with the object’s gas field.
gasPrice - BigInt

Checks for equality with the object’s gasPrice field.
input - String

Checks for equality with the object’s input field.
blockTimestamp - BigInt

Checks for equality with the object’s blockTimestamp field.
maxFeePerGas - BigInt

Checks for equality with the object’s maxFeePerGas field.
maxPriorityFeePerGas - BigInt

Checks for equality with the object’s maxPriorityFeePerGas field.
transactionType - BigInt

Checks for equality with the object’s transactionType field.
receiptCumulativeGasUsed - BigInt

Checks for equality with the object’s receiptCumulativeGasUsed field.
receiptGasUsed - BigInt

Checks for equality with the object’s receiptGasUsed field.
receiptContractAddress - String

Checks for equality with the object’s receiptContractAddress field.
receiptRoot - String

Checks for equality with the object’s receiptRoot field.
receiptStatus - BigInt

Checks for equality with the object’s receiptStatus field.
receiptEffectiveGasPrice - BigInt

Checks for equality with the object’s receiptEffectiveGasPrice field.
Example
{
  "hash": "xyz789",
  "nonce": {},
  "blockHash": "xyz789",
  "blockNumber": {},
  "transactionIndex": {},
  "fromAddress": "xyz789",
  "toAddress": "abc123",
  "value": BigFloat,
  "gas": {},
  "gasPrice": {},
  "input": "xyz789",
  "blockTimestamp": {},
  "maxFeePerGas": {},
  "maxPriorityFeePerGas": {},
  "transactionType": {},
  "receiptCumulativeGasUsed": {},
  "receiptGasUsed": {},
  "receiptContractAddress": "xyz789",
  "receiptRoot": "xyz789",
  "receiptStatus": {},
  "receiptEffectiveGasPrice": {}
}
Types

TransactionsConnection

Description

A connection to a list of Transaction values.

Fields
Field Name Description
nodes - [Transaction]! A list of Transaction objects.
edges - [TransactionsEdge!]! A list of edges which contains the Transaction and cursor to aid in pagination.
pageInfo - PageInfo! Information to aid in pagination.
totalCount - Int! The count of all Transaction you could get from the connection.
Example
{
  "nodes": [Transaction],
  "edges": [TransactionsEdge],
  "pageInfo": PageInfo,
  "totalCount": 123
}
Types

TransactionsEdge

Description

A Transaction edge in the connection.

Fields
Field Name Description
cursor - Cursor A cursor for use in pagination.
node - Transaction The Transaction at the end of the edge.
Example
{
  "cursor": Cursor,
  "node": Transaction
}
Types

TransactionsOrderBy

Description

Methods to use when ordering Transaction.

Values
Enum Value Description

NATURAL

HASH_ASC

HASH_DESC

NONCE_ASC

NONCE_DESC

BLOCK_HASH_ASC

BLOCK_HASH_DESC

BLOCK_NUMBER_ASC

BLOCK_NUMBER_DESC

TRANSACTION_INDEX_ASC

TRANSACTION_INDEX_DESC

FROM_ADDRESS_ASC

FROM_ADDRESS_DESC

TO_ADDRESS_ASC

TO_ADDRESS_DESC

VALUE_ASC

VALUE_DESC

GAS_ASC

GAS_DESC

GAS_PRICE_ASC

GAS_PRICE_DESC

INPUT_ASC

INPUT_DESC

BLOCK_TIMESTAMP_ASC

BLOCK_TIMESTAMP_DESC

MAX_FEE_PER_GAS_ASC

MAX_FEE_PER_GAS_DESC

MAX_PRIORITY_FEE_PER_GAS_ASC

MAX_PRIORITY_FEE_PER_GAS_DESC

TRANSACTION_TYPE_ASC

TRANSACTION_TYPE_DESC

RECEIPT_CUMULATIVE_GAS_USED_ASC

RECEIPT_CUMULATIVE_GAS_USED_DESC

RECEIPT_GAS_USED_ASC

RECEIPT_GAS_USED_DESC

RECEIPT_CONTRACT_ADDRESS_ASC

RECEIPT_CONTRACT_ADDRESS_DESC

RECEIPT_ROOT_ASC

RECEIPT_ROOT_DESC

RECEIPT_STATUS_ASC

RECEIPT_STATUS_DESC

RECEIPT_EFFECTIVE_GAS_PRICE_ASC

RECEIPT_EFFECTIVE_GAS_PRICE_DESC

PRIMARY_KEY_ASC

PRIMARY_KEY_DESC
Example
"NATURAL"