# Token Holder Observations — Valid Row Export

> Token Holder Observations — Valid Row Export 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 of token holder observation data and exports only the rows that pass all declared contract rules, up to 1000 rows.

## Facts

- Endpoint: POST https://market.datapackvibe.com/x402/assistant-bx-csv-token-holders-valid-rows?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-valid-row-export-40a84478
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2EgR95Lki3laP57oY701E

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-valid-row-export-40a84478 -d '<json body>'
```

Example prompt: Can you validate my token holder observations CSV and export only the valid rows? The data uses comma delimiters, holder counts should be between 0 and 1000000, allowed token groups are group-a and group-b, and each cell shouldn't exceed 500 characters.

## When to prefer this

Use this endpoint when you need to enforce a declared CSV table contract on token holder observation data specifically — validating value ranges, allowed categories, and cell lengths without any external enrichment or lookups. Prefer this over generic CSV validators when your data follows the token holder observations schema (observation_id, observed_on, token_address, holder_count, circulating_tokens) and you need a clean export of only conforming rows.

## Known failure modes

- CSV exceeds 100,000 character limit — request rejected
- CSV has zero rows or is empty — validation cannot proceed
- Delimiter mismatch causes all rows to appear malformed
- Values outside the specified minimum/maximum range cause rows to be filtered out
- Categories not in allowed_categories list cause those rows to fail validation
- Cell content exceeding max_cell_length causes row rejection
- Malformed CSV structure (unclosed quotes, wrong column count) may cause parse errors

## How this service works

Token holder observations — Valid row export: Valid row export 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 valid row export report.

## Output

A valid row export report listing which rows from the submitted token holder observations CSV passed all declared contract rules (value ranges, allowed categories, cell length limits), covering up to 1000 rows. Rows failing any constraint are excluded from the output.

## 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-valid-row-export-40a84478/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)