# Foundry Hacker News Top Stories

> Foundry Hacker News Top Stories is a paid API for AI agents from minty-sprout.onrender.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-11-01).

Fetches the current top Hacker News stories (1–10) with title, link, points, and comment count

## Facts

- Endpoint: POST https://minty-sprout.onrender.com/v1/hacker-news-top?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/foundry-hacker-news-top-stories-cc7d7444
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_DZZUq_nZB2Jh-fSLCN4bX

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 foundry-hacker-news-top-stories-cc7d7444 -d '<json body>'
```

Example prompt: What are the top 5 stories on Hacker News right now? Give me the titles, links, and how many points each one has.

## When to prefer this

Use this endpoint when you need real-time Hacker News front-page data — titles, links, scores, and discussion counts — without scraping or requiring an HN API key yourself. Prefer it over general web search when the task is specifically about what is trending on Hacker News, since it returns structured data directly from the HN API rather than raw HTML. It is pay-per-call with no subscription required.

## Known failure modes

- Invalid count (outside 1–10 range) may return an error or default value
- Hacker News API downtime causes upstream failure
- Network timeout from the Render hosting environment
- Stale data if HN API caching is in effect

## How this service works

Hacker News top stories right now: title, link, points and comments. Input: how many, 1 to 10.

## Output

A JSON object with a source field ('Hacker News API') and a stories array. Each story object contains: title, url (link to the article), hn_url (link to HN discussion thread), by (author username), points (upvote score), and comments (comment count). Stories are ordered by current HN ranking.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "input": {
   "type": "string",
   "maxLength": 8000,
   "description": "Number of stories, 1 to 10"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "source": "Hacker News API",
  "stories": [
   {
    "by": "karpathy",
    "url": "https://karpathy.bearblog.dev/hacker-tube/",
    "title": "HackerTube: YouTube built from videos recommended by HN",
    "hn_url": "https://news.ycombinator.com/item?id=50319510",
    "points": 514,
    "comments": 193
   },
   {
    "by": "ecares",
    "url": "https://www.smithsonianmag.com/science-nature/italian-farmer-found-unknown-seeds-attic-with-nothing-lose-planted-them-result-biblical-180989644/",
    "title": "An Italian Farmer Found Some Unknown Seeds in His Attic and Planted Them",
    "hn_url": "https://news.ycombinator.com/item?id=50320963",
    "points": 41,
    "comments": 8
   },
   {
    "by": "oger",
    "url": "https://atlasum.net/blog/cve-2026-98432-linux-ipv4-tcp-uaf",
    "title": "TCP Use-After-Free: CVE-2026-98432 / CVSS 9.8",
    "hn_url": "https://news.ycombinator.com/item?id=50319143",
    "points": 265,
    "comments": 132
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/foundry-hacker-news-top-stories-cc7d7444/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from minty-sprout.onrender.com](https://www.zero.xyz/host/minty-sprout.onrender.com/llms.txt)