List Collections

GET 
/public/NftCollections

Returns a list of NFTs with support for sorting and filtration.

Request

Query Parameters

currency string

Fiat currency used for converting crypto prices.

cursor string

Cursor token. Pass tokens obtained from successful responses.

filter object

Filters to apply. Note: if filters are present, they are required to be passed for an initial request and omitted for subsequent ones.

page_size uint16required

Maximum number of items to be returned by a single request.

sort string

Possible values: [RecentlyAdded, RecentlyVerified, PriceLowToHigh, PriceHighToLow, NameAsc, NameDesc, TotalVolumeAsc, TotalVolumeDesc, SevenDayVolumeAsc, SevenDayVolumeDesc, OwnerCountAsc, OwnerCountDesc, MostRelevant, ByAllTimeKrakenVolumeAsc, ByAllTimeKrakenVolumeDesc, By30DaysKrakenVolumeAsc, By30DaysKrakenVolumeDesc, By7DaysKrakenVolumeAsc, By7DaysKrakenVolumeDesc, By24HoursKrakenVolumeAsc, By24HoursKrakenVolumeDesc]

Sorting to apply. Note: sort parameter is required to be passed for an initial request and omitted for subsequent ones.

Responses

200

Response

application/json

Schema

Schema

error string[]required
result objectnullable
Batch of paginated items from list APIs.
cursor stringnullable
Cursor token to send to get subsequent items after performing the requested search.
items object[]required
Items from the response.
Array [
creators object[]required
creator of collection
Array [
id stringrequired
Server side generated ID of the Creator.
image objectnullable
Main image
kind stringrequired
Possible values: [Main, Image, Animation, Video, TopBanner, Other]
Role of this media relative to the catalog object.
media objectnullable
Exact copy of the original media, stored in a Kraken server.
DO NOT TRUST THIS DATA TO BE SAFE.
Danger: this contains arbitrary content from the internet and may be malicious. This should never be embedded directly inside a webpage. Proper care should be given if linking to this media (e.g. use rel="noopener").
Despite these risks, the raw media is still exposed as it's the true copy of the blockchain media as retrieved by Kraken. Viewing it may help if processing introduced defects to the media.
The value depends on MediaProcessingState: - Wait or Source: None - Process or Ready: Some
media_type stringnullable
Media type: image/png, image/jpeg, etc.
size uint64nullable
Full size of the content in bytes.
Note that the actual transfer size may be smaller if compression is applied.
url stringrequired
URL for the content of this media.
This is always served as HTTPS, either from the Kraken media server directly or from a Cloudflare Images subdomain.
name stringrequired
Name of the Creator.
username stringnullable
Username of the Creator.
verified booleanrequired
Verified by Kraken to have accurate data.
]
date_added int64required
Date when collection was added to the DB
description stringnullable
collection description
floor_price objectnullable
Floor price
fiat objectnullable
Floor price in fiat currency, specified by a user.
amount object required
An amount, either as a string, and integer, or a decimal value
oneOf
MOD1
string
MOD2
integer
MOD3
number
asset_alt_name stringrequired
alt_name is handy when interacting with Kraken API
asset_name stringrequired
user friendly asset name for display purpose
native objectnullable
Floor price in native currency of a blockchain that this collection belongs to.
amount object required
An amount, either as a string, and integer, or a decimal value
oneOf
MOD1
string
MOD2
integer
MOD3
number
asset_alt_name stringrequired
alt_name is handy when interacting with Kraken API
asset_name stringrequired
user friendly asset name for display purpose
original objectrequired
Floor price in original asset, without applying any exchange rates.
amount object required
An amount, either as a string, and integer, or a decimal value
oneOf
MOD1
string
MOD2
integer
MOD3
number
asset_alt_name stringrequired
alt_name is handy when interacting with Kraken API
asset_name stringrequired
user friendly asset name for display purpose
id stringrequired
kraken internal collection identifier
image objectnullable
Main image
kind stringrequired
Possible values: [Main, Image, Animation, Video, TopBanner, Other]
Role of this media relative to the catalog object.
media objectnullable
Exact copy of the original media, stored in a Kraken server.
DO NOT TRUST THIS DATA TO BE SAFE.
Danger: this contains arbitrary content from the internet and may be malicious. This should never be embedded directly inside a webpage. Proper care should be given if linking to this media (e.g. use rel="noopener").
Despite these risks, the raw media is still exposed as it's the true copy of the blockchain media as retrieved by Kraken. Viewing it may help if processing introduced defects to the media.
The value depends on MediaProcessingState: - Wait or Source: None - Process or Ready: Some
media_type stringnullable
Media type: image/png, image/jpeg, etc.
size uint64nullable
Full size of the content in bytes.
Note that the actual transfer size may be smaller if compression is applied.
url stringrequired
URL for the content of this media.
This is always served as HTTPS, either from the Kraken media server directly or from a Cloudflare Images subdomain.
market_cap objectnullable
See [Collection::market_cap].
fiat objectnullable
AssetAmount contains asset_id and amount bound in one struct
amount object required
An amount, either as a string, and integer, or a decimal value
oneOf
MOD1
string
MOD2
integer
MOD3
number
asset_alt_name stringrequired
alt_name is handy when interacting with Kraken API
asset_name stringrequired
user friendly asset name for display purpose
native objectrequired
AssetAmount contains asset_id and amount bound in one struct
amount object required
An amount, either as a string, and integer, or a decimal value
oneOf
MOD1
string
MOD2
integer
MOD3
number
asset_alt_name stringrequired
alt_name is handy when interacting with Kraken API
asset_name stringrequired
user friendly asset name for display purpose
name stringrequired
collection name
seven_day_volume objectnullable
See [Collection::seven_day_volume].
fiat objectnullable
AssetAmount contains asset_id and amount bound in one struct
amount object required
An amount, either as a string, and integer, or a decimal value
oneOf
MOD1
string
MOD2
integer
MOD3
number
asset_alt_name stringrequired
alt_name is handy when interacting with Kraken API
asset_name stringrequired
user friendly asset name for display purpose
native objectrequired
AssetAmount contains asset_id and amount bound in one struct
amount object required
An amount, either as a string, and integer, or a decimal value
oneOf
MOD1
string
MOD2
integer
MOD3
number
asset_alt_name stringrequired
alt_name is handy when interacting with Kraken API
asset_name stringrequired
user friendly asset name for display purpose
seven_day_volume_change object
Seven day volume of sales change in percentages with floating precision. Change period: 7 days.
oneOf
MOD1
string
MOD2
integer
MOD3
number
MOD4
object
top_banner objectnullable
Top-banner image
kind stringrequired
Possible values: [Main, Image, Animation, Video, TopBanner, Other]
Role of this media relative to the catalog object.
media objectnullable
Exact copy of the original media, stored in a Kraken server.
DO NOT TRUST THIS DATA TO BE SAFE.
Danger: this contains arbitrary content from the internet and may be malicious. This should never be embedded directly inside a webpage. Proper care should be given if linking to this media (e.g. use rel="noopener").
Despite these risks, the raw media is still exposed as it's the true copy of the blockchain media as retrieved by Kraken. Viewing it may help if processing introduced defects to the media.
The value depends on MediaProcessingState: - Wait or Source: None - Process or Ready: Some
media_type stringnullable
Media type: image/png, image/jpeg, etc.
size uint64nullable
Full size of the content in bytes.
Note that the actual transfer size may be smaller if compression is applied.
url stringrequired
URL for the content of this media.
This is always served as HTTPS, either from the Kraken media server directly or from a Cloudflare Images subdomain.
total_items uint64required
number of items in the collection
total_owners uint64required
number of owners
total_volume objectnullable
See [Collection::total_volume].
fiat objectnullable
AssetAmount contains asset_id and amount bound in one struct
amount object required
An amount, either as a string, and integer, or a decimal value
oneOf
MOD1
string
MOD2
integer
MOD3
number
asset_alt_name stringrequired
alt_name is handy when interacting with Kraken API
asset_name stringrequired
user friendly asset name for display purpose
native objectrequired
AssetAmount contains asset_id and amount bound in one struct
amount object required
An amount, either as a string, and integer, or a decimal value
oneOf
MOD1
string
MOD2
integer
MOD3
number
asset_alt_name stringrequired
alt_name is handy when interacting with Kraken API
asset_name stringrequired
user friendly asset name for display purpose
verified booleanrequired
The collection was verified by Kraken.
volume_stats_kraken objectnullable
Statistics about volume traded on Kraken (both internally and via Market Maker)
days_30 objectrequired
AssetAmount contains asset_id and amount bound in one struct
amount object required
An amount, either as a string, and integer, or a decimal value
oneOf
MOD1
string
MOD2
integer
MOD3
number
asset_alt_name stringrequired
alt_name is handy when interacting with Kraken API
asset_name stringrequired
user friendly asset name for display purpose
days_7 objectrequired
AssetAmount contains asset_id and amount bound in one struct
amount object required
An amount, either as a string, and integer, or a decimal value
oneOf
MOD1
string
MOD2
integer
MOD3
number
asset_alt_name stringrequired
alt_name is handy when interacting with Kraken API
asset_name stringrequired
user friendly asset name for display purpose
days_7_change object required
An amount, either as a string, and integer, or a decimal value
oneOf
MOD1
string
MOD2
integer
MOD3
number
hours_24 objectrequired
AssetAmount contains asset_id and amount bound in one struct
amount object required
An amount, either as a string, and integer, or a decimal value
oneOf
MOD1
string
MOD2
integer
MOD3
number
asset_alt_name stringrequired
alt_name is handy when interacting with Kraken API
asset_name stringrequired
user friendly asset name for display purpose
hours_24_change object required
An amount, either as a string, and integer, or a decimal value
oneOf
MOD1
string
MOD2
integer
MOD3
number
total objectrequired
AssetAmount contains asset_id and amount bound in one struct
amount object required
An amount, either as a string, and integer, or a decimal value
oneOf
MOD1
string
MOD2
integer
MOD3
number
asset_alt_name stringrequired
alt_name is handy when interacting with Kraken API
asset_name stringrequired
user friendly asset name for display purpose
]
total_items object
Total number of items.
oneOf
MOD1
relation stringrequired
Possible values: [eq]
value uint64required
MOD2
relation stringrequired
Possible values: [gte]
value uint64required

