# Token Holder Observations — CSV Validation Summary

> Token Holder Observations — CSV Validation Summary 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 (up to 1000 rows) and returns a structured validation summary report.

## Facts

- Endpoint: POST https://market.datapackvibe.com/x402/assistant-bx-csv-token-holders-summary?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-csv-validation-summary-d80ed011
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_gd_6RUxyla8TGQ0JW4V49

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-validation-summary-d80ed011 -d '<json body>'
```

Example prompt: Can you validate this token holder observations CSV for me — use a comma delimiter, limit cell length to 500 characters, and only allow categories 'group-a' and 'group-b', with holder counts between 0 and 1000000: 'observation_id,observed_on,token_address,holder_count,circulating_tokens\nrecord-1,2026-01-01,group-a,50,100'?

## When to prefer this

Choose this endpoint when you need a fast, structured validation summary for a CSV dataset specifically containing token holder observations (with fields like observation_id, observed_on, token_address, holder_count, circulating_tokens), and want to enforce category allowlists and numeric range constraints without any external data enrichment. It is purpose-built for this data shape and returns a concise summary report rather than row-level detail.

## Known failure modes

- CSV exceeds 100,000 character limit — request rejected
- CSV contains fewer than 1 character — request rejected
- Delimiter not one of comma, semicolon, or tab — validation error
- Row count exceeds 1000 — only first 1000 rows may be processed
- max_cell_length out of allowed range (1–5000) — request rejected
- allowed_categories list exceeds 100 items — request rejected
- Malformed JSON body — 400 error
- Payment not included or insufficient — 402 Payment Required

## How this service works

Token holder observations — Validation summary: Validation summary 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 validation summary report.

## Output

A structured validation summary report covering the submitted CSV, including counts of valid and invalid rows, details of any cell length violations, out-of-range numeric values, disallowed category values, and overall pass/fail status — up to 1000 rows analyzed.

## 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-validation-summary-d80ed011/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)