Skip to main content
GET
cURL
40 credits per request

  • One entry per collection: name, logo, number of NFTs held and one preview image
  • Collection floor price and the holding’s total floor value, in the chain’s native token and in your currency
Use this for a “Collections” view. To list every NFT individually, across all chains, with images, attributes and fiat values, use GET /wallet/nft.
  • address: Query parameter. Wallet address (ENS names work when reading ethereum alone).
  • page & limit: Control pagination. Pages list collections; limit is capped at 100.
  • blockchain: Chain to read, a comma-separated list, or “all”. Defaults to ethereum.
  • currency: Fiat currency for value. Defaults to USD.
  • sortBy: floorValue lists the most valuable collections first.
  • spam: exclude (default), include or only.
Floor prices are current on Ethereum, Base and Arbitrum and null on other chains. Only collections verified on OpenSea get a value and count toward totals; unverified ones still show their floor price.

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

page
number

Page number to retrieve (1-based indexing)

Example:

1

limit
number

Number of items to return per page

Example:

20

blockchain
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. Comma-separate several, or pass "all". Defaults to ethereum.

Example:

"ethereum,base"

currency
object

Fiat currency for values, e.g. USD, EUR. Defaults to USD.

Example:

"USD"

sortBy
enum<string>
default:default

default keeps upstream order; floorValue lists the most valuable collections first (reads up to 1,000 collections).

Available options:
default,
floorValue
spam
enum<string>
default:exclude

exclude (default) hides spam collections, include returns everything, only returns spam alone.

Available options:
exclude,
include,
only
address
string
required

Wallet address (0x…), or an ENS name when reading ethereum alone.

Example:

"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"

Response

data
object[]
required
meta
object
required
failedBlockchains
string[]
required

Chains that could not be read; their collections are missing

Example: