Nft Floor

Gets an NFT collection's floor price and recent sales via Reservoir.

Overview

Gets an NFT collection's floor price and recent sales via Reservoir. Covers Ethereum, Base, Arbitrum, Optimism, and Polygon; returns floor, top bid, 24h/7d/30d volume + change, ranks, and recent sales. Use it as an NFT floor price API or collection floor lookup.

Endpoint

Method	Endpoint	Price	Description
POST	/v1/marketplace/api/nft-floor	$0.0115	Invoke Nft Floor (General) and return the upstream response.

How to call it

Requests are paid per call over the x402 protocol. Call the endpoint, receive a 402 Payment Required quote, then repeat the request with the signed payment header. The SDKs do both steps for you.

# 1. Ask for a quote
curl -i -X POST https://api.jarvisclaw.ai/v1/marketplace/api/nft-floor \
  -H 'Content-Type: application/json' \
  -d '{}'

# 2. Pay it (the SDK signs and retries for you)
curl -X POST https://api.jarvisclaw.ai/v1/marketplace/api/nft-floor \
  -H 'Content-Type: application/json' \
  -H 'X-PAYMENT: <signed-payload>' \
  -d '{}'

Open in the marketplace