# Hacker News Top Stories Feed

> Hacker News Top Stories Feed is a paid API for AI agents from oracles-production.up.railway.app, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-14).

Returns current top Hacker News stories with score, comment count, author, and link, optionally filtered by significance level

## Facts

- Endpoint: GET https://oracles-production.up.railway.app/v1/hacker-news/changes
- Price: $0.05/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-26e963cd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Fmekeivfdi6jwmJk-X4CZ

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-26e963cd
```

Example prompt: What are the biggest stories on Hacker News right now? Only show me the high-impact ones — significance 7 or above — and limit it to the top 20.

## When to prefer this

Use this endpoint when you need a real-time pulse of what the tech and developer community is actively discussing on Hacker News, especially when you want to filter for only the most significant stories by importance score. Prefer this over generic RSS or scraping when you need structured metadata (score, author, significance, detection time) and a clean API interface. Ideal for monitoring tech trends, surfacing breaking developer news, or building digest-style summaries of what matters in tech right now.

## Known failure modes

- No stories returned if min_significance threshold is set too high (e.g. 10) and no stories meet that bar
- Empty result set if 'since' timestamp is very recent and no new stories have appeared
- Rate limiting or payment failure (402) if USDC payment is not correctly attached
- Invalid date-time format for 'since' parameter returns a 400 error
- limit parameter out of range (below 1 or above 500) causes validation error

## How this service works

Current top Hacker News stories with score, comment count, author, and link — a real-time pulse of what the tech community is discussing. Filter ?min_significance=7 for the biggest stories only.

## Output

A JSON array of Hacker News story change objects, each containing a title, source URL, summary, author, significance score (1–10), detection timestamp, and entity ID. Also includes a total count and source label. Stories are ranked by significance and can be filtered to only the most newsworthy items.

## 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": {
      "limit": {
       "type": "integer",
       "maximum": 500,
       "minimum": 1
      },
      "since": {
       "type": "string",
       "format": "date-time",
       "description": "Only changes detected after this ISO-8601 instant"
      },
      "min_significance": {
       "type": "integer",
       "maximum": 10,
       "minimum": 1,
       "description": "Keep only changes scored at least this"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "count": {
       "type": "integer"
      },
      "source": {
       "type": "string"
      },
      "changes": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "type": {
          "type": "string"
         },
         "title": {
          "type": "string"
         },
         "detail": {
          "type": "object"
         },
         "summary": {
          "type": "string"
         },
         "entityId": {
          "type": "string"
         },
         "sourceUrl": {
          "type": [
           "string",
           "null"
          ],
          "description": "Primary-source link for verification"
         },
         "detectedAt": {
          "type": "string",
          "format": "date-time"
         },
         "significance": {
          "type": "integer",
          "maximum": 10,
          "minimum": 1
         },
         "effectiveDate": {
          "type": [
           "string",
           "null"
          ]
         }
        }
       }
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hacker-news-top-stories-feed-26e963cd/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from oracles-production.up.railway.app](https://www.zero.xyz/host/oracles-production.up.railway.app/llms.txt)