v1

latestOpenAPI 3.0.12026-07-26171200932.8 KB
Social Feeds

Get user pinned feed posts

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/news
  • GET /api/v1/feeds/saved
  • GET /api/v1/feeds/user/{userId}
  • GET /api/v1/feeds/users/{userId}

Retrieves the posts that the specified user has pinned to the top of their profile feed. The pinned feed surfaces highlighted content the user has explicitly chosen to feature, ordered by pin time.

get/api/v1/feeds/users/{userId}/pinned

Path parameters

userIdstring required

ID of the user whose pinned posts should be retrieved

Query parameters

badgesExperimentIsEnabledboolean

Flag indicating whether to include user badges in the response. Part of badges feature experiment.

Headers

x-request-idstring uuid required
Example:c3321008-bc3b-4a86-abd4-92c19cb6b031

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

Successfully retrieved user pinned feed posts