Skip to main content
GET
/
api
/
v1
/
feeds
/
instrument
/
{marketId}
Get instrument feed posts
curl --request GET \
  --url https://public-api.etoro.com/api/v1/feeds/instrument/{marketId} \
  --header 'x-api-key: <x-api-key>' \
  --header 'x-request-id: <x-request-id>' \
  --header 'x-user-key: <x-user-key>'
{
  "discussions": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "post": {
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "owner": {
          "id": "7890",
          "username": "johndoe",
          "firstName": "John",
          "lastName": "Doe",
          "avatar": {
            "small": "https://etoro-cdn.etorostatic.com/avatars/150X150/johndoe.jpg",
            "medium": "https://etoro-cdn.etorostatic.com/avatars/200X200/johndoe.jpg",
            "large": "https://etoro-cdn.etorostatic.com/avatars/300X300/johndoe.jpg",
            "svg": {
              "url": "https://etoro-cdn.etorostatic.com/avatars/svg/johndoe.svg",
              "backgroundColor": "#2196F3",
              "textColor": "#FFFFFF"
            }
          },
          "roles": [
            "Regular"
          ],
          "isBlocked": false,
          "isPrivate": false,
          "countryCode": 840,
          "piLevel": 0
        },
        "obsoleteId": "12345",
        "message": {
          "text": "Excited about $TSLA earnings next week!",
          "languageCode": "en"
        },
        "created": "2025-01-15T10:30:00Z",
        "updated": "2025-01-16T08:00:00Z",
        "type": "Default",
        "isDeleted": false,
        "isSpam": false,
        "editStatus": "None",
        "attachments": [
          {
            "url": "https://cdn.etoro.com/rich-media/images/johndoe/abc-2025-01-15.jpg",
            "title": "Tesla Q4 Earnings Chart",
            "host": "cdn.etoro.com",
            "description": "Tesla quarterly earnings breakdown",
            "mediaType": "Image",
            "media": {
              "image": {
                "width": 1200,
                "height": 630,
                "url": "https://cdn.etoro.com/rich-media/images/johndoe/abc-2025-01-15.jpg"
              },
              "video": {
                "videoSourceId": "dQw4w9WgXcQ",
                "videoSource": "YouTube",
                "image": {
                  "width": 1280,
                  "height": 720,
                  "url": "https://img.youtube.com/vi/dQw4w9WgXcQ/hqdefault.jpg"
                }
              }
            }
          }
        ],
        "tags": [
          {
            "market": {
              "id": "TSLA",
              "symbolName": "TSLA",
              "displayName": "Tesla",
              "updated": "2025-01-15T00:00:00Z",
              "assetType": "Stocks",
              "internalId": 59114,
              "avatar": {
                "small": "https://cdn.etoro.com/assets/img/markets/TSLA/small.png",
                "medium": "https://cdn.etoro.com/assets/img/markets/TSLA/medium.png",
                "large": "https://cdn.etoro.com/assets/img/markets/TSLA/large.png",
                "svg": {
                  "url": "https://cdn.etoro.com/assets/img/markets/TSLA/logo.svg",
                  "backgroundColor": "#CC0000",
                  "textColor": "#FFFFFF"
                }
              },
              "application": "eToro",
              "metadata": "{}",
              "assetTypeId": 10,
              "assetTypeSubCategoryId": 101
            }
          }
        ],
        "mentions": [
          {
            "user": {
              "id": "7890",
              "username": "johndoe",
              "firstName": "John",
              "lastName": "Doe",
              "avatar": {
                "small": "https://etoro-cdn.etorostatic.com/avatars/150X150/johndoe.jpg",
                "medium": "https://etoro-cdn.etorostatic.com/avatars/200X200/johndoe.jpg",
                "large": "https://etoro-cdn.etorostatic.com/avatars/300X300/johndoe.jpg",
                "svg": {
                  "url": "https://etoro-cdn.etorostatic.com/avatars/svg/johndoe.svg",
                  "backgroundColor": "#2196F3",
                  "textColor": "#FFFFFF"
                }
              },
              "roles": [
                "Regular"
              ],
              "isBlocked": false,
              "isPrivate": false,
              "countryCode": 840,
              "piLevel": 0
            },
            "isDirect": true
          }
        ],
        "metadata": {
          "share": {
            "sharedPost": "<unknown>",
            "sharedOriginPost": "<unknown>"
          },
          "marketEvent": {
            "earningReportId": 1042,
            "market": {
              "id": "TSLA",
              "symbolName": "TSLA",
              "displayName": "Tesla",
              "updated": "2025-01-15T00:00:00Z",
              "assetType": "Stocks",
              "internalId": 59114,
              "avatar": {
                "small": "https://cdn.etoro.com/assets/img/markets/TSLA/small.png",
                "medium": "https://cdn.etoro.com/assets/img/markets/TSLA/medium.png",
                "large": "https://cdn.etoro.com/assets/img/markets/TSLA/large.png",
                "svg": {
                  "url": "https://cdn.etoro.com/assets/img/markets/TSLA/logo.svg",
                  "backgroundColor": "#CC0000",
                  "textColor": "#FFFFFF"
                }
              },
              "application": "eToro",
              "metadata": "{}",
              "assetTypeId": 10,
              "assetTypeSubCategoryId": 101
            },
            "stocksIndustryId": 15,
            "earningsDate": "2025-01-15T10:30:00Z",
            "isBeforeMarketOpen": true,
            "earningsYear": 2025,
            "earningsQuarter": 1,
            "verified": true,
            "marketCap": 800000000000,
            "estimatedEps": 1.42,
            "estimatedSales": 25000000000,
            "tagName": "Reports",
            "textKey": 3
          },
          "trade": {
            "type": "Open",
            "positionId": 987654321,
            "market": {
              "id": "TSLA",
              "symbolName": "TSLA",
              "displayName": "Tesla",
              "updated": "2025-01-15T00:00:00Z",
              "assetType": "Stocks",
              "internalId": 59114,
              "avatar": {
                "small": "https://cdn.etoro.com/assets/img/markets/TSLA/small.png",
                "medium": "https://cdn.etoro.com/assets/img/markets/TSLA/medium.png",
                "large": "https://cdn.etoro.com/assets/img/markets/TSLA/large.png",
                "svg": {
                  "url": "https://cdn.etoro.com/assets/img/markets/TSLA/logo.svg",
                  "backgroundColor": "#CC0000",
                  "textColor": "#FFFFFF"
                }
              },
              "application": "eToro",
              "metadata": "{}",
              "assetTypeId": 10,
              "assetTypeSubCategoryId": 101
            },
            "gain": 12.5,
            "rate": 245.3,
            "direction": "Long"
          },
          "order": {
            "type": "Open",
            "orderId": 123456789,
            "market": {
              "id": "TSLA",
              "symbolName": "TSLA",
              "displayName": "Tesla",
              "updated": "2025-01-15T00:00:00Z",
              "assetType": "Stocks",
              "internalId": 59114,
              "avatar": {
                "small": "https://cdn.etoro.com/assets/img/markets/TSLA/small.png",
                "medium": "https://cdn.etoro.com/assets/img/markets/TSLA/medium.png",
                "large": "https://cdn.etoro.com/assets/img/markets/TSLA/large.png",
                "svg": {
                  "url": "https://cdn.etoro.com/assets/img/markets/TSLA/logo.svg",
                  "backgroundColor": "#CC0000",
                  "textColor": "#FFFFFF"
                }
              },
              "application": "eToro",
              "metadata": "{}",
              "assetTypeId": 10,
              "assetTypeSubCategoryId": 101
            },
            "rate": 240,
            "direction": "Long"
          },
          "copy": {
            "type": "Start",
            "user": {
              "id": "7890",
              "username": "johndoe",
              "firstName": "John",
              "lastName": "Doe",
              "avatar": {
                "small": "https://etoro-cdn.etorostatic.com/avatars/150X150/johndoe.jpg",
                "medium": "https://etoro-cdn.etorostatic.com/avatars/200X200/johndoe.jpg",
                "large": "https://etoro-cdn.etorostatic.com/avatars/300X300/johndoe.jpg",
                "svg": {
                  "url": "https://etoro-cdn.etorostatic.com/avatars/svg/johndoe.svg",
                  "backgroundColor": "#2196F3",
                  "textColor": "#FFFFFF"
                }
              },
              "roles": [
                "Regular"
              ],
              "isBlocked": false,
              "isPrivate": false,
              "countryCode": 840,
              "piLevel": 0
            }
          },
          "poll": {
            "id": 55,
            "title": "Where do you see $TSLA by year-end?",
            "gcid": 7890,
            "options": [
              {
                "id": 1,
                "index": 1,
                "text": "Bullish",
                "isUserVoted": false,
                "votesCount": 128
              }
            ]
          },
          "article": {
            "id": 9001,
            "title": "Why TSLA Could Hit $500 This Year",
            "url": "https://etoro.com/news/markets/articles/why-tsla-could-hit-500",
            "rating": "Bullish",
            "featuredImage": {
              "url": "https://cdn.etoro.com/rich-media/images/johndoe/abc-2025-01-15.jpg",
              "title": "Tesla Q4 Earnings Chart",
              "host": "cdn.etoro.com",
              "description": "Tesla quarterly earnings breakdown",
              "mediaType": "Image",
              "media": {
                "image": {
                  "width": 1200,
                  "height": 630,
                  "url": "https://cdn.etoro.com/rich-media/images/johndoe/abc-2025-01-15.jpg"
                },
                "video": {
                  "videoSourceId": "dQw4w9WgXcQ",
                  "videoSource": "YouTube",
                  "image": {
                    "width": 1280,
                    "height": 720,
                    "url": "https://img.youtube.com/vi/dQw4w9WgXcQ/hqdefault.jpg"
                  }
                }
              }
            },
            "body": "<p>Tesla has shown strong fundamentals...</p>",
            "bodyPreview": "Tesla has shown strong fundamentals this quarter...",
            "aiSummary": "Analyst argues Tesla's pipeline supports a $500 target by year-end.",
            "languageCode": "en",
            "status": "Published",
            "editStatus": "None",
            "ownerId": 7890,
            "created": "2025-01-15T10:30:00Z",
            "updated": "2025-01-16T08:00:00Z",
            "published": "2025-01-16T09:00:00Z",
            "readingTimeMinutes": 3.5,
            "wordCount": 750
          }
        }
      },
      "commentsData": {
        "reactionPaging": {
          "totalCount": 14
        },
        "comments": [
          {
            "entity": {
              "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
              "owner": {
                "id": "7890",
                "username": "johndoe",
                "firstName": "John",
                "lastName": "Doe",
                "avatar": {
                  "small": "https://etoro-cdn.etorostatic.com/avatars/150X150/johndoe.jpg",
                  "medium": "https://etoro-cdn.etorostatic.com/avatars/200X200/johndoe.jpg",
                  "large": "https://etoro-cdn.etorostatic.com/avatars/300X300/johndoe.jpg",
                  "svg": {
                    "url": "https://etoro-cdn.etorostatic.com/avatars/svg/johndoe.svg",
                    "backgroundColor": "#2196F3",
                    "textColor": "#FFFFFF"
                  }
                },
                "roles": [
                  "Regular"
                ],
                "isBlocked": false,
                "isPrivate": false,
                "countryCode": 840,
                "piLevel": 0
              },
              "obsoleteId": "98765",
              "created": "2025-01-15T10:30:00Z",
              "updated": "2025-01-15T11:00:00Z",
              "message": {
                "text": "Excited about $TSLA earnings next week!",
                "languageCode": "en"
              },
              "attachments": [
                {
                  "url": "https://cdn.etoro.com/rich-media/images/johndoe/abc-2025-01-15.jpg",
                  "title": "Tesla Q4 Earnings Chart",
                  "host": "cdn.etoro.com",
                  "description": "Tesla quarterly earnings breakdown",
                  "mediaType": "Image",
                  "media": {
                    "image": {
                      "width": 1200,
                      "height": 630,
                      "url": "https://cdn.etoro.com/rich-media/images/johndoe/abc-2025-01-15.jpg"
                    },
                    "video": {
                      "videoSourceId": "dQw4w9WgXcQ",
                      "videoSource": "YouTube",
                      "image": {
                        "width": 1280,
                        "height": 720,
                        "url": "https://img.youtube.com/vi/dQw4w9WgXcQ/hqdefault.jpg"
                      }
                    }
                  }
                }
              ],
              "mentions": [
                {
                  "user": {
                    "id": "7890",
                    "username": "johndoe",
                    "firstName": "John",
                    "lastName": "Doe",
                    "avatar": {
                      "small": "https://etoro-cdn.etorostatic.com/avatars/150X150/johndoe.jpg",
                      "medium": "https://etoro-cdn.etorostatic.com/avatars/200X200/johndoe.jpg",
                      "large": "https://etoro-cdn.etorostatic.com/avatars/300X300/johndoe.jpg",
                      "svg": {
                        "url": "https://etoro-cdn.etorostatic.com/avatars/svg/johndoe.svg",
                        "backgroundColor": "#2196F3",
                        "textColor": "#FFFFFF"
                      }
                    },
                    "roles": [
                      "Regular"
                    ],
                    "isBlocked": false,
                    "isPrivate": false,
                    "countryCode": 840,
                    "piLevel": 0
                  },
                  "isDirect": true
                }
              ],
              "tags": [
                {
                  "market": {
                    "id": "TSLA",
                    "symbolName": "TSLA",
                    "displayName": "Tesla",
                    "updated": "2025-01-15T00:00:00Z",
                    "assetType": "Stocks",
                    "internalId": 59114,
                    "avatar": {
                      "small": "https://cdn.etoro.com/assets/img/markets/TSLA/small.png",
                      "medium": "https://cdn.etoro.com/assets/img/markets/TSLA/medium.png",
                      "large": "https://cdn.etoro.com/assets/img/markets/TSLA/large.png",
                      "svg": {
                        "url": "https://cdn.etoro.com/assets/img/markets/TSLA/logo.svg",
                        "backgroundColor": "#CC0000",
                        "textColor": "#FFFFFF"
                      }
                    },
                    "application": "eToro",
                    "metadata": "{}",
                    "assetTypeId": 10,
                    "assetTypeSubCategoryId": 101
                  }
                }
              ],
              "isSpam": false,
              "editStatus": "None",
              "parent": {
                "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
                "obsoleteId": "12345",
                "type": "Post"
              }
            },
            "repliesCount": 2,
            "replies": "<array>",
            "emotionsData": {
              "like": {
                "paging": {
                  "totalCount": 42,
                  "offsetEntityId": "b2c3d4e5-f6a7-4890-bcde-f23456789012",
                  "next": "/api/v1/reactions/3fa85f64-5717-4562-b3fc-2c963f66afa6/emotions?offset=10&take=10"
                },
                "emotions": [
                  {
                    "type": "Like",
                    "id": "b2c3d4e5-f6a7-4890-bcde-f23456789012",
                    "owner": {
                      "id": "7890",
                      "username": "johndoe",
                      "firstName": "John",
                      "lastName": "Doe",
                      "avatar": {
                        "small": "https://etoro-cdn.etorostatic.com/avatars/150X150/johndoe.jpg",
                        "medium": "https://etoro-cdn.etorostatic.com/avatars/200X200/johndoe.jpg",
                        "large": "https://etoro-cdn.etorostatic.com/avatars/300X300/johndoe.jpg",
                        "svg": {
                          "url": "https://etoro-cdn.etorostatic.com/avatars/svg/johndoe.svg",
                          "backgroundColor": "#2196F3",
                          "textColor": "#FFFFFF"
                        }
                      },
                      "roles": [
                        "Regular"
                      ],
                      "isBlocked": false,
                      "isPrivate": false,
                      "countryCode": 840,
                      "piLevel": 0
                    },
                    "obsoleteId": "54321",
                    "parent": {
                      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
                      "obsoleteId": "12345",
                      "type": "Post"
                    },
                    "created": "2025-01-15T10:30:00Z"
                  }
                ]
              }
            },
            "requesterContext": {
              "isOwner": false,
              "isFlaggingAsSpam": false,
              "isSubscribed": false,
              "isLiking": false,
              "isSaved": false,
              "isPinned": false,
              "isRequesterBlocking": false,
              "isInteractionRestricted": false
            }
          }
        ]
      },
      "emotionsData": {
        "like": {
          "paging": {
            "totalCount": 42,
            "offsetEntityId": "b2c3d4e5-f6a7-4890-bcde-f23456789012",
            "next": "/api/v1/reactions/3fa85f64-5717-4562-b3fc-2c963f66afa6/emotions?offset=10&take=10"
          },
          "emotions": [
            {
              "type": "Like",
              "id": "b2c3d4e5-f6a7-4890-bcde-f23456789012",
              "owner": {
                "id": "7890",
                "username": "johndoe",
                "firstName": "John",
                "lastName": "Doe",
                "avatar": {
                  "small": "https://etoro-cdn.etorostatic.com/avatars/150X150/johndoe.jpg",
                  "medium": "https://etoro-cdn.etorostatic.com/avatars/200X200/johndoe.jpg",
                  "large": "https://etoro-cdn.etorostatic.com/avatars/300X300/johndoe.jpg",
                  "svg": {
                    "url": "https://etoro-cdn.etorostatic.com/avatars/svg/johndoe.svg",
                    "backgroundColor": "#2196F3",
                    "textColor": "#FFFFFF"
                  }
                },
                "roles": [
                  "Regular"
                ],
                "isBlocked": false,
                "isPrivate": false,
                "countryCode": 840,
                "piLevel": 0
              },
              "obsoleteId": "54321",
              "parent": {
                "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
                "obsoleteId": "12345",
                "type": "Post"
              },
              "created": "2025-01-15T10:30:00Z"
            }
          ]
        }
      },
      "requesterContext": {
        "isOwner": false,
        "isFlaggingAsSpam": false,
        "isSubscribed": false,
        "isLiking": true,
        "isSaved": false,
        "isPinned": false,
        "isRequesterBlocking": false,
        "isInteractionRestricted": false,
        "isFollowing": true
      },
      "summary": {
        "totalCommentsAndReplies": 14,
        "sharedCount": 3
      },
      "reason": {
        "type": "followed-user",
        "sourceId": "7890",
        "owner": "johndoe"
      }
    }
  ],
  "paging": {
    "next": "/api/v1/feeds/user/7890?offset=20&take=20",
    "offSet": 0,
    "take": 20,
    "version": "v1"
  },
  "metadata": {
    "experimentName": "ForYouRankingV2",
    "streamType": "ForYou",
    "designatedStreamType": "ForYou"
  }
}

Headers

​
x-request-id
string<uuid>
required

A unique request identifier.

Example:

"7ed04791-ec01-447c-8918-bdadd273398e"

​
x-api-key
string<password>
required

API key for authentication.

Example:

"lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663"

​
x-user-key
string<password>
required

User-specific authentication key.

Example:

"eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_"

Path Parameters

​
marketId
string
required

Unique identifier of the financial instrument/market to retrieve feed posts for

Query Parameters

​
requesterUserId
string

ID of the user making the request. Used for personalization and permission checks.

​
take
integer<int32>
default:20

Number of feed posts to retrieve. Used for pagination.

Required range: 1 <= x <= 100
​
badgesExperimentIsEnabled
boolean
default:false

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

​
offset
integer<int32>
default:0

Number of feed posts to skip. Used for pagination in combination with take parameter.

Required range: x >= 0
​
reactionsPageSize
integer<int32>
default:10

Number of reactions to include per post. Controls the pagination of post reactions.

Required range: 1 <= x <= 50

Response

200 - application/json

Successfully retrieved instrument feed posts

Paginated feed response containing a list of discussions

​
discussions
object[]
​
paging
object

Pagination info

​
metadata
object

Feed-level metadata for analytics