# Batch Chunk Plan

> Batch Chunk Plan is a paid API for AI agents from api.delx.ai, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Computes an ordered list of bounded chunk offsets and counts given a total item count and a desired chunk size, returning a versioned deterministic JSON plan.

## Facts

- Endpoint: POST https://api.delx.ai/api/v1/x402/batch-chunk-plan
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/batch-chunk-plan-68232740
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_U-rsN07dkV-s0Kiml7udb

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 batch-chunk-plan-68232740 -d '<json body>'
```

Example prompt: Split 8500 items into chunks of 200 and give me the full ordered chunk plan with counts and offsets.

## When to prefer this

Use this endpoint when an agent needs a precise, deterministic, versioned chunk plan before handing structured batch data to a downstream tool with a strict payload or size contract. Prefer it over writing ad-hoc chunking logic inline when you need reproducible, normalized chunk boundaries with a guaranteed result schema. Ideal for orchestration pipelines where chunk metadata (offsets, counts, total batches) must be passed downstream explicitly.

## Known failure modes

- item_count or chunk_size missing or non-integer returns a validation error
- chunk_size of zero or negative causes a division error
- item_count of zero may return an empty chunk plan or an error
- payment of $0.001 USDC not provided or rejected by x402 results in a 402 Payment Required response
- very large item counts may hit server-side bounds limits

## How this service works

Batch Chunk Plan: Batch Chunk Plan plans ordered bounded chunks from item count and chunk size from bounded caller-supplied values without an external provider. Call Batch Chunk Plan before an agent hands structured data or a batch plan to a downstream tool with a stricter contract. Returns the bounded transformation or validation finding with counts, normalized values, and a versioned result contract for Batch Chunk Plan as versioned deterministic JSON. Price: $0.001 USDC via x402 on Base. Fir…

## Output

Returns a versioned deterministic JSON object containing the ordered list of chunk definitions — each chunk has an index, start offset, and item count — along with aggregate counts (total items, total chunks, chunk size used) and normalized values, all wrapped in a versioned result contract.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chunk_size": {
   "type": "integer",
   "description": "Chunk Size supplied to Batch Chunk Plan; used only for this bounded calculation and processed in memory without retention."
  },
  "item_count": {
   "type": "integer",
   "description": "Item Count supplied to Batch Chunk Plan; used only for this bounded calculation and processed in memory without retention."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "result": {
   "chunks": [
    {
     "count": 25,
     "index": 0,
     "start": 0,
     "end_exclusive": 25
    },
    {
     "count": 25,
     "index": 1,
     "start": 25,
     "end_exclusive": 50
    },
    {
     "count": 25,
     "index": 2,
     "start": 50,
     "end_exclusive": 75
    },
    {
     "count": 25,
     "index": 3,
     "start": 75,
     "end_exclusive": 100
    }
   ],
   "chunk_count": 4
  },
  "schema": "delx/util-batch-chunk-plan/v1",
  "status": "pass",
  "evidence": {
   "retained": false,
   "input_sha256": "1c1864f89fcfbfd9c21b66bbe5be9c8be513a1fb836166a02d8125ac169ca095",
   "external_calls": 0
  },
  "operation": "data_batch:batch_chunk_plan"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/batch-chunk-plan-68232740/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.delx.ai](https://www.zero.xyz/host/api.delx.ai/llms.txt)