Skip to main content

GET /api/nfts/{address}

NFT holdings summary

GET nfts data from nfts service

Endpoint​

GET https://api.web3identity.com/api/nfts/{address}

Parameters​

NameInTypeRequiredDescription
addresspathstringâś…Ethereum address (0x...)

Example Request​

curl -s "https://api.web3identity.com/api/nfts/:address" | jq

Responses​

200 Success​

{
  "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "nfts": [
    {
      "contractAddress": "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D",
      "tokenId": "1234",
      "name": "Bored Ape #1234",
      "collection": "Bored Ape Yacht Club",
      "image": "ipfs://QmExample1234",
      "attributes": [
        {
          "trait_type": "Background",
          "value": "Blue"
        },
        {
          "trait_type": "Fur",
          "value": "Brown"
        }
      ],
      "lastSale": {
        "price": 28.5,
        "date": "2026-01-15T10:30:00.000Z"
      }
    }
  ],
  "count": 1,
  "totalValueUSD": 92573.93
}

400 Bad request - invalid parameters​

{
  "example": "response"
}

402 Payment required​

404 Resource not found​

{
  "example": "response"
}

429 Rate Limited​

{
  "example": "response"
}

500 Internal Server Error - Something went wrong on our end​

{
  "error": "Internal server error",
  "code": "INTERNAL_ERROR"
}

Auto-generated from OpenAPI spec