Token flows by holder group
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.
Answeringour last check, 2026-10-24
1 of 1checks answered this week
229 msmedian answer time
$0.05listed price per call
$0.05price it asked us
Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.
Endpoint
POST https://api.hivemindos.app/v1/x402/onchain-intelligence/tokens.flows
| Category | Market data |
|---|---|
| Provider host | api.hivemindos.app |
| Networks | eip155:8453 |
| Payment schemes | exact |
| Self-reported calls, 30 days | 3 from 2 payers (the provider's figure, not ours) |
Our checks, last 30 days
| Day | Result | HTTP | Asked | Time |
|---|---|---|---|---|
| 2026-10-24 | valid payment request | 402 | $0.05 | 229 ms |
Example input (from the provider)
{
"body": {
"chain": "base",
"label": "exchange",
"tokenAddress": "0x4ed4e862860bed51a9570b96d89af5e1b0efefed"
},
"bodyType": "json",
"method": "POST",
"type": "http"
}
Promised output schema (from the provider)
{
"$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\u2026) 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"
}