Docs

Iceberg Cafe is launching for verified Cozy Penguin and Woofy holders. Here’s the shape of what you’ll get — one endpoint, standard GraphQL over HTTP.

The schema

Four types cover everything: collections, tokens, owners, and the transfer log they’re all derived from.

Collection: A registered contract — Cozy Penguins or Woofys. Name, chain, supply, holder count.
Token: A single NFT: resolved metadata, current owner, its full attribute list.
Owner: An address's standing within a collection — how many tokens, which ones, when they moved.
Transfer: One onchain event — mint, transfer, or burn — with block, transaction hash, and timestamp.

Filtering and pagination

Every list is a standard cursor connection. Combine trait filters freely — a query only returns tokens matching every trait/value pair given.

Exhibitquery.graphql

query {
  tokens(
    collectionId: "cozy"
    traits: [{ traitType: "Hat", value: "Top Hat" }]
    first: 20
  ) {
    edges {
      node {
        tokenId
        name
        imageUrl
      }
      cursor
    }
    pageInfo {
      hasNextPage
      endCursor
    }
  }
}

Exhibitquery.graphql

Rate limits

Generous enough for normal use, strict enough to keep the API fast for everyone. Exceeding the request limit returns a 429 with a Retry-After header.

Requests: 30 per 60 seconds
Query size: 20,000 bytes
Query depth: 16 levels
Data freshness: 5 minutes