# HivemindOS New Token Discovery

> HivemindOS New Token Discovery 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-28).

Screens one or more blockchains for newly listed or fast-moving tokens, filterable and sortable by age, market cap, volume, or liquidity

## Facts

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

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-new-token-discovery-59eeebbd -d '<json body>'
```

Example prompt: Screen Base and Solana for new tokens launched in the last 24 hours, sorted by volume descending, and only show ones with at least $50k in liquidity.

## When to prefer this

Choose this endpoint when an agent needs to proactively discover newly listed or fast-moving tokens across one or more chains, especially for trading research or momentum screening workflows. Prefer it over the general market scout endpoint when the focus is specifically on new token launches or tokens gaining velocity, and when filtering by age, market cap, volume, or liquidity is required.

## Known failure modes

- Invalid or unsupported chain name returns an error
- Date range with 'from' after 'to' causes a validation failure
- More than 8 chains specified exceeds the maxItems limit
- Payment failure on Base USDC results in no response
- Empty result set if no tokens match the specified filters
- Unsupported timeframe enum value causes a schema error

## How this service works

New token discovery: screens chains for new or fast-moving tokens, filtered and sorted by age, market cap, volume or liquidity. Use when an agent is screening a chain for new or fast-moving tokens to research or trade. $0.05 this call, in USDC on Base; you pay only if it succeeds. HivemindOS SuperAgent API.

## Output

A ranked list of tokens matching the screen criteria, including token identifiers, chain, age, market cap, volume, and liquidity metrics, ordered by the requested sort fields.

## 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."
  },
  "chains": {
   "type": "array",
   "items": {
    "type": "string"
   },
   "maxItems": 8,
   "minItems": 1,
   "description": "Chain names to cover, such as base and 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."
  },
  "timeframe": {
   "enum": [
    "1h",
    "6h",
    "24h",
    "7d",
    "30d"
   ],
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hivemindos-new-token-discovery-59eeebbd/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)
