eToro · Schema

WatchlistResponse

Represents a watchlist with its metadata and items

Social TradingCopy TradingInvestingMarket DataPortfolio ManagementFintechTradingStocksCryptocurrencyETFs

Properties

Name Type Description
watchlistId string Unique identifier of the watchlist
name string Display name of the watchlist
Gcid integer Global Customer ID of the watchlist owner
watchlistType string Type of the watchlist
totalItems integer Total number of items in the watchlist
isDefault boolean Whether this is a default system watchlist
isUserSelectedDefault boolean Whether this is the user's selected default watchlist
watchlistRank integer Display order rank of the watchlist
dynamicUrl string URL for dynamic watchlist queries
items array Items contained in the watchlist
relatedAssets array Related asset IDs
View JSON Schema on GitHub

JSON Schema

WatchlistResponse.json Raw ↑
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/etoro/refs/heads/main/json-schema/WatchlistResponse.json",
  "title": "WatchlistResponse",
  "type": "object",
  "description": "Represents a watchlist with its metadata and items",
  "properties": {
    "watchlistId": {
      "type": "string",
      "description": "Unique identifier of the watchlist",
      "example": "12345"
    },
    "name": {
      "type": "string",
      "description": "Display name of the watchlist",
      "example": "Tech Watchlist"
    },
    "Gcid": {
      "type": "integer",
      "format": "int32",
      "description": "Global Customer ID of the watchlist owner",
      "example": 12345
    },
    "watchlistType": {
      "type": "string",
      "enum": [
        "Static",
        "Dynamic",
        "RecentlyInvested",
        "Default"
      ],
      "description": "Type of the watchlist",
      "example": "Static"
    },
    "totalItems": {
      "type": "integer",
      "format": "int32",
      "description": "Total number of items in the watchlist",
      "example": 100
    },
    "isDefault": {
      "type": "boolean",
      "description": "Whether this is a default system watchlist",
      "example": true
    },
    "isUserSelectedDefault": {
      "type": "boolean",
      "description": "Whether this is the user's selected default watchlist",
      "example": true
    },
    "watchlistRank": {
      "type": "integer",
      "format": "int32",
      "description": "Display order rank of the watchlist",
      "example": 1
    },
    "dynamicUrl": {
      "type": "string",
      "nullable": true,
      "description": "URL for dynamic watchlist queries"
    },
    "items": {
      "type": "array",
      "description": "Items contained in the watchlist",
      "items": {
        "$ref": "#/components/schemas/WatchlistItemDto"
      },
      "example": [
        {
          "itemId": 12345,
          "itemType": "Instrument",
          "itemRank": 1
        }
      ]
    },
    "relatedAssets": {
      "type": "array",
      "description": "Related asset IDs",
      "nullable": true,
      "items": {
        "type": "integer",
        "format": "int32"
      },
      "example": [
        12345,
        67890
      ]
    }
  }
}