DegenFeedDegenFeed

Documentation

Everything you need to know about DegenFeed — the open-source web3 social aggregator.

Quick start

DegenFeed is a multi-protocol social aggregator that pulls public posts from 8 networks into one unified timeline. No account is needed to browse. Connect your wallet to like, reply, cross-post, and tip.

Open the web app

Browse all feeds immediately. Zero sign-up.

app.degenfeed.xyz →

Get a handle

Free @degenfeed.xyz Mastodon account. Federates with the entire Fediverse.

social.degenfeed.xyz →

Supported protocols

ProtocolEndpointAuthenticationType
Nostrwss://relay.damus.ionsec keyDecentralized relays
Farcasterhub.farcaster.standardcrypto.vc:2281Signer keyHubs + on-chain registry
Lensapi.lens.xyz/graphqlWallet sign-inPolygon smart contracts
Blueskypublic.api.bsky.appApp passwordAT Protocol PDS
Mastodonsocial.degenfeed.xyzOAuth tokenActivityPub federation
Threadsthreads.net (public HTML)None (read-only)Meta ActivityPub + scraping
Redditreddit.com/.rssNone (RSS)RSS feed scraping
RSSAny feed URLNoneSyndication standard

API reference

All endpoints are served from degenfeed.xyz/api/*. No API key is required for public endpoints. Rate limit: 20 requests per 5 seconds per IP.

GET/api/feed/homeHome timeline. Aggregated and ranked feed across all enabled protocols.
GET/api/feed/trendingTrending posts across all protocols. Sorted by engagement velocity.
GET/api/feed/newsCurated news feed from RSS, Mastodon, and Bluesky sources.
GET/api/feed/rss.xmlRSS feed of top DegenFeed posts. Subscribe in any RSS reader.
GET/api/feed/:protocolPer-protocol feed (nostr, farcaster, lens, bluesky, mastodon, threads, reddit, rss).
GET/api/feed/healthProtocol health status. Latency and uptime per provider.
GET/api/feed/category/:catFiltered feed by niche category (defi, nft, ai, gaming, etc.).
POST/api/publishCross-post to connected protocols. Requires wallet authentication.
POST/api/engageLike, reply, or repost. Protocol-native signing per platform.
GET/api/searchCross-protocol search. Query params: q, protocol, limit.
GET/api/account/exportExport all your data. GDPR-compliant data portability.
POST/api/account/deletePermanently delete your account and all associated data.
POST/api/newsletter/subscribeSubscribe to the daily digest newsletter. Optional topic preferences.
GET/api/newsletter/digestPreview the latest daily digest.
POST/api/tip/createCreate a crypto tip (ETH, SOL, USDC). Returns transaction payload.

Self-hosting

DegenFeed is licensed under MIT. You can run your own instance on Cloudflare Pages (free tier) or any Node.js host.

01

Clone the repo

git clone https://git.rugmunch.io/RugMunchMedia/degenfeed-web.git && cd degenfeed-web
02

Install dependencies

pnpm install
03

Configure environment

cp .env.example .env && $EDITOR .env
04

Start development server

pnpm dev
05

Build for production

pnpm build
06

Deploy to Cloudflare

npx wrangler pages deploy apps/web --project-name degenfeed-web

Environment variables

Required for full functionality (posting, tipping, auth):

AUTH_SECRET — session signing secret (generate with openssl rand -hex 32)
ALLOWED_ORIGINS — comma-separated allowed CORS origins
RELAY_URLS — comma-separated Nostr relay URLs
FARCASTER_HUB_URL — Farcaster hub gRPC endpoint
LENS_API_URL — Lens GraphQL API endpoint
SOLANA_RPC_URL — Solana RPC for wallet verification

Architecture

Monorepo structure

  • apps/web/ — Next.js 15 App Router frontend
  • workers/api/ — Cloudflare Worker edge proxy + aggregator
  • packages/feed-core/ — Feed normalization and deduplication
  • packages/feed-providers/ — 8 protocol adapters (Nostr, Farcaster, Lens, Bluesky, Mastodon, Threads, Reddit, RSS)
  • packages/ranking/ — 7-component transparent scoring algorithm
  • packages/ui/ — Shared React components
  • packages/identity/ — Cross-protocol identity resolution
  • packages/auth/ — SIWE + Solana wallet sign-in

Data flow

  1. 1. Worker receives feed request
  2. 2. Providers fetch posts in parallel
  3. 3. Feed core normalizes to UnifiedPost
  4. 4. Ranking engine scores each post
  5. 5. Results merged, deduplicated, sorted
  6. 6. Response cached at edge (30s)
  7. 7. Client renders with infinite scroll

Tech stack

TypeScript 5Next.js 15React 19Cloudflare WorkersCloudflare PagesCloudflare KVpnpm 11Turborepo 2BiomeTailwind CSSGotoSocial 0.22SQLiteWagmiSolana Web3.jsviem

More resources

FAQ

15 common questions about accounts, protocols, federation, payments, and privacy.

About

Mission, team, Rug Munch Media LLC, infrastructure, and open-source commitment.

Status

Live health dashboard for all 8 protocol providers. Latency and uptime.

Source code (Forgejo)

Full monorepo source. MIT licensed. Issues and PRs welcome.

GitLab mirror

Public mirror synced on every push. CI/CD and merge requests.

Newsletter

Daily digest of curated web3, crypto, and AI news from 8 protocols.

DegenFeed is a product of Rug Munch Media LLC. MIT licensed. Built on open protocols.