Search Contract Metadata

GET

/v3/{apiKey}/searchContractMetadata

Searches for a keyword across metadata of all ERC-721 and ERC-1155 smart contracts.

This endpoint is currently in BETA. If you have any questions or feedback, please contact us at [email protected] or open a ticket in the dashboard.

Please note that this endpoint is only available on Ethereum, Polygon, Arbitrum, Optimism & Base networks.

Path Parameters

stringrequireddefaults to docs-demo

For higher throughput, create your own API key

Query Parameters

stringrequireddefaults to bored

String - The search string that you want to search for in contract metadata

Responses

200

Returns the list of NFT contracts where the metadata has one or more keywords from the search string.

List of contracts where the metadata contains one or more keywords from the search string.

GET/nft/v3/{apiKey}/searchContractMetadata

curl --request GET \  --url 'https://eth-mainnet.g.alchemy.com/nft/v3/docs-demo/searchContractMetadata?query=bored'

200Returns the list of NFT contracts where the metadata has one or more keywords from the search string.

[  {    "address": "string",    "name": "string",    "symbol": "string",    "totalSupply": "string",    "tokenType": "ERC721",    "contractDeployer": "string",    "deployedBlockNumber": 1,    "openseaMetadata": {      "floorPrice": 1,      "collectionName": "string",      "safelistRequestStatus": "string",      "imageUrl": "string",      "description": "string",      "externalUrl": "string",      "twitterUsername": "string",      "discordUrl": "string",      "bannerImageUrl": "string",      "lastIngestedAt": "string"    }  }]

Was this page helpful?