📊GraphQL Indexer

This is our preferred option as it is probably the most flexible option and allows an easy schema exploration.

Endpoints

NetworkEndpoint

mainnet

https://graph.mintbase.xyz/mainnet

testnet

https://graph.mintbase.xyz/testnet

Use GraphiQL

The queries and relationships are extensible, we suggest just clicking around the tree to make the queries and it will become easy over time.

API Key

In the future, users may be required to register using an api key. For now, simply passing the valueanon for mb-api-key will work: e.g.


curl --location --request POST 'https://graph.mintbase.xyz' \
--header 'mb-api-key: anon' \
--header 'Content-Type: application/json' \
--data-raw '{"query":"query blocks {\n    blocks {\n        synced_height\n    }\n}","variables":{}}'

Examples

  1. Get NFTs owned by an account, notice the burned_timestamp if null indicates it has not been burned yet

  2. Get Metadata from token reference including title, media, documents, sound, 3d.

Query Formatting

Find all the different entities and parameters for interacting with the API.

Core Entities

  • nft_tokens: Gets data on single tokens

  • mb_views_nft_metadata_unburned: The token type (metadata wrapper)

  • nft_metadata: Indexed metadata

  • nft_contracts: Stores/contracts deployed

  • nft_listings: Marketplace listings

  • offers: Offers made to market listings

  • mb_store_minters: Allowed mintings accounts

  • nft_earnings: Historical earnings per account

Aggregated Entities

...

Query Parameters

...

Pagination Parameters

offset: position where it should start the results ex: offset : 12 it will render results from 12 > \

Query Examples

GetTokenById

Query to retrieve a specific nft/Token

you need tokenId , and contractAddress ex: tokenId: 137 contract Address: voiceoftheoceans.mintbase1.near\

GetStoreNfts

GetStoreDataById

GetRoyaltiesInfo

GetTokensSplitbyMetadataId

Demo

Last updated