x402AgentTools

๐Ÿ“ˆNFT Collection Activity

Live transfer feed of an NFT collection with per-address accumulation analysis: net quantities received vs sent over recent activity, ranking the buyers adding to positions and the wallets exiting. The actionable view behind the raw transfer list.

Worked examples

BAYC recent activity

GET /api/v1/nft/collection-activity?contract=0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D&chain=ethereum&limit=20

Result: 20 recent transfers ยท 5 accumulating ยท 5 exiting

Machine API (x402)

$0.003 / call

This tool is also a JSON API for AI agents. Requests without payment receive 402 Payment Required plus instructions; agents pay USDC on Base via the x402 protocol โ€” no accounts, no API keys.

GET /api/v1/nft/collection-activity?contract=0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D&chain=ethereum&limit=20 HTTP/1.1
Host: agenttools-hub.vercel.app

โ†’ 402 (payment required, instructions in headers)
โ†’ 200 (after X-PAYMENT header; JSON body below)

{
  "tool": "nft/collection-activity",
  "input": {"contract":"0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D","chain":"ethereum","limit":20},
  "result": { "value": 20, "answer": "20 recent transfers ยท 5 accumulating ยท 5 exiting" }
}

Agent docs: /llms.txt ยท OpenAPI spec ยท integration guide

About this tool

Raw transfer lists don't answer the question agents actually have: who is accumulating and who is dumping? This tool nets recent transfers per address, ranks the buyers adding to positions and the wallets exiting, and returns both the human-readable feed and machine-readable rankings.

Frequently asked questions

What window does 'recent' cover?

The most recent transfers returned by the chain (typically the last few blocks to a few hours depending on collection velocity). It's a live pulse, not a historical report.

Do marketplace settlements count as accumulation?

Purchases via custodial marketplace contracts show the contract as the counterparty โ€” genuine buyer accumulation is visible as net-receiving wallets.

Related tools