# HyperD Token Archetype Classifier

> HyperD Token Archetype Classifier is a paid API for AI agents from api.hyperd.ai, paid per call via x402, $0.3/call, status unknown (last checked 2026-09-15).

Classifies a token contract into a semantic archetype (stablecoin, blue_chip, mid_cap, memecoin, wrapped, governance, or unverified) with a plain-language verdict by fanning out to token_info, token_security, and protocol_tvl.

## Facts

- Endpoint: GET https://api.hyperd.ai/api/token/archetype
- Price: $0.3/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hyperd-token-archetype-classifier-811879cb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_gVTtoPosJnwf3FS5zsSgF

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 hyperd-token-archetype-classifier-811879cb
```

Example prompt: What archetype is the token at contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum — is it a stablecoin, blue chip, memecoin, or something else, and what's the plain-language verdict?

## When to prefer this

Use this endpoint when you need a single, synthesized, human-readable classification of a token rather than raw metrics. It is ideal when an agent needs to quickly decide how to treat an unknown token (e.g., is it safe to route funds through, is it a governance asset, is it speculative?) without making multiple separate calls to token_info, token_security, and TVL APIs and aggregating the results manually.

## Known failure modes

- Contract address not found on the specified chain — returns error or unverified archetype
- Unsupported chain specified — validation error listing allowed chains
- Downstream fan-out failure (token_info, token_security, or protocol_tvl unavailable) — partial or degraded response
- Malformed contract address format — returns 400-level validation error
- Payment not provided or insufficient — 402 Payment Required

## How this service works

Composed token classification. Fans out to token_info, token_security, protocol_tvl and returns a single archetype (stablecoin / blue_chip / mid_cap / memecoin / wrapped / governance / unverified) plus a plain-language verdict.

## Output

A single token archetype label (one of: stablecoin, blue_chip, mid_cap, memecoin, wrapped, governance, unverified) plus a human-readable plain-language verdict summarizing why the token received that classification, synthesized from token metadata, security signals, and protocol TVL data.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "contract"
     ],
     "properties": {
      "chain": {
       "enum": [
        "base",
        "ethereum",
        "polygon",
        "arbitrum",
        "optimism",
        "avalanche",
        "bnb"
       ],
       "type": "string"
      },
      "contract": {
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hyperd-token-archetype-classifier-811879cb/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.hyperd.ai](https://www.zero.xyz/host/api.hyperd.ai/llms.txt)