# Surf Reddit

> Pay-per-use Reddit data API with x402 micropayments.

Base URL: https://reddit.surf.cascade.fyi
Payment: USDC on Base, Solana, or Tempo via x402/MPP. No API keys needed.
Marketplace: https://surf.cascade.fyi

## Overview

Reddit data API. Search posts, browse subreddits, fetch posts with comments, user profiles. Pricing: $0.001 (lookups), $0.003 (listings), $0.004 (posts/user content), $0.005 (search). All requests require x402 or MPP payment (USDC on Solana, Base, or Tempo).

## Payment Flow

All paid endpoints return HTTP 402 with payment instructions on first request.
Use `npx x402-proxy` to handle payment automatically:

1. Install: `npm i -g x402-proxy` (or use `npx` directly)
2. Check wallet: `npx x402-proxy wallet`
3. Make requests - payment is handled transparently on 402 responses

Supported networks: Base (EVM), Solana, Tempo (MPP).
Force a specific network: `npx x402-proxy --network base ...` or `--network solana`.

## Try It

    npx x402-proxy https://reddit.surf.cascade.fyi/search?q=x402+protocol&limit=10

    npx x402-proxy https://reddit.surf.cascade.fyi/r/cryptocurrency/posts?sort=hot&limit=5

    npx x402-proxy https://reddit.surf.cascade.fyi/r/cryptocurrency

## Endpoints

| Method | Path | Price | Description |
| --- | --- | --- | --- |
| GET | /search | $0.005 | Search Reddit posts |
| GET | /r/[subreddit]/posts | $0.003 | Subreddit posts |
| GET | /posts/[id] | $0.004 | Post with comments |
| GET | /r/[subreddit] | $0.001 | Subreddit info |
| GET | /users/[username] | $0.001 | User profile |
| GET | /users/[username]/posts | $0.004 | User posts |
| GET | /users/[username]/comments | $0.004 | User comments |

## MCP (Model Context Protocol)

This service is available as an MCP server for AI agents:

    npx x402-proxy mcp https://reddit.surf.cascade.fyi/mcp

List available tools:

    npx @modelcontextprotocol/inspector --cli npx x402-proxy mcp https://reddit.surf.cascade.fyi/mcp --method tools/list

## Links

- [OpenAPI Spec](https://reddit.surf.cascade.fyi/openapi.json)
- [API Reference](https://reddit.surf.cascade.fyi/docs)
- [Surf Marketplace](https://surf.cascade.fyi)
- [x402 Protocol](https://x402.org)