# Throughput Budget Calculator

> Throughput Budget Calculator is a paid API for AI agents from data-calc.x402tookit.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-30).

Converts requests-per-second and payload size into Mbps bandwidth requirements, applying peak factor, protocol overhead, and link headroom checks.

## Facts

- Endpoint: GET https://data-calc.x402tookit.com/throughput-budget?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/throughput-budget-calculator-cedccd24
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_DtBBKZlqP3m8IM_b8VTIl

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 throughput-budget-calculator-cedccd24
```

Example prompt: Calculate my throughput budget for 5000 requests per second at 8192 bytes each, assume a peak-to-average ratio of 3 and 7% protocol overhead, and check if a 2000 Mbps link at 70% target utilization can handle it.

## When to prefer this

Use this endpoint when you need to translate traffic metrics (RPS, IOPS, payload size) into network bandwidth figures for infrastructure sizing, link capacity validation, or capacity planning reports. It is purpose-built for systems engineers who already have RPS and byte-size estimates and need Mbps/MB/s outputs with peak and overhead adjustments — prefer it over generic calculators when you need provisioned link fit-checks and monthly data volume projections in one call.

## Known failure modes

- Missing required requestsPerSecond or bytesPerRequest parameters returns a validation error
- Values outside allowed ranges (e.g. RPS below 0.001 or above 1e9, bytes outside 1–1e12) rejected
- Non-numeric query parameter values cause parse errors
- Payment not included or insufficient USDC results in 402 Payment Required

## How this service works

Requests per second times payload size to Mbps with peak factor, protocol overhead and link headroom; or IOPS to MB/s.

## Output

Returns average Mbps, peak Mbps, average MB/s, average MiB/s, estimated data volumes per day (GB) and per month (TB), a suggested link size, and if a link capacity was provided, a verdict on whether the link fits along with provisioned Mbps and target utilization percentage.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "requestsPerSecond",
      "bytesPerRequest"
     ],
     "properties": {
      "linkMbps": {
       "type": "number",
       "description": "Optional existing link capacity in Mbps, to check fit"
      },
      "peakFactor": {
       "type": "number",
       "description": "Peak-to-average ratio (default 1)"
      },
      "bytesPerRequest": {
       "type": "number",
       "description": "Average payload size per request in bytes (a 4 KiB block = 4096), 1 to 1e12"
      },
      "overheadPercent": {
       "type": "number",
       "description": "Protocol overhead added to the payload, percent (default 0; TCP/IP/Ethernet is about 5 to 10)"
      },
      "requestsPerSecond": {
       "type": "number",
       "description": "Average requests (or I/O operations) per second, 0.001 to 1e9"
      },
      "targetUtilizationPercent": {
       "type": "number",
       "description": "Highest sustained link utilisation you accept, 10 to 100 (default 70)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "asOf": {
       "type": [
        "null",
        "string"
       ]
      },
      "source": {
       "type": [
        "null",
        "string"
       ]
      },
      "reasons": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "string"
       }
      },
      "summary": {
       "type": [
        "null",
        "string"
       ]
      },
      "verdict": {
       "type": [
        "null",
        "string"
       ]
      },
      "degraded": {
       "type": [
        "boolean",
        "null"
       ]
      },
      "peakMbps": {
       "type": [
        "null",
        "number"
       ]
      },
      "disclaimer": {
       "type": [
        "null",
        "string"
       ]
      },
      "notChecked": {
       "type": [
        "array",
        "null"
       ],
      
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/throughput-budget-calculator-cedccd24/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from data-calc.x402tookit.com](https://www.zero.xyz/host/data-calc.x402tookit.com/llms.txt)
