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 nowExample 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 |