Subgraph Querying
The HTTP endpoint for GraphQL queries can be found on the subgraph page in the dashboard.
All GraphQL queries are authenticated using a query key. Your organization can have multiple query keys with the following settings:
- Origins: Permitted origins for queries. Wildcard matching is supported (e.g.
*.satsuma.xyz
). - Rate limits (Coming soon): Queries per second allowed.
Example use cases:
- From your backend - Create a query key with no origin restrictions and no rate limit.
- From your frontend - Create a query key that allows origins from your domain(s) and has no rate limit.
- For your community - Create a query key with a rate limit and no origin restrictions.
We currently support two ways of passing in query keys into queries — by path and by header.
Path
The query key can be included as part of the URL path. For example:
curl -v \
'https://subgraph.satsuma-prod.com/<QUERY_KEY>/<ORGANIZATION>/<SUBGRAPH_NAME>/version/<VERSION_NAME>/api' \
--data-raw '{"query":"{entities(first:1){id}}"}'
Header
The query key can be attached with a
x-api-key
header. For example:curl -v \
'https://subgraph.satsuma-prod.com/<ORGANIZATION>/<SUBGRAPH_NAME>/version/<VERSION_NAME>/api' \
-H 'x-api-key: <QUERY_KEY>' \
--data-raw '{"query":"{entities(first:1){id}}"}'