# Token Holder Observations — Numeric Range Check

> Token Holder Observations — Numeric Range 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-16).

Validates numeric columns in a token holder observations CSV table by checking that all values fall within a specified minimum/maximum range.

## Facts

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

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-range-check-b158dec9 -d '<json body>'
```

Example prompt: Check my token holder observations CSV for any numeric values outside the range of 0 to 1,000,000 — here's the CSV with columns observation_id, observed_on, token_address, holder_count, and circulating_tokens, comma-delimited, and flag anything out of range.

## When to prefer this

Choose this endpoint when you need to validate that numeric fields in a token holder observations CSV conform to expected bounds, particularly for blockchain/DeFi datasets tracking holder counts and circulating supply. It is purpose-built for this schema (observation_id, observed_on, token_address, holder_count, circulating_tokens) with category-aware validation and no external enrichment, making it fast and deterministic. Prefer it over general CSV validators when your data is specifically structured as token holder observations and you need a focused range-check report.

## Known failure modes

- CSV exceeds 100,000 character limit — request rejected
- CSV contains more than 1,000 rows — only first 1,000 may be processed
- Malformed CSV that cannot be parsed — error returned
- Minimum value greater than maximum value — invalid range error
- Cell length exceeds max_cell_length setting — cell flagged or truncated
- Payment not provided or invalid — 402 Payment Required

## How this service works

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

## Output

A numeric range check report identifying which cells or rows in the token holder observations CSV contain values outside the specified minimum/maximum bounds, covering up to 1,000 rows with support for quoted cells and configurable delimiter and cell length settings.

## 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-range-check-b158dec9/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)