# Surf

> Pay-per-use research API for AI agents. Twitter, Reddit, and web data with x402 micropayments.

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

## Overview

9 composite endpoints (GET + POST): /api/v1/twitter/{search,tweet,user}, /api/v1/reddit/{search,post,subreddit,user}, /api/v1/web/{search,crawl}. GET uses path params (e.g. /api/v1/twitter/user/cascade_fyi), POST uses JSON body. MCP server at /mcp with optional ?tools= filter. All require x402 or MPP payment.

## 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://new.surf.cascade.fyi/api/v1/twitter/user/cascade_fyi

    npx x402-proxy https://new.surf.cascade.fyi/api/v1/reddit/search/x402+protocol

    npx x402-proxy https://new.surf.cascade.fyi/api/v1/web/crawl/https://x402.org

## Endpoints

| Method | Path | Price | Description |
| --- | --- | --- | --- |
| POST | /api/v1/twitter/search | $0.005 | Search Twitter with advanced operators |
| POST | /api/v1/twitter/tweet | $0.004 | Fetch a tweet with thread context and optional replies/quotes |
| POST | /api/v1/twitter/user | $0.004 | Fetch a user profile with recent tweets |
| POST | /api/v1/reddit/search | $0.005 | Search Reddit posts |
| POST | /api/v1/reddit/post | $0.004 | Fetch a Reddit post with comments |
| POST | /api/v1/reddit/subreddit | $0.003 | Fetch subreddit info and top posts |
| POST | /api/v1/reddit/user | $0.004 | Fetch a Reddit user profile with recent posts and comments |
| POST | /api/v1/web/search | $0.01 | Web search powered by Exa |
| POST | /api/v1/web/crawl | $0.002 | Crawl web pages and extract content |
| GET | /api/v1/twitter/user/:ref | $0.004 | Fetch a user profile with recent tweets (GET shorthand) |
| GET | /api/v1/twitter/tweet/:ref | $0.004 | Fetch a tweet with thread context (GET shorthand) |
| GET | /api/v1/twitter/search/:query | $0.005 | Search Twitter (GET shorthand) |
| GET | /api/v1/reddit/post/:ref | $0.004 | Fetch a Reddit post with comments (GET shorthand) |
| GET | /api/v1/reddit/subreddit/:name | $0.003 | Fetch subreddit info and posts (GET shorthand) |
| GET | /api/v1/reddit/user/:ref | $0.004 | Fetch Reddit user profile (GET shorthand) |
| GET | /api/v1/reddit/search/:query | $0.005 | Search Reddit (GET shorthand) |
| GET | /api/v1/web/search/:query | $0.01 | Web search (GET shorthand) |
| GET | /api/v1/web/crawl/:url | $0.002 | Crawl a web page (GET shorthand) |

## MCP (Model Context Protocol)

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

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

List available tools:

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

## Links

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