Sign in
Query

Execute a query against EVM smart contracts

Evaluates a query expression against the contracts defined in schema on the given chain. The engine automatically batches on-chain reads into multicall rounds and returns a typed result along with execution metadata (block number, call count), latency, and units consumed. Validate expressions with POST /query/validate before invoking this endpoint to catch type errors without spending units.

post/query

Request

  • Base URL: https://api.evmquery.com/api/v1
  • URL: https://api.evmquery.com/api/v1/query
  • Auth: one of:
    • API key in header X-API-Key
    • bearer (a scheme the document does not define)

Request body

chainstring required

Chain Identifier

expressionstring required

Query expression to evaluate

contextobject

Runtime context variables

Response

Successful execution. The response contains the typed result, on-chain meta (block number, total calls, total rounds), performance metrics, and the units consumed by this call.

Changes

No recorded changes to this operation across all 1 revision of this API.