# Vibes-Coded HN Headlines Feed

> Vibes-Coded HN Headlines Feed is a paid API for AI agents from vibes-coded.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns a pay-per-call JSON feed of current Hacker News top stories for AI agents via the x402 micropayment protocol

## Facts

- Endpoint: POST https://vibes-coded.com/api/v1/outcomes/hn-headlines
- 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/vibes-coded-hn-headlines-feed-60ce5c84
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6Dq66ue9THGYfETPXl7cs

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 vibes-coded-hn-headlines-feed-60ce5c84 -d '<json body>'
```

Example prompt: Pull the current top stories from Hacker News and give me the titles, scores, and links as a structured list.

## When to prefer this

Choose this endpoint when you need structured, pay-per-call Hacker News headline data with no API key setup, billed per-use in USDC via x402. Prefer it for AI agent pipelines that need lightweight, on-demand access to HN top stories without managing subscriptions or OAuth tokens. Less suitable if you need full story text, comments, or historical data.

## Known failure modes

- HTTP 402 returned if USDC payment not provided or insufficient — agent must handle x402 payment flow before retrying
- Upstream Hacker News API unavailable — endpoint may return error or stale data
- Invalid feed type parameter results in an error response
- Rate limiting or network timeout if HN is slow to respond

## How this service works

Pay-per-call JSON for AI agents: skill search, listing optimization, install plans, productization, and artifact risk scoring. HTTP 402 → USDC. Full skill marketplace on-site.

## Output

A JSON object containing ok status, feed type (e.g. 'top'), a stories array with each entry including author, story ID, URL, score, and title, plus the resource name and result count.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "feed": "top",
  "stories": [
   {
    "by": "agent",
    "id": 1,
    "url": "https://news.ycombinator.com/item?id=1",
    "score": 128,
    "title": "Show HN: pay-per-call JSON over x402"
   }
  ],
  "resource": "hn-headlines",
  "result_count": 1
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vibes-coded-hn-headlines-feed-60ce5c84/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from vibes-coded.com](https://www.zero.xyz/host/vibes-coded.com/llms.txt)