NFT 价格追踪器

使用免费 API 追踪 NFT 系列的统计数据、地板价（floor price）及近期成交记录。

免费 API（无需密钥）

Reservoir API（推荐）

获取系列地板价：

curl -s "https://api.reservoir.tools/collections/v6?slug=boredapeyachtclub" | jq '.collections[0] | {name, floorAsk: .floorAsk.price.amount.native, volume24h: .volume["1day"], volumeChange: .volumeChange["1day"]}'

热门系列 slug

• boredapeyachtclub — Bored Ape Yacht Club（BAYC）
• mutant-ape-yacht-club — Mutant Ape Yacht Club（MAYC）
• cryptopunks — CryptoPunks
• azuki — Azuki
• pudgypenguins — Pudgy Penguins
• doodles-official — Doodles
• clonex — CloneX

系列统计数据

获取详细的系列统计数据：

curl -s "https://api.reservoir.tools/collections/v6?slug=mutant-ape-yacht-club" | jq '.collections[0] | {
  name: .name,
  floor_eth: .floorAsk.price.amount.native,
  floor_usd: .floorAsk.price.amount.usd,
  volume_24h: .volume["1day"],
  volume_7d: .volume["7day"],
  volume_30d: .volume["30day"],
  owners: .ownerCount,
  supply: .tokenCount
}'

近期成交记录

获取某一系列的近期成交数据：

curl -s "https://api.reservoir.tools/sales/v6?collection=0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d&limit=10" | jq '.sales[] | {token_id: .token.tokenId, price_eth: .price.amount.native, timestamp: .timestamp, marketplace: .orderSource}'

合约地址：

• BAYC：0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d
• MAYC：0x60e4d786628fea6478f785a6d7e704777c86a7c6
• CryptoPunks：0xb47e3cd837ddf8e4c57f05d70ab865de6e193bbb

地板价历史数据

获取随时间变化的地板价：

curl -s "https://api.reservoir.tools/collections/daily-volumes/v1?collection=0x60e4d786628fea6478f785a6d7e704777c86a7c6&limit=30" | jq '.[] | {date: .timestamp, floor: .floorAskPrice, volume: .volume}'

热门系列榜单

按交易量获取 Top 系列：

curl -s "https://api.reservoir.tools/collections/v6?sortBy=1DayVolume&limit=10" | jq '.collections[] | {name: .name, floor: .floorAsk.price.amount.native, volume_24h: .volume["1day"]}'

代币查询

获取某个特定 NFT 的详细信息：

# MAYC #1234
curl -s "https://api.reservoir.tools/tokens/v7?tokens=0x60e4d786628fea6478f785a6d7e704777c86a7c6:1234" | jq '.tokens[0] | {name: .token.name, image: .token.image, lastSale: .token.lastSale.price.amount.native, owner: .token.owner}'

价格提醒（脚本示例）

持续监控地板价，并在低于阈值时发出提醒：

#!/bin/bash
COLLECTION="mutant-ape-yacht-club"
THRESHOLD=5  # ETH

FLOOR=$(curl -s "https://api.reservoir.tools/collections/v6?slug=$COLLECTION" | jq -r '.collections[0].floorAsk.price.amount.native')

if (( $(echo "$FLOOR < $THRESHOLD" | bc -l) )); then
  echo "ALERT: $COLLECTION floor is $FLOOR ETH (below $THRESHOLD ETH)"
fi

OpenSea API（需密钥）

若你已拥有 OpenSea API 密钥：

curl -s "https://api.opensea.io/api/v2/collections/mutant-ape-yacht-club/stats" 
  -H "X-API-KEY: $OPENSEA_API_KEY" | jq '.'

使用提示

• Reservoir API 免费且对基础查询无需身份认证
• 存在调用频率限制，请尽可能缓存响应结果
• 除非特别说明，价格单位默认为 ETH
• 进行精确查询时请使用合约地址；便捷查询可使用 slug