{"uid":"cap_YaFb-LGfT_dadSc2iCA23","slug":"agenttools-nft-collection-accumulation-exit-analysis-3b25c519","name":"AgentTools NFT Collection Accumulation & Exit Analysis","description":"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. Use this when an agent needs to who is accumulating and who is exiting — right now.","url":"https://agentstoolshub.com/api/v1/nft/collection-activity?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["contract"],"properties":{"chain":{"enum":["ethereum","base"],"type":"string","description":"Chain"},"limit":{"type":"number","description":"Transfers to analyze"},"contract":{"type":"string","description":"Collection contract"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_PEc7OnSty3qjFBOzPlHu4","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a live transfer feed for an NFT collection with per-address net position analysis, ranking wallets by accumulation (net buys) versus exits (net sells) over recent activity.","exampleAgentPrompt":"Who's been accumulating and who's been exiting the Pudgy Penguins collection on Ethereum recently? Analyze the last 200 transfers and rank the wallets by net position change.","exampleUseCases":[{"title":"Spotting smart money NFT accumulation","prompt":"Check the last 100 transfers for the Bored Ape Yacht Club contract on Ethereum and tell me which wallets are adding the most to their positions — I want to know who the biggest accumulators are right now."},{"title":"Identifying NFT distribution and exit pressure","prompt":"For the Base chain NFT collection at contract 0xd4307e0acd12cf46fd6cf93bc264f5d5d1598792, who's been selling or exiting the most over recent activity? Give me the top wallets by net outflow."},{"title":"Live NFT market sentiment by wallet behavior","prompt":"I want to gauge sentiment on the Azuki collection on Ethereum — pull the last 150 transfers and show me whether the dominant wallet activity is accumulation or distribution, ranked by net quantity."}],"resultDescription":"Returns a structured feed of recent NFT transfers for the specified collection, aggregated per wallet address to show net quantity (tokens received minus tokens sent). Wallets are ranked in two groups: top accumulators (positive net, adding to positions) and top exiters (negative net, reducing or closing positions), giving an actionable snapshot of who is buying into and who is leaving the collection.","failureModes":["Missing or invalid contract address returns a validation error","Unsupported chain value (not ethereum or base) returns an enum validation error","Contract address not found on the specified chain may return empty results or a not-found error","Very low limit values may produce insufficient data for meaningful ranking","Rate limiting or payment failure (x402) blocks the request","Network latency or upstream RPC issues may cause timeout or partial data"],"whenToPreferThis":"Choose this endpoint when you need a real-time, actionable breakdown of NFT wallet behavior — specifically net accumulation vs. exit positioning — rather than raw transfer lists or floor price data. It is ideal for on-chain sentiment analysis, smart money tracking, and identifying conviction buyers or sellers at the wallet level. Prefer it over generic block explorers when you need the aggregation and ranking layer already computed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T12:50:14.272Z","isFirstParty":false,"canonicalSlug":"agenttools-nft-collection-accumulation-exit-analysis-3b25c519"}