Query

Validate a query expression without executing it

Type-checks a query expression against the provided schema and returns its inferred result type plus an estimatedUnits cost. Use this endpoint in editors and pre-flight checks to surface errors early without consuming units for an actual on-chain read.

post/query/validate

Request

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

Request body

expressionstring required

Query expression to validate

chainstring required

Chain Identifier

Response

The expression was parsed and type-checked. valid reflects whether the expression is well-formed, type is the inferred result type, and estimatedUnits is an upper bound on the units an execution would consume.

validboolean required

Whether the expression is valid

typestring nullable required

Inferred result type

estimatedUnitsnumber

Estimated units this expression will consume

Changes

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