NFT Floor Price & Rarity API

io.github.Br0ski777Published by GitHub account Br0ski777v1.1.0Updated Oct 24, 2026

NFT collection floor price, volume, holders, rarity rank via Reservoir. ETH + Base. x402.

The publisher's own server: PriceWin

VerifiedSSEWeb executableFinanceData & Analytics

Overview

AI-generated overview

Remote MCP endpoint that gives an assistant NFT collection stats and token rarity data for Ethereum and Base, paid per call in USDC via x402.

What you can do
  • Retrieve collection stats for an NFT contract: floor price, 24-hour volume, supply, holder and listing counts, and top trait floors
  • Fetch rarity details for a single token: rarity rank and score, trait frequencies, trait floor prices and an estimated value
  • Query the same data over GET or POST variants of each tool
  • Choose between the Ethereum and Base chains per request
When to use it
Useful when an assistant needs on-demand NFT market figures — valuing a collection or portfolio, comparing collections, checking floor price movement, or judging whether a specific token is underpriced by rarity. Not needed if you never work with NFT market data.
Requirements
A remote MCP endpoint added by URL; nothing to install locally. No API key or signup, but each call is paid per request in USDC on Base L2 through the x402 protocol, so an x402-capable client and a funded wallet are needed. Network access to the provider endpoint is required.
Before you install
Every tool call costs money (about $0.012 for collection data and $0.008 for rarity), charged in USDC on Base, so automated or repeated calls can spend funds from the connected wallet. Payment is handled by x402 clients that sign transactions; review spending limits before enabling. Requests go to a third-party API that relays data from Alchemy and Reservoir, and returned figures are estimates, not trading advice.

Installation

In SourceWeft

  1. Open NFT Floor Price & Rarity API in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via SSE. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.Br0ski777%2Fnft-floor/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "nft-floor-price-rarity-api": {
      "type": "sse",
      "url": "https://nft-floor.api.klymax402.com/mcp"
    }
  }
}

README

NFT Floor Price & Rarity API

[MCP Server] [x402] [License: MIT]

NFT collection floor price, volume, holders, rarity data. Ethereum and Base via Alchemy. Pay-per-call via x402 (USDC on Base L2) -- no API key, no signup, no rate-limit wall.

Part of the klymax402 marketplace -- 100 x402 micropayment APIs for AI agents, one wallet, USDC on Base.

Quickstart -- MCP

Add to your MCP client config (Claude Desktop, Cursor, ElizaOS, etc.):

json
{  "mcpServers": {    "nft-floor": {      "url": "https://nft-floor.api.klymax402.com/mcp"    }  }}

Quickstart -- HTTP (x402)

bash
curl "https://nft-floor.api.klymax402.com/api/collection?address=0x0000000000000000000000000000000000dEaD"# -> 402 Payment Required, with an x402 payment challenge in the response body

Any x402-aware client (@x402/fetch, x402-agent-tools, ATXP) handles the 402 -> sign -> retry cycle automatically.

Tools

ToolMethodPathPriceDescription
nft_get_collection_dataGET/api/collection$0.012Get NFT collection floor price, volume, and stats
nft_get_collection_dataPOST/api/collection$0.012Get NFT collection floor price, volume, and stats (POST variant)
nft_get_token_rarityGET/api/rarity$0.008Get NFT token rarity rank, score, and trait floor prices
nft_get_token_rarityPOST/api/rarity$0.008Get NFT token rarity rank, score, and trait floor prices (POST variant)

nft_get_collection_data

Use this when you need NFT collection floor price, volume, or holder data. Returns comprehensive collection stats from Alchemy for Ethereum and Base NFTs.

Parameters

NameTypeRequiredDescription
addressstringyesNFT collection contract address. e.g. 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D (BAYC)
chainstringnoBlockchain: ethereum or base. Default: ethereum

Returns

  • floorPrice -- current floor price in ETH and USD
  • volume24h -- 24-hour trading volume in ETH and USD
  • totalSupply -- total number of NFTs in the collection
  • holderCount -- number of unique holders
  • listedCount -- number of NFTs currently listed for sale
  • listedPercent -- percentage of supply listed
  • topTraitFloors -- floor prices broken down by top traits

Example response:

json
{"floorPrice":{"eth":12.5,"usd":44000},"volume24h":{"eth":89.3,"usd":314000},"totalSupply":10000,"holderCount":5421,"listedCount":312,"listedPercent":3.12,"topTraitFloors":[{"trait":"Gold Fur","floor":45.2}]}

When to use: tracking NFT collection values, comparing collections, or monitoring floor price movements. Essential for NFT portfolio valuation and market analysis.

nft_get_collection_data

Use this when you need NFT collection floor price, volume, or holder data. Returns comprehensive collection stats from Alchemy for Ethereum and Base NFTs. POST variant of nft_get_collection_data -- same params passed as JSON body instead of query string.

Parameters

NameTypeRequiredDescription
addressstringyesNFT collection contract address. e.g. 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D (BAYC)
chainstringnoBlockchain: ethereum or base. Default: ethereum

