> ## Documentation Index > Fetch the complete documentation index at: https://docs.centaur.io/llms.txt > Use this file to discover all available pages before exploring further. # List trader activity > Select traders by eligible position count, asset, source platform, and optional position-open time. Requires stats.read and signal visibility. Resolve returned trader IDs through /v2/traders. ## OpenAPI ````yaml /openapi-v2.json get /traders/activity openapi: 3.1.0 info: title: Centaur API version: 2.0.0 description: >- Public, read-only API for Centaur's data over REST with a companion MCP surface. servers: - url: https://api.centaur.io/v2 description: Centaur API v2 security: [] tags: - name: System description: Health and service metadata endpoints. - name: Discovery description: Read-only trader and asset directory discovery endpoints. - name: Events description: >- Historical trade-event reads with source, trader, asset, and position context. - name: Messages description: >- Read-only access to source messages by message timestamp or Source Message ID. - name: Channel Summaries description: Generated channel narrative summaries selected by Source Window overlap. - name: Aggregate Summaries description: >- Generated aggregate narrative summaries selected by Aggregate Window overlap. - name: Positions description: Read-only position history and open-position live state reads. - name: Stats description: Read-only aggregate trader and asset stats. externalDocs: description: Canonical Centaur API documentation url: https://docs.centaur.io paths: /traders/activity: get: tags: - Discovery summary: List trader activity description: >- Select traders by eligible position count, asset, source platform, and optional position-open time. Requires stats.read and signal visibility. Resolve returned trader IDs through /v2/traders. operationId: listTraderActivity parameters: - schema: type: string minLength: 1 description: Case-insensitive partial match against trader name or slug. required: false description: Case-insensitive partial match against trader name or slug. name: search in: query - schema: anyOf: - type: string - type: array items: type: string - type: array items: type: number description: Filter to specific trader IDs. required: false description: Filter to specific trader IDs. name: traderIds in: query - schema: anyOf: - type: string - type: array items: type: string - type: array items: type: number description: Filter to traders with eligible positions on specific asset IDs. required: false description: Filter to traders with eligible positions on specific asset IDs. name: assetIds in: query - schema: anyOf: - anyOf: - type: string - type: array items: type: string - type: array items: type: number - type: array items: $ref: '#/components/schemas/SourcePlatform' description: Filter to traders whose source platform is `TELEGRAM` or `X`. required: false description: Filter to traders whose source platform is `TELEGRAM` or `X`. name: sourcePlatforms in: query - schema: type: string format: date-time description: >- Inclusive ISO-8601 lower bound on position open time for positionCount. Unbounded when omitted. required: false description: >- Inclusive ISO-8601 lower bound on position open time for positionCount. Unbounded when omitted. name: startTime in: query - schema: type: string format: date-time description: >- Inclusive ISO-8601 upper bound on position open time for positionCount. Unbounded when omitted. required: false description: >- Inclusive ISO-8601 upper bound on position open time for positionCount. Unbounded when omitted. name: endTime in: query - schema: type: integer minimum: 1 maximum: 200 description: Maximum number of rows to return. required: false description: Maximum number of rows to return. name: limit in: query - schema: type: string minLength: 1 description: Forward pagination cursor from `meta.nextCursor`. required: false description: Forward pagination cursor from `meta.nextCursor`. name: cursor in: query - schema: type: integer minimum: 0 default: 3 description: >- Minimum eligible position count after asset and position-open time filters. Defaults to 3; pass 0 to include zero-position traders. required: false description: >- Minimum eligible position count after asset and position-open time filters. Defaults to 3; pass 0 to include zero-position traders. name: minPositionCount in: query responses: '200': description: Paginated trader position counts content: application/json: schema: type: object properties: success: type: boolean enum: - true data: $ref: '#/components/schemas/TraderActivityResponseData' requestId: type: string example: c8e2c6e4-80dd-4ffc-9d66-4e31bf64c6b8 required: - success - data - requestId '400': description: Invalid cursor content: application/json: example: success: false error: code: INVALID_CURSOR message: Malformed cursor requestId: c8e2c6e4-80dd-4ffc-9d66-4e31bf64c6b8 schema: $ref: '#/components/schemas/ErrorEnvelope' '401': description: Unauthorized content: application/json: example: success: false error: code: UNAUTHORIZED message: Unauthorized requestId: c8e2c6e4-80dd-4ffc-9d66-4e31bf64c6b8 schema: $ref: '#/components/schemas/ErrorEnvelope' '403': description: Forbidden content: application/json: example: success: false error: code: FORBIDDEN message: Forbidden requestId: c8e2c6e4-80dd-4ffc-9d66-4e31bf64c6b8 schema: $ref: '#/components/schemas/ErrorEnvelope' '422': description: Validation error content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' '503': description: Authentication service temporarily unavailable headers: Retry-After: description: Seconds to wait before retrying authentication schema: type: integer minimum: 1 content: application/json: example: success: false error: code: AUTHENTICATION_UNAVAILABLE message: Authentication is temporarily unavailable requestId: c8e2c6e4-80dd-4ffc-9d66-4e31bf64c6b8 schema: $ref: '#/components/schemas/ErrorEnvelope' security: - ApiKeyAuth: [] components: schemas: SourcePlatform: type: string enum: - TELEGRAM - X TraderActivityResponseData: type: object properties: results: type: array items: type: object properties: traderId: type: integer positionCount: type: integer required: - traderId - positionCount filtersApplied: type: object properties: search: type: string nullable: true traderIds: type: array items: type: integer assetIds: type: array items: type: integer sourcePlatforms: type: array items: $ref: '#/components/schemas/SourcePlatform' minPositionCount: type: integer appliedTimeRange: $ref: '#/components/schemas/AppliedTimeRange' required: - search - traderIds - assetIds - sourcePlatforms - minPositionCount - appliedTimeRange meta: type: object properties: hasMore: type: boolean nextCursor: type: string nullable: true serverTime: type: string format: date-time description: >- Server UTC time when this response was produced (ISO-8601). Anchor relative-time phrases such as "today" or "this week" on this value rather than on a cached one. required: - hasMore - nextCursor - serverTime required: - results - filtersApplied - meta ErrorEnvelope: type: object properties: success: type: boolean enum: - false error: $ref: '#/components/schemas/Error' requestId: type: string example: c8e2c6e4-80dd-4ffc-9d66-4e31bf64c6b8 required: - success - error - requestId AppliedTimeRange: type: object properties: startTime: type: string nullable: true format: date-time endTime: type: string nullable: true format: date-time required: - startTime - endTime Error: type: object properties: code: type: string description: Stable machine-readable error code. example: UNAUTHORIZED message: type: string description: Human-readable explanation for the failure. example: Unauthorized details: nullable: true description: Optional structured details for validation or input failures. required: - code - message securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: API key issued by Centaur. x-default: ````