agentutility(7)$ man nft-floor
/nft-floor
PRICE / CALL
$0.01
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
edgemarketCATEGORY
uncategorized
STATUS
● live
NAME
nft-floor — returns an nft collection's floor price and market stats from coingecko
SYNOPSIS
POST https://x402.agentutility.ai/nft-floor
Content-Type: application/json
X-PAYMENT: <signed-transferWithAuthorization>
{ ... }↳ first call →
402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.DESCRIPTION
Returns an NFT collection's floor price and market stats from CoinGecko. Send a CoinGecko collection slug and get floor price in the native token and USD, market cap, 24h volume, floor change over 24h/7d/30d/1y, market cap rank, holder count, and total supply. Covers the NFT collections CoinGecko tracks across major chains. Use it as an NFT floor price API, collection market cap lookup, or NFT floor tracker.
INPUT — request schema
| property | type | description | req? |
|---|---|---|---|
| collection | string | CoinGecko NFT collection slug, e.g. 'bored-ape-yacht-club'. The only input the handler reads. | required |
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.agentutility.ai/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 the MCP package for this endpoint's cluster npx -y @agentutility/mcp-<cluster> # Required: EVM private key with USDC on Base export X402_PRIVATE_KEY=0x... # Then call the nft-floor tool from your MCP-aware agent.
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 | Returns verified source code and ABI for any deployed contract on Ethereum, Base, Optimism, Arbitrum, or Polygon. | $0.01 |
| contract-source-verified | Fetches verified contract source code and ABI for a deployed contract on Ethereum, Optimism, Polygon, Base, or Arbitrum. | $0.01 |
| dex-liquidity-depth | Measures DEX liquidity depth by summing TVL across every DefiLlama-tracked yield pool holding a given ERC-20 on Ethereum, Base, Polygon,… | $0.01 |
| eth-logs | Reads on-chain event logs with generic eth_getLogs queries across Base, Ethereum, Arbitrum, Optimism, Polygon, and BSC via public no-auth… | $0.01 |
| lp-lock-check | Checks whether an LP token's liquidity is locked, useful for detecting rug-pull risk before swapping into a new pair. | $0.01 |
| agent-card-resolve | Resolves an ERC-8004 agentId to its on-chain owner, agentURI, and agent card JSON. | $0.005 |
| arbitrage-spread | Finds the cross-exchange arbitrage spread for any CoinGecko-listed coin. | $0.005 |
| basename-resolve | Resolves Coinbase Basenames (.base.eth) to Ethereum addresses and back, reading the Base mainnet L2 Resolver on-chain (no gas, no wallet). | $0.005 |
SEE ALSO