# Tokenguard Web Read API

> Tokenguard Web Read API is a paid API for AI agents from eltociear-tokenguard.hf.space, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Fetches and converts a web page URL into structured markdown content with title and word count for AI agents

## Facts

- Endpoint: POST https://eltociear-tokenguard.hf.space/web/read
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tokenguard-web-read-api-57a67c8d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cJiCVRDEXu0jp2DDMAbYm

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 tokenguard-web-read-api-57a67c8d -d '<json body>'
```

Example prompt: Can you fetch the content of this article at https://example.com/article and give me the full text as markdown along with the title and word count?

## When to prefer this

Use this endpoint when you need to fetch and parse a specific web page URL into structured markdown content with metadata like title and word count, particularly in crypto/DeFi research workflows where subsequent analysis of on-chain articles or reports is needed. Prefer this over general-purpose scrapers when operating within a micropayment-enabled x402 agent pipeline on Base.

## Known failure modes

- URL is unreachable or returns a non-200 status — endpoint may return an error or empty content
- Paywalled or JavaScript-heavy pages may return incomplete or empty markdown
- Invalid URL format causes request failure
- Micropayment of $0.005 USDC not provided or rejected — request blocked by x402 payment gate
- Rate limiting or server-side throttling on the target URL

## How this service works

Fetch a URL and return its main content as clean Markdown (boilerplate stripped)

## Output

Returns a JSON object containing the original URL, the page title, the full page content rendered as markdown, and the word count of the extracted content.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "format": "uri",
   "description": "Page to fetch and clean"
  },
  "include_links": {
   "type": "boolean",
   "description": "Keep hyperlinks (default true)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "url": "https://example.com/article",
  "title": "Article title",
  "markdown": "# Article title\n\nMain content…",
  "word_count": 1234
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tokenguard-web-read-api-57a67c8d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from eltociear-tokenguard.hf.space](https://www.zero.xyz/host/eltociear-tokenguard.hf.space/llms.txt)