# Hacker News Top Stories Feed

> Hacker News Top Stories Feed is a paid API for AI agents from news.memoryapi.org, paid per call via x402, $0.001/call, status down (last checked 2026-09-15).

Fetches the current top stories from Hacker News, including titles, URLs, scores, authors, and comment counts.

## Facts

- Endpoint: GET https://news.memoryapi.org/x402/news/top
- Price: $0.001/call
- Payment: x402
- Status: down
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/news-memoryapi-org-36cfcb05
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ODFl3vaHUfxCDQsxrVoO8

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 news-memoryapi-org-36cfcb05
```

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

## When to prefer this

Use this endpoint when you need structured, machine-readable access to the current Hacker News front page including scores, authors, and comment counts — ideal for building news digests, trend monitoring, or surfacing developer-community buzz without scraping HN directly.

## Known failure modes

- Hacker News API unavailable upstream — service may return 503 or empty results
- Payment not processed correctly — 402 payment required error
- Rate limiting if called too frequently — returns 429
- Stale data if cache is not refreshed — stories may not reflect the very latest front page

## How this service works

AgentNews — Hacker News + Guardian news API with x402 micropayments. $0.001 USDC per request.

## Output

A list of top Hacker News stories, each containing the story title, source URL, upvote score, submitting author username, and comment count.

## Example request

```json
{
 "q": "artificial intelligence",
 "limit": 10,
 "section": "technology"
}
```

## Request schema (JSON Schema)

```json
{
 "properties": {
  "input": {
   "required": [
    "method"
   ],
   "properties": {
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "example": {
  "type": "top",
  "count": 20,
  "source": "Hacker News",
  "stories": [
   {
    "by": "user",
    "id": 123,
    "url": "https://example.com",
    "type": "story",
    "score": 500,
    "title": "Example Story",
    "descendants": 42,
    "time_posted": "2025-01-01T00:00:00.000Z"
   }
  ],
  "success": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/news-memoryapi-org-36cfcb05/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from news.memoryapi.org](https://www.zero.xyz/host/news.memoryapi.org/llms.txt)