# southpow.media Hacker News Ethereum Stories

> southpow.media Hacker News Ethereum Stories is a paid API for AI agents from southpow.media, paid per call via x402, $0.01/call, status unknown (last checked 2026-11-12).

Returns the latest (or top) Hacker News stories tagged with 'ethereum', including points, comment counts, and links, sorted newest-first by default.

## Facts

- Endpoint: GET https://southpow.media/v1/hn/ethereum?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/southpow-media-hacker-news-ethereum-stories-847224a2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rS5w4ALRu9VWZBA_p1WQb

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 southpow-media-hacker-news-ethereum-stories-847224a2
```

Example prompt: Pull the top 15 Hacker News stories about Ethereum right now — I want to see which ones have the most points and comments.

## When to prefer this

Use this endpoint when you need live, ranked Hacker News community discussion specifically about Ethereum without needing an API key or account. Prefer it over scraping HN directly or using generic news APIs when you want community-curated signals (points, comment counts) rather than raw news volume. It is ideal for lightweight, pay-per-call access with no subscription overhead.

## Known failure modes

- Payment not sent or insufficient USDC — returns 402 Payment Required
- Invalid sort value other than 'recent' or 'top' — may return error or default behavior
- n parameter outside 1-30 range — may be clamped or return an error
- HN API upstream outage — may return 503 or empty results
- No matching stories at that moment — returns empty list

## How this service works

Hacker News stories about 'ethereum', newest first (or sort=top), with points, comments and links. $0.01 USDC on Base. No account, no API key.

## Output

A list of up to 30 Hacker News stories matching the 'ethereum' topic, each including the story title, link, points (upvotes), comment count, and submission metadata, ordered by newest-first or top score depending on the sort parameter.

## 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",
     "required": [],
     "properties": {
      "n": {
       "type": "string",
       "description": "Stories, 1-30 (default 10)"
      },
      "sort": {
       "type": "string",
       "description": "recent (default) or top"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "sort": "recent",
  "as_of": "2026-11-03T00:00:00Z",
  "count": 1,
  "query": "AI agents",
  "stories": [
   {
    "url": "https://example.com",
    "title": "Show HN: example",
    "points": 42,
    "posted": "2026-11-03T00:00:00Z",
    "comments": 10
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/southpow-media-hacker-news-ethereum-stories-847224a2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from southpow.media](https://www.zero.xyz/host/southpow.media/llms.txt)
