# Token Bid-Ask Spread Distribution Histogram

> Token Bid-Ask Spread Distribution Histogram 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).

Computes a distribution histogram of bid-ask spread values across a supplied set of token quote observations, returning binned frequency data.

## Facts

- Endpoint: POST https://market.datapackvibe.com/x402/assistant-bx-token-quote-spread-histogram?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-bid-ask-spread-distribution-histogram-742c783c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mqrWnmjsuCm-rxaTfN2Ge

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-bid-ask-spread-distribution-histogram-742c783c -d '<json body>'
```

Example prompt: I have 8 token quote observations — bids of 0.98, 1.078, 0.97, 1.05, 0.99, 1.02, 1.08, 0.96 and asks of 1.02, 1.122, 1.03, 1.10, 1.01, 1.06, 1.12, 1.00 — can you generate a bid-ask spread distribution histogram using 5 bins?

## When to prefer this

Choose this endpoint when you have a collected set of token bid/ask price pairs and need a deterministic, histogram-style distribution of spread values for offline analysis, reporting, or pre-trade research. It is ideal for batch analysis of up to 200 observations where you want binned frequency output without live market connectivity. Not suitable for real-time scanning, safety verdicts, or trade signals.

## Known failure modes

- Fewer than 2 row observations provided — minimum 2 required
- More than 200 rows submitted — exceeds maxItems limit
- Bid or ask value is zero or negative — exclusiveMinimum:0 required
- Bins count below 1 or above 30 — outside allowed range
- Ask price lower than bid price for an observation — logically inverted spread
- Malformed JSON body — missing required bid or ask fields

## How this service works

Token bid-ask spread — Distribution histogram: Distribution histogram for Token bid-ask spread. Supplied token observations only. Deterministic calculation or caller-threshold verdict, not a live scan, safety proof or trade recommendation. Specialised preset in a shared 50-profile, 20-operation engine. 0.01 USDC includes one bounded distribution histogram report.

## Output

A bounded distribution histogram report showing how bid-ask spread values (ask minus bid) from the supplied observations are distributed across the specified number of bins, including bin boundaries and observation counts per bin. The calculation is deterministic and based solely on the provided data — it is not a live market scan or trade recommendation.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "bins": {
   "type": "integer",
   "default": 5,
   "maximum": 30,
   "minimum": 1
  },
  "rows": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "ask",
     "bid"
    ],
    "properties": {
     "ask": {
      "type": "number",
      "default": 1.02,
      "maximum": 10000000000000000,
      "minimum": 0,
      "exclusiveMinimum": 0
     },
     "bid": {
      "type": "number",
      "default": 0.98,
      "maximum": 10000000000000000,
      "minimum": 0,
      "exclusiveMinimum": 0
     }
    },
    "additionalProperties": false
   },
   "default": [
    {
     "ask": 1.02,
     "bid": 0.98
    },
    {
     "ask": 1.122,
     "bid": 1.078
    },
    {
     "ask": 1.02,
     "bid": 0.98
    },
    {
     "ask": 1.122,
     "bid": 1.078
    }
   ],
   "maxItems": 200,
   "minItems": 2
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/token-bid-ask-spread-distribution-histogram-742c783c/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)