NFT Rankings

Get a ranked list of NFT collections based on trading activity and collection popularity across a user's network - updating in real-time as onchain activity happens. Optionally provide a farcaster FID for rankings tailored to a farcaster user's social graph.

nftRanking

Returns a paginated list of NFT collections. Supports pagination and optional tailoring by providing a farcaster ID.

• NFT collection trading metrics
• Real-time collection data integration
• Farcaster user personalization capabilities
• Paginated results with cursor-based navigation
• Cross-chain NFT collection rankings

Example Use Case: Top Trending NFT Collections

Get the most active NFT collections based on onchain activity, emphasized for a farcaster user.

Try it now

Example Variables

{
  "first": 10,
  "after": null,
  "fid": 954583
}

Example Query

query NftRanking($first: Int, $after: String, $fid: Int) {
  nftRanking(first: $first, after: $after, fid: $fid) {
    pageInfo {
      hasPreviousPage
      hasNextPage
      startCursor
      endCursor
    }
    edges {
      cursor
      node {
        id
        collectionAddress
        chainId
      }
    }
  }
}

Example Response

{
  "data": {
    "nftRanking": {
      "edges": [
        {
          "node": {
            "chainId": 8453,
            "collectionAddress": "0x6e8991f1f2fdee6007dbbf2f336119bf3da56ced",
            "id": "RmFyY2FzdGVyTmZ0Q29sbGVjdGlvbkZlZWRJdGVtLTB4NmU4OTkxZjFmMmZkZWU2MDA3ZGJiZjJmMzM2MTE5YmYzZGE1NmNlZDI2ODE1NzQ0MQ=="
          },
          "cursor": "NjhjODZmYTQxODBkMjgyNDMwMTBjMzdmfDM="
        },
        {
          "node": {
            "chainId": 8453,
            "collectionAddress": "0x61886e7d61f4086ada1829880af440aa0de3fc96",
            "id": "RmFyY2FzdGVyTmZ0Q29sbGVjdGlvbkZlZWRJdGVtLTB4NjE4ODZlN2Q2MWY0MDg2YWRhMTgyOTg4MGFmNDQwYWEwZGUzZmM5NjEzODg1NTg5OQ=="
          },
          "cursor": "NjhjODZmYTQxODBkMjgyNDMwMTBjMzdmfDM="
        },
        {
          "node": {
            "chainId": 1,
            "collectionAddress": "0xd4307e0acd12cf46fd6cf93bc264f5d5d1598792",
            "id": "RmFyY2FzdGVyTmZ0Q29sbGVjdGlvbkZlZWRJdGVtLTB4ZDQzMDdlMGFjZDEyY2Y0NmZkNmNmOTNiYzI2NGY1ZDVkMTU5ODc5Mjc5NjA1MQ=="
          },
          "cursor": "NjhjODZmYTQxODBkMjgyNDMwMTBjMzdmfDM="
        }
      ],
      "pageInfo": {
        "hasPreviousPage": false,
        "hasNextPage": true,
        "startCursor": null,
        "endCursor": "Tmpoak9EWm1ZVFF4T0RCa01qZ3lORE13TVRCak16ZG1mRE09"
      }
    }
  }
}

---

Arguments

Argument	Description	Type	Required
first	Number of ranked NFT collections to fetch (default: 6, max: 20)	Int	No
after	Cursor for pagination	String	No
fid	Customize results by Farcaster ID	Int	No

Fields

Field	Description	Type
pageInfo	Pagination information	PageInfo!
edges	Array of ranked NFT collection results	[FarcasterNftCollectionFeedV2Edge!]!

FarcasterNftCollectionFeedItem Fields

Field	Description	Type
id	Unique identifier	ID!
collectionAddress	NFT collection contract address	String!
chainId	Chain ID where the collection exists	Int!
collection	Detailed collection information	NftCollection

For more information on the NftCollection type, see NFT Collections Documentation.

PageInfo Fields

Field	Description	Type
hasPreviousPage	Whether there are previous results	Boolean!
hasNextPage	Whether there are more results	Boolean!
startCursor	Cursor of the first item in results	String
endCursor	Cursor of the last item in results	String