Attributes Summary By Contract

GET

/v3/:apiKey/summarizeNFTAttributes

GET

/nft/v3/:apiKey/summarizeNFTAttributes

1 import requests
2 
3 url = "https://eth-mainnet.g.alchemy.com/nft/v3/docs-demo/summarizeNFTAttributes"
4 
5 querystring = {"contractAddress":"0xe785E82358879F061BC3dcAC6f0444462D4b5330"}
6 
7 response = requests.get(url, params=querystring)
8 
9 print(response.json())

Try it

200

1 {
2   "totalSupply": "10000",
3   "summary": {
4     "Earrings": {
5       "WoW Coins": 437,
6       "Pizza Lovers": 188,
7       "Lucky Charms": 415,
8       "White Ovals": 210,
9       "Artist Palettes": 21,
10       "Queen's Emeralds": 206,
11       "Silver Drops": 822,
12       "Flower Power": 366,
13       "Pearls": 833,
14       "Spikes": 776,
15       "Yam's Fave": 381,
16       "Classic Hoops": 780,
17       "Ocean Hoops": 770,
18       "Triple Rings": 823,
19       "60s Fantasy": 399,
20       "Lightning Bolts": 226,
21       "Empresses Of Darkness": 103
22     },
23     "Necklace": {
24       "WoW Coin": 481,
25       "Malka": 494,
26       "Amazonite Energy": 490,
27       "Satin Choker": 721,
28       "Back To The 90s": 706,
29       "Empress of Darkness": 58,
30       "Spike Choker": 449,
31       "Golden Bib": 251,
32       "Golden Flakes": 710,
33       "Art Lover": 29,
34       "Rainbow": 474,
35       "Gold Ruler": 477,
36       "Wolf Pendant": 229,
37       "Tutti Frutti Beads": 691,
38       "Sun Keeper": 730
39     },
40     "Eyes": {
41       "Purple To The Left": 158,
42       "Heterochromia To The Left": 57,
43       "Brown To The Right": 455,
44       "Black Eye Roll": 881,
45       "Yellow To The Left": 141,
46       "Purple Eye Roll": 145,
47       "Green Straight": 433,
48       "Blue To The Left": 407,
49       "Green To The Right": 410,
50       "Black Straight": 794,
51       "Purple To The Right": 145,
52       "Black To The Right": 870,
53       "Green Eye Roll": 413,
54       "Yellow Straight": 128,
55       "Brown To The Left": 465,
56       "Brown Eye Roll": 416,
57       "Heterochromia To The Right": 76,
58       "Blue Straight": 415,
59       "Black To The Left": 877,
60       "Heterochromia Eye Roll": 85,
61       "Purple Straight": 158,
62       "Brown Straight": 434,
63       "Yellow Eye Roll": 141,
64       "Heterochromia Straight": 77,
65       "Yellow To The Right": 139,
66       "Blue To The Right": 416,
67       "Green To The Left": 424,
68       "Blue Eye Roll": 440
69     },
70     "Background": {
71       "Green Purple": 905,
72       "Purple Pink": 905,
73       "Dark Emerald": 924,
74       "Yellow Pink": 896,
75       "Pink Pastel": 849,
76       "Blue Green": 924,
77       "Soft Purple": 983,
78       "Green Orange": 907,
79       "Dark Purple": 876,
80       "Red Turquoise": 914,
81       "Orange Yellow": 917
82     },
83     "Mouth": {
84       "Cigarette": 502,
85       "Whistle": 868,
86       "Slight Smile": 1666,
87       "Stern": 1733,
88       "Countryside": 927,
89       "Huh": 506,
90       "Slightly Open": 1661,
91       "Bubble Gum": 404,
92       "Surprised": 1733
93     },
94     "Clothes": {
95       "80s Silk Shirt": 400,
96       "70s Shirt": 421,
97       "Fantasy Shirt": 542,
98       "Adventurer": 583,
99       "Striped Tee": 567,
100       "Naiade": 98,
101       "Tunic": 193,
102       "Checkmate": 396,
103       "Painter's Overall": 550,
104       "Witch Dress": 198,
105       "Little Red Dress": 437,
106       "Cabaret Corset": 535,
107       "Polka Dot Top": 573,
108       "Freedom Is Power Tee": 368,
109       "Warrior Armor": 177,
110       "Emerald Elven Cape": 117,
111       "Faux Fur Coat": 404,
112       "Red Leather Jacket": 374,
113       "White Tee": 533,
114       "Tuxedo": 100,
115       "Steampunk Octopus Top": 186,
116       "Queen's Dress": 391,
117       "Cherry Tee": 590,
118       "NFT Goddesses Top": 189,
119       "Gala Dress": 192,
120       "Psychedelic Dress": 492,
121       "Futuristic Dress": 394
122     },
123     "Facial Features": {
124       "Nose Piercing": 598,
125       "Red Eyeliner": 608,
126       "Leader": 224,
127       "Neck Tattoo": 227,
128       "Pearl Eyes": 207,
129       "Red Blue Bolt": 97,
130       "Rose Tattoo": 286,
131       "Feline Eyes": 590,
132       "Elven Warrior": 99,
133       "Marilyn": 633,
134       "Freckles": 581,
135       "Flashy Blue": 304,
136       "Sunset": 297,
137       "Heart Tattoo": 591,
138       "Rainbow": 578,
139       "Eyebrow Tattoo MMXXI": 303,
140       "Eye Scar": 308,
141       "Treble Bass Clef Tattoo": 210,
142       "Crystal Queen": 221,
143       "Antoinette": 582,
144       "Cyber Warrior": 120,
145       "Eyebrow Piercing": 619,
146       "Claw Scar": 236
147     },
148     "Hairstyle": {
149       "Badass Bob": 178,
150       "Curly Ponytail": 390,
151       "Finger Waves": 398,
152       "Colorful": 186,
153       "Fuchsia": 562,
154       "Retro": 408,
155       "Royal": 227,
156       "Boy Cut": 566,
157       "Bob": 653,
158       "Bun": 607,
159       "Long Dark": 416,
160       "Curly Pearl Updo": 122,
161       "Lucky Green": 417,
162       "Lioness": 600,
163       "Natural Red": 608,
164       "Double Buns": 182,
165       "Cotton Candy": 228,
166       "Rose Hair": 388,
167       "Purple Rainbow": 187,
168       "Lollipop": 612,
169       "Silver": 205,
170       "Braided Ponytail": 561,
171       "Platinum Pixie": 570,
172       "Black And White": 110,
173       "Feeling Turquoise": 412
174     },
175     "Lips Color": {
176       "Space": 195,
177       "Gold": 622,
178       "Purple": 1967,
179       "Burgundy": 1995,
180       "Party Pink": 1114,
181       "Passion Red": 3008,
182       "Flashy Blue": 1099
183     },
184     "Skin Tone": {
185       "Rainbow Bright": 197,
186       "Light Warm Yellow": 1021,
187       "Burning Red": 497,
188       "Cyber Green": 511,
189       "Night Goddess": 85,
190       "Deep Warm Gold": 1026,
191       "Light Medium Warm Gold": 997,
192       "Deep Bronze": 1047,
193       "Medium Olive": 976,
194       "Deep Neutral": 996,
195       "Medium Gold": 937,
196       "Light Warm Olive": 1031,
197       "Cool Blue": 486,
198       "Golden": 193
199     },
200     "Face Accessories": {
201       "Oversized Statement Sunglasses": 396,
202       "Psychedelic Sunglasses": 390,
203       "Resting Butterfly": 83,
204       "Red Round Sunglasses": 695,
205       "Classic Aviator WoW": 414,
206       "Black Mask": 398,
207       "Cateye Sunglasses": 221,
208       "On Fire": 116,
209       "70s Feels": 718,
210       "3D Glasses": 216,
211       "Round Glasses": 704,
212       "Black Round Retro": 403,
213       "Hypnotic Glasses": 209
214     }
215   },
216   "contractAddress": "0xe785E82358879F061BC3dcAC6f0444462D4b5330"
217 }

Generates a summary of attribute prevalence for a specific NFT collection.

Please note that this endpoint is only available on Ethereum (mainnet) & Polygon (mainnet & mumbai).

Path parameters

apiKeystringRequired

Query parameters

contractAddressstringRequired

String - Contract address for the NFT contract (ERC721 and ERC1155 supported).

Response

Returns a summary of attribute prevalence for the specified NFT collection.

totalSupplystringOptional

String - Total number of NFTs in a given NFT collection.

summaryobjectOptional

Object mapping trait types to the prevalence of each trait within that type.

contractAddressstringOptionalDefaults to 0xe785E82358879F061BC3dcAC6f0444462D4b5330