# kosoyy tools — URL Reader (x402 paid micro-API)

> kosoyy tools — URL Reader (x402 paid micro-API) is a paid API for AI agents from alert-woodpecker-2022.kosoyyagent.deno.net, paid per call via x402, $0.005/call, status unknown (last checked 2026-11-16).

Fetches and returns the content of a public HTTP(S) URL, paid per call in USDC via x402.

## Facts

- Endpoint: POST https://alert-woodpecker-2022.kosoyyagent.deno.net/api/reader?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/kosoyy-tools-url-reader-x402-paid-micro-api-16746001
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_uejz6u2Pi0hhE7CT2q6NY

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 kosoyy-tools-url-reader-x402-paid-micro-api-16746001 -d '<json body>'
```

Example prompt: Can you fetch the contents of https://example.com/data.json and show me what it returns?

## When to prefer this

Choose this endpoint when you need to fetch a public URL in a pay-per-call, no-subscription model using USDC micropayments on Solana or Base. Best suited for agents that only occasionally need URL fetching and want to avoid subscription overhead, or for workflows integrated with the x402 payment protocol.

## Known failure modes

- Unpaid request returns HTTP 402 with a payment offer (x402 protocol)
- Invalid or non-public URL returns an error in the result object
- URL that requires authentication or is behind a firewall may fail to fetch
- Network timeout for slow or unreachable URLs
- Malformed URL input returns a validation error

## How this service works

Deterministic utility tools, paid per call in USDC (Solana or Base). Unpaid requests return a 402 offer.

## Output

A JSON object with an 'ok' boolean indicating success, a 'route' string identifying which tool handled the request, and a 'result' object containing the fetched content from the target URL.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "url"
 ],
 "properties": {
  "url": {
   "type": "string",
   "description": "public http(s) URL to fetch"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "ok": {
   "type": "boolean"
  },
  "route": {
   "type": "string"
  },
  "result": {
   "type": "object"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/kosoyy-tools-url-reader-x402-paid-micro-api-16746001/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from alert-woodpecker-2022.kosoyyagent.deno.net](https://www.zero.xyz/host/alert-woodpecker-2022.kosoyyagent.deno.net/llms.txt)
