# Polygon Block Gas Summary

> Polygon Block Gas Summary is a paid API for AI agents from signalharness.ai, paid per call via x402, $0.015/call, status unknown (last checked 2026-09-15).

Analyzes gas usage metrics from a supplied Polygon PoS block, returning base fee, gas limit, utilization, transaction count, and transaction type breakdown.

## Facts

- Endpoint: POST https://signalharness.ai/api/agent/services/polygon_block_gas_summary/invoke
- Price: $0.015/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/polygon-block-gas-summary-22550e6b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Sj9eUUf5PbQMIi9m9tnSD

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 polygon-block-gas-summary-22550e6b -d '<json body>'
```

Example prompt: Analyze the gas usage for this Polygon block — here's the raw block JSON — and give me the base fee per gas, total gas used, utilization in ppm, and a breakdown of transaction types.

## When to prefer this

Choose this endpoint when you have raw Polygon PoS block data already fetched and need a fast, structured gas summary without running your own parsing logic. It is ideal for pipelines that ingest block data from an RPC node and need utilization metrics, fee breakdowns, and transaction type stats in one call. Not suitable if you need real-time block fetching (you must supply the block JSON yourself) or need cryptographic proof of finality.

## Known failure modes

- Malformed or missing request_json causes validation error
- Supplied block data missing required gas fields returns partial or failed analysis
- Non-Polygon chain IDs in block data may produce incorrect network context
- No on-chain finality verification — warnings note data is caller-supplied
- Payment failure (insufficient USDC balance) results in HTTP 402 before execution

## How this service works

Explore 330 pay-per-call x402 API services and 27 agent-native digital products, with Base USDC pricing, secure Polar checkout, and free discovery.

## Output

Returns a structured JSON analysis containing base_fee_per_gas, gas_limit, gas_used, utilization_ppm, transaction_count, transaction_types (keyed by EIP-2718 type), and network context including accepted chain IDs and protocol family. Also includes a warnings array and evidence_scope indicating the data is caller-supplied (not independently verified on-chain).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "request_json": {
   "type": "string",
   "maxLength": 65536,
   "minLength": 2
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "replay": false,
  "result": {
   "warnings": [
    "Does not prove canonical or finalized status."
   ],
   "service_id": "polygon_block_gas_summary",
   "analysis_json": "{\"base_fee_per_gas\":\"100\",\"gas_limit\":\"30000000\",\"gas_used\":\"21000\",\"network_context\":{\"accepted_chain_ids\":[\"137\",\"80002\"],\"bridge_model\":\"root-child state sync plus checkpoint evidence\",\"completion_policy\":\"never inferred without supplied evidence\",\"protocol_family\":\"Polygon PoS\"},\"number\":\"1\",\"transaction_count\":1,\"transaction_types\":{\"0x2\":1},\"utilization_ppm\":\"700\"}",
   "evidence_scope": "caller_supplied_data",
   "analyzed_network": "polygon"
  },
  "status": "succeeded",
  "receipt": {
   "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
   "usage": [],
   "status": "succeeded",
   "network": "eip155:8453",
   "artifacts": [],
   "endedAtMs": 0,
   "latencyMs": 0,
   "paymentId": "example-payment",
   "receiptId": "example-receipt",
   "requestId": "example-request",
   "serviceId": "polygon_block_gas_summary",
   "executionId": "example-execution",
   "startedAtMs": 0,
   "amountAtomic": "15000",
   "resultSha256": "e834ac8780e2e0b865a99db035dd6c72b78e2ad159da2bbc5258bd7fab481607",
   "serviceVersion": "1.0.0",
   "settlementReference": "0x0000000000000000000000000000000000000000000000000000000000000000"
  },
  "artifacts": [],
  "requestId": "example-request",
  "executionId": "example-execution"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/polygon-block-gas-summary-22550e6b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from signalharness.ai](https://www.zero.xyz/host/signalharness.ai/llms.txt)