# Token Holder Observations — Required Cell Check

> Token Holder Observations — Required Cell Check is a paid API for AI agents from market.datapackvibe.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-15).

Validates that required cells in a token holder observations CSV are non-empty and conform to declared constraints, returning a report of violations.

## Facts

- Endpoint: POST https://market.datapackvibe.com/x402/assistant-bx-csv-token-holders-required?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/token-holder-observations-required-cell-check-a52519d0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ADtKgt9xaFJu7C3l9c8b-

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 token-holder-observations-required-cell-check-a52519d0 -d '<json body>'
```

Example prompt: Check my token holder observations CSV for any missing required cells — it uses a comma delimiter, up to 1000 rows, and the allowed categories are group-a and group-b; give me a full required-cell violation report.

## When to prefer this

Use this endpoint when you specifically need to validate that required cells in a token holder observations CSV are present and conform to declared constraints (numeric range, allowed categories, cell length), without any external enrichment or transformation. It is purpose-built for the token holder observations schema and is preferable to generic CSV validators when you need a structured violation report tailored to that data model at a low per-call cost.

## Known failure modes

- CSV exceeds 1000 rows — only up to 1000 rows are validated
- CSV string exceeds 100,000 character limit — request rejected
- Invalid delimiter specified — must be comma, semicolon, or tab
- Cell value exceeds max_cell_length — flagged as violation
- Malformed CSV (unmatched quotes, inconsistent columns) — parse error returned
- Allowed categories list exceeds 100 entries — request rejected
- Payment not included or insufficient — x402 payment required error

## How this service works

Token holder observations — Required cell check: Required cell check for Token holder observations. Validate a declared CSV table contract, up to 1000 rows. Quoted cells supported; no external enrichment. Specialised preset in a shared 50-profile, 20-operation engine. 0.01 USDC includes one CSV required cell check report.

## Output

A structured report identifying which rows and cells in the token holder observations CSV fail the required-cell contract — including which fields are missing, empty, or violate the declared constraints such as numeric range, cell length, or category allowlist. Up to 1000 rows are checked per call.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "csv": {
   "type": "string",
   "default": "observation_id,observed_on,token_address,holder_count,circulating_tokens\nrecord-a,2026-01-01,group-a,10,2\nrecord-b,2026-01-02,group-b,20,3",
   "maxLength": 100000,
   "minLength": 1
  },
  "maximum": {
   "type": "number",
   "default": 1000000000000,
   "maximum": 1000000000000,
   "minimum": -1000000000000
  },
  "minimum": {
   "type": "number",
   "default": -1000000000000,
   "maximum": 1000000000000,
   "minimum": -1000000000000
  },
  "delimiter": {
   "enum": [
    ",",
    ";",
    "\t"
   ],
   "type": "string",
   "default": ","
  },
  "max_cell_length": {
   "type": "integer",
   "default": 1000,
   "maximum": 5000,
   "minimum": 1
  },
  "allowed_categories": {
   "type": "array",
   "items": {
    "type": "string",
    "default": "",
    "maxLength": 100,
    "minLength": 1
   },
   "default": [
    "group-a",
    "group-b"
   ],
   "maxItems": 100,
   "minItems": 0
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/token-holder-observations-required-cell-check-a52519d0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from market.datapackvibe.com](https://www.zero.xyz/host/market.datapackvibe.com/llms.txt)