# Blackhull Token Check

> Blackhull Token Check is a paid API for AI agents from blackhullsystems.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-31).

Returns live on-chain measured facts and risk flags for a single Base network ERC-20 token contract address

## Facts

- Endpoint: GET https://blackhullsystems.com/check/token?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blackhull-token-check-e3398385
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_yFiYeHtrM3N0bYQy3e6Za

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 blackhull-token-check-e3398385
```

Example prompt: Can you run a blackhull token check on the Base contract 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913 and tell me if it's upgradeable, can mint, and whether the owner is active?

## When to prefer this

Choose this endpoint when you need live, on-chain measured facts about a specific Base network token — particularly its risk profile (mint capability, upgradeability, owner activity) and liquidity signals. Prefer this over static token databases or CEX APIs when you need current chain state rather than cached metadata, and when the Base network is specifically relevant. It is well-suited for pre-trade screening, bot-driven risk checks, or agent workflows that must verify token safety before executing swaps or transfers.

## Known failure modes

- Invalid or malformed address (not 0x + 40 hex) returns an error
- Address is not a deployed contract on Base — may return empty or error response
- Contract exists but is not ERC-20 — checks may be empty or partial
- Rate limiting or payment failure (x402) if USDC not provided
- Network latency or RPC issues may cause delayed or failed responses

## How this service works

Blackhull measures the agent economy and sells AI agents the check they run before they pay another service.

## Output

A JSON object containing an array of risk/status codes (e.g. OWNER_ACTIVE, CAN_MINT, UPGRADEABLE, V3_WETH_LIQUIDITY), a checks object with ERC-20 verification results including symbol and decimals, and the queried contract address — all sourced live from the Base chain.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "address": {
       "type": "string",
       "description": "the token contract address on Base (0x + 40 hex)"
      }
     }
    }
   }
  },
  "output": {
   "type": "object",
   "properties": {
    "type": {
     "const": "json"
    },
    "schema": {
     "type": "object"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "codes": [
   "OWNER_ACTIVE",
   "CAN_MINT",
   "UPGRADEABLE",
   "V3_WETH_LIQUIDITY"
  ],
  "checks": {
   "erc20": {
    "value": true,
    "evidence": {
     "symbol": "USDC",
     "decimals": 6
    }
   }
  },
  "address": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blackhull-token-check-e3398385/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from blackhullsystems.com](https://www.zero.xyz/host/blackhullsystems.com/llms.txt)