v1
latestOpenAPI 3.0.12026-07-26171200932.8 KBSocial Feeds
Get news feed
Rate limit: 60 requests per 60 seconds. This is a shared quota — the same budget is consumed by a group of related endpoints, so calling any of them reduces what is left for the others (you cannot call each at the full rate independently). Endpoints sharing this quota:
- GET /api/v1/feeds/following
- GET /api/v1/feeds/for-you
- GET /api/v1/feeds/instrument/{marketId}
- GET /api/v1/feeds/markets/{marketId}
- GET /api/v1/feeds/saved
- GET /api/v1/feeds/user/{userId}
- GET /api/v1/feeds/users/{userId}
- GET /api/v1/feeds/users/{userId}/pinned
Returns a ranked news feed for the authenticated user. Ranking method is resolved via A/B experiment and a configurable default.
get/api/v1/feeds/news
Query parameters
takeinteger
Number of posts to return (1–100, default 20)
offsetinteger
Number of posts to skip for pagination
reactionsPageSizeinteger
Number of inline reactions to include per post (1–50, default 10)
badgesExperimentIsEnabledboolean
Include user badges in the response
Headers
x-request-idstring uuid required
Example:488cba2f-295d-4c91-b019-6129f898629a
A unique request identifier.
x-api-keystring password required
Example:lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663
API key for authentication.
x-user-keystring password required
Example:eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_
User-specific authentication key.
Response
News feed posts