Tokenbound ERC6551 Accounts

Learn how to get ERC6551 Accounts owned By Lens profile(s). Get Lens profile who own NFTs owned by ERC6551 accounts.
🪆 Tokenbound ERC6551 Accounts
​Airstack provides easy-to-use APIs for enriching Lens applications and integrating on-chain and off-chain data with Lens.
Table Of Contents
In this guide you will learn how to use Airstack to:
​Get ERC6551 Account Addresses of Lens profile(s)​
​Get Assets Owned by ERC6551 Accounts of Lens profile(s)​
​Get Lens profile of Owner that Owns NFT that Owns ERC6551 Accounts​
Pre-requisites
An Airstack account (free)
Basic knowledge of GraphQL
Basic knowledge of ERC6551​
Get Started
JavaScript/TypeScript/Python
If you are using JavaScript/TypeScript or Python, Install the Airstack SDK:
npm
yarn
pnpm
pip
React
npm install @airstack/airstack-react
Node
npm install @airstack/node
React
yarn add @airstack/airstack-react
Node
yarn add @airstack/node
React
pnpm install @airstack/airstack-react
Node
pnpm install @airstack/node
pip install airstack
Then, add the following snippets to your code:
React
Node
Python
import { init, useQuery } from "@airstack/airstack-react";
​
init("YOUR_AIRSTACK_API_KEY");
​
const query = `YOUR_QUERY`; // Replace with GraphQL Query
​
const Component = () => {
  const { data, loading, error } = useQuery(query);
​
  if (data) {
    return <p>Data: {JSON.stringify(data)}</p>;
  }
​
  if (loading) {
    return <p>Loading...</p>;
  }
​
  if (error) {
    return <p>Error: {error.message}</p>;
  }
};
import { init, fetchQuery } from "@airstack/node";
​
init("YOUR_AIRSTACK_API_KEY");
​
const query = `YOUR_QUERY`; // Replace with GraphQL Query
​
const { data, error } = await fetchQuery(query);
​
console.log("data:", data);
console.log("error:", error);
import asyncio
from airstack.execute_query import AirstackClient
​
api_client = AirstackClient(api_key="YOUR_AIRSTACK_API_KEY")
​
query = """YOUR_QUERY""" # Replace with GraphQL Query
​
async def main():
    execute_query_client = api_client.create_execute_query_object(
        query=query)
​
    query_response = await execute_query_client.execute_query()
    print(query_response.data)
