NFT Data

NFT collections and metadata

NFT Collection

get

Get NFTs owned by the wallet with metadata and floor prices

Query parameters

addressstringRequired

Ethereum wallet address (0x format)

Example: 0x742d35cc6634C0532925a3b8D7aa5ac000000000Pattern: ^0x[a-fA-F0-9]{40}$

chainstring · enumOptional

Blockchain network identifier

Default: ethPossible values:

limitinteger · min: 1 · max: 100Optional

Maximum number of items to return

Default: 50

exclude_spambooleanOptional

Exclude spam tokens/NFTs from results

Default: true

normalizeMetadatabooleanOptional

Normalize NFT metadata

Default: true

media_itemsbooleanOptional

Include media items in response

Default: true

cursorstringOptional

Pagination cursor for next page

bustCachebooleanOptional

Force cache refresh

Default: false

Responses

200

NFT collection data

application/json

400

Bad request - missing or invalid parameters

application/json

429

Rate limit exceeded

application/json

500

Internal server error

application/json

get

/api/wallet/nfts

HTTPcURLJavaScriptPython

GET /api/wallet/nfts?address=0x742d35cc6634C0532925a3b8D7aa5ac000000000 HTTP/1.1
Host: kairolabs.io
Accept: */*

{
  "result": [
    {
      "token_address": "text",
      "token_id": "text",
      "owner_of": "text",
      "block_number": "text",
      "block_number_minted": "text",
      "token_hash": "text",
      "amount": "text",
      "contract_type": "text",
      "name": "text",
      "symbol": "text",
      "token_uri": "text",
      "metadata": "text",
      "last_token_uri_sync": "text",
      "last_metadata_sync": "text",
      "minter_address": "text",
      "possible_spam": true,
      "verified_collection": true
    }
  ],
  "cursor": "text",
  "total": 1
}