BLblockvision

Retrieve Collections

Changed on

This API is optimized for quickly fetching a list of all NFTs by slug list, contract address etc. of a given NFT contract.

get/nft/collections

Request

  • Base URL
    https://api.blockvision.org/v2
  • URL
    https://api.blockvision.org/v2/nft/collections
  • Auth
    API key in header x-api-key

Query parameters

contractAddressListstring[]

The contract address list of the NFT contract to get the collection information for.

collectionSlugListstring[]

The slug list of the NFT contract to get the collection information for.

nameFuzzySearchstring

String - The name of the NFT contract to get the collection information for. Supports fuzzy search.

sortFieldstring

String - The field that is specified to return the sorted data. Supports either create_block_number(by default) or floor_price.

sortDirectionstring

String - Can be either asc or desc(default).

IncludeStatsboolean

Include Collection Stats not or

pageSizeinteger

Integer - The number of records showing on each page. 20 by default and up to 50.

pageIndexinteger

Integer - The index of the page to retrieve. The first page is typically indexed as 1, and subsequent pages are numbered incrementally.

Response

200

nextPageIndexinteger
totalinteger

Example response

{
  "data": [
    {
      "Id": 12,
      "Name": "Bored Ape Yacht Club",
      "CollectionSlug": "boredapeyachtclub",
      "Traits": "{\"Background\": {\"aquamarine\": 1266, \"army green\": 1243, \"blue\": 1242, \"gray\": 1170, \"new punk blue\": 1232, \"orange\": 1273, \"purple\": 1291, \"yellow\": 1283}, \"Clothes\": {\"admirals coat\": 64, \"bandolier\": 163, \"bayc t black\": 215, \"bayc t red\": 140, \"biker vest\": 253, \"black holes t\": 205, \"black suit\": 42, \"black t\": 334, \"blue dress\": 95, \"bone necklace\": 203, \"bone tee\": 230, \"caveman pelt\": 163, \"cowboy shirt\": 119, \"guayabera\": 232, \"hawaiian\": 283, \"hip hop\": 128, \"kings robe\": 68, \"lab coat\": 144, \"leather jacket\": 206, \"leather punk jacket\": 153, \"lumberjack shirt\": 213, \"navy striped tee\": 334, \"pimp coat\": 80, \"prison jumpsuit\": 235, \"prom dress\": 103, \"puffy vest\": 227, \"rainbow suspenders\": 135, \"sailor shirt\": 284, \"service\": 142, \"sleeveless logo t\": 144, \"sleeveless t\": 252, \"smoking jacket\": 221, \"space suit\": 105, \"striped tee\": 412, \"stunt jacket\": 178, \"tanktop\": 235, \"tie dye\": 144, \"toga\": 202, \"tuxedo tee\": 235, \"tweed suit\": 141, \"vietnam jacket\": 224, \"wool turtleneck\": 240, \"work vest\": 188}, \"Earring\": {\"cross\": 149, \"diamond stud\": 222, \"gold hoop\": 462, \"gold stud\": 439, \"silver hoop\": 882, \"silver stud\": 823}, \"Eyes\": {\"3d\": 487, \"angry\": 432, \"blindfold\": 264, \"bloodshot\": 846, \"blue beams\": 49, \"bored\": 1714, \"closed\": 710, \"coins\": 479, \"crazy\": 407, \"cyborg\": 108, \"eyepatch\": 333, \"heart\": 394, \"holographic\": 151, \"hypnotized\": 220, \"laser eyes\": 69, \"robot\": 350, \"sad\": 551, \"scumbag\": 233, \"sleepy\": 751, \"sunglasses\": 352, \"wide eyed\": 549, \"x eyes\": 243, \"zombie\": 308}, \"Fur\": {\"black\": 1229, \"blue\": 490, \"brown\": 1370, \"cheetah\": 406, \"cream\": 636, \"dark brown\": 1352, \"death bot\": 175, \"dmt\": 215, \"golden brown\": 778, \"gray\": 496, \"noise\": 155, \"pink\": 511, \"red\": 474, \"robot\": 265, \"solid gold\": 46, \"tan\": 626, \"trippy\": 77, \"white\": 397, \"zombie\": 302}, \"Hat\": {\"army hat\": 294, \"baby's bonnet\": 158, \"bandana blue\": 89, \"bayc flipped brim\": 231, \"bayc hat black\": 228, \"bayc hat red\": 119, \"beanie\": 578, \"bowler\": 262, \"bunny ears\": 195, \"commie hat\": 304, \"cowboy hat\": 354, \"faux hawk\": 136, \"fez\": 377, \"fisherman's hat\": 345, \"girl's hair pink\": 105, \"girl's hair short\": 150, \"halo\": 324, \"horns\": 252, \"irish boho\": 225, \"king's crown\": 77, \"laurel wreath\": 72, \"party hat 1\": 120, \"party hat 2\": 107, \"police motorcycle helmet\": 130, \"prussian helmet\": 130, \"s&m hat\": 235, \"safari\": 182, \"sea captain's hat\": 304, \"seaman's hat\": 420, \"short mohawk\": 318, \"spinner hat\": 181, \"stuntman helmet\": 157, \"sushi chef headband\": 187, \"trippy captain's hat\": 65, \"vietnam era helmet\": 223, \"ww2 pilot helm\": 110}, \"Mouth\": {\"bored\": 2272, \"bored bubblegum\": 119, \"bored cigar\": 121, \"bored cigarette\": 710, \"bored dagger\": 49, \"bored kazoo\": 74, \"bored party horn\": 88, \"bored pipe\": 132, \"bored pizza\": 50, \"bored unshaven\": 1551, \"bored unshaven bubblegum\": 65, \"bored unshaven cigar\": 94, \"bored unshaven cigarette\": 438, \"bored unshaven dagger\": 28, \"bored unshaven kazoo\": 61, \"bored unshaven party horn\": 45, \"bored unshaven pipe\": 101, \"bored unshaven pizza\": 26, \"discomfort\": 208, \"dumbfounded\": 505, \"grin\": 713, \"grin diamond grill\": 78, \"grin gold grill\": 91, \"grin multicolored\": 116, \"jovial\": 296, \"phoneme  ooo\": 255, \"phoneme l\": 241, \"phoneme oh\": 237, \"phoneme vuh\": 333, \"phoneme wah\": 163, \"rage\": 266, \"small grin\": 272, \"tongue out\": 202}}",
      "Description": "The Bored Ape Yacht Club is a collection of 10,000 unique Bored Ape NFTs— unique digital collectibles living on the Ethereum blockchain. Your Bored Ape doubles as your Yacht Club membership card, and grants access to members-only benefits, the first of which is access to THE BATHROOM, a collaborative graffiti board. Future areas and perks can be unlocked by the community through roadmap activation. Visit www.BoredApeYachtClub.com for more details.",
      "ImageUrl": "https://i.seadn.io/gae/Ju9CkWtV-1Okvf45wo8UctR-M9He2PjILP0oOvxE89AyiPPGtrR3gysu1Zgy0hjd2xKIgjJJtWIc0ybj4Vd7wv8t3pxDGHoJBzDB?w=500&auto=format",
      "BannerImageUrl": "https://i.seadn.io/gae/i5dYZRkVCUK97bfprQ3WXyrT9BnLSZtVKGJlKQ919uaUB0sxbngVCioaiyu9r6snqfi2aaTyIvv6DHm4m2R3y7hMajbsv14pSZK8mhs?w=500&auto=format",
      "DiscordUrl": "https://discord.gg/3P5K3dzgdB",
      "TwitterUsername": "BoredApeYC",
      "ExternalUrl": "http://www.boredapeyachtclub.com/",
      "CreatedDate": "2021-04-22T23:14:04Z",
      "OpenSeaIsVerified": true,
      "CreatedAt": "2023-02-07T07:31:10Z",
      "UpdatedAt": "2023-02-07T07:31:10Z"
    }
  ],
  "nextPageIndex": 1,
  "total": 1
}

Changes