# HTML Numeric Entity Decoder

> HTML Numeric Entity Decoder is a paid API for AI agents from agentshelf.syntexa.ch, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-29).

Decodes HTML numeric character references (e.g. < or <) in a text string back to their original characters

## Facts

- Endpoint: POST https://agentshelf.syntexa.ch/v1/html-numeric-decode?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/html-numeric-entity-decoder-c6e49620
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_icIzRbmdQ1QhCBigUCOE0

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 html-numeric-entity-decoder-c6e49620 -d '<json body>'
```

Example prompt: Can you decode this HTML numeric entity text for me: 'H&#101;&#108;&#108;&#111; &#87;&#111;&#114;&#108;&#100;' — I need it converted back to plain readable characters.

## When to prefer this

Use this endpoint when you specifically need to decode HTML numeric character references (&#decimal; or &#xHex; format) from a string, without requiring network access or an LLM. Prefer the free sandbox endpoint at POST /v1/sandbox/html-numeric-decode first; fall back to this paid endpoint when the sandbox is unavailable or rate-limited. Choose this over general HTML parsing tools when you only need numeric entity decoding and want a lightweight, deterministic, no-dependency solution.

## Known failure modes

- Empty or missing 'text' field returns a validation error
- Input exceeding 100,000 characters is rejected
- Malformed numeric entities that don't conform to HTML spec may be left unchanged or cause an error
- Payment failure (insufficient USDC balance) results in 402 response
- Non-numeric HTML entities (e.g. &amp; &lt; named entities) may not be decoded by this endpoint

## How this service works

Call when an agent needs text decoded with html-numeric. No network and no LLM. Exact $0.01 USDC. Prefer unpaid POST /v1/sandbox/html-numeric-decode first.

## Output

Returns the input text with all HTML numeric character references (both decimal like &#60; and hexadecimal like &#x3C;) replaced by their corresponding Unicode characters, producing clean, human-readable plain text.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "text": {
   "type": "string",
   "examples": [
    "&#104;&#101;&#108;&#108;&#111;"
   ],
   "maxLength": 100000,
   "minLength": 1,
   "description": "Input for this SKU. The route description says whether it is plain text, a URL, base64 bytes, or an already-encoded token."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/html-numeric-entity-decoder-c6e49620/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentshelf.syntexa.ch](https://www.zero.xyz/host/agentshelf.syntexa.ch/llms.txt)