Blockchain indexer

Network	URL	Current	Previous
Mainnet (Hosted Services)	https://thegraph.com/hosted-service/subgraph/decentraland/marketplace	QmPdVPhDvK3bs8cmUeFeMAYRYky6yqYE9jYwpcMdi4QCdB	Qmf8fcWxGiKcxffcWRfhbAb36HEvXFNXsoRunuf4sPR1Bp
Mainnet (Satsuma)	https://subgraph.satsuma-prod.com/decentraland/marketplace/playground	QmPdVPhDvK3bs8cmUeFeMAYRYky6yqYE9jYwpcMdi4QCdB	Qmf8fcWxGiKcxffcWRfhbAb36HEvXFNXsoRunuf4sPR1Bp
Mainnet Temp (Hosted Services)	https://thegraph.com/hosted-service/subgraph/decentraland/marketplace-temp	QmPT9v6EsqqCA8BzrYtArJL54mVgfH81FzFTX2gLv9XcSp	QmR9z6HJpRP9tSPLNPWkQ67JbDP4wzM4hBVkWmbgdKBCuo
Goerli (Hosted Services)	https://thegraph.com/hosted-service/subgraph/decentraland/marketplace-goerli	QmS2GCuAkzH2kNDYe2pA9HkRTPLpC5DpbXRqhQW93exZEM	QmRDXpMaGDL2Sq9Jfw7VfPz6aTfJNorEcY5LfhyQGgHeRY
Goerli (Satsuma)	https://subgraph.satsuma-prod.com/decentraland/marketplace-goerli/playground	QmS2GCuAkzH2kNDYe2pA9HkRTPLpC5DpbXRqhQW93exZEM	-
Ropsten (Hosted Services)	https://thegraph.com/hosted-service/subgraph/decentraland/marketplace-ropsten	QmZTADndoP4XRoWGVoQuaz8WTATx3UDXMn5SdE3GfkErkW	QmfHCGhLTZV8v2duxDkKtPZKMEdJM7X8YGRj2UvqmrAUBB

Using The Graph and Satsuma

Deploy

npm run codegen
npm run deploy:ropsten # or deploy:mainnet

If a new collection in Ethereum is added you will need to add it as following

npx ts-node scripts/importWearableCollection.ts --collection ../../wearable-api/data/collections/{collection_name}/index.json > src/data/wearables/{collection_name}.ts

checkout the docs https://thegraph.com/docs/quick-start

Queries

The collection's id is the smart contract address of the collection. The item's id is {collection_contract_address}-{item_blochain_id}. The item_blockchain_id is the index of the item in the collection. E.g: if you have a collection with 2 items, the first is 0 and the second one is 1. Therefore, the id of the first item will be: {contract_address}-0

Ethereum addresses should be passed lowercased:

• 0xB549B2442b2BD0a53795BC5cDcBFE0cAF7ACA9f8 ❌
• 0xb549b2442b2bd0a53795bc5cdcbfe0caf7aca9f8 ✅

Get first 5 entities for each category

{
  parcels(first: 5) {
    id
    x
    y
    owner {
      id
    }
  }

  estates(first: 5) {
    id
    parcels {
      id
    }
    owner {
      id
    }
  }

  enss(first: 5) {
    id
    subdomain
    owner {
      id
    }
  }

  wearables(first: 5) {
    id
    owner {
      id
    }
  }
}

Get first 5 NFTs

Owner's id is the owner's Ethereum address. Category could be: parcel, estate, ens, wearable

{
  nfts(first: 5) {
    id
    category
    tokenId
    owner {
      id
    }
  }
}

Get first 5 Collection NFTs Orders

{
  orders(first: 5) {
    id
    category
    nftAddress
    price
    buyer
    status
    nft {
      id
    }
  }
}