Create a comment on a post

Rate limit: 60 requests per 60 seconds. This is the default shared quota — it is shared with every other endpoint that has no dedicated limit, so requests across those endpoints all draw from the same budget.

---

Creates a new comment on a specific discussion post. Comments can include text, mentions, tags, and attachments.

POST /api/v1/posts/{postId}/comments

cURL

textComment

curl --request POST \
  --url https://public-api.etoro.com/api/v1/posts/{postId}/comments \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --header 'x-request-id: <x-request-id>' \
  --header 'x-user-key: <x-user-key>' \
  --data @- <<EOF
{
  "message": "Great analysis — I've been watching $TSLA closely too."
}
EOF

201

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

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:

"9e116225-671a-41f5-a48b-e7128f5ad211"

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

postId · string<uuid> · required

ID of the post to comment on (UUID)

Body

application/json

Comment creation details. message is required; attachments is optional.

Request body for creating a comment or reply

message · string · required

Comment text (max 500 chars)

Example:

"Great analysis! I agree — the fundamentals are solid."

attachments · object[]

List of attachments for a post or comment (request body format)

Show child attributes

Response

201

application/json

Comment created successfully

A comment (or reply) on a post, wrapped with interaction data

entity · object

Core comment data

Show child attributes

repliesCount · integer

Number of direct replies to this comment

Example:

2

replies · array

Inline reply preview. Each entry has the same shape as Comment; nested replies arrays are not populated at this level.

emotionsData · object

Aggregated emotions (likes) on an entity

Show child attributes

requesterContext · object

Requester's relationship state with the comment

Show child attributes