Sign in

69c1fb266c35

latestOpenAPI 3.0.12026-07-26171200932.8 KB
Social Feeds

Create a poll 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 poll post. The poll must include a title and at least 2 options. Once created the poll is immutable — options and title cannot be changed. The post itself can still be deleted.

post/api/v1/posts/polls

Headers

x-request-idstring uuid required
Example:0a686e26-897d-4643-9f22-6f1d84776096

A unique request identifier.

x-api-keystring password required
Example:lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663

API key for authentication.

x-user-keystring password required
Example:eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_

User-specific authentication key.

Request body

messagestring required

Text content of the post (max 1000 chars)

Example request

{
  "message": "Where do you think $TSLA will be in 6 months?",
  "poll": {
    "title": "TSLA price target in 6 months?",
    "options": [
      {
        "text": "Above $300",
        "index": 1
      }
    ]
  },
  "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"
        }
      }
    }
  ]
}

Response

Poll post created

idstring

Unique post ID

obsoleteIdstring

Legacy numeric post ID

createdstring date-time

Creation timestamp

updatedstring date-time nullable

Last-edited timestamp

isDeletedboolean

True when the post has been soft-deleted

type'Default' | 'Share' | 'MarketEvent' | 'Trade' | 'Order' | 'Copy' | 'Poll' | 'Article'

Post type

isSpamboolean

True when the post is classified as spam

editStatus'None' | 'Edited' | 'Moderated'

Edit lifecycle status

Example response

{
  "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"
    ],
    "countryCode": 840
  },
  "obsoleteId": "12345",
  "created": "2025-01-15T10:30:00Z",
  "message": {
    "text": "Excited about $TSLA earnings next week!",
    "languageCode": "en"
  },
  "updated": "2025-01-16T08:00:00Z",
  "type": "Default",
  "metadata": {
    "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"
        ],
        "countryCode": 840
      }
    },
    "poll": {
      "id": 55,
      "title": "Where do you see $TSLA by year-end?",
      "gcid": 7890,
      "options": [
        {
          "id": 1,
          "index": 1,
          "text": "Bullish",
          "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
    }
  },
  "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"
        ],
        "countryCode": 840
      },
      "isDirect": true
    }
  ],
  "editStatus": "None"
}