API Reference

Ownership Summary by Wallet(s)

get
https://api.simplehash.xyz/api/v0/nfts/contracts?chains=&wallet_addresses=
This endpoint is commonly used to pass specific wallet addresses to get back a summary of the NFT contract ownership of these addresses. A common use case could include token-gated experiences - if supplying a set of wallet addresses and NFT contracts, you could check whether each wallet owns an NFT that is part of a specific contract or not:
To supply multiple values, provide them comma separated in the query params, e.g., chains=optimism,ethereum&wallet_addresses=0xa12,0xb34. ENS addresses can also be provided for the wallet_addresses.
To understand more about the difference between Collections and Contracts, please refer to our FAQ
Query Params
string
required
Defaults to ethereum,polygon

Chain(s) to query - may be comma delimited (e.g., ethereum,arbitrum)

string
required
Defaults to 0xC01A0311708476E586fc194eB433979FF904E6Dd

Owner wallet address(es), comma-separated for multiple values (e.g., 0xa12,0xb34). Limit of 20 addresses.

string
Defaults to 0x6d4530149e5B4483d2F7E60449C02570531A0751,0x892848074ddeA461A15f337250Da3ce55580CA85

NFT contract address(es) to filter on, comma-separated for multiple values (e.g., 0xa12,0xb34). Limit of 20 addresses.

string

Comma-separated list of contract_id values to hide from the results. For example: excluded_contract_ids=ethereum.0xc0cb81c1f89ab0873653f67eea42652f13cd8416,polygon.0x3147f9c776f59231226504c77332ad952a6d2402

Responses

Updated almost 3 years ago

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated almost 3 years ago