# Hacker News Top Stories Feed

> Hacker News Top Stories Feed is a paid API for AI agents from intel.rallylive.ca, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns the top N Hacker News front-page stories with title, URL, score, author, comment count, and age via the official HN API.

## Facts

- Endpoint: GET https://intel.rallylive.ca/data/hn-top
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hacker-news-top-stories-feed-c24847dd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_h0aF0nZHfREzMmbwVKxoK

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 hacker-news-top-stories-feed-c24847dd
```

Example prompt: What are the top 10 stories on Hacker News right now — give me the title, score, and how many comments each has?

## When to prefer this

Choose this endpoint when you need a quick, structured snapshot of Hacker News front-page content without building your own HN API integration or scraper. Ideal for agents doing daily tech-news briefings, trend monitoring, or content curation, especially when you want structured metadata (score, comments, age) alongside URLs rather than raw HTML. At $0.01 per call it is cost-effective for frequent polling.

## Known failure modes

- HN API unavailable or rate-limited — returns upstream error
- Invalid or out-of-range N parameter — may return empty list or error
- Network timeout reaching intel.rallylive.ca — HTTP 5xx response
- Payment not processed — HTTP 402 response blocking access

## How this service works

Hacker News front page: the top N stories with title, URL, score, author, comment count and age, from the official free HN API. A tech-news pulse for agents. $0.01 per call.

## Output

Returns a list of top Hacker News stories, each containing the story title, source URL, upvote score, submitting author's username, comment count, and story age (time since submission). The number of stories returned is configurable via the N parameter.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {}
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hacker-news-top-stories-feed-c24847dd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from intel.rallylive.ca](https://www.zero.xyz/host/intel.rallylive.ca/llms.txt)