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.