Skip to main content

Subgraph uses The Graph to load data from Juicebox protocol contracts without directly querying the blockchain.

Multiple subgraphs are maintained by Peel in a Graph Studio owned by the Peel Gnosis safe. Only the primary Juicebox subgraph has been published to the Graph Network; others are available to use for free with rate-limited queries.

juiceboxView on Graph explorerThe primary mainnet subgraph used by
mainnet-devQueries: mainnet Juicebox protocol contracts.
goerli-devQueries: goerli Juicebox protocol contracts. (Does not include v1 & v2 contracts, except for v2 JBProjects)

Querying the subgraph

The Juicebox subgraph schema is the same on all networks, and can be found on the following page. For information on structuring Graph queries, read the Graph docs. You can also reference the tools used for

Avoid Rate-Limiting

To use the mainnet Juicebox subgraph without being rate-limited:

  1. Create your API key on Subgraph Studio API Keys.
  2. Fund your billing balance on Subgraph Studio Billing.
  3. Query the mainnet Juicebox subgraph using<your-api-key>/subgraphs/id/FVmuv3TndQDNd2BWARV8Y27yuKKukryKXPzvAS5E7htC.

You can also follow the Video Tutorial.

For more info on Graph query billing, visit Billing on the Subgraph Studio - The Graph Docs and Managing your API Key & Setting your indexer preferences.