# Beehive Token Brief

> Beehive Token Brief is a paid API for AI agents from engine.beehivewebstudio.com, paid per call via x402, $0.25/call, status unknown (last checked 2026-10-25).

Checks ERC-20 token decimals and total supply on Base at a recorded block, and verifies up to three factual claims about the token against cited evidence, returning supported/contradicted/unknown verdicts.

## Facts

- Endpoint: GET https://engine.beehivewebstudio.com/v1/token-briefs/brief?utm_source=zero.xyz
- Price: $0.25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-25
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/beehive-token-brief-5c3b73b2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_8AIoq50g0pBbFDrZAQfJr

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 beehive-token-brief-5c3b73b2
```

Example prompt: Can you check whether the claim 'Base USDC has 6 decimals' and 'total supply exceeds 1 billion' are supported by on-chain evidence for the USDC contract at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base?

## When to prefer this

Use this endpoint when you need to programmatically verify specific factual claims about a Base ERC-20 token's on-chain metadata (decimals, total supply) against cited evidence, and need a structured supported/contradicted/unknown verdict rather than a raw data lookup. Prefer it over general blockchain explorers when claim verification with evidence citation is required. Note: official coverage currently extends only to Base USDC; other tokens may yield 'unknown' results.

## Known failure modes

- Unsupported contract address (only Base USDC has full official coverage — other contracts may return 'unknown' verdicts)
- Invalid contract address format (must match 0x + 40 hex chars)
- Missing or reused Idempotency-Key header (must be a fresh 64-char lowercase hex string)
- Claim text exceeds 500 characters or is empty
- Network or provider error returning unavailable block data
- Payment not processed, resulting in 402 response

## How this service works

Check Base ERC-20 decimals and total supply at a recorded block, and up to three claims against cited evidence. Returns supported, contradicted, or unknown. Official project coverage currently includes Base USDC only. No safety verdict, liquidity, or holder analysis. One brief costs 0.25 USDC; retain your private Idempotency-Key for recovery.

## Output

Returns the token's ERC-20 decimals and total supply recorded at a specific block on the Base network, along with verdicts ('supported', 'contradicted', or 'unknown') for up to three submitted claims, each backed by cited evidence. Does not include safety ratings, liquidity analysis, or holder distribution 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",
    "queryParams",
    "headers"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "const": "GET"
    },
    "headers": {
     "type": "object",
     "required": [
      "Idempotency-Key"
     ],
     "properties": {
      "Idempotency-Key": {
       "type": "string",
       "pattern": "^[0-9a-f]{64}$",
       "description": "Generate a fresh cryptographically random 32-byte hex secret per purchase. Never reuse the example. Keep it for retries and recovery; do not disclose it."
      }
     },
     "additionalProperties": false
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "claim": {
       "type": "string",
       "maxLength": 500,
       "minLength": 1,
       "description": "First proposition to check."
      },
      "claim2": {
       "type": "string",
       "maxLength": 500,
       "minLength": 1
      },
      "claim3": {
       "type": "string",
       "maxLength": 500,
       "minLength": 1
      },
      "contractAddress": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$",
       "description": "Base ERC-20 contract; defaults to native USDC."
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type",
    "example"
   ],
   "properties": {
    "type": {
     "const": "json"
    },
    "example": {
     "type": "object"
    }
   },
   "additionalProperties": false
  }
 },
 "additionalProperties": false
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/beehive-token-brief-5c3b73b2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from engine.beehivewebstudio.com](https://www.zero.xyz/host/engine.beehivewebstudio.com/llms.txt)