# klymax402 NFT Rarity Score Lookup

> klymax402 NFT Rarity Score Lookup is a paid API for AI agents from klymax402.com, paid per call via x402, $0.008/call, status unknown (last checked 2026-09-14).

Returns the rarity rank and rarity score for a specific NFT token within a collection on Ethereum or Base.

## Facts

- Endpoint: GET https://klymax402.com/api/nft-floor/api/rarity
- Price: $0.008/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/klymax402-nft-rarity-score-lookup-3c09a69e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__8Bn1c3GDjmjM_7rQs7fY

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 klymax402-nft-rarity-score-lookup-3c09a69e
```

Example prompt: What's the rarity rank and score for token ID 1234 in the Bored Ape Yacht Club collection at contract address 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D on Ethereum?

## When to prefer this

Use this endpoint when you need rarity rank and score for a specific NFT token on Ethereum or Base. Prefer this over floor price endpoints when the user wants to understand how rare a particular token is within its collection, not just its market price. Good for pre-purchase due diligence or portfolio analysis of NFT holdings.

## Known failure modes

- Invalid or non-existent contract address returns an error
- Token ID not found within the collection returns an error
- Unsupported chain (not ethereum or base) returns an error
- Rate limiting or payment failure results in 402 response
- Collection not indexed for rarity returns empty or error response

## How this service works

One MCP endpoint gives your AI agent access to 100 APIs -- crypto, DeFi, web, AI, finance and utilities. No API keys, USDC on Base from $0.003/call.

## Output

Returns a JSON object containing the chain, contract address, token ID, rarity rank (integer position within the collection), rarity score (numeric rarity value), and an array of the token's traits used to compute rarity.

## 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"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "address",
      "tokenId"
     ],
     "properties": {
      "chain": {
       "type": "string",
       "description": "Blockchain: ethereum or base. Default: ethereum"
      },
      "address": {
       "type": "string",
       "description": "NFT collection contract address"
      },
      "tokenId": {
       "type": "string",
       "description": "Token ID within the collection. e.g. 1234"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "chain": "example",
  "traits": [],
  "address": "example",
  "tokenId": "example",
  "rarityRank": 1,
  "rarityScore": 1
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/klymax402-nft-rarity-score-lookup-3c09a69e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from klymax402.com](https://www.zero.xyz/host/klymax402.com/llms.txt)