{"uid":"cap_Vf1ZKBR1c0R_EOv2Gduap","slug":"hivemindos-token-flows-by-holder-group-6e63271a","name":"HivemindOS Token Flows by Holder Group","description":"Token flows by holder group: how much of one token flowed into and out of exchanges, whales, public figures or the top 100 holders over time. Use when an agent needs to know whether exchanges, whales or top holders are accumulating or selling a token. $0.05 this call, in USDC on Base; you pay only if it succeeds. HivemindOS SuperAgent API.","url":"https://api.hivemindos.app/v1/x402/onchain-intelligence/tokens.flows?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"date":{"type":"object","required":["from","to"],"properties":{"to":{"type":"string","format":"date"},"from":{"type":"string","format":"date"}},"description":"The window to read, as YYYY-MM-DD dates. Defaults to recent days."},"chain":{"type":"string","description":"Chain name, such as base, ethereum or solana."},"label":{"enum":["exchange","whale","public_figure","top_100_holders"],"type":"string"},"request":{"type":"string","maxLength":2000,"description":"The read in plain words, naming the address, $SYMBOL, chain or exchange."},"tokenAddress":{"type":"string","description":"EVM address (0x…) or Solana address."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_TH388CGOFbct44bDndvk2","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns net token inflows and outflows for a specific holder group (exchanges, whales, public figures, or top 100 holders) over a date range for a given token.","exampleAgentPrompt":"Can you check whether whales have been net buying or selling ETH on Ethereum over the past 7 days — from 2025-07-01 to 2025-07-08?","exampleUseCases":[{"title":"Whale accumulation check before trade","prompt":"I'm thinking of buying $WIF on Solana — can you tell me whether whales have been net accumulating or dumping it over the last two weeks, say from July 1 to July 14?"},{"title":"Exchange inflow spike investigation","prompt":"There's been a lot of talk about PEPE being sold off — can you pull the exchange inflows and outflows for PEPE on Ethereum from June 25 to July 5 so I can see if exchanges are really absorbing supply?"},{"title":"Top 100 holders distribution signal","prompt":"Check whether the top 100 holders of AERO on Base have been moving tokens in or out over the past 10 days — I want to know if they're quietly distributing before a potential drop."}],"resultDescription":"Returns time-series data showing how much of the specified token flowed into and out of the selected holder group (exchange, whale, public figure, or top 100 holders) over the requested date window, enabling net accumulation or distribution analysis.","failureModes":["Unknown or unsupported token address returns an error or empty result","Chain not supported for the requested token leads to a null response","Date range too far in the past may return incomplete or unavailable data","Invalid label enum value causes a validation error","Payment failure in x402 protocol results in no response and no charge"],"whenToPreferThis":"Use this endpoint when you need to understand the directional behavior of a specific holder group for a token — particularly whether exchanges, whales, public figures, or top-100 holders are accumulating or distributing. Prefer this over general market data endpoints when you need holder-segmented flow intelligence rather than price or volume data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T06:43:50.592Z","isFirstParty":false,"canonicalSlug":"hivemindos-token-flows-by-holder-group-6e63271a"}