Links
📊

GraphQL Indexer

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

Endpoints

Network
Endpoint
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. 1.
    Get NFTs owned by an account, notice the burned_timestamp if null indicates it has not been burned yet

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 an specific nft/Token
you need tokenId , and contractAddress ex: tokenId: 137 contract Address: voiceoftheoceans.mintbase1.near

GetStoreNfts

GetStoreDataById

GetRoyaltiesInfo
GetTokensSplitbyMetadataId

Demo