# ChainRay NFT Floor Price

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

Retrieves the current floor price for an NFT collection by contract address on a specified blockchain network

## Facts

- Endpoint: GET https://chainray.online/nft-floor/:var1
- Price: $0.005/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-floor-price-4b18cb9e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2p6Mq6Toyn00PSflZVQcL

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-floor-price-4b18cb9e
```

Example prompt: What's the current floor price of the NFT collection at contract address 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D on Ethereum?

## When to prefer this

Use this endpoint when you need real-time NFT floor price data for a specific collection identified by contract address across multiple blockchain networks. Prefer this over generic crypto price APIs when you specifically need NFT collection floor pricing rather than token prices. ChainRay covers 46+ chains making it ideal for cross-chain NFT floor lookups.

## Known failure modes

- Invalid or non-NFT contract address returns an error or empty result
- Unsupported blockchain network returns an error
- Contract address with no active listings may return null floor price
- Rate limiting or payment failure (402) if USDC payment not provided
- Network-specific address format mismatch causes lookup failure

## How this service works

ChainRay /nft-floor

## Output

Returns the current floor price for the specified NFT collection contract, including the minimum price to acquire an NFT from the collection on the given blockchain network, likely expressed in the native currency or USD equivalent.

## 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": [
      "address"
     ],
     "properties": {
      "chain": {
       "type": "string",
       "description": "Blockchain network"
      },
      "address": {
       "type": "string",
       "description": "Wallet or contract address"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/chainray-nft-floor-price-4b18cb9e/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)