# ONE Engine Numeric Histogram (Top-10)

> ONE Engine Numeric Histogram (Top-10) is a paid API for AI agents from one-search.one-engine.workers.dev, paid per call via x402, $0.03/call, status unknown (last checked 2026-10-02).

Computes a histogram over an array of up to 1000 numeric values, returning the top-10 most frequent bins with optional min/max range, bin count, rounding, scaling, and offset controls.

## Facts

- Endpoint: POST https://one-search.one-engine.workers.dev/v3/numeric/histogram/t10?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/one-engine-numeric-histogram-top-10-8753777a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__bdGyOHOVghlEworvns2X

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 one-engine-numeric-histogram-top-10-8753777a -d '<json body>'
```

Example prompt: Compute a top-10 histogram for this list of 500 sensor readings: [12.3, 45.1, 33.7, ...], using 20 bins between 0 and 100, rounded to 2 decimal places.

## When to prefer this

Use this endpoint when you need a fast, pay-per-call numeric histogram focused on the top-10 most populated bins from a raw numeric array, especially in agent workflows on Base where x402 micropayments are already in use. Prefer it over full statistical libraries when you only need a ranked bin distribution without a full stats package or persistent storage.

## Known failure modes

- Array contains more than 1000 values — request rejected or truncated
- Non-finite values (NaN, Infinity) in the array cause computation errors
- min >= max produces degenerate or empty bins
- size <= 0 or negative bin count returns an error
- Payment not submitted or insufficient USDC balance returns HTTP 402

## How this service works

Low-cost pay-per-call utility APIs for autonomous agents using x402 on Base.

## Output

Returns a JSON object containing the top-10 histogram bins derived from the input numeric array, each bin representing a value range and its frequency count, shaped by any supplied min/max bounds, bin count, rounding digits, scale factor, and offset.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "values"
 ],
 "properties": {
  "max": {
   "type": "number"
  },
  "min": {
   "type": "number"
  },
  "size": {
   "type": "integer"
  },
  "digits": {
   "type": "integer"
  },
  "factor": {
   "type": "number"
  },
  "offset": {
   "type": "number"
  },
  "values": {
   "type": "array",
   "description": "Finite numbers, maximum 1000"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "additionalProperties": true
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/one-engine-numeric-histogram-top-10-8753777a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from one-search.one-engine.workers.dev](https://www.zero.xyz/host/one-search.one-engine.workers.dev/llms.txt)