eToro Feeds API

openapi: 3.2.0
info:
  title: Deprecated eToro Public API operations Agent Portfolios Feeds API
  version: v1.158.0
  description: Snapshot of API operations that existed in the previous docs OpenAPI file and are no longer present in the current upstream Swagger.
servers:
- url: https://public-api.etoro.com/api/v1
  description: Base URL declared by the provider in apis.yml (roadmap#122).
tags:
- name: Feeds
paths:
  /api/v1/feeds/following:
    get:
      tags:
      - Feeds
      summary: Get following feed
      description: Returns a chronological feed of posts from users the authenticated user follows. Requires authentication.
      parameters:
      - name: x-request-id
        in: header
        required: true
        schema:
          type: string
          format: uuid
          example: 158efe60-6508-4de3-8696-6215352f5924
        description: A unique request identifier.
      - name: x-api-key
        in: header
        required: true
        schema:
          type: string
          format: password
          example: lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663
        description: API key for authentication.
      - name: x-user-key
        in: header
        required: true
        schema:
          type: string
          format: password
          example: eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_
        description: User-specific authentication key.
      - name: take
        in: query
        description: Number of posts to return (1–100, default 20)
        schema:
          type: integer
          default: 20
          minimum: 1
          maximum: 100
        example: 20
      - name: offset
        in: query
        description: Number of posts to skip for pagination
        schema:
          type: integer
          default: 0
          minimum: 0
        example: 0
      - name: reactionsPageSize
        in: query
        description: Number of inline reactions to include per post (1–50, default 10)
        schema:
          type: integer
          default: 10
          minimum: 1
          maximum: 50
        example: 10
      - name: badgesExperimentIsEnabled
        in: query
        description: Include user badges in the response
        schema:
          type: boolean
          default: false
      responses:
        '200':
          description: Following feed posts
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DiscussionsResponse'
        '401':
          description: Authentication required
      operationId: getFollowingFeed
  /api/v1/feeds/for-you:
    get:
      tags:
      - Feeds
      summary: Get personalised For You feed
      description: Returns a personalised feed for the authenticated user ranked by followed users, followed instruments, prior engagement, and freshness. Ranking method is resolved via A/B experiment (Optimizely) and per-user overrides. Requires authentication — this feed is intrinsically personal.
      parameters:
      - name: x-request-id
        in: header
        required: true
        schema:
          type: string
          format: uuid
          example: 9335832f-4a83-46ac-99f8-21e5e2c31e2b
        description: A unique request identifier.
      - name: x-api-key
        in: header
        required: true
        schema:
          type: string
          format: password
          example: lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663
        description: API key for authentication.
      - name: x-user-key
        in: header
        required: true
        schema:
          type: string
          format: password
          example: eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_
        description: User-specific authentication key.
      - name: take
        in: query
        description: Number of posts to return (1–100, default 20)
        schema:
          type: integer
          default: 20
          minimum: 1
          maximum: 100
        example: 20
      - name: offset
        in: query
        description: Number of posts to skip for pagination
        schema:
          type: integer
          default: 0
          minimum: 0
        example: 0
      - name: reactionsPageSize
        in: query
        description: Number of inline reactions to include per post (1–50, default 10)
        schema:
          type: integer
          default: 10
          minimum: 1
          maximum: 50
        example: 10
      - name: badgesExperimentIsEnabled
        in: query
        description: Include user badges in the response
        schema:
          type: boolean
          default: false
      responses:
        '200':
          description: Personalised feed posts
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DiscussionsResponse'
        '401':
          description: Authentication required
      operationId: getPersonalisedForYouFeed
  /api/v1/feeds/instrument/{marketId}:
    get:
      tags:
      - Feeds
      summary: Get instrument feed posts
      description: Retrieves feed posts associated with a specific financial instrument. The feed includes discussions, analyses, and other content related to the instrument.
      parameters:
      - name: x-request-id
        in: header
        required: true
        schema:
          type: string
          format: uuid
          example: 7ed04791-ec01-447c-8918-bdadd273398e
        description: A unique request identifier.
      - name: x-api-key
        in: header
        required: true
        schema:
          type: string
          format: password
          example: lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663
        description: API key for authentication.
      - name: x-user-key
        in: header
        required: true
        schema:
          type: string
          format: password
          example: eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_
        description: User-specific authentication key.
      - name: marketId
        in: path
        description: Unique identifier of the financial instrument/market to retrieve feed posts for
        required: true
        schema:
          type: string
        example: '123456'
      - name: requesterUserId
        in: query
        description: ID of the user making the request. Used for personalization and permission checks.
        schema:
          type: string
        example: '7890'
      - name: take
        in: query
        description: Number of feed posts to retrieve. Used for pagination.
        schema:
          type: integer
          format: int32
          default: 20
          minimum: 1
          maximum: 100
        example: 20
      - name: badgesExperimentIsEnabled
        in: query
        description: Flag indicating whether to include user badges in the response. Part of badges feature experiment.
        schema:
          type: boolean
          default: false
      - name: offset
        in: query
        description: Number of feed posts to skip. Used for pagination in combination with take parameter.
        schema:
          type: integer
          format: int32
          default: 0
          minimum: 0
      - name: reactionsPageSize
        in: query
        description: Number of reactions to include per post. Controls the pagination of post reactions.
        schema:
          type: integer
          format: int32
          default: 10
          minimum: 1
          maximum: 50
      responses:
        '200':
          description: Successfully retrieved instrument feed posts
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DiscussionsResponse'
      operationId: getInstrumentFeedPosts
  /api/v1/feeds/markets/{marketId}:
    get:
      tags:
      - Feeds
      summary: Get instrument feed posts
      description: Retrieves feed posts associated with a specific financial instrument. The feed includes discussions, analyses, and other content related to the instrument.
      parameters:
      - name: x-request-id
        in: header
        required: true
        schema:
          type: string
          format: uuid
          example: 03b3f65e-99f5-4225-8d35-6e7c3309854b
        description: A unique request identifier.
      - name: x-api-key
        in: header
        required: true
        schema:
          type: string
          format: password
          example: lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663
        description: API key for authentication.
      - name: x-user-key
        in: header
        required: true
        schema:
          type: string
          format: password
          example: eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_
        description: User-specific authentication key.
      - name: marketId
        in: path
        description: Unique identifier of the financial instrument/market to retrieve feed posts for
        required: true
        schema:
          type: string
        example: '123456'
      - name: take
        in: query
        description: Number of feed posts to retrieve. Used for pagination.
        schema:
          type: integer
          format: int32
          default: 20
          minimum: 1
          maximum: 100
        example: 20
      - name: badgesExperimentIsEnabled
        in: query
        description: Flag indicating whether to include user badges in the response. Part of badges feature experiment.
        schema:
          type: boolean
          default: false
      - name: offset
        in: query
        description: Number of feed posts to skip. Used for pagination in combination with take parameter.
        schema:
          type: integer
          format: int32
          default: 0
          minimum: 0
      - name: reactionsPageSize
        in: query
        description: Number of reactions to include per post. Controls the pagination of post reactions.
        schema:
          type: integer
          format: int32
          default: 10
          minimum: 1
          maximum: 50
      responses:
        '200':
          description: Successfully retrieved instrument feed posts
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DiscussionsResponse'
        '401':
          description: Authentication required
      operationId: getInstrumentFeedPosts2
  /api/v1/feeds/news:
    get:
      tags:
      - Feeds
      summary: Get news feed
      description: Returns a ranked news feed for the authenticated user. Ranking method is resolved via A/B experiment and a configurable default.
      parameters:
      - name: x-request-id
        in: header
        required: true
        schema:
          type: string
          format: uuid
          example: 83493b17-6f29-488f-9f15-3a481b5a4a67
        description: A unique request identifier.
      - name: x-api-key
        in: header
        required: true
        schema:
          type: string
          format: password
          example: lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663
        description: API key for authentication.
      - name: x-user-key
        in: header
        required: true
        schema:
          type: string
          format: password
          example: eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_
        description: User-specific authentication key.
      - name: take
        in: query
        description: Number of posts to return (1–100, default 20)
        schema:
          type: integer
          default: 20
          minimum: 1
          maximum: 100
        example: 20
      - name: offset
        in: query
        description: Number of posts to skip for pagination
        schema:
          type: integer
          default: 0
          minimum: 0
        example: 0
      - name: reactionsPageSize
        in: query
        description: Number of inline reactions to include per post (1–50, default 10)
        schema:
          type: integer
          default: 10
          minimum: 1
          maximum: 50
        example: 10
      - name: badgesExperimentIsEnabled
        in: query
        description: Include user badges in the response
        schema:
          type: boolean
          default: false
      responses:
        '200':
          description: News feed posts
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DiscussionsResponse'
        '401':
          description: Authentication required
      operationId: getNewsFeed
  /api/v1/feeds/post:
    post:
      tags:
      - Feeds
      summary: Create a new discussion post
      description: Creates a new discussion post in the feed system. This endpoint allows users to create posts that can be associated with instruments, users, or general discussions.
      requestBody:
        description: Discussion post creation details
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DiscussionCreateRequest'
      responses:
        '201':
          description: Post accepted successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Post'
      parameters:
      - name: x-request-id
        in: header
        required: true
        schema:
          type: string
          format: uuid
          example: 9e0c08a1-afcd-4234-87b8-47de3438bda5
        description: A unique request identifier.
      - name: x-api-key
        in: header
        required: true
        schema:
          type: string
          format: password
          example: lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663
        description: API key for authentication.
      - name: x-user-key
        in: header
        required: true
        schema:
          type: string
          format: password
          example: eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_
        description: User-specific authentication key.
      operationId: createANewDiscussionPost
  /api/v1/feeds/saved:
    get:
      tags:
      - Feeds
      summary: Get saved feed
      description: Returns a list of posts the authenticated user has bookmarked. Only the requesting user can see their own saved feed. Requires authentication.
      parameters:
      - name: x-request-id
        in: header
        required: true
        schema:
          type: string
          format: uuid
          example: 02b69c47-fca4-4bb1-9920-65e5ab3dc85d
        description: A unique request identifier.
      - name: x-api-key
        in: header
        required: true
        schema:
          type: string
          format: password
          example: lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663
        description: API key for authentication.
      - name: x-user-key
        in: header
        required: true
        schema:
          type: string
          format: password
          example: eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_
        description: User-specific authentication key.
      - name: take
        in: query
        description: Number of posts to return (1–100, default 20)
        schema:
          type: integer
          default: 20
          minimum: 1
          maximum: 100
        example: 20
      - name: offset
        in: query
        description: Number of posts to skip for pagination
        schema:
          type: integer
          default: 0
          minimum: 0
        example: 0
      - name: reactionsPageSize
        in: query
        description: Number of inline reactions to include per post (1–50, default 10)
        schema:
          type: integer
          default: 10
          minimum: 1
          maximum: 50
        example: 10
      - name: badgesExperimentIsEnabled
        in: query
        description: Include user badges in the response
        schema:
          type: boolean
          default: false
      responses:
        '200':
          description: Saved feed posts
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DiscussionsResponse'
        '401':
          description: Authentication required
      operationId: getSavedFeed
  /api/v1/feeds/user/{userId}:
    get:
      tags:
      - Feeds
      summary: Get user feed posts
      description: Retrieves feed posts associated with a specific user. The feed includes the user's discussions, analyses, and other content they have posted.
      parameters:
      - name: x-request-id
        in: header
        required: true
        schema:
          type: string
          format: uuid
          example: 2206c17f-7068-4ab1-a27c-3854e6350918
        description: A unique request identifier.
      - name: x-api-key
        in: header
        required: true
        schema:
          type: string
          format: password
          example: lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663
        description: API key for authentication.
      - name: x-user-key
        in: header
        required: true
        schema:
          type: string
          format: password
          example: eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_
        description: User-specific authentication key.
      - name: userId
        in: path
        description: ID of the user whose feed posts should be retrieved
        required: true
        schema:
          type: string
        example: '7890'
      - name: requesterUserId
        in: query
        description: ID of the user making the request. Used for personalization and permission checks.
        schema:
          type: string
        example: '1111'
      - name: take
        in: query
        description: Number of feed posts to retrieve. Used for pagination.
        schema:
          type: integer
          format: int32
          default: 20
          minimum: 1
          maximum: 100
      - name: badgesExperimentIsEnabled
        in: query
        description: Flag indicating whether to include user badges in the response. Part of badges feature experiment.
        schema:
          type: boolean
          default: false
      - name: offset
        in: query
        description: Number of feed posts to skip. Used for pagination in combination with take parameter.
        schema:
          type: integer
          format: int32
          default: 0
          minimum: 0
      - name: reactionsPageSize
        in: query
        description: Number of reactions to include per post. Controls the pagination of post reactions.
        schema:
          type: integer
          format: int32
          default: 10
          minimum: 1
          maximum: 50
      responses:
        '200':
          description: Successfully retrieved user feed posts
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DiscussionsResponse'
      operationId: getUserFeedPosts
  /api/v1/feeds/users/{userId}:
    get:
      tags:
      - Feeds
      summary: Get user feed posts
      description: Retrieves feed posts associated with a specific user. The feed includes the user's discussions, analyses, and other content they have posted.
      parameters:
      - name: x-request-id
        in: header
        required: true
        schema:
          type: string
          format: uuid
          example: 7de756b6-e69a-4342-b510-a39a935510eb
        description: A unique request identifier.
      - name: x-api-key
        in: header
        required: true
        schema:
          type: string
          format: password
          example: lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663
        description: API key for authentication.
      - name: x-user-key
        in: header
        required: true
        schema:
          type: string
          format: password
          example: eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_
        description: User-specific authentication key.
      - name: userId
        in: path
        description: ID of the user whose feed posts should be retrieved
        required: true
        schema:
          type: string
        example: '7890'
      - name: take
        in: query
        description: Number of feed posts to retrieve. Used for pagination.
        schema:
          type: integer
          format: int32
          default: 20
          minimum: 1
          maximum: 100
      - name: badgesExperimentIsEnabled
        in: query
        description: Flag indicating whether to include user badges in the response. Part of badges feature experiment.
        schema:
          type: boolean
          default: false
      - name: offset
        in: query
        description: Number of feed posts to skip. Used for pagination in combination with take parameter.
        schema:
          type: integer
          format: int32
          default: 0
          minimum: 0
      - name: reactionsPageSize
        in: query
        description: Number of reactions to include per post. Controls the pagination of post reactions.
        schema:
          type: integer
          format: int32
          default: 10
          minimum: 1
          maximum: 50
      responses:
        '200':
          description: Successfully retrieved user feed posts
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DiscussionsResponse'
        '401':
          description: Authentication required
      operationId: getUserFeedPosts2
  /api/v1/feeds/users/{userId}/pinned:
    get:
      tags:
      - Feeds
      summary: Get user pinned feed posts
      description: 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.
      parameters:
      - name: x-request-id
        in: header
        required: true
        schema:
          type: string
          format: uuid
          example: e01c33d4-e7db-4a2a-b8b5-b99acb166fce
        description: A unique request identifier.
      - name: x-api-key
        in: header
        required: true
        schema:
          type: string
          format: password
          example: lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663
        description: API key for authentication.
      - name: x-user-key
        in: header
        required: true
        schema:
          type: string
          format: password
          example: eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_
        description: User-specific authentication key.
      - name: userId
        in: path
        description: ID of the user whose pinned posts should be retrieved
        required: true
        schema:
          type: string
        example: '7890'
      - name: badgesExperimentIsEnabled
        in: query
        description: Flag indicating whether to include user badges in the response. Part of badges feature experiment.
        schema:
          type: boolean
          default: false
      responses:
        '200':
          description: Successfully retrieved user pinned feed posts
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DiscussionsResponse'
        '401':
          description: Authentication required
      operationId: getUserPinnedFeedPosts
components:
  schemas:
    Attachments:
      type: array
      description: List of attachments for a post or comment (request body format)
      items:
        type: object
        description: Media or link attachment
        properties:
          url:
            type: string
            description: Full URL of the attachment
            example: https://cdn.etoro.com/rich-media/images/johndoe/abc-2025-01-15.jpg
          title:
            type: string
            description: Title of the attachment
            example: Tesla Q4 Earnings Chart
          host:
            type: string
            description: Host domain of the attachment
            example: cdn.etoro.com
          description:
            type: string
            description: Short description of the attachment
            example: Tesla quarterly earnings breakdown
          mediaType:
            type: string
            enum:
            - None
            - Link
            - Image
            description: Type of media (video not supported for upload)
            example: Image
          media:
            type: object
            description: Media content details (images only)
            properties:
              image:
                type: object
                description: Image dimensions and URL
                properties:
                  width:
                    type: integer
                    description: Width in pixels
                    example: 1200
                  height:
                    type: integer
                    description: Height in pixels
                    example: 630
                  url:
                    type: string
                    description: Image URL
                    example: https://cdn.etoro.com/rich-media/images/johndoe/abc-2025-01-15.jpg
    DiscussionCreateRequest:
      type: object
      description: Request body for creating a new discussion post
      properties:
        message:
          type: string
          description: Post text content (max 1000 chars)
          example: Just opened a long position on $TSLA — strong earnings ahead!
        attachments:
          $ref: '#/components/schemas/Attachments'
    Emotion:
      type: object
      description: A like reaction on a post or comment
      properties:
        type:
          type: string
          enum:
          - Like
          description: Emotion type (currently only Like is supported)
          example: Like
        id:
          type: string
          description: Emotion ID
          example: b2c3d4e5-f6a7-4890-bcde-f23456789012
        owner:
          $ref: '#/components/schemas/User'
        obsoleteId:
          type: string
          description: Legacy numeric emotion ID
          example: '54321'
        parent:
          type: object
          description: Parent entity reference
          properties:
            id:
              type: string
              description: Parent entity ID
              example: 3fa85f64-5717-4562-b3fc-2c963f66afa6
            obsoleteId:
              type: string
              description: Legacy parent ID
              example: '12345'
            type:
              type: string
              enum:
              - Unknown
              - Post
              - Comment
              - Reply
              description: Parent entity type
              example: Post
        created:
          type: string
          format: date-time
          description: When the like was created
          example: '2025-01-15T10:30:00Z'
    DiscussionsPost:
      type: object
      description: Post data embedded inside a Discussion feed item
      properties:
        id:
          type: string
          description: Post ID
          example: 3fa85f64-5717-4562-b3fc-2c963f66afa6
        owner:
          $ref: '#/components/schemas/User'
        obsoleteId:
          type: string
          description: Legacy numeric post ID
          example: '12345'
        message:
          type: object
          description: Post/comment text content
          properties:
            text:
              type: string
              description: Text content
              example: Excited about $TSLA earnings next week!
            languageCode:
              type: string
              description: BCP-47 language code
              example: en
        created:
          type: string
          format: date-time
          description: Creation timestamp
          example: '2025-01-15T10:30:00Z'
        updated:
          type:
          - string
          - 'null'
          format: date-time
          description: Last-edited timestamp
          example: '2025-01-16T08:00:00Z'
        type:
          type: string
          enum:
          - Default
          - Share
          - MarketEvent
          - Trade
          - Order
          - Copy
          - Poll
          - Article
          description: Post type
          example: Default
        isDeleted:
          type: boolean
          description: True when soft-deleted
          example: false
        isSpam:
          type: boolean
          description: True when classified as spam
          example: false
        editStatus:
          type: string
          enum:
          - None
          - Edited
          - Moderated
          description: Edit lifecycle status
          example: None
        attachments:
          type: array
          items:
            $ref: '#/components/schemas/Attachment'
        tags:
          type: array
          items:
            type: object
            properties:
              market:
                $ref: '#/components/schemas/Market'
        mentions:
          type: array
          items:
            type: object
            properties:
              user:
                $ref: '#/components/schemas/User'
              isDirect:
                type: boolean
                description: Direct @-mention
                example: true
        metadata:
          type: object
          description: Post type–specific metadata — only the relevant key is populated
          properties:
            share:
              type: object
              description: Share metadata — present when type is Share
              properties:
                sharedPost:
                  $ref: '#/components/schemas/DiscussionsPost'
                sharedOriginPost:
                  $ref: '#/components/schemas/DiscussionsPost'
            marketEvent:
              type: object
              description: Market event metadata — present when type is MarketEvent
              properties:
                earningReportId:
                  type: integer
                  description: Earnings report ID
                  example: 1042
                market:
                  $ref: '#/components/schemas/Market'
                stocksIndustryId:
                  type: integer
                  description: Industry sector ID
                  example: 15
                earningsDate:
                  type: string
                  format: date-time
                  description: Earnings announcement date
                  example: '2025-01-15T10:30:00Z'
                isBeforeMarketOpen:
                  type: boolean
                  description: Event occurs before market open
                  example: true
                earningsYear:
                  type: integer
                  description: Fiscal year of earnings
                  example: 2025
                earningsQuarter:
                  type: integer
                  description: Fiscal quarter (1–4)
          

# --- truncated at 32 KB (72 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/etoro/refs/heads/main/openapi/etoro-feeds-api-openapi.yml