# Vextorium Hacker News Top Stories

> Vextorium Hacker News Top Stories is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-19).

Fetches top (or other category) Hacker News stories with title, author, points, comments, and URLs

## Facts

- Endpoint: POST https://api.vextorium.com/v1/hackernews-top?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vextorium-hacker-news-top-stories-8dfde418
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_CJPfKsAhIRzGZER_DvGer

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 vextorium-hacker-news-top-stories-8dfde418 -d '<json body>'
```

Example prompt: Can you pull the top 10 stories from Hacker News right now and show me the titles, points, and links?

## When to prefer this

Choose this endpoint when you need structured, ranked Hacker News story data including points, comment counts, and discussion links without scraping HN yourself. It supports multiple list types (top, new, best, ask, show, jobs) and returns clean JSON. Prefer it over direct HN API calls when using x402 pay-per-call infrastructure and needing a ready-to-use normalized response.

## Known failure modes

- Invalid list enum value (must be one of: top, nuevas, mejores, ask, show, empleos) returns a 400 error
- Hacker News API upstream outage causes failure or empty results
- Limit parameter exceeding available stories may return fewer results than requested
- Payment failure or insufficient USDC balance returns a 402 error

## How this service works

558 pay-per-call data APIs for AI agents: Solana and EVM on-chain data, tokenized stocks, DeFi, Hyperliquid, economy and official statistics, FX, validation, web and developer tools. Pay in USDC via x402.

## Output

Returns a JSON object with the list type (e.g. 'top'), source attribution ('Hacker News API (Y Combinator)'), and an array of stories each containing rank, title, URL, author, points, comment count, hours since posting, and a direct link to the HN discussion thread.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "list": {
   "enum": [
    "top",
    "nuevas",
    "mejores",
    "ask",
    "show",
    "empleos"
   ],
   "type": "string"
  },
  "limit": {
   "type": "integer"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "list": "top",
  "source": "Hacker News API (Y Combinator)",
  "stories": [
   {
    "url": "https://yuka.dev/blog-2026-10-02-linux-m4.html",
    "rank": 1,
    "title": "The Forgetful CPU (Linux on M4)",
    "author": "signa11",
    "points": 89,
    "comments": 15,
    "hours_ago": 10.9,
    "discussion": "https://news.ycombinator.com/item?id=49933869"
   },
   {
    "url": "https://www.eff.org/deeplinks/2026/10/court-agrees-eff-utahs-vpn-law-demands-technical-impossibility",
    "rank": 2,
    "title": "Court agrees with EFF: Utah's VPN law demands a technical impossibility",
    "author": "hn_acker",
    "points": 493,
    "comments": 221,
    "hours_ago": 26.9,
    "discussion": "https://news.ycombinator.com/item?id=49927754"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vextorium-hacker-news-top-stories-8dfde418/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vextorium.com](https://www.zero.xyz/host/api.vextorium.com/llms.txt)