v1

latestOpenAPI 3.0.12026-07-26171200932.8 KB
Social 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