# Hacker News Top Stories Feed

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

Fetches the current top stories from Hacker News including title, score, author, URL, and timestamp metadata

## Facts

- Endpoint: POST https://padelmaps.org/api/x402-tools/hackernews/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/padelmaps-org-0c73e3ab
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mYvZ6SV81nwC8jYPHUuCZ

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 padelmaps-org-0c73e3ab -d '<json body>'
```

Example prompt: What are the top stories on Hacker News right now — give me the titles, scores, authors, and links.

## When to prefer this

Use this endpoint when you need structured, ready-to-consume Hacker News top story data including metadata like score, author, and timestamp, without having to scrape or call the Hacker News API directly. Ideal for agents building news digests, trend monitoring, or tech community pulse checks.

## Known failure modes

- Hacker News API unavailable — upstream service outage returns an error response
- Rate limit or payment failure — insufficient USDC balance returns a payment-required error
- Empty result set if Hacker News feed is temporarily inaccessible

## How this service works

Get top Hacker News stories

## Output

Returns a list of Hacker News top stories, each with title, score, author username, source URL, and publication timestamp — ready for display or further processing.

## Example request

```json
{
 "input": {
  "body": {
   "limit": 5
  },
  "type": "http",
  "method": "POST",
  "bodyType": "json"
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "properties": {
      "limit": {
       "type": "integer",
       "description": "Number of top stories to return (default 10, max 30)"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "cached": {
       "type": "boolean"
      },
      "stories": {
       "type": "array"
      }
     }
    }
   }
  }
 }
}
```

## More

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