# HivemindOS Token Transfers

> HivemindOS Token Transfers is a paid API for AI agents from api.hivemindos.app, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-30).

Returns the largest recent token transfers for a specific token, showing large-holder and exchange movements on-chain

## Facts

- Endpoint: POST https://api.hivemindos.app/v1/x402/onchain-intelligence/tokens.transfers?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hivemindos-token-transfers-c46369e6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_KODvYV36PIdVk8KZtytZa

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability hivemindos-token-transfers-c46369e6 -d '<json body>'
```

Example prompt: Show me the largest transfers of $LINK on Ethereum over the past 3 days, sorted by volume descending — I want to see if big holders are moving into exchanges right now.

## When to prefer this

Use this endpoint when you need to understand real-time or recent large-holder behavior for a specific token — particularly whether whales or exchanges are accumulating or distributing. It is distinct from general market activity endpoints (use Market Scout for broad market scanning) and from perp position endpoints. Best for: detecting exchange inflows/outflows, tracking smart-money wallet activity, and spotting unusual transfer spikes for a token before or after price moves.

## Known failure modes

- Unknown or misspelled token symbol returns no results
- Unsupported chain name causes a validation error
- Date range too far in the past may return empty or incomplete data
- Invalid EVM or Solana token address returns an error
- Payment failure in USDC on Base results in a 402 response and no data returned
- Overly broad request with no token specified may return ambiguous results

## How this service works

Token transfers: the largest recent transfers of one token, including moves into and out of exchanges. Use when an agent needs to see whether large holders or exchanges are moving a token right now. $0.05 this call, in USDC on Base; you pay only if it succeeds. HivemindOS SuperAgent API.

## Output

A ranked list of the largest token transfers within the requested date window, including sender and receiver addresses, transfer amounts in USD, token quantities, and whether the transfers involved exchange addresses (indicating exchange inflows or outflows). Results can be sorted and filtered by value, market cap, or other criteria.

## Request schema (JSON Schema)

```json
{
 "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."
  },
  "filters": {
   "type": "object",
   "description": "Optional narrowing, such as a minimum USD value or market cap."
  },
  "orderBy": {
   "type": "array",
   "maxItems": 3,
   "description": "Optional sort, e.g. [{ field: \"volume\", direction: \"DESC\" }]."
  },
  "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."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hivemindos-token-transfers-c46369e6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.hivemindos.app](https://www.zero.xyz/host/api.hivemindos.app/llms.txt)