Skip to main content
GET
cURL
40 credits per request

  • One entry per NFT: name, description, image, thumbnail, animation and attributes
  • Its collection, floor price and value in your currency
  • Spam flag with reasons and mint details
Use this for an NFT gallery or token detail views. For one row per collection with a count of NFTs held, use GET /wallet/nft/collections.
  • address: Query parameter. 0x wallet address.
  • blockchain: Comma-separated chains or “all” (default).
  • spam: exclude (default), include or only.
  • sort: default or floorValue.
  • currency: Fiat currency for values. Defaults to USD.
  • contracts: Comma-separated collection addresses, up to 45, to return only their NFTs.
  • page & limit: Control pagination; limit is capped at 100.
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 NFT items to return per page

Example:

20

blockchain
string
default:all

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" (default).

Example:

"ethereum,base"

spam
enum<string>
default:exclude

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

Available options:
exclude,
include,
only
sort
enum<string>
default:default

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

Available options:
default,
floorValue
currency
object

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

Example:

"USD"

contracts
string

Comma-separated collection contract addresses, up to 45. Only NFTs from these collections are returned.

Example:

"0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d"

address
string
required

Wallet address (0x…).

Example:

"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"

Response

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

Chains that could not be read; their NFTs are missing

Example:
truncated
boolean
required

sort=floorValue or contracts only: the wallet holds more NFTs than were read

Example:

false