# x402-toolbox Hacker News Top Stories

> x402-toolbox Hacker News Top Stories is a paid API for AI agents from x402-toolbox.shablony-pro.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-02).

Fetches the current top stories from Hacker News via a pay-per-call x402 endpoint requiring no API key or signup.

## Facts

- Endpoint: GET https://x402-toolbox.shablony-pro.workers.dev/news/hackernews-top?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-toolbox-hacker-news-top-stories-31114ce4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1PP_s9nms_YE6PBZ4A03I

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 x402-toolbox-hacker-news-top-stories-31114ce4
```

Example prompt: What are the top stories on Hacker News right now? Pull the current front page for me.

## When to prefer this

Choose this endpoint when you need Hacker News top stories without any API key, account registration, or OAuth flow — payment via x402/USDC on Base is the only credential required. Ideal for AI agents operating autonomously that need tech community signals without managing API credentials.

## Known failure modes

- Payment not included or invalid x402 USDC payment — returns 402 Payment Required
- Network timeout reaching upstream Hacker News API — returns error with ok:false
- Invalid schema parameter — may return malformed or empty response
- Hacker News upstream outage — endpoint returns error state

## How this service works

309 deterministic pay-per-call tools for AI agents over x402 (USDC, Base). No signup, no API key: the payment is the identity.

## Output

Returns a JSON object with ok and paid status flags, along with the current top stories from Hacker News including titles, URLs, scores, and comment counts as surfaced by the HN ranking algorithm.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "schema": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "paid": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-toolbox-hacker-news-top-stories-31114ce4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-toolbox.shablony-pro.workers.dev](https://www.zero.xyz/host/x402-toolbox.shablony-pro.workers.dev/llms.txt)