Name: nft-floor
Price: 0.01 USDC
Availability: InStock

$ man nft-floor

agentutility / edge-market / nft-floor

PRICE / CALL

$0.01

USDC · base mainnet · scheme: exact

METHOD

POST

CLUSTER

edgemarket

CATEGORY

uncategorized

STATUS

● live

NAME

nft-floor — nft collection floor + recent sales via reservoir

SYNOPSIS

POST https://x402.org/v1/nft-floor
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

     { ... }

↳ first call → 402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.

DESCRIPTION

NFT collection floor + recent sales via Reservoir. Ethereum / Base / Arbitrum / Optimism / Polygon. Floor, top bid, 24h/7d/30d volume + change, ranks, recent sales.

INPUT — request schema

property	type	description	req?
collection	string	Slug or contract address.	required
chain	string	EVM chain to query: ethereum, base, arbitrum, optimism, or polygon. enum: ethereum · base · arbitrum · optimism · polygon	optional
include_recent_sales	boolean	When true, includes a recent_sales array of the latest transactions for the collection.	optional
recent_sales_limit	number	Max number of recent sales to return when include_recent_sales is true.	optional

OUTPUT — response shape

field	type	description
floor_native	string	Collection floor price in the chain's native token (e.g. ETH, MATIC) as a decimal string.
token_count	string	Total number of tokens (NFTs) in the collection as a string.

EXAMPLES — two ways to call

EXAMPLE 1 · curl

curl -X POST https://x402.org/v1/nft-floor \
  -H 'Content-Type: application/json' \
  -d '{ }'

first response = 402 Payment Required with payment requirements; sign + retry with X-PAYMENT.

EXAMPLE 2 · mcp

# install once
claude mcp add x402 --command "npx x402-deployer-mcp"

# then ask Claude Code:
# "use the nft-floor tool to ..."

MCP server handles payment automatically — your coding agent just calls the tool by name.

METADATA

tags: nftfloor-pricereservoircollection-statsnft-salesedge-marketnft-floor
methods: POST
cluster: edgemarket
price: $0.01 USDC per call

ADJACENT — other endpoints in edgemarket

endpoint	description	price
contract-source	Verified contract source code / Etherscan source / contract ABI fetcher / Solidity source lookup.	$0.01
contract-source-verified	Verified contract source code / Etherscan source / Basescan ABI / Solidity source lookup / contract verification check / ABI fetcher / Et…	$0.01
dex-liquidity-depth	DEX liquidity depth / pool TVL aggregator / total liquidity per token / on-chain liquidity audit.	$0.01
eth-logs	eth_getLogs / on-chain event logs / EVM event reader / Transfer event scan / ERC20 Transfer logs / NFT mint logs / DEX swap events / mult…	$0.01
lp-lock-check	LP lock check / liquidity-lock auditor / Unicrypt + Team Finance + burn-address detection.	$0.01
agent-card-resolve	Agent card resolver / ERC-8004 Identity Registry lookup / Trustless Agents / agentId → owner + agentURI / A2A identity / agent.json fetch…	$0.005
arbitrage-spread	Cross-exchange arbitrage spread / max-min price / CEX price dispersion / spread % calculator.	$0.005
basename-resolve	Basename resolver / Coinbase Basenames / .base.eth lookup / Base name service / on-chain name resolution.	$0.005

/nft-floor(1)