Create a new discussion post

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.

POST /api/v1/feeds/post

Create a new discussion post

cURL

curl --request POST \
  --url https://public-api.etoro.com/api/v1/feeds/post \
  --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 '
{
  "owner": 0,
  "message": "string",
  "tags": {
    "tags": [
      {
        "name": "string",
        "id": "string"
      }
    ]
  },
  "mentions": {
    "mentions": [
      {
        "userName": "string",
        "id": "string",
        "isDirect": true
      }
    ]
  },
  "attachments": [
    {
      "url": "string",
      "title": "string",
      "host": "string",
      "description": "string",
      "mediaType": "None",
      "media": {
        "image": {
          "width": 0,
          "height": 0,
          "url": "string"
        },
        "video": {
          "videoSourceId": "string",
          "videoSource": "None",
          "image": {
            "width": 0,
            "height": 0,
            "url": "string"
          }
        }
      }
    }
  ]
}
'

201

{
  "id": "<string>",
  "owner": {
    "id": "<string>",
    "username": "<string>",
    "firstName": "<string>",
    "lastName": "<string>",
    "avatar": {
      "small": "<string>",
      "medium": "<string>",
      "large": "<string>"
    },
    "roles": [
      "<string>"
    ],
    "isBlocked": true,
    "isPrivate": true,
    "countryCode": 123,
    "piLevel": 123
  },
  "obsoleteId": "<string>",
  "created": "2023-11-07T05:31:56Z",
  "message": {
    "text": "<string>",
    "languageCode": "<string>"
  },
  "updated": "2023-11-07T05:31:56Z",
  "isDeleted": true,
  "type": "Default",
  "metadata": {
    "share": {
      "sharedPost": "<string>",
      "sharedOriginPost": "<string>"
    },
    "marketEvent": {
      "earningReportId": 123,
      "market": {
        "id": "<string>",
        "symbolName": "<string>",
        "displayName": "<string>",
        "updated": "2023-11-07T05:31:56Z",
        "assetType": "Stocks",
        "internalId": 123,
        "avatar": {
          "small": "<string>",
          "medium": "<string>",
          "large": "<string>"
        },
        "application": "eToro",
        "metadata": "<string>"
      },
      "stocksIndustryId": 123,
      "earningsDate": "2023-11-07T05:31:56Z",
      "isBeforeMarketOpen": true,
      "earningsYear": 123,
      "earningsQuarter": 123,
      "verified": true,
      "marketCap": 123,
      "estimatedEps": 123,
      "estimatedSales": 123,
      "tagName": "<string>",
      "textKey": 123
    },
    "trade": {
      "type": "Open",
      "positionId": 123,
      "market": {
        "id": "<string>",
        "symbolName": "<string>",
        "displayName": "<string>",
        "updated": "2023-11-07T05:31:56Z",
        "assetType": "Stocks",
        "internalId": 123,
        "avatar": {
          "small": "<string>",
          "medium": "<string>",
          "large": "<string>"
        },
        "application": "eToro",
        "metadata": "<string>"
      },
      "gain": 123,
      "rate": 123,
      "direction": "Long"
    },
    "order": {
      "type": "Open",
      "orderId": 123,
      "market": {
        "id": "<string>",
        "symbolName": "<string>",
        "displayName": "<string>",
        "updated": "2023-11-07T05:31:56Z",
        "assetType": "Stocks",
        "internalId": 123,
        "avatar": {
          "small": "<string>",
          "medium": "<string>",
          "large": "<string>"
        },
        "application": "eToro",
        "metadata": "<string>"
      },
      "rate": 123,
      "direction": "Long"
    },
    "copy": {
      "type": "Start",
      "user": {
        "id": "<string>",
        "username": "<string>",
        "firstName": "<string>",
        "lastName": "<string>",
        "avatar": {
          "small": "<string>",
          "medium": "<string>",
          "large": "<string>"
        },
        "roles": [
          "<string>"
        ],
        "isBlocked": true,
        "isPrivate": true,
        "countryCode": 123,
        "piLevel": 123
      }
    },
    "poll": {
      "id": 123,
      "title": "<string>",
      "gcid": 123,
      "options": [
        {
          "id": 123,
          "index": 123,
          "text": "<string>",
          "isUserVoted": true,
          "votesCount": 123
        }
      ]
    }
  },
  "attachments": [
    {
      "type": "image",
      "url": "<string>",
      "thumbnailUrl": "<string>",
      "metadata": {
        "width": 123,
        "height": 123,
        "duration": 123
      }
    }
  ],
  "tags": [
    {
      "market": {
        "id": "<string>",
        "symbolName": "<string>",
        "displayName": "<string>",
        "updated": "2023-11-07T05:31:56Z",
        "assetType": "Stocks",
        "internalId": 123,
        "avatar": {
          "small": "<string>",
          "medium": "<string>",
          "large": "<string>"
        },
        "application": "eToro",
        "metadata": "<string>"
      }
    }
  ],
  "mentions": [
    {
      "user": {
        "id": "<string>",
        "username": "<string>",
        "firstName": "<string>",
        "lastName": "<string>",
        "avatar": {
          "small": "<string>",
          "medium": "<string>",
          "large": "<string>"
        },
        "roles": [
          "<string>"
        ],
        "isBlocked": true,
        "isPrivate": true,
        "countryCode": 123,
        "piLevel": 123
      },
      "isDirect": true
    }
  ],
  "isSpam": true,
  "editStatus": "None"
}

Headers

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

A unique request identifier.

Example:

"3aa7ed5d-ac4e-48c2-a33b-c8a0abef8ce9"

x-api-key · string<password> · required

API key for authentication.

Example:

"lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663"

x-user-key · string<password> · required

User-specific authentication key.

Example:

"eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_"

Body

application/json

Discussion post creation details

Request model for creating a new discussion post

owner · integer

ID of the owner creating the discussion

Example:

0

message · string

The main text content of the discussion post

Example:

"string"

tags · object

Tags associated with the discussion

Show child attributes

mentions · object

Mentions included in the discussion

Show child attributes

attachments · object[]

List of attachments for the discussion

Show child attributes

Response

201 - application/json

Post accepted successfully

Represents a feed post with its content and metadata

id · string

Unique identifier of the post

owner · object

Show child attributes

obsoleteId · string

Obsolete identifier for backward compatibility

created · string<date-time>

Timestamp when the post was created

message · object

Show child attributes

updated · string<date-time>

Timestamp when the post was last updated

isDeleted · boolean

Indicates if the post is deleted

type · enum<string>

Type of the post

Available options: Default

metadata · object

Show child attributes

attachments · object[]

Show child attributes

tags · object[]

Show child attributes

mentions · object[]

Show child attributes

isSpam · boolean

Indicates if the post is marked as spam

editStatus · enum<string>

Edit status of the post

Available options: None, Edited, Moderated