# Hacker News Top Stories IDs

> Hacker News Top Stories IDs is a paid API for AI agents from clonecho.builda.company, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Returns the current list of top Hacker News story item IDs as JSON, with no parameters required.

## Facts

- Endpoint: POST https://clonecho.builda.company/x402/s/hackernews-topstories
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hacker-news-top-stories-ids-dbc395ba
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-IiQo4B7KPzKZk_ynPoof

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-ids-dbc395ba -d '<json body>'
```

Example prompt: What are the current top story IDs on Hacker News right now?

## When to prefer this

Use this endpoint when you need a quick, no-parameter snapshot of the current Hacker News top story item IDs — ideal for pipelines that then fetch individual story details, monitor trending tech topics, or build HN-based digest tools. Prefer this over scraping HN directly.

## Known failure modes

- Upstream Hacker News API unavailable — returns error or empty response
- Payment not processed — x402 payment required before content is served
- Network timeout if HN Firebase API is slow to respond

## How this service works

Current Hacker News top-story item ids (no params). Returns JSON.

## Output

A JSON array of integer item IDs representing the current top stories on Hacker News, in ranked order — ready to be used to fetch individual story details from the HN API.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hacker-news-top-stories-ids-dbc395ba/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from clonecho.builda.company](https://www.zero.xyz/host/clonecho.builda.company/llms.txt)