Returns

  • floorPrice -- current floor price in ETH and USD
  • volume24h -- 24-hour trading volume in ETH and USD
  • totalSupply -- total number of NFTs in the collection
  • holderCount -- number of unique holders
  • listedCount -- number of NFTs currently listed for sale
  • listedPercent -- percentage of supply listed
  • topTraitFloors -- floor prices broken down by top traits

Example response:

json
{"floorPrice":{"eth":12.5,"usd":44000},"volume24h":{"eth":89.3,"usd":314000},"totalSupply":10000,"holderCount":5421,"listedCount":312,"listedPercent":3.12,"topTraitFloors":[{"trait":"Gold Fur","floor":45.2}]}

When to use: tracking NFT collection values, comparing collections, or monitoring floor price movements. Essential for NFT portfolio valuation and market analysis.

nft_get_token_rarity

Use this when you need rarity data for a specific NFT token. Returns rarity rank, score, attributes, and trait-level floor prices for valuation.

Parameters

NameTypeRequiredDescription
addressstringyesNFT collection contract address
tokenIdstringyesToken ID within the collection. e.g. 1234
chainstringnoBlockchain: ethereum or base. Default: ethereum

Returns

  • rarityRank -- token's rarity rank within the collection (e.g. 142 out of 10000)
  • rarityScore -- computed rarity score
  • totalSupply -- total tokens in the collection
  • attributes -- array of token traits with name, value, frequency, and trait floor price
  • estimatedValue -- estimated value based on rarity and trait floors

Example response:

json
{"rarityRank":142,"rarityScore":285.4,"totalSupply":10000,"attributes":[{"trait":"Background","value":"Gold","frequency":0.02,"traitFloor":18.5},{"trait":"Eyes","value":"Laser","frequency":0.04,"traitFloor":15.2}],"estimatedValue":{"eth":22.3,"usd":78500}}

When to use: valuing individual NFTs, finding underpriced tokens, or building rarity-based trading strategies.

nft_get_token_rarity

Use this when you need rarity data for a specific NFT token. Returns rarity rank, score, attributes, and trait-level floor prices for valuation. POST variant of nft_get_token_rarity -- same params passed as JSON body instead of query string.

Parameters

NameTypeRequiredDescription
addressstringyesNFT collection contract address
tokenIdstringyesToken ID within the collection. e.g. 1234
chainstringnoBlockchain: ethereum or base. Default: ethereum

Returns

  • rarityRank -- token's rarity rank within the collection (e.g. 142 out of 10000)
  • rarityScore -- computed rarity score
  • totalSupply -- total tokens in the collection
  • attributes -- array of token traits with name, value, frequency, and trait floor price
  • estimatedValue -- estimated value based on rarity and trait floors

Example response:

json
{"rarityRank":142,"rarityScore":285.4,"totalSupply":10000,"attributes":[{"trait":"Background","value":"Gold","frequency":0.02,"traitFloor":18.5},{"trait":"Eyes","value":"Laser","frequency":0.04,"traitFloor":15.2}],"estimatedValue":{"eth":22.3,"usd":78500}}

When to use: valuing individual NFTs, finding underpriced tokens, or building rarity-based trading strategies.

Example agent prompts

  • "NFT collection floor price, volume, or holder data"
  • "NFT collection floor price, volume, or holder data"
  • "Rarity data for a specific NFT token"

Payment

  • Protocol: x402 -- HTTP-native pay-per-call, no signup, no API key
  • Network: Base L2 (eip155:8453)
  • Asset: USDC
  • Facilitator: Coinbase CDP (primary), PayAI (fallback)
  • Also reachable via ATXP (OAuth-wrapped x402, RFC 9728 protected-resource metadata)

Part of klymax402

100 x402 micropayment APIs for AI agents -- one wallet, USDC on Base, zero signup.

License

MIT

Source: README.md at commit a570dda

Tools

0
SourceWeft has not read this server's tools yet.

Version history

1
  1. v1.1.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declaredRequired10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Price integrations

PriceWin

win.priceOfficial publisher

Remote MCP server for live hotel and flight price comparison across Booking.com, Agoda, Trip.com, Traveloka and others, plus direct hotel booking requests.

Streamable HTTPWeb executable
Location & Lifestyle13 toolsOct 27, 2026

Mcp Amazon Product Price Stock Tracker

com.mambabuilt

Reads Amazon price, stock, seller and rating for ASINs or product URLs via an Apify actor, with change rows between runs.

STDIODesktop only
Data & AnalyticsNot validated yetNov 7, 2026

Postage Stamp Price MCP

Published by GitHub account theluckystrike

Remote MCP server that gives an assistant current USPS retail postage prices, read from USPS Notice 123 at call time, plus letter postage calculations.

Streamable HTTPWeb executable
Location & Lifestyle3 toolsNov 5, 2026

Silver Price Per Gram MCP

Published by GitHub account theluckystrike

Live silver price per gram by fineness and currency, junk silver coin value, gold silver ratio.

Streamable HTTPWeb executable
4 toolsNov 3, 2026

Emalls Price Comparison

Published by GitHub account sepehr071

Unofficial read-only MCP server for Emalls (emalls.ir) price comparison: search Iranian shop products, offers, price history and shop profiles.

STDIODesktop only
Web Search & ScrapingNot validated yetNov 7, 2026