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

Get user pinned feed posts

cURL

curl --request GET \
  --url https://public-api.etoro.com/api/v1/feeds/users/{userId}/pinned \
  --header 'Authorization: Bearer <token>' \
  --header 'x-api-key: <x-api-key>' \
  --header 'x-request-id: <x-request-id>' \
  --header 'x-user-key: <x-user-key>'

import requests

url = "https://public-api.etoro.com/api/v1/feeds/users/{userId}/pinned"

headers = {
    "x-request-id": "<x-request-id>",
    "x-api-key": "<x-api-key>",
    "x-user-key": "<x-user-key>",
    "Authorization": "Bearer <token>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {
    'x-request-id': '<x-request-id>',
    'x-api-key': '<x-api-key>',
    'x-user-key': '<x-user-key>',
    Authorization: 'Bearer <token>'
  }
};

fetch('https://public-api.etoro.com/api/v1/feeds/users/{userId}/pinned', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://public-api.etoro.com/api/v1/feeds/users/{userId}/pinned",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "x-api-key: <x-api-key>",
    "x-request-id: <x-request-id>",
    "x-user-key: <x-user-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://public-api.etoro.com/api/v1/feeds/users/{userId}/pinned"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-request-id", "<x-request-id>")
	req.Header.Add("x-api-key", "<x-api-key>")
	req.Header.Add("x-user-key", "<x-user-key>")
	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://public-api.etoro.com/api/v1/feeds/users/{userId}/pinned")
  .header("x-request-id", "<x-request-id>")
  .header("x-api-key", "<x-api-key>")
  .header("x-user-key", "<x-user-key>")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://public-api.etoro.com/api/v1/feeds/users/{userId}/pinned")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-request-id"] = '<x-request-id>'
request["x-api-key"] = '<x-api-key>'
request["x-user-key"] = '<x-user-key>'
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

200

{
  "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"
  }
}

Authorizations

Authorization · string · header · required

eToro OAuth2. Each operation lists the scopes that grant access as separate security requirements (OpenAPI OR semantics): the caller's token only needs ONE of them — you do NOT need all of them. The same scopes back the x-api-key/x-user-key credential pair.

Headers

x-request-id · string<uuid> · required

A unique request identifier.

Example:

"c3321008-bc3b-4a86-abd4-92c19cb6b031"

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

userId · string · required

ID of the user whose pinned posts should be retrieved

Query Parameters

badgesExperimentIsEnabled · boolean · default: false

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

Response

200

application/json

Successfully retrieved user pinned feed posts

Paginated feed response containing a list of discussions

discussions · object[]

Show child attributes

paging · object

Pagination info

Show child attributes

metadata · object

Feed-level metadata for analytics

Show child attributes