Notional V3 Subgraphs

The Graph & subgraphs

The Graph is a decentralized protocol for indexing and querying data from blockchains. Anyone can build and publish open APIs, called subgraphs, making data easily accessible in a decentralized and reliable way. Subgraphs make it possible for anyone to query data that would otherwise be difficult to query on-chain directly. Each subgraph pays attention to events of a project’s contracts and maps that event data to data that The Graph stores in its database. Learn more about The Graph here.

GraphQL

GraphQL is the underlying query language utilized in The Graph. GraphQL is especially useful for calls requiring lots of information where instead of making multiple API calls one only needs to do one subgraph call to get all of the information needed. Learn more about GraphQL here.

Notional Subgraphs

Version
Network
Subgraph Endpoint
Notional V3
Mainnet
Link
Notional V3
Arbitrum
Link
Notional V2
Mainnet
Link

Query Notional’s subgraph with python

To run subgraph queries through python one can use the following script and modify the url to the appropriate endpoint and modify the GQL query:
from gql import gql, Client from gql.transport.requests
import RequestsHTTPTransport
#Connect with theGraph
sample_transport = RequestsHTTPTransport( url="https://api.studio.thegraph.com/proxy/33671/notional-finance-v3-arbitrum/v0.0.135/", # change to the appropriate endpoint
verify=True, retries=10, ) client = Client( transport=sample_transport )
#Update the GQL query
query = gql('''
{
accounts(first: 1000, where:{ systemAccountType: None}) {
id
}
}
''')
response = client.execute(query)
We will go over a few example queries to explore Notional's V3 subgraph.