# Pa1m Reddit — Reddit Data API for AI Agents

Pay-per-request Reddit data access via x402 USDC on Base. No Reddit account required for read endpoints.

## Read Endpoints ($0.01 each — no Reddit account needed)

GET /posts?subreddit=python&sort=hot&limit=25&after=t3_xxx
  Fetch posts from any subreddit. Sorts: hot (default), new, top, rising, controversial, best.
  Use t= (hour/day/week/month/year/all) with top or controversial.

GET /search?q=openai&subreddit=MachineLearning&sort=new&t=week&limit=25
  Search Reddit posts globally or within a subreddit.
  Sorts: relevance (default), new, hot, top, comments.

GET /comments?permalink=/r/python/comments/abc/title/
  Full comment tree for a post by permalink URL. Includes nested replies, upvotes, author metadata.

GET /comments/{post_id}
  Same as above but by short post ID (e.g. 1sgjld3). Use when you have the ID, not the URL.

GET /user/{username}
  Public profile: link karma, comment karma, account age, gold/mod/employee flags, profile description.

GET /user/{username}/comments?sort=top&limit=25
  User's recent comments with subreddit, upvotes, parent post title, and pagination cursor.

## Write Endpoints (require Reddit session cookies from POST /login)

POST /login — Authenticate a Reddit account, receive session cookies for write operations ($0.05)
  Body: {"username": "...", "password": "...", "totp_secret": "..." (optional for 2FA)}
  Returns: {"success": true, "cookies": {"reddit_session": "...", "loid": "...", ...}}

POST /vote — Upvote or downvote a post (t3_xxx) or comment (t1_xxx) ($0.02)
  Body: {"thing_id": "t3_abc123", "direction": "up", "reddit_session": "...", "loid": "..."}

POST /comment — Submit a comment on a Reddit post ($0.05)
  Body: {"post_url": "https://reddit.com/r/...", "text": "...", "reddit_session": "...", "loid": "..."}

POST /dm — Send a direct message to a Reddit user ($0.10)
  Body: {"to_username": "...", "message": "...", "reddit_session": "...", "loid": "..."}

## Discovery

agent.json: https://reddit.hypa1m.xyz/.well-known/agent.json
x402 payTo: 0xE43b08f2031e3332ce97C0E0EA6E8bB00bd04fB4 on Base (eip155:8453)
MCP endpoint: https://reddit.hypa1m.xyz/mcp
System prompt: https://reddit.hypa1m.xyz/prompt.txt
ERC-8004 identity: https://8004scan.io/agents/base/59959
agentscan.info: https://agentscan.info/agents/6f4716ea-44bf-496e-bced-5647cfd0f0db
8004agents.ai: https://8004agents.ai/base/agent/59959