Example (from schema)

{
  "error": [
    "EGeneral:Invalid arguments"
  ],
  "result": {
    "cursor": "string",
    "items": [
      {
        "creators": [
          {
            "id": "string",
            "image": {
              "kind": "Main",
              "media": {
                "media_type": "string",
                "size": 0,
                "url": "string"
              }
            },
            "name": "string",
            "username": "string",
            "verified": true
          }
        ],
        "date_added": 0,
        "description": "string",
        "floor_price": {
          "fiat": {
            "amount": "string",
            "asset_alt_name": "string",
            "asset_name": "string"
          },
          "native": {
            "amount": "string",
            "asset_alt_name": "string",
            "asset_name": "string"
          },
          "original": {
            "amount": "string",
            "asset_alt_name": "string",
            "asset_name": "string"
          }
        },
        "id": "string",
        "image": {
          "kind": "Main",
          "media": {
            "media_type": "string",
            "size": 0,
            "url": "string"
          }
        },
        "market_cap": {
          "fiat": {
            "amount": "string",
            "asset_alt_name": "string",
            "asset_name": "string"
          },
          "native": {
            "amount": "string",
            "asset_alt_name": "string",
            "asset_name": "string"
          }
        },
        "name": "string",
        "seven_day_volume": {
          "fiat": {
            "amount": "string",
            "asset_alt_name": "string",
            "asset_name": "string"
          },
          "native": {
            "amount": "string",
            "asset_alt_name": "string",
            "asset_name": "string"
          }
        },
        "seven_day_volume_change": "string",
        "top_banner": {
          "kind": "Main",
          "media": {
            "media_type": "string",
            "size": 0,
            "url": "string"
          }
        },
        "total_items": 0,
        "total_owners": 0,
        "total_volume": {
          "fiat": {
            "amount": "string",
            "asset_alt_name": "string",
            "asset_name": "string"
          },
          "native": {
            "amount": "string",
            "asset_alt_name": "string",
            "asset_name": "string"
          }
        },
        "verified": true,
        "volume_stats_kraken": {
          "days_30": {
            "amount": "string",
            "asset_alt_name": "string",
            "asset_name": "string"
          },
          "days_7": {
            "amount": "string",
            "asset_alt_name": "string",
            "asset_name": "string"
          },
          "days_7_change": "string",
          "hours_24": {
            "amount": "string",
            "asset_alt_name": "string",
            "asset_name": "string"
          },
          "hours_24_change": "string",
          "total": {
            "amount": "string",
            "asset_alt_name": "string",
            "asset_name": "string"
          }
        }
      }
    ],
    "total_items": {}
  }
}

