# Token Holder Observations — CSV Header Contract Check

> Token Holder Observations — CSV Header Contract 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-12).

Validates the CSV header contract (column names, types, and value constraints) for token holder observation data, supporting up to 1000 rows.

## Facts

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

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-csv-header-contract-check-64f96147 -d '<json body>'
```

Example prompt: Can you check whether my token holder observations CSV has the right headers and valid data? It uses comma delimiters, holder counts between 0 and 1,000,000, and allowed category values of 'group-a' and 'group-b'.

## When to prefer this

Use this endpoint when you need a lightweight, contract-focused validation of a token holder observations CSV — specifically checking headers, value ranges, cell lengths, and category allowlists — without any external enrichment or complex schema inference. It is purpose-built for the token holder observation data shape (observation_id, observed_on, token_address, holder_count, circulating_tokens) and ideal for pre-upload quality gates or regression checks in DeFi data pipelines.

## Known failure modes

- CSV exceeds 100,000 character limit — request rejected
- CSV has fewer than 1 character — validation fails
- Delimiter not in allowed set (comma, semicolon, tab) — schema error
- Allowed categories list exceeds 100 items — rejected
- Cell length exceeds max_cell_length threshold — row-level violation reported
- Malformed CSV with unclosed quotes — parser error
- Numeric values outside declared minimum/maximum bounds — contract violation flagged

## How this service works

Token holder observations — Header contract check: Header contract 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 header contract check report.

## Output

A header contract check report indicating whether the CSV's column headers and data values conform to the declared schema, including any violations in column names, value ranges, cell lengths, or category allowlists, covering 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-csv-header-contract-check-64f96147/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)