Skip to main content

GraphQL

Erigon implements the standard Ethereum GraphQL interface defined in EIP-1767, following the same schema as Geth.

Enabling GraphQL​

GraphQL is disabled by default. Enable it with the --graphql flag:

./erigon --graphql

GraphQL shares the same port as the HTTP JSON-RPC server (default 8545). It does not use --http.api — --graphql is its own toggle.

Endpoints​

EndpointPurpose
http://localhost:8545/graphqlGraphQL API endpoint
http://localhost:8545/graphql/uiGraphiQL browser UI for interactive queries

Schema Reference​

Erigon follows the Geth GraphQL schema. For the full schema reference, query examples, and field descriptions, see https://geth.ethereum.org/docs/interacting-with-geth/rpc/graphql.

The schema includes queries for blocks, transactions, accounts, logs, and pending state, as well as the sendRawTransaction mutation.

Example Query​

{
  block(number: 21000000) {
    hash
    number
    timestamp
    transactions {
      hash
      from { address }
      to { address }
      value
    }
  }
}
curl -X POST http://localhost:8545/graphql \
  -H "Content-Type: application/json" \
  -d '{"query": "{ block(number: 21000000) { hash number } }"}'