Skip to main content
GET
cURL
5 credits per request

  • Per collection: whether it is held, token count and ids
  • address: Query parameter. Wallet address (or ENS name on ethereum).
  • contracts: Comma-separated collection addresses, up to 45.
  • blockchain: Chain to check. Defaults to ethereum.

Authorizations

X-API-KEY
string
header
required

API key required to access the endpoints. Generate one from your dashboard at https://openapi.coinstats.app and pass it in the X-API-KEY request header. Never expose your key in client-side code.

Query Parameters

contracts
string
required

Comma-separated NFT contract addresses to check, up to 45.

Example:

"0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d"

blockchain
enum<string>
default:ethereum

The blockchain network identifier from /wallet/blockchains call response (its chain field). NFT data is available on: ethereum, polygon-pos, base, arbitrum-one, optimistic-ethereum, zksync, blast, linea, scroll, zora, abstract, apechain, avalanche, binance_smart, unichain, soneium, berachain, world-chain, celo, xdai, monad. Defaults to ethereum.

Available options:
ethereum,
polygon-pos,
base,
arbitrum-one,
optimistic-ethereum,
zksync,
blast,
linea,
scroll,
zora,
abstract,
apechain,
avalanche,
binance_smart,
unichain,
soneium,
berachain,
world-chain,
celo,
xdai,
monad
Example:

"ethereum"

address
string
required

Wallet address (0x…), or an ENS name when blockchain is ethereum.

Example:

"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"

Response

address
string
required
Example:

"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"

blockchain
string
required
Example:

"ethereum"

holdsAny
boolean
required

Holds at least one of the contracts

contracts
object[]
required