# Token Holder Observations — Category Allowlist Check

> Token Holder Observations — Category Allowlist 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 a CSV table of token holder observations by checking that category values fall within a user-defined allowlist of permitted categories.

## Facts

- Endpoint: POST https://market.datapackvibe.com/x402/assistant-bx-csv-token-holders-categories?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-category-allowlist-check-ca5ea398
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cvdHY0G_A7oWOM2KLICga

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-category-allowlist-check-ca5ea398 -d '<json body>'
```

Example prompt: Can you validate my token holder observations CSV and check that all the category values are within my allowed list of ["group-a", "group-b", "group-c"]? The CSV uses comma delimiters and has up to 500 rows.

## When to prefer this

Choose this endpoint when you have a structured CSV of token holder observations and need to enforce that category fields (such as token address groups) only contain values from a predefined allowlist. It is purpose-built for this specific validation pattern and includes support for quoted cells and configurable delimiters. Prefer it over general-purpose validators when working within the token holder observation data model.

## Known failure modes

- CSV exceeds 1000 rows — only up to 1000 rows are validated
- CSV string exceeds 100,000 character limit — request rejected
- No allowed_categories provided — all categories may be flagged or no check performed
- Invalid delimiter specified — parsing errors on non-comma/semicolon/tab input
- Cell length exceeds max_cell_length — row may be rejected or truncated
- Malformed CSV with unmatched quotes — parsing failure

## How this service works

Token holder observations — Category allowlist check: Category allowlist 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 category allowlist check report.

## Output

A category allowlist check report indicating which rows in the token holder observations CSV contain category values outside the declared allowed list, along with a summary of compliant and non-compliant entries across up to 1000 rows.

## 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-category-allowlist-check-ca5ea398/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)