# Reddit on fetcher.sh

> Reddit on fetcher.sh is an x402-paywalled web-data API: 15 GET endpoints (Reddit), each payable per call in USDC on Base, Polygon, Arbitrum, Monad or Solana — or prepaid via a credit balance with a bby_live_ Bearer API key. Built for autonomous agents: no accounts, no OAuth, machine-readable 402 challenges.

- Base URL: https://reddit.fetcher.sh
- OpenAPI 3.1 contract: https://reddit.fetcher.sh/openapi.json
- Remote MCP server (Streamable HTTP): https://reddit.fetcher.sh/mcp — free tools: search_endpoints, describe_endpoint, check_balance; paid tools: fetch_data, topup_credits, and its named shortcut reddit_search_post; pays via x402 on any network below, or an Authorization: Bearer bby_live_... header
- Agent setup instructions: https://reddit.fetcher.sh/skill.md
- Human top-up page (browser wallet): https://reddit.fetcher.sh/topup
- Payments: x402 "exact" scheme in USDC on eip155:8453, eip155:137, eip155:42161, eip155:143, solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp — every 402 lists one accepts entry per network, Base first, each with its own asset and payTo; gas sponsored, no native token needed
- Credits: POST /api/credits/topup?amount=<usd> (min $1, x402-paid; the first top-up returns the API key exactly once, &rotate=1 mints a fresh one), then Authorization: Bearer bby_live_... per call; GET /api/credits/balance reads the balance; sending Authorization: Bearer with the top-up recharges that key's account from any wallet
- Response envelope: { "status": number, "message": string, "data": any }
- Chain caveats: the facilitator enforces a per-chain minimum payment, so a cheap endpoint can be refused on an expensive chain — retry on another network. On Solana, USDC needs an associated token account on both sides or the transfer fails with InvalidAccountData; receiving USDC once creates it.
- Credits are keyed by wallet address, so an EVM wallet and a Solana wallet are separate balances with separate keys
- No rate limits; no refunds on upstream failures (settlement precedes delivery)

## Services

- Reddit (also: subreddits) — https://reddit.fetcher.sh — 15 endpoints — Search posts, subreddits, and users; pull hot/new/top/best feeds, comment trees, and user history.

## Endpoints (price per call)

### Reddit

GET /api/post/{id} — $0.002 — Post
GET /api/post/{id}/comments — $0.002 — Post comments
GET /api/post/{id}/comments/{commentId}/replies — $0.002 — Post comments replies
GET /api/posts/best — $0.002 — Posts best
GET /api/posts/hot — $0.002 — Posts hot
GET /api/posts/new — $0.002 — Posts new
GET /api/posts/top — $0.002 — Posts top
GET /api/search/post — $0.002 — Search post
GET /api/search/subreddit — $0.002 — Search subreddit
GET /api/search/user — $0.002 — Search user
GET /api/subreddit/{name} — $0.002 — Subreddit
GET /api/subreddit/{name}/posts — $0.002 — Subreddit posts
GET /api/user/{username} — $0.002 — User
GET /api/user/{username}/comments — $0.002 — User comments
GET /api/user/{username}/posts — $0.002 — User posts