POST /api/gzipCompress a string with gzip (RFC 1952) and return it as base64. Reports input bytes, output bytes, and the compression ratio so you can decide if it was worth doing. Input can be plain text (utf8) or already-binary content (base64 or hex).
| Field | Type | Description |
|---|---|---|
input * | string | Content to compress (max 10MB after decoding) |
inputFormat | string | How `input` is encoded: utf8 (default), base64, or hex |
level | number | Compression level 1-9 (default 9 = best ratio, slower) |
{
"algorithm": "gzip",
"inputBytes": 41,
"outputBytes": 21,
"ratio": 0.4878,
"output": "H4sIAA…"
}
curl -i -X POST https://agent402.tools/api/gzip \
-H "Content-Type: application/json" \
-d '{"input":"hello hello hello hello hello hello hello","inputFormat":"utf8"}'
The response is HTTP 402 Payment Required with exact payment requirements. Any x402 v2 client pays automatically and retries:
import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";
const client = new x402Client();
registerExactEvmScheme(client, { signer: privateKeyToAccount(KEY) });
const payFetch = wrapFetchWithPayment(fetch, client);
const res = await payFetch("https://agent402.tools/api/gzip", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"input": "hello hello hello hello hello hello hello",
"inputFormat": "utf8"
}),
});
This is a pure-CPU tool, so an agent without a wallet can pay with proof-of-work instead of USDC: fetch a challenge, solve the sha256 puzzle (16 leading zero bits — a fraction of a second of CPU, no money, no AI tokens), and resend with the X-Pow-Solution header.
import { createHash } from "node:crypto";
const lz = (b) => { let t = 0; for (const x of b) { if (!x) { t += 8; continue; } t += Math.clz32(x) - 24; break; } return t; };
const c = await (await fetch("https://agent402.tools/api/pow/challenge?slug=gzip")).json();
let n = 0;
while (lz(createHash("sha256").update(c.challenge + ":" + n).digest()) < c.difficulty) n++;
await fetch("https://agent402.tools/api/gzip", { method: "POST", headers: { "X-Pow-Solution": c.token + ":" + n, "Content-Type": "application/json" }, body: JSON.stringify({"input":"hello hello hello hello hello hello hello","inputFormat":"utf8"}) });
GET /api/gov-dataSearch 300,000+ US government datasets on catalog.data.gov (CKAN): titles, publishing org, formats, and direct resource …
GET /api/weather-alertsActive National Weather Service alerts for a US state as clean JSON: event, severity, headline, affected areas, onset/ex…
GET /api/earthquakesReal-time USGS earthquake feed: magnitude, place, time, depth, coordinates. Live government data, no key. ?minMag=4.5&pe…