​
asyncio.run(main())
Other Programming Languages
To access the Airstack APIs in other languages, you can use https://api.airstack.xyz/gql as your GraphQL endpoint.
🤖 AI Natural Language​​
​Airstack provides an AI solution for you to build GraphQL queries to fulfill your use case easily. You can find the AI prompt of each query in the demo's caption or title for yourself to try.
Airstack AI (Demo)
Get ERC6551 Account Addresses of Lens Profile(s)
Try Demo
https://app.airstack.xyz/query/RN1geS8sSR
Show all ERC6551 accounts owned by lens/@jayden
Code
Query
Response
query MyQuery {
  TokenBalances(
    input: {
      filter: { owner: { _in: ["lens/@jayden"] } }
      blockchain: ethereum
      limit: 200
    }
  ) {
    TokenBalance {
      tokenNfts {
        erc6551Accounts {
          address {
            addresses
          }
        }
      }
    }
  }
}
{
  "data": {
    "TokenBalances": {
      "TokenBalance": [
        {
          "tokenNfts": {
            "erc6551Accounts": [
              {
                "address": {
                  "addresses": ["0x5416e5dc14caa0950b2a24ede1eb0e97c360bcf5"]
                }
              }
            ]
          }
        },
        {
          "tokenNfts": {
            "erc6551Accounts": null
          }
        }
      ]
    }
  }
}
Get Assets Owned by ERC6551 Accounts of Lens Profile(s)
Try Demo
https://app.airstack.xyz/query/J14TVepK23
Show all assets owned by ERC6551 accounts owned by lens/@jayden
Code
Query
Response
query MyQuery {
  TokenBalances(
    input: {
      filter: { owner: { _in: ["lens/@jayden"] } }
      blockchain: ethereum
      limit: 200
    }
  ) {
    TokenBalance {
      tokenNfts {
        erc6551Accounts {
          address {
            addresses
            tokenBalances {
              tokenAddress
              tokenId
              amount
              token {
                name
                symbol
                tokenNfts {
                  contentValue {
                    image {
                      extraSmall
                      large
                      medium
                      original
                      small
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}
{
  "data": {
    "TokenBalances": {
      "TokenBalance": [
        {
          "tokenNfts": {
            "erc6551Accounts": [
              {
                "address": {
                  "addresses": ["0x5416e5dc14caa0950b2a24ede1eb0e97c360bcf5"],
                  "tokenBalances": [
                    {
                      "tokenAddress": "0x8ee9a60cb5c0e7db414031856cb9e0f1f05988d1",
                      "tokenId": "9707",
                      "amount": "1",
                      "token": {
                        "name": "STAPLEVERSE - FEED CLAN",
                        "symbol": "FEED",
                        "tokenNfts": [
                          {
                            "contentValue": {
                              "image": {
                                "extraSmall": "https://assets.airstack.xyz/image/nft/1/0x8ee9a60cb5c0e7db414031856cb9e0f1f05988d1/1/extra_small",
                                "large": "https://assets.airstack.xyz/image/nft/1/0x8ee9a60cb5c0e7db414031856cb9e0f1f05988d1/1/large",
                                "medium": "https://assets.airstack.xyz/image/nft/1/0x8ee9a60cb5c0e7db414031856cb9e0f1f05988d1/1/medium",
                                "original": "https://assets.airstack.xyz/image/nft/1/0x8ee9a60cb5c0e7db414031856cb9e0f1f05988d1/1/original_image",
                                "small": "https://assets.airstack.xyz/image/nft/1/0x8ee9a60cb5c0e7db414031856cb9e0f1f05988d1/1/small"
                              }
                            }
                          }
                        ]
                      }
                    }
                  ]
                }
              }
            ]
          }
        },
        {
          "tokenNfts": {
            "erc6551Accounts": null
          }
        }
      ]
    }
  }
}
Get Lens Profile of Owner that Owns NFT that Owns ERC6551 Accounts
You can know whether an NFT is owned by an ERC6551 accounts and the NFT that own the account:
Try Demo
https://app.airstack.xyz/query/E63g0vYA83
Show owner of NFT that owns ERC6551 account with address 0x5416e5dc14caa0950b2a24ede1eb0e97c360bcf5
Code
Query
Response
query MyQuery {
  Accounts(
    input: {
      filter: { address: { _in: "0x5416e5dc14caa0950b2a24ede1eb0e97c360bcf5" } }
      blockchain: ethereum
    }
  ) {
    Account {
      nft {
        tokenBalances {
          owner {
            addresses
            socials(input: { filter: { dappName: { _eq: lens } } }) {
              profileName
              userId
            }
          }
        }
      }
    }
  }
}
{
  "data": {
    "Accounts": {
      "Account": [
        {
          "nft": {
            "tokenBalances": [
              {
                "owner": {
                  "addresses": ["0xa75b7833c78eba62f1c5389f811ef3a7364d44de"],
                  "socials": [
                    {
                      "profileName": "lens/@jayden",
                      "userId": "0xa75b7833c78eba62f1c5389f811ef3a7364d44de"
                    }
                  ]
                }
              }
            ]
          }
        }
      ]
    }
  }
}
Developer Support
If you have any questions or need help regarding fetching token bound ERC6551 accounts, please join our Airstack's Telegram group.
More Resources
​Tokenbound ERC6551 Guides​
​Accounts API References​
​TokenBalances API References​