# Token Execution Fee Relative to Notional — Distribution Histogram

> Token Execution Fee Relative to Notional — 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-15).

Computes a distribution histogram of token execution fee-to-notional ratios from a supplied set of trade observations, returning bucketed frequency analysis across a configurable number of bins.

## Facts

- Endpoint: POST https://market.datapackvibe.com/x402/assistant-bx-token-fee-burden-histogram?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-execution-fee-relative-to-notional-distribution-histogram-4081ae50
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_03o8W-Kr_aJJwObyl1_Lo

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-execution-fee-relative-to-notional-distribution-histogram-4081ae50 -d '<json body>'
```

Example prompt: I have a list of 8 token trades with their fee and notional amounts — can you generate a distribution histogram with 10 bins showing how the execution fee burden (fee relative to notional) is spread across those trades?

## When to prefer this

Choose this endpoint when you need a quick, deterministic, histogram-based view of how token execution fees compare to notional trade value across a batch of observations — specifically for token (crypto/DeFi) trades where fee burden analysis is the goal. Prefer it over raw ratio calculators when you want bucketed frequency distribution rather than per-trade metrics, and over live market scanners when your input is a fixed, caller-supplied dataset rather than streaming market data.

## Known failure modes

- Fewer than 2 rows supplied — minimum 2 observations required
- notional_usd of 0 or negative — exclusiveMinimum enforced, will reject zero-notional rows
- bins value outside 1–30 range — request will be rejected
- More than 200 rows supplied — exceeds maxItems limit
- fee_usd or notional_usd values exceeding 1e16 — outside allowed maximum
- Malformed row objects missing required fee_usd or notional_usd fields
- Payment failure — 0.01 USDC x402 payment required per call

## How this service works

Token execution fee relative to notional — Distribution histogram: Distribution histogram for Token execution fee relative to notional. 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 the ratio of execution fee to notional value is distributed across the supplied token trade observations, bucketed into the specified number of bins (1–30). Output is a deterministic, calculation-based analysis — 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": [
     "fee_usd",
     "notional_usd"
    ],
    "properties": {
     "fee_usd": {
      "type": "number",
      "default": 2,
      "maximum": 10000000000000000,
      "minimum": 0
     },
     "notional_usd": {
      "type": "number",
      "default": 1000,
      "maximum": 10000000000000000,
      "minimum": 0,
      "exclusiveMinimum": 0
     }
    },
    "additionalProperties": false
   },
   "default": [
    {
     "fee_usd": 2,
     "notional_usd": 1000
    },
    {
     "fee_usd": 2.2,
     "notional_usd": 1100
    },
    {
     "fee_usd": 2,
     "notional_usd": 1000
    },
    {
     "fee_usd": 2.2,
     "notional_usd": 1100
    }
   ],
   "maxItems": 200,
   "minItems": 2
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/token-execution-fee-relative-to-notional-distribution-histogram-4081ae50/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)