# Token Holder Observations — CSV Record Key Uniqueness Validator

> Token Holder Observations — CSV Record Key Uniqueness Validator 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 that record keys in a token holder observations CSV are unique, checking up to 1000 rows for duplicate primary keys.

## Facts

- Endpoint: POST https://market.datapackvibe.com/x402/assistant-bx-csv-token-holders-keys?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-record-key-uniqueness-validator-bb26d5ed
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1b90ps6k689Fhg6PEGtzG

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-record-key-uniqueness-validator-bb26d5ed -d '<json body>'
```

Example prompt: Can you check my token holder observations CSV for duplicate record keys? Here's the CSV with comma delimiter — make sure observation_id values are all unique across up to 1000 rows.

## When to prefer this

Choose this endpoint when you need a fast, affordable ($0.01 USDC) check specifically for record key uniqueness in token holder observation CSVs, up to 1000 rows, with support for quoted cells and configurable delimiters. Prefer it over general-purpose CSV validators when your data matches the token holder observation schema (observation_id, observed_on, token_address, holder_count, circulating_tokens) and you only need primary key deduplication without external enrichment.

## Known failure modes

- CSV exceeds 100,000 character limit — request rejected
- More than 1000 rows submitted — validation truncated or rejected
- Invalid delimiter specified — parsing error returned
- Cell content exceeds max_cell_length — row flagged or rejected
- Malformed CSV with unclosed quotes — parse failure
- Empty CSV body — validation cannot proceed

## How this service works

Token holder observations — Record key uniqueness: Record key uniqueness 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 record key uniqueness report.

## Output

A structured report indicating whether all record keys in the submitted token holder observations CSV are unique, identifying any duplicate keys found across up to 1000 rows, with details on which keys collide and their row positions.

## 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-record-key-uniqueness-validator-bb26d5ed/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)
