API Endpoints

All endpoints are relative to https://social.degenfeed.xyz.

Accounts

Method	Endpoint	Auth	Description
POST	/api/v1/accounts	App	Register a new account
GET	/api/v1/accounts/verify_credentials	User	Verify access token
PATCH	/api/v1/accounts/update_credentials	User	Update profile
GET	/api/v1/accounts/:id	User	Get account by ID
GET	/api/v1/accounts/:id/statuses	User	Get account's posts
GET	/api/v1/accounts/:id/followers	User	Get followers
GET	/api/v1/accounts/:id/following	User	Get following
POST	/api/v1/accounts/:id/follow	User	Follow account
POST	/api/v1/accounts/:id/unfollow	User	Unfollow account
GET	/api/v1/accounts/search	User	Search accounts

Statuses (Posts)

Method	Endpoint	Auth	Description
GET	/api/v1/statuses/:id	User	Get a single post
POST	/api/v1/statuses	Write	Create a new post
DELETE	/api/v1/statuses/:id	Write	Delete a post
GET	/api/v1/statuses/:id/context	User	Get thread context
GET	/api/v1/statuses/:id/reblogged_by	User	Who boosted a post
GET	/api/v1/statuses/:id/favourited_by	User	Who favorited a post
POST	/api/v1/statuses/:id/reblog	Write	Boost a post
POST	/api/v1/statuses/:id/unreblog	Write	Un-boost a post
POST	/api/v1/statuses/:id/favourite	Write	Favorite a post
POST	/api/v1/statuses/:id/unfavourite	Write	Un-favorite a post

Creating a Post

curl -X POST https://social.degenfeed.xyz/api/v1/statuses \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "Hello from the DegenFeed API!",
    "visibility": "public",
    "language": "en"
  }'

Timelines

Method	Endpoint	Auth	Description
GET	/api/v1/timelines/home	Read	Home timeline
GET	/api/v1/timelines/public	None	Public/federated timeline
GET	/api/v1/timelines/tag/:hashtag	User	Hashtag timeline
GET	/api/v1/timelines/list/:list_id	Read	List timeline

Notifications

Method	Endpoint	Auth	Description
GET	/api/v1/notifications	Read	Get notifications
GET	/api/v1/notifications/:id	Read	Get single notification
POST	/api/v1/notifications/clear	Write	Clear notifications

Media

Method	Endpoint	Auth	Description
POST	/api/v2/media	Write	Upload media

Cross-Post (DegenFeed Extension)

Method	Endpoint	Auth	Description
GET	/api/v1/degenfeed/networks	Read	List connected networks
POST	/api/v1/degenfeed/cross-post	Write	Cross-post to selected networks

Cross-Post Request

curl -X POST https://social.degenfeed.xyz/api/v1/degenfeed/cross-post \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "Hello across all networks!",
    "networks": ["mastodon", "bluesky", "nostr", "farcaster"],
    "visibility": "public"
  }'

Tipping (DegenFeed Extension)

Method	Endpoint	Auth	Description
GET	/api/v1/degenfeed/tips/received	Read	Get received tips
GET	/api/v1/degenfeed/tips/sent	Read	Get sent tips
GET	/api/v1/degenfeed/tips/config	Read	Get tipping config
PATCH	/api/v1/degenfeed/tips/config	Write	Update tipping config

Pagination

All list endpoints support cursor-based pagination:

GET /api/v1/timelines/home?limit=20&max_id=12345

Parameter	Description
limit	Maximum results (default 20, max 40)
max_id	Return results older than this ID
since_id	Return results newer than this ID
min_id	Return results immediately newer than this ID