Skip to main content

Query Formatting

The Different Entities and Parameters in the API#

note

Check out our GraphiQL to play around with the API

Core Entities#

  • token: Gets data on a single token
  • tokens: Gets data for multiple tokens
  • collections: NFT collection information
  • events: Contract event information, e.g. Transfers, Mints, Approvals, etc. Queries may timeout if not scoped to a specific contract.
  • sales: Historical sales data from ZORA, OpenSea, LooksRare, Foundation, and more.
  • mints: Historical minting data

Aggregated Entities#

  • aggregateStat: Returns owner count, total supply, sales volume, and other statistics
  • aggregateAttributes: Gets the total set of NFT attributes

Query Parameters#

  • where: Parameters that grab a specific set of NFT data, e.g. collectionAddress
  • filter: Filters down the results from the where parameters into a smaller data set
  • networks: The network and chain to grab NFT data from
  • pagination: A way to set the limit and starting point of the response
  • sort: Sorts the order of the returned data

Sales Price Responses#

  • nativePrice: The sales price in the currency that was used in the sale transaction
  • usdcPrice: The sales price in USD at the time of the sale
  • chainTokenPrice: The sales price in the chain's gas token at the time of the sale
    • Ethereum = ETH
    • Polygon = Matic

Pagination Parameters#

  • limit: Limits the size of the response
  • after: A cursor string from the previous page
    • after can be obtained from the endCursor in the pageInfo response