# HivemindOS Token Intelligence Brief

> HivemindOS Token Intelligence Brief 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 live market intelligence for a single crypto token: money flows, recent buyers/sellers, price history, and optionally recent DEX trades.

## Facts

- Endpoint: POST https://api.hivemindos.app/v1/x402/onchain-intelligence/tokens.brief?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-intelligence-brief-8f7defff
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-U4xnxresn_MSE5Q97_U7

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-intelligence-brief-8f7defff -d '<json body>'
```

Example prompt: Pull the on-chain market brief for $WIF on Solana for the past 7 days — I want to see who's been buying and selling, how money has been flowing, price history, and include the recent DEX trades too.

## When to prefer this

Choose this endpoint when an agent needs a fast, structured snapshot of a single token's on-chain market activity — specifically buyer/seller identity, money flows, and price history — before making a trade decision, generating a market report, or evaluating a listing. Prefer this over general search or news endpoints when the question is specifically about who is trading a token and how capital is moving. Use the includeTrades flag when DEX-level granularity is needed.

## Known failure modes

- Token address not found on the specified chain — returns error or empty result
- Unsupported chain name provided — returns validation error
- Date range too wide or outside available history — may return partial data
- Invalid EVM or Solana address format — returns parsing error
- Payment failure via x402 USDC — call does not execute and no data is returned
- Network or RPC issues for the target chain — may cause timeout or incomplete data

## How this service works

Token intelligence: money flows, recent buyers and sellers and price history for one token, with its DEX trades on request. Use when an agent needs a token's live market picture (who is buying and selling, money flows and price history) before trading, listing or reporting on it. $0.05 this call, in USDC on Base; you pay only if it succeeds. HivemindOS SuperAgent API.

## Output

Returns a structured brief for the specified token including: capital/money flow metrics, a list of recent on-chain buyers and sellers with amounts, price history over the requested date window, and (if includeTrades=true) a list of recent DEX trades with timestamps, pairs, and volumes.

## 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."
  },
  "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."
  },
  "includeTrades": {
   "type": "boolean",
   "description": "Also return its recent DEX trades."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hivemindos-token-intelligence-brief-8f7defff/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)