DegenFeed API v1

Authorization: Bearer df_key_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

// 401 — Invalid key
{ "error": "Invalid or revoked API key" }

// 403 — Insufficient scope
{ "error": "Missing required scopes: write:tip" }

// 429 — Rate limit exceeded
{
  "error": "Rate limit exceeded",
  "retryAfterMs": 1800000,
  "tier": "free",
  "limit": 1000,
  "window": "1h"
}

# Get the trending feed
curl -H "Authorization: Bearer df_key_..." \
  "https://degenfeed.xyz/v1/feed/home?sort=hot&limit=10"

# Search for Bitcoin posts
curl -H "Authorization: Bearer df_key_..." \
  "https://degenfeed.xyz/v1/search?q=bitcoin&limit=5"

# Resolve an identity
curl -H "Authorization: Bearer df_key_..." \
  "https://degenfeed.xyz/v1/identity/resolve?handle=vitalik.eth"

# Check protocol health (no auth required)
curl "https://degenfeed.xyz/v1/health/protocols"

// Install: npm install @degenfeed/api-client
import { DegenFeedClient } from '@degenfeed/api-client';

const client = new DegenFeedClient({
  apiKey: 'df_key_...',
});

// Get the trending feed
const feed = await client.feed.home({
  protocols: ['nostr', 'farcaster'],
  sort: 'hot',
  limit: 20,
});

// Search
const results = await client.search.query('bitcoin');

// Resolve identity
const identity = await client.identity.resolve('vitalik.eth');

// console.log(feed.posts, results.results, identity.resolved);

// Or use fetch directly
// const API_KEY = 'df_key_...';
// const BASE = 'https://degenfeed.xyz/v1';
//
// async function getFeed() {
//   const res = await fetch(`${BASE}/feed/home?sort=hot&limit=10`, {
//     headers: { Authorization: `Bearer ${API_KEY}` },
//   });
  if (!res.ok) throw new Error(`API error: ${res.status}`);
  return res.json();
}

async function searchIdentity(handle) {
  const res = await fetch(`${BASE}/identity/resolve?handle=${handle}`, {
    headers: { Authorization: `Bearer ${API_KEY}` },
  });
  return res.json();
}

# Install: pip install degenfeed-client
from degenfeed import DegenFeedClient

client = DegenFeedClient(api_key="df_key_...")

# Get the trending feed
feed = client.feed.home(protocols=["nostr", "farcaster"], sort="hot", limit=20)

# Search
results = client.search.query("bitcoin")

# Resolve identity
identity = client.identity.resolve("vitalik.eth")

print(feed, results, identity)

# Or use httpx directly
import httpx

API_KEY = "df_key_..."
BASE = "https://degenfeed.xyz/v1"

def get_feed():
    res = httpx.get(
        f"{BASE}/feed/home",
        params={"sort": "hot", "limit": 10},
        headers={"Authorization": f"Bearer {API_KEY}"},
    )
    res.raise_for_status()
    return res.json()

def search_identity(handle: str):
    res = httpx.get(
        f"{BASE}/identity/resolve",
        params={"handle": handle},
        headers={"Authorization": f"Bearer {API_KEY}"},
    )
    return res.json()