{"slug":"api-hivemindos-app-v1-x402-onchain-intelligence-tokens-flows-15cedc","title":"Token flows by holder group","host":"api.hivemindos.app","method":"POST","resource":"https://api.hivemindos.app/v1/x402/onchain-intelligence/tokens.flows","category":"market","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 i","price_listed":0.05,"price_asked":0.05,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":229,"reported_calls_30d":3,"reported_payers_30d":2,"networks":["eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"chain":"base","label":"exchange","tokenAddress":"0x4ed4e862860bed51a9570b96d89af5e1b0efefed"},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"additionalProperties":false,"anyOf":[{"required":["tokenAddress","chain"]},{"required":["request"]}],"properties":{"chain":{"description":"Chain name, such as base, ethereum or solana.","type":"string"},"date":{"description":"The window to read, as YYYY-MM-DD dates. Defaults to recent days.","properties":{"from":{"format":"date","type":"string"},"to":{"format":"date","type":"string"}},"required":["from","to"],"type":"object"},"label":{"enum":["exchange","whale","public_figure","top_100_holders"],"type":"string"},"request":{"description":"The read in plain words, naming the address, $SYMBOL, chain or exchange.","maxLength":2000,"type":"string"},"tokenAddress":{"description":"EVM address (0x…) or Solana address.","type":"string"}},"type":"object"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"method":{"enum":["POST"],"type":"string"},"type":{"const":"http","type":"string"}},"required":["type","method","bodyType","body"],"type":"object"},"output":{"properties":{"example":{"properties":{"chargedCredits":{"description":"Agent Credits the service charged (500 = $1).","type":"number"},"followUp":{"description":"apiKey holding the credits the call did not use, or null when none are left.","properties":{"apiKey":{"type":"string"},"keyId":{"type":["string","null"]},"remainingCredits":{"type":"number"},"use":{"type":"string"}},"type":["object","null"]},"ok":{"description":"true when the call worked; a failed call is never charged.","type":"boolean"},"operationId":{"type":"string"},"result":{"description":"Inflows and outflows of the token for the chosen holder group over time."},"serviceId":{"type":"string"},"status":{"description":"The service's own HTTP status.","type":"integer"},"x402":{"description":"The payment: settled only after the call worked.","properties":{"charged":{"type":"boolean"},"network":{"type":["string","null"]},"payer":{"type":["string","null"]},"priceUsd":{"type":"number"},"receiptId":{"type":"string"},"transaction":{"type":["string","null"]}},"type":"object"}},"required":["ok","x402"],"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-10-24","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.05,"price_match":true,"latency_ms":229,"error":null}],"description_full":"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.","last_updated":"2026-10-23T12:01:04.114Z","schemes":["exact"]}