# GEDX402 Social – Reddit Subreddit Feed

> GEDX402 Social – Reddit Subreddit Feed is a paid API for AI agents from social.gedx402.com, paid per call via x402, $0.014/call, status unknown (last checked 2026-09-14).

Fetches posts from a specified Reddit subreddit with sort, timeframe, and pagination options via a pay-per-call x402 proxy.

## Facts

- Endpoint: GET https://social.gedx402.com/v1/sociavault/reddit/subreddit
- Price: $0.014/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gedx402-social-reddit-subreddit-feed-dce45941
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_S8U_pa1lXKu5AvPvqitTg

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 gedx402-social-reddit-subreddit-feed-dce45941
```

Example prompt: Pull the top posts from r/MachineLearning on Reddit for the past week, sorted by top, and trim the response to keep it concise.

## When to prefer this

Use this endpoint when you need to programmatically fetch Reddit subreddit post feeds with flexible sorting (hot, top, new, rising) and timeframe filtering, especially in automated agent workflows that support x402 micropayment-per-call billing. Prefer over direct Reddit API access when you want a simple pay-as-you-go proxy without managing Reddit OAuth credentials.

## Known failure modes

- Missing or invalid subreddit name returns an error or empty data
- Invalid sort value may return unexpected results or an API error
- Payment failure (x402) blocks the request before data is returned
- Subreddit is private, banned, or quarantined — returns no data
- Invalid timeframe value results in a default or error response
- Rate limiting or upstream Reddit API errors propagate as failure

## How this service works

SociaVault API proxy — reddit-subreddit. Query/body matches https://docs.sociavault.com/api-reference/openapi.json. GET/POST per route; x402 per call. $0.014 USDC per request.

## Output

A JSON object containing subreddit post data (titles, scores, links, metadata, etc.) under a 'data' key, a 'success' boolean, and a 'provider' field set to 'sociavault'. Pagination is supported via an 'after' cursor.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "sort": {
   "type": "string"
  },
  "trim": {
   "type": "boolean"
  },
  "after": {
   "type": "string"
  },
  "subreddit": {
   "type": "string"
  },
  "timeframe": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {},
  "success": true,
  "provider": "sociavault"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gedx402-social-reddit-subreddit-feed-dce45941/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from social.gedx402.com](https://www.zero.xyz/host/social.gedx402.com/llms.txt)