Example

{
  "error": [],
  "result": {
    "total_items": {
      "relation": "eq",
      "value": 2
    },
    "items": [
      {
        "id": "NCQNABO-XYCA7-JMMSDF",
        "name": "Williams Racing Collectibles+ Grid Pass",
        "description": "Plus-up your Williams Racing experience with our brand-new Grid Pass, presented by Kraken. Collect your free pass and unlock immediate exclusive digital and physical perks, plus access to unique Williams Racing experiences. The Grid Pass is each holders’ “ignition key” to power the engine of benefits and experiences that the Williams Racing Collectibles+ program will provide.",
        "date_added": 1696338839,
        "image": {
          "kind": "Main",
          "media": {
            "url": "https://assets-dynamic.kraken.com/media1/51c66513591958f4e123679890226f890bf255e298e00680acdc141c03b59637.png",
            "media_type": "image/png",
            "size": 60183
          }
        },
        "top_banner": {
          "kind": "TopBanner",
          "media": {
            "url": "https://assets-dynamic.kraken.com/media1/6b69f72e13fcda3e3e0d6839f260cd7a3c4ac644fa4a2cf170c9f47763b5e10c.png",
            "media_type": "image/png",
            "size": 488376
          }
        },
        "floor_price": {
          "original": {
            "asset_name": "AED",
            "asset_alt_name": "AED",
            "amount": "1.8400"
          },
          "native": {
            "asset_name": "MATIC",
            "asset_alt_name": "MATIC",
            "amount": "0.5907577600"
          },
          "fiat": {
            "asset_name": "USD",
            "asset_alt_name": "USD",
            "amount": "0.5010"
          }
        },
        "creators": [
          {
            "id": "NA7NELE-FOQFZ-ODWOTV",
            "name": "Williams Racing",
            "username": " ",
            "image": {
              "kind": "Main",
              "media": {
                "url": "https://assets-dynamic.kraken.com/media1/71802e3780ae54ca416845955146ed04a5b059af0d08a66bf03583423f48040f.png",
                "media_type": "image/png",
                "size": 19582
              }
            },
            "verified": true
          }
        ],
        "total_items": 100000,
        "total_owners": 0,
        "total_owners_change": null,
        "total_sales": null,
        "total_volume": null,
        "total_volume_change": null,
        "market_cap": null,
        "seven_day_volume": null,
        "seven_day_volume_change": null,
        "seven_day_average_price": null,
        "seven_day_average_price_change": null,
        "verified": true,
        "volume_stats_kraken": {
          "total": {
            "asset_name": "USD",
            "asset_alt_name": "USD",
            "amount": "1422.9446"
          },
          "days_30": {
            "asset_name": "USD",
            "asset_alt_name": "USD",
            "amount": "564.6989"
          },
          "days_7": {
            "asset_name": "USD",
            "asset_alt_name": "USD",
            "amount": "10.0214"
          },
          "hours_24": {
            "asset_name": "USD",
            "asset_alt_name": "USD",
            "amount": "0.0000"
          },
          "days_7_change": "-98.15",
          "hours_24_change": "-100.00"
        }
      },
      {
        "id": "NC35CAI-A5DKX-BHMJDT",
        "name": "Gulf x Williams Racing 'Bolder than Bold' Fan Livery",
        "description": "A collectible created by Kraken in collaboration with Williams and Gulf Oil.",
        "date_added": 1701203657,
        "image": {
          "kind": "Main",
          "media": {
            "url": "https://assets-dynamic.kraken.com/media1/e71bc1bdaf0f1713d75fe80346241f3fea9fb008a6edf4b98a8e6f8787d04045.png",
            "media_type": "image/png",
            "size": 447164
          }
        },
        "top_banner": {
          "kind": "TopBanner",
          "media": {
            "url": "https://assets-dynamic.kraken.com/media1/8586973407a01c59ad89ef67739d76649bdc768a7210b06e675a33229d91cb42.png",
            "media_type": "image/png",
            "size": 594465
          }
        },
        "floor_price": {
          "original": {
            "asset_name": "EUR",
            "asset_alt_name": "EUR",
            "amount": "0.7300"
          },
          "native": {
            "asset_name": "MATIC",
            "asset_alt_name": "MATIC",
            "amount": "0.9270941600"
          },
          "fiat": {
            "asset_name": "USD",
            "asset_alt_name": "USD",
            "amount": "0.7862"
          }
        },
        "creators": [
          {
            "id": "NA7NELE-FOQFZ-ODWOTV",
            "name": "Williams Racing",
            "username": " ",
            "image": {
              "kind": "Main",
              "media": {
                "url": "https://assets-dynamic.kraken.com/media1/71802e3780ae54ca416845955146ed04a5b059af0d08a66bf03583423f48040f.png",
                "media_type": "image/png",
                "size": 19582
              }
            },
            "verified": true
          }
        ],
        "total_items": 31423,
        "total_owners": 0,
        "total_owners_change": null,
        "total_sales": null,
        "total_volume": null,
        "total_volume_change": null,
        "market_cap": null,
        "seven_day_volume": null,
        "seven_day_volume_change": null,
        "seven_day_average_price": null,
        "seven_day_average_price_change": null,
        "verified": true,
        "volume_stats_kraken": {
          "total": {
            "asset_name": "USD",
            "asset_alt_name": "USD",
            "amount": "8022.6171"
          },
          "days_30": {
            "asset_name": "USD",
            "asset_alt_name": "USD",
            "amount": "750.6086"
          },
          "days_7": {
            "asset_name": "USD",
            "asset_alt_name": "USD",
            "amount": "202.3166"
          },
          "hours_24": {
            "asset_name": "USD",
            "asset_alt_name": "USD",
            "amount": "0.0000"
          },
          "days_7_change": "191.32",
          "hours_24_change": "-100.00"
        }
      }
    ]
  }
}

Loading...