TypeScript icon, indicating that this package has built-in type declarations

1.0.24 • Public • Published


Join PopRank Discord   Follow PopRank Twitter

PopRank SDK: API Client & Types

The PopRank SDK contains the building blocks needed to interact with and build on top of PopRank. In fact, the PopRank team uses the SDK to power https://poprank.io, @poprank/rankings, @poprank/opensea, and various other offerings.

The SDK is comprised of two main sections: client and types.

Getting Started


Install the NPM package.

yarn add @poprank/sdk

Client Setup

Import, configure, and instantiate the PopRank API client.

import { ClientConfig, PopRankClient } from '@poprank/sdk';

const config: ClientConfig = { // optional
    timeout: 10_000

const client = new PopRankClient(config);

Note: ClientConfig is a pass-through import of axios's AxiosRequestConfig. View all config options here.

Make API Calls

Make calls to the PopRank API with the newly instantiated PopRank API client.

const nft = await client.getNFT('thewickedcraniums', 420);

All client methods can be found here. For in-depth documentation on all the PopRank endpoints, see our API documentation.

Reference PopRank Models

You can also directly reference PopRank types/models, like so.

const nft: Nft = {
    collection: 'thewickedcraniums',
    id: '420',
    rating: 1196,

All types are found within the types directory.


As always, don't hesitate to reach out to the PopRank team on Twitter or Discord if you have any questions!


DownloadsWeekly Downloads






Unpacked Size

56 kB

Total Files


Last publish


  • poprank