zora orb logo

Zora Subgraph Entities

This page describes all of the GraphQL entities of the Zora Subgraph.

Media

The Media entity represents the core data for a piece of Zora cryptomedia.

Field NameTypeDescription
idIDThe tokenId on the Zora Media Contract
ownerUserThe current owner of the Media
creatorUserThe creator of the Media
prevownerUserThe previous owner of the Zora Media's Market
approvedUserThe approved user of the Media
contentHashBytesThe sha256 hash of the media's content
metadataHashBytesThe sha256 hash of the media's metadata
contentURIStringThe uri of the content
metadataURIStringThe uri of the metadata
ownerBidShareBigIntThe bid share for the current owner of the Media
creatorBidShareBigIntThe bid share for the creator of the Media
prevOwnerBidShareBigIntThe bid share for the previous owner of the Media's market
createdAtTimestampBigIntThe timestamp of the block the Media was minted in
createdAtBlockNumberBigIntThe number of the block the Media was minted in
burnedAtTimestampBigIntThe timestamp of the block the Media was burned in
burnedAtBlockNumberBigIntThe number of the block the Media was burned in
currentAskAskThe current Ask of the Media
currentBids[Bid]The current Bids on the Media
inactiveAsks[Ask]The InactiveAsks of the Media
inactiveBids[Bid]The InactiveBids of the Media

Users

The User entity represents ethereum accounts that interact with the Zora Protocol.

Field NameTypeDescription
idIDEthereum Address
authorizedUsers[User]Users that have been granted ApprovalForAll Media of the User's Collection
collection[Media]The Media the User owns
creations[Media]The Media the User created
currentBids[Bid]The active Bids made by the User

Ask

The Ask entity represents an onchain Ask for a piece of cryptomedia on the Zora Protocol.

Field NameTypeDescription
idID<tokenId>-<ownerAddress>
mediaMediaThe Media associated with the Ask
currencyCurrencyThe Currency of the Ask
amountBigIntThe amount of Currency of the Ask
ownerUserThe owner of the Ask
createdAtTimestampBigIntThe timestamp of the block the Ask was created in
createdAtBlockNumberBigIntThe number of the block the Ask created in

InactiveAsk

The InactiveAsk entity represents an Ask that is no longer valid on the Zora Protocol. InactiveAsks have either been removed or finalized.

Field NameTypeDescription
idID<tokenId>-<ownerAddress>
mediaMediaThe Media associated with the InactiveAsk
typeMarketEventTypeThe why this Ask is Inactive
currencyCurrencyThe Currency of the InactiveAsk
amountBigIntThe amount of Currency of the InactiveAsk
ownerUserThe owner of the InactiveAsk
createdAtTimestampBigIntThe timestamp of the block the InactiveAsk was created in
createdAtBlockNumberBigIntThe number of the block the InactiveAsk created in

Bid

The Bid entity represents an onchain Bid for a piece of cryptomedia on the Zora Protocol.

Field NameTypeDescription
idID<tokenId>-<bidderAddress>
mediaMediaThe Media associated with the Bid
currencyCurrencyThe Currency of the Bid
amountBigIntThe amount of Currency of the Bid
sellOnShareBigInthe sellOnShare of the Bid
bidderUserThe bidder of the Bid
recipientUserThe recipient of the Bid
createdAtTimestampBigIntThe timestamp of the block the Bid was created in
createdAtBlockNumberBigIntThe number of the block the Bid created in

InactiveBid

The InactiveAsk entity represents a Bid that is no longer valid on the Zora Protocol. InactiveBids have either been removed or finalized.

Field NameTypeDescription
idID<tokenId>-<bidderAddress>
mediaMediaThe Media associated with the InactiveBid
typeMarketEventTypeThe why this Bid is Inactive
currencyCurrencyThe Currency of the InactiveBid
amountBigIntThe amount of Currency of the InactiveBid
sellOnShareBigInthe sellOnShare of the InactiveBid
bidderUserThe bidder of the InactiveBid
recipientUserThe recipient of the InactiveBid
createdAtTimestampBigIntThe timestamp of the block the InactiveBid was created in
createdAtBlockNumberBigIntThe number of the block the InactiveBid created in

Currency

The Currency entity represents ERC-20 tokens that have been used as Asks or Bids on the Zora Protocol.

Field NameTypeDescription
idIDThe address of the Currency
nameStringThe name of the Currency
symbolStringThe symbol of the Currency
decimalsIntThe decimals of the Currency
liquidityBigIntTotal Bid Liquidity of the Currency on all Zora Media
activeBids[Bid]The active Bids denominated in the Currency
activeAsksUserThe active Asks denominated in the Currency
inactiveBidsUserThe InactiveBids denominated in the Currency
inactiveAsksBigIntThe InactiveAsks denominated in the Currency

Transfer

The Transfer entity represents transfers of ownership of pieces of cryptomedia on the Zora Protocol.

Field NameTypeDescription
idID<tokenId>-<transactionHash>-<logIndex>
mediaStringThe Media associated with the Transfer
fromStringThe User transferring the Media
toIntThe User receiving the Media
createdAtTimestampBigIntThe timestamp of the block the Transfer was created in
createdAtBlockNumberBigIntThe number of the block the Transfer was created in

URIUpdate

The URIUpdate entity represents updates to the content or metadata uris of cryptomedia on the Zora Protocol.

Field NameTypeDescription
idID<tokenId>-<transactionHash>-<logIndex>
typeURIUpdateTypeThe Type of URIUpdate
fromStringThe previous uri
toIntThe new uri
mediaStringThe Media associated with the URIUpdate
ownerUserThe owner of the Media
updaterUserThe updaterr of the Media's URI
createdAtTimestampBigIntThe timestamp of the block the URIUpdate was created in
createdAtBlockNumberBigIntThe number of the block the URIUpdate was created in