Token Data

Using GraphQL to get Mintbase Token Data

Using TheGraph

TheGraph is an Ethereum indexer that stores aggregated data on IPFS directly from the Ethereum blockchain. When you change the state of the blockchain (mint, transfer, buy, or burn) an event is emitted and then organized by our open sourced mapping tool. Our entire interface hooks into the open query using polling on our React app with Apollo GraphQL, and updates on blockchain confirmations. You can also build your own reporting systems from this.

// Websocket

// Query

Fetch Token Metadata on Arweave Gateway


Getting the metadata for a token

  "minter": "0x87085d8d22d688e7ac9da3384127169f83e059e6",
  "mintedOn": "2020-06-02T22:16:28.820Z",
  "contractAddress": "0x0163f249af5a4781cd09edeb2326066b9552d8ec",
  "minted": "Minted on",
  "fiatPrice": "$24.02",
  "name": "99 β€’ Mars-Man",
  "description": "We are not perfect. We were not made by computational probabilities and mathematical calculations. We are the product of pure fun. That is why WE ARE UNIQUE.",
  "youtube_url": "",
  "price": "$0.00",
  "ethPrice": "0.1",
  "amountToMint": 1,
  "forSale": true,
  "image": "",
  "attributes": [
      "trait_type": "rarity",
      "value": "e02HZ3Ifqk5gPOghuA7t"
      "trait_type": "location",
      "value": "Mexico"
      "trait_type": "place_id",
      "value": "ChIJU1NoiDs6BIQREZgJa760ZO0"
      "trait_type": "website",
      "value": ""
      "trait_type": "Side",
      "value": "Rudo"
      "trait_type": "Technique",
      "value": "Martian Scissors"
      "trait_type": "Shape",
      "value": "Triangle"
  "category": "alJuInV4dezvHTNU8Dp1",
  "external_url": "",
  "type": "ERC721"


Your can also find the metadata at the end in the url on the Pez Dispenser link

Tracking Your Store

Click the drop down here and you can see example, but just enter your created contract (make sure it's all lowercase)

Things vs Token

A Thing is the batch of tokens (like a cup of coffee) and a Thing will have many to it tokens (15 tokens of a Thing). All these tokens are sharing the same metaId which is the unique idea for a Thing.

Token State:

You'll notice in our graph under s=tokens there is a state field, this is what helps us sell or not sell an item using the buyThing function. If a user sets a price and is for sale anyone can grab that NFT if they throw the price or greater. If no price is set and the token is set for sale, anyone can grab them for free, they just need to pay the transfer gas cost.



What the state does


Not for Sale

The token can only be airdropped by the minter


For Sale

Anyone can grab the token using the buyThing function if enough ETH is sent



Sold and cannot go up for resale on Mintbase, buyThing function no longer works



Sent after minting buyThing function no longer works

Using React + Apollo

We use Apollo on our React app front end for that hooks into the graph query url

Realtime Data

We suggest using polling over subscriptions on your quries as theGraph has shown some major delays and websockets can be a nightmare. It's pretty easy to setup.

  import { useQuery } from "@apollo/react-hooks";
  // Gets all stores from a users eth account
  // Note to always use lowercase when quiering the graph
  const useableAccount= '0x66268791b55e1f5fa585d990326519f101407257`
  const [{ loading, data }] = useQuery(GET_STORES, {
    variables: { id: useableAccount, approver: process.env.approver },
    pollInterval: 900

Last updated