Subgraph

The subgraph indexes all slot deployments, ownership transitions, tax events, and metadata updates.

Endpoints

Network	Endpoint
Base Mainnet	`https://gateway.thegraph.com/api/subgraphs/id/4sZrdv1SFzN4KzE9jiWDRuUyM4CnCrmvQ54Rv1s65qUq`
Base Sepolia	`https://gateway.thegraph.com/api/subgraphs/id/Z361DLoMdPh9WAopH7shJP8WoXYAB9XeKrLUCTYjdZR`

Key Entities

Entity	Key Fields
`Slot`	`id`, `recipient`, `currency`, `occupant`, `price`, `deposit`, `taxPercentage`, `collectedTax`, `totalCollected`, `createdAt`, `metadata`
`Account`	`id`, `type` (EOA/CONTRACT/DELEGATED/SPLIT), `slotCount`, `occupiedCount`, `slotsAsRecipient`, `slotsAsOccupant`
`Currency`	`id`, `name`, `symbol`, `decimals`
`Module`	`id`, `name`, `version`, `verified`
`MetadataSlot`	`id`, `uri`, `rawJson`, `adType`, `updatedBy`, `updateCount`

Event Entities

All events include slot, timestamp, blockNumber, and tx.

Entity	Key Fields
`BoughtEvent`	`buyer`, `previousOccupant`, `price`, `selfAssessedPrice`
`ReleasedEvent`	`occupant`, `refund`
`LiquidatedEvent`	`liquidator`, `occupant`, `bounty`
`SettledEvent`	`taxOwed`, `taxPaid`, `depositRemaining`
`TaxCollectedEvent`	`recipient`, `amount`
`PriceUpdatedEvent`	`oldPrice`, `newPrice`
`MetadataUpdatedEvent`	`author`, `uri`, `rawJson`, `adType`

Example Queries

List Slots

{
  slots(first: 10, orderBy: createdAt, orderDirection: desc) {
    id
    recipient
    occupant
    price
    deposit
    taxPercentage
    currency { symbol decimals }
    module { name verified }
    createdAt
  }
}

Slot Activity

query GetSlotActivity($slot: String!) {
  boughtEvents(where: { slot: $slot }, orderBy: timestamp, orderDirection: desc) {
    buyer
    price
    selfAssessedPrice
    timestamp
  }
  releasedEvents(where: { slot: $slot }, orderBy: timestamp, orderDirection: desc) {
    occupant
    refund
    timestamp
  }
  liquidatedEvents(where: { slot: $slot }, orderBy: timestamp, orderDirection: desc) {
    liquidator
    bounty
    timestamp
  }
}

SDK equivalent: await client.getSlotActivity({ slot: "0x..." })

Account Lookup

query GetAccount($id: ID!) {
  account(id: $id) {
    id
    type
    slotCount
    occupiedCount
    slotsAsRecipient { id price totalCollected }
    slotsAsOccupant { id price deposit }
  }
}