API

Sync GraphQL POST client. Base class for Info and Exchange.

Use API directly when you need to post a GraphQL document the SDK does not wrap. Most callers should pick Info or Exchange instead.

Setup

from dango.api import API
 
api = API("https://api-mainnet.dango.zone")

API(base_url: str, *, timeout: float | None = None) -> None

base_url — str. GraphQL endpoint URL; the suffix /graphql is appended at query time.

timeout — float | None, optional. HTTP timeout in seconds applied to every POST. Default: no timeout.

Method	Description
`query`	POST a GraphQL document and return the `data` field
`query_typed`	Same as `query` plus a static cast on the result

def query(
    self,
    document: str,
    variables: dict[str, Any] | None = None,
) -> dict[str, Any]

POSTs {"query": document, "variables": variables} to <base_url>/graphql and returns the GraphQL data envelope. Raises:

ServerError on 5xx, network failures, or non-JSON bodies
ClientError on 4xx
GraphQLError on a non-empty errors array, or when both data and errors are missing

data = api.query("""
query Status { queryStatus { chainId block { blockHeight } } }
""")
print(data["queryStatus"]["chainId"])

def query_typed[T](
    self,
    document: str,
    variables: dict[str, Any] | None = None,
    *,
    response_type: type[T],
) -> T

Same as query but cast(T, ...)s the result. No runtime validation — the cast is for type checkers only.

The class holds a requests.Session for HTTP keep-alive across queries.
Content-Type: application/json is set on the session at construction; no need to override per call.
Both query and mutation documents go through query() — the GraphQL operation keyword lives inside the document string.