---
title: "Get collection ranking list"
method: GET
path: "/openapi/v1/collection/ranking"
tags: ["Collection"]
---

# Get collection ranking list

`GET /openapi/v1/collection/ranking`

This endpoint can be used to fetch collection ranking list from the system.

## Query parameters

- `chain` 'eth' | 'bsc' | 'polygon' | 'avalanche' | 'arbitrum' | 'zksync' | 'linea' | 'starknet' | 'opbnb' | 'base' | 'scroll' | 'manta_pacific' | 'optimism' | 'mantle' | 'zkfair' | 'blast' | 'merlin' | 'mode' | 'cyber' | 'bob' | 'lightlink' | 'zeta' | 'nibiru' | 'abstract' | 'bitlayer' | 'mantra' | 'monad' | 'ink', required
- `sort_type` 'Top' | 'Trending', required
- `level` 'L5M' | 'L15M' | 'L30M' | 'L1H' | 'L3H' | 'L12H' | 'L1D' | 'L3D' | 'L7D' | 'L30D', required
- `cursor` string
- `limit` integer

## Response `200`

OK

- ApiResponseCollectionHighRankingList
  - `code` integer — Error Code
  - `msg` string — Error Message
  - `data` CollectionHighRankingList — Return data, Generic
    - `pageInfo` PageInfo — Page infomation
      - `startCursor` string
      - `endCursor` string
      - `hasPreviousPage` string
      - `hasNextPage` string
    - `rankingList` CollectionHighRankItem[] — Collection ranking list
      - `cursor` string — The cursor of this event in system.
      - `collectionRank` CollectionHighRank — Collection Rank Info.
        - `collectionId` integer
        - `ownerCount` integer — Number of owners
        - `assetCount` integer — Total assets
        - `totalVolume` number, double — Total transaction amount of collection
        - `usdTotalVolume` number, double — Total transaction amount of collection in USD
        - `totalListingCount` integer — Total listing count of collection
        - `floorPrice` number, double — Floor price
        - `usdFloorPrice` number, double — Floor price in USD
        - `floorPriceRatio` number, double — Floor price change
        - `saleCount` number, double — Total sale count
        - `saleCountRatio` number, double — Sale count change
        - `uniqueBuyer` number, double — The number of buyers separated by address
        - `uniqueBuyerRatio` number, double — The ratio of buyers separated by address
        - `listingsCount` number, double — Listing count of select level
        - `listingsCountRatio` number, double — Listing count change of select level
        - `volume` number, double — Transaction amount of select level
        - `volumeRatio` number, double — Transaction amount change of select level
        - `usdVolume` number, double — Transaction amount of select level in USD
        - `avgPrice` number, double — Average transaction price
        - `avgPriceRatio` number, double — Average transaction price change
        - `usdAvgPrice` number, double — Average transaction price in USD
        - `whales` number, double — Number of whales
        - `statsToken` CoinInfo
          - `id` string
          - `name` string
          - `address` string
          - `icon` string
          - `symbol` string
          - `decimal` integer
          - `accuracy` integer
          - `chain` string
          - `chainId` string
        - `collection` Collection — The collection of this contract
          - `id` string
          - `name` string — Collection name
          - `slug` string — Collection slug
          - `description` string — Collection description
          - `royalty` integer — Copyright royalty
          - `createDate` string — createDate
          - `royaltyAddress` string — Royalty Address
          - `platformSellerFee` integer — Service charge charged by the platform
          - `platformSellerAddress` string — Service charge address by the platform
          - `imageUrl` string
          - `bannerImageUrl` string
          - `featuredImageUrl` string
          - `externalUrl` string
          - `twitterUrl` string
          - `instagramUrl` string
          - `facebookUrl` string
          - `mediumUrl` string
          - `telegramUrl` string
          - `discordUrl` string
          - `contracts` CollectionContract[] — Contract list about this collection
            - `blockChain` BlockChain — Chain information
              - …
            - `address` string — Contract address
            - `alias` string — Contract alias
            - `category` ContractCategory — Contract category
              - …
          - `owners` Account[]
            - `identity` Identity — Identification
              - …
          - `isVerified` boolean
          - `stats` CollectionStats — Simple field Collection Stats
            - `ownerCount` integer — Total number of owners
            - `assetCount` integer — Total number of asset
        - `volumeHistory` number[]
  - `message` string

## Other responses

- `400` — Bad Request
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.net/element/apis/element-open-api.md) · [All operations](https://skmtc.net/element/apis/element-open-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/element/element-open-api/revisions/fa83ac7feb23/schema)