Blockchain indexer

Network	Provider	URL	Current	Previous
Mainnet	Hosted Services	https://thegraph.com/hosted-service/subgraph/decentraland/marketplace	QmXPFoaeZjJrukrFRFLh1RheK2PWF1hAb6K3kYbHvqffZK	Qmc9dMhcgUqH77cTtDfnXduxMfavrKjX2SSDBhiwWpEvKx
Mainnet	Satsuma	https://subgraph.satsuma-prod.com/decentraland/marketplace/playground	QmXPFoaeZjJrukrFRFLh1RheK2PWF1hAb6K3kYbHvqffZK	Qmc9dMhcgUqH77cTtDfnXduxMfavrKjX2SSDBhiwWpEvKx
Mainnet Temp	Hosted Services	https://thegraph.com/hosted-service/subgraph/decentraland/marketplace-temp	QmPdVPhDvK3bs8cmUeFeMAYRYky6yqYE9jYwpcMdi4QCdB	QmPT9v6EsqqCA8BzrYtArJL54mVgfH81FzFTX2gLv9XcSp
Sepolia	Graph Studio	https://api.studio.thegraph.com/query/49472/marketplace-sepolia/version/latest	QmVvJsoaTLi5HVfdUaLTsKcbvxB3ZE2ksZH9ENh8EoStaE	QmTu8KKidkfRaCCvEHdBnWhRfLRLwPmhHpfRFxTk2wPAzN
Sepolia	Satsuma	https://subgraph.satsuma-prod.com/decentraland/marketplace-sepolia/playground	QmdY3w9t5Su2K1j2mETTEQnY4C5AWfr9qd6ki2NR8iHSXm

Using The Graph and Satsuma

Deploy

npm run codegen
npm run deploy:sepolia # 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
    }
  }
}