# Hacker News Front Page Live Feed

> Hacker News Front Page Live Feed is a paid API for AI agents from twin.unykorn.org, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-02).

Returns the current Hacker News front page stories with titles, scores, links, and metadata, up to 50 results per call.

## Facts

- Endpoint: POST https://twin.unykorn.org/research/hn-front-page?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hacker-news-front-page-live-feed-ca4b5338
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qsX-ssXwNiPrmDH5uQ4X1

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-front-page-live-feed-ca4b5338 -d '<json body>'
```

Example prompt: What are the top 10 stories on Hacker News right now?

## When to prefer this

Use this endpoint when you need a real-time snapshot of what is currently trending on Hacker News without a keyword filter. Prefer it over the sibling HN search endpoint when you want the ranked front page rather than keyword-based search results. Ideal for briefings, monitoring, or seeding downstream analysis pipelines with fresh tech-community signals.

## Known failure modes

- limit out of range (below 1 or above 50) returns a validation error
- Hacker News API upstream downtime may cause empty or error response
- no input provided defaults to 30 results — agents must not assume full 50 without specifying

## How this service works

Hacker News front page right now — Genesis402 / UnyKorn Operator Network

## Output

Returns an ordered list of front-page Hacker News stories, each including the story title, external URL, HN discussion link, upvote score, submitting user, comment count, and time posted. Up to 50 stories returned depending on the limit parameter.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "params": {
   "type": "object",
   "properties": {
    "limit": {
     "type": "integer",
     "maximum": 50,
     "minimum": 1,
     "description": "optional: max rows (default 30, max 50)"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "type": "hn-front-page",
  "receipt": {
   "tx_hash": "0x<64hex>",
   "amount_usd": 0.001,
   "receipt_id": "g402-<16hex>"
  },
  "sources": [
   {
    "ok": true,
    "name": "<source>"
   }
  ],
  "limitations": "<text>",
  "generated_at": "<iso time>",
  "evidence_hash": "sha256:<64hex>"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hacker-news-front-page-live-feed-ca4b5338/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from twin.unykorn.org](https://www.zero.xyz/host/twin.unykorn.org/llms.txt)
