GraphQL

GraphQL endpoint

Changed on

GraphQL endpoint (shared auth/rate limit with REST), proxied to the Ponder GraphQL API. Ponder LIKE filter operators reject unescaped % and _ wildcard values. Before proxying, the API bounds the complete request including unused runtime variables, variable defaults, inline arguments, input bytes/nodes/depth, boolean clauses, list entries, aliases, totalCount, execution cost, limit (default maximum 1,000), and offset (default maximum 10,000). Offset scan cost is offset + limit; selected output expansion remains based on limit. Resource violations return QUERY_TOO_BROAD and malformed documents return VALIDATION_ERROR without contacting Ponder. Ponder 0.15.17 does not use first or last pagination arguments. Each API process also enforces a shared upstream concurrency cap (default 8), one total fetch-and-stream timeout (default 10 seconds), redirect rejection, GraphQL JSON media-type and object-shape validation, and a streamed decoded response cap (default 5,242,880 bytes). A non-queueing per-process query-cost bucket defaults to 100,000 units of capacity and a 25,000-unit-per-second refill. Exhaustion returns 429 before an upstream slot is acquired; the shared per-client API rate limiter remains the outer control. Select a supported chain with the chainId query parameter, then X-Chain-Id, then the JSON body chainId, in that precedence order.

post/v3/graphql

Request

  • Base URL
    https://v3.euler.finance
  • URL
    https://v3.euler.finance/v3/graphql
  • Auth
    none required

Query parameters

chainIdinteger

Supported chain to query. Takes precedence over X-Chain-Id and body chainId.

Headers

X-Chain-Idinteger

Supported chain to query when the query parameter is absent. Takes precedence over body chainId.

Request body

querystring required
variablesobject
operationNamestring

Response

GraphQL response

object required

Changes

    • breaking

      the request property became required

    • breaking

      the request property's minLength was increased from 0 to 1

    • breaking

      added the pattern \S to the request property

    • info

      added the new optional header request parameter X-Chain-Id

    • info

      added the new optional query request parameter chainId

    • info

      added the new optional request property