# ChainRay NFT Holders Lookup

> ChainRay NFT Holders Lookup is a paid API for AI agents from chainray.online, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns the list of holders for a given NFT contract address on a specified blockchain network

## Facts

- Endpoint: GET https://chainray.online/nft-holders/:var1
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/chainray-nft-holders-lookup-d13db37f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6VydEI9Tvk_7ARs0wmsqH

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability chainray-nft-holders-lookup-d13db37f
```

Example prompt: Can you pull up all the current holders of the NFT contract 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D on Ethereum using ChainRay?

## When to prefer this

Use this endpoint when you need to enumerate the current holders of a specific NFT collection by contract address on any supported blockchain. Ideal for snapshot analysis, airdrop targeting, holder distribution analytics, or verifying token ownership at scale. Prefer this over general token APIs when you specifically need NFT holder enumeration across multiple chains.

## Known failure modes

- Invalid or non-existent contract address returns an error or empty result
- Unsupported blockchain network in the 'chain' parameter returns an error
- Missing required 'contract' query parameter returns a 400-level error
- Contract address is not an NFT contract returns an error or empty result
- Network timeout or chain RPC unavailability causes a service error

## How this service works

ChainRay /nft-holders

## Output

A list of wallet addresses that currently hold tokens from the specified NFT contract, along with relevant ownership data such as token counts or IDs per holder, for the requested blockchain network.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "contract"
     ],
     "properties": {
      "chain": {
       "type": "string",
       "description": "Blockchain network"
      },
      "contract": {
       "type": "string",
       "description": "NFT contract address"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/chainray-nft-holders-lookup-d13db37f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from chainray.online](https://www.zero.xyz/host/chainray.online/llms.txt)