API ReferenceNFT APIGet NFT Traits and RarityGet NFTs by TraitsGet NFTs by TraitsPOSThttps://deep-index.moralis.io/api/v2.2/nft/:address/nfts-by-traitsFind NFTs in a contract matching specific traits, perfect for attribute-based searches.PATH PARAMSaddressstringrequiredThe address of the NFT contractQUERY PARAMSchainstringThe chain to queryeth0x1sepolia0xaa36a7polygon0x89bsc0x38bsc testnet0x61avalanche0xa86afantom0xfacronos0x19arbitrum0xa4b1chiliz0x15b38chiliz testnet0x15b32gnosis0x64gnosis testnet0x27d8base0x2105base sepolia0x14a34optimism0xaholesky0x4268polygon amoy0x13882linea0xe708moonbeam0x504moonriver0x505moonbase0x507linea sepolia0xe705flow0x2ebflow-testnet0x221ronin0x7e4ronin-testnet0x7e5lisk0x46flisk-sepolia0x106apulse0x171sei0x531limitnumberThe desired page size of the result.cursorstringThe cursor returned in the previous response (used for getting the next page).formatstringThe format of the token IDnormalizeMetadatabooleanShould normalized metadata be returned?falsetruemedia_itemsbooleanShould preview media data be returned?falsetrueBODY PARAMRequest BodyjsonrequiredBody{}Responses200Returns a collection of NFTs400Bad Request404Not Found429Too Many Requests500Internal Server ErrorAPI KEYTest Live APIcURLNode.jsPythonGoPHPcurl --request POST \ --url 'https://deep-index.moralis.io/api/v2.2/nft/0x524cab2ec69124574082676e6f654a18df49a048/nfts-by-traits?chain=eth&limit=25&format=decimal' \ --header 'accept: application/json' \ --header 'X-API-Key: YOUR_API_KEY' // Node.js v18+ has native fetch support// No additional dependencies requiredconst options = { method: 'POST', headers: { accept: 'application/json', 'X-API-Key': 'YOUR_API_KEY' },};fetch('https://deep-index.moralis.io/api/v2.2/nft/0x524cab2ec69124574082676e6f654a18df49a048/nfts-by-traits?chain=eth&limit=25&format=decimal', options) .then(response => response.json()) .then(response => console.log(response)) .catch(err => console.error(err));# Dependencies to install:# $ python -m pip install requestsimport requestsurl = "https://deep-index.moralis.io/api/v2.2/nft/0x524cab2ec69124574082676e6f654a18df49a048/nfts-by-traits?chain=eth&limit=25&format=decimal"headers = { "Accept": "application/json", "X-API-Key": "YOUR_API_KEY"}response = requests.request("POST", url, headers=headers)print(response.text)package mainimport ( "fmt" "net/http" "io")func main() { url := "https://deep-index.moralis.io/api/v2.2/nft/0x524cab2ec69124574082676e6f654a18df49a048/nfts-by-traits?chain=eth&limit=25&format=decimal" req, _ := http.NewRequest("POST", url, payload) req.Header.Add("Accept", "application/json") req.Header.Add("X-API-Key", "YOUR_API_KEY") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body))}<?php// Dependencies to install:// $ composer require guzzlehttp/guzzlerequire_once('vendor/autoload.php');$client = new \GuzzleHttp\Client();$response = $client->request('POST', 'https://deep-index.moralis.io/api/v2.2/nft/0x524cab2ec69124574082676e6f654a18df49a048/nfts-by-traits?chain=eth&limit=25&format=decimal', [ 'headers' => [ 'Accept' => 'application/json', 'X-API-Key' => 'YOUR_API_KEY', ],]);echo $response->getBody();Response Example200 Returns a collection of NFTs{ "page": "2", "page_size": "100", "cursor": "", "result": { "token_address": "0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB", "token_id": "15", "owner_of": "0x9c83ff0f1c8924da96cb2fcb7e093f78eb2e316b", "token_hash": "502cee781b0fb40ea02508b21d319ced", "block_number": "88256", "block_number_minted": "88256", "contract_type": "ERC721", "token_uri": "", "metadata": "", "normalized_metadata": "", "media": "", "minter_address": "0x9c83ff0f1c8924da96cb2fcb7e093f78eb2e316b", "last_token_uri_sync": "", "last_metadata_sync": "", "amount": "1", "name": "CryptoKitties", "symbol": "RARI", "possible_spam": "false", "verified_collection": "false", "rarity_rank": 21669, "rarity_percentage": 98, "rarity_label": "Top 98%", "last_sale": { "transaction_hash": "0x19e14f34b8f120c980f7ba05338d64c00384857fb9c561e2c56d0f575424a95c", "block_timestamp": "2023-04-04T15:59:11.000Z", "buyer_address": "0xcb1c1fde09f811b294172696404e88e658659905", "seller_address": "0x497a7dee2f13db161eb2fec060fa783cb041419f", "price": "7300000000000000", "price_formatted": "0.0073", "usd_price_at_sale": "13.61", "current_usd_value": "15.53", "token_address": "0xe8778996e096b39705c6a0a937eb587a1ebbda17", "token_id": "170" }, "list_price": { "listed": true, "price": "27008", "price_currency": "eth", "price_usd": "13.61", "marketplace": "opensea" }, "floor_price": "12345", "floor_price_usd": "12345.4899", "floor_price_currency": "eth" }}