# Token Holder Observations — Numeric Type Check

> Token Holder Observations — Numeric Type 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 that all numeric columns in a token holder observations CSV conform to expected numeric types, range bounds, and allowed categories.

## Facts

- Endpoint: POST https://market.datapackvibe.com/x402/assistant-bx-csv-token-holders-types?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-numeric-type-check-8874ab0d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_eZ61U3at6SbRYip1jDlHK

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-numeric-type-check-8874ab0d -d '<json body>'
```

Example prompt: Can you run a numeric type check on my token holder observations CSV? It uses comma delimiters, and I want to make sure holder_count and circulating_tokens are valid numbers between -1000000000000 and 1000000000000 — here's the CSV data: 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

## When to prefer this

Choose this endpoint when you need lightweight, fast numeric type validation specifically for token holder observation CSVs (up to 1000 rows), with support for quoted cells, configurable delimiters, and bounded numeric ranges. Ideal for pre-ingestion QA pipelines, data contract enforcement, or automated checks on crypto token holder snapshots. Not suitable for datasets exceeding 1000 rows or for non-numeric validations like date or string format checks.

## Known failure modes

- CSV exceeds 100,000 character limit — request rejected
- CSV contains more than 1000 rows — only first 1000 processed or error returned
- Invalid delimiter specified — must be comma, semicolon, or tab
- Malformed CSV that cannot be parsed — parse error returned
- min/max values outside allowed range of -1000000000000 to 1000000000000
- Cell length exceeds max_cell_length setting — validation error
- Payment not included or insufficient — x402 payment required error

## How this service works

Token holder observations — Numeric type check: Numeric type 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 numeric type check report.

## Output

A numeric type check report covering up to 1000 rows of the submitted CSV, identifying which cells or rows fail numeric type expectations, fall outside specified min/max bounds, or contain disallowed category values. The report includes conformance status per column and row-level error details.

## 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-numeric-type-check-8874ab0d/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)