# Network Calc: Ethernet Efficiency & Goodput Calculator

> Network Calc: Ethernet Efficiency & Goodput Calculator is a paid API for AI agents from network-calc.x402tookit.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-30).

Calculates Ethernet wire overhead, TCP/UDP goodput, and maximum packets per second at line rate for a given packet size and link speed.

## Facts

- Endpoint: GET https://network-calc.x402tookit.com/ethernet-efficiency?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/network-calc-ethernet-efficiency-goodput-calculator-d3824891
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_X5gcumEakQdzTtDjDVgQs

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 network-calc-ethernet-efficiency-goodput-calculator-d3824891
```

Example prompt: What's the actual TCP goodput and packets-per-second on a 10000 Mbps link with 1500-byte IP packets using tcp4, including a VLAN tag?

## When to prefer this

Use this endpoint when you need precise, standards-accurate Ethernet and TCP/UDP overhead calculations for a specific link speed and packet size — especially when planning network capacity, comparing protocol overhead (IPv4 vs IPv6, TCP vs UDP), evaluating VLAN or TCP timestamp impact, or determining line-rate PPS limits. Prefer this over manual calculations or generic bandwidth tools when you need all overhead layers (Ethernet preamble, IFG, headers) accounted for correctly.

## Known failure modes

- Missing required linkMbps parameter returns a validation error
- ipPacketBytes outside the range 20–9216 is rejected
- Invalid protocol enum value returns an error
- Non-numeric linkMbps causes a schema validation failure

## How this service works

Ethernet wire overhead, TCP/UDP goodput and maximum packets per second at line rate for a packet size and link speed.

## Output

Returns a structured object with: wire bytes and frame bytes per packet, payload and protocol header bytes, overhead bytes per packet, L3 efficiency percent, goodput in Mbps and MBps, L3 throughput in Mbps, packets per second at line rate, nanoseconds per packet, minimum frame padding, protocol used, link speed, and optional metadata fields (summary, disclaimer, source, asOf).

## 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": [
      "linkMbps"
     ],
     "properties": {
      "vlan": {
       "type": "string",
       "description": "true: 802.1Q VLAN tag (4 bytes) on the frame"
      },
      "linkMbps": {
       "type": "number",
       "description": "Link speed in Mbps, for example 1000 or 10000"
      },
      "protocol": {
       "enum": [
        "raw",
        "tcp4",
        "tcp6",
        "udp4",
        "udp6"
       ],
       "type": "string",
       "description": "raw, tcp4 (default), tcp6, udp4 or udp6"
      },
      "ipPacketBytes": {
       "type": "integer",
       "description": "IP packet size in bytes, 20 to 9216 (default 1500)"
      },
      "tcpTimestamps": {
       "type": "string",
       "description": "true: TCP timestamp option (12 bytes) is in use"
      }
     }
    }
   },
   "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"
       ]
      },
      "linkMbps": {
       "type": [
        "null",
        "number"
       ]
      },
      "protocol": {
       "type": [
        "null",
        "string"
       ]
      },
      "wireBytes": {
       "type": [
        "null",
        "number"
       ]
      },
      "disclaimer": {
       "type": [
        "null",
        "string"
       ]
      },
      "frameBytes": {
       "type": [
        "null",
        "number"
       ]
      },
      "notChecked": {
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/network-calc-ethernet-efficiency-goodput-calculator-d3824891/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from network-calc.x402tookit.com](https://www.zero.xyz/host/network-calc.x402tookit.com/llms.txt)