> ## Documentation Index
> Fetch the complete documentation index at: https://api-portal.etoro.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get user watchlists (BFF V2)

> **Rate limit:** 60 requests per 60 seconds. This is a **dedicated** limit for this endpoint — it is **not shared** with (pooled across) any other endpoint, so the full rate is available to this endpoint alone.

---

Retrieves the authenticated user's watchlists as a BFF component response (V2 facade). The request body selects the userWatchlists component and its params.



## OpenAPI

````yaml /api-reference/openapi.json post /api/v2/watchlists
openapi: 3.0.1
info:
  title: eToro Api
  version: v1.352.0
  description: >-
    eToro’s public API provides access to real-time financial data, trading
    insights, and account management features, allowing developers to integrate
    eToro’s services into their applications. With access to market prices,
    historical data, and social trading information, the API empowers users to
    enhance their trading strategies. Designed for security and scalability, the
    eToro API ensures smooth and reliable integration for a variety of financial
    applications.


    For more details on integrating with eToro's public WebSocket service,
    please refer to the dedicated [WebSocket
    documentation](./websocket/websocket-doc.html).


    ## Authentication


    Every request must be authenticated with exactly one of two options: an
    OAuth 2.0 access token (`Authorization: Bearer <token>`), or the
    non-interactive credential pair (`x-api-key` + `x-user-key` headers). The
    two options are mutually exclusive — a request carrying both is rejected.
    Each operation lists the OAuth scopes that grant access as alternative
    security requirements: a bearer token needs only ONE of them, and the same
    permissions govern the credential pair.
servers:
  - url: https://public-api.etoro.com
    description: eToro Public API
security:
  - apiKeyAuth: []
    userKeyAuth: []
  - oauth2: []
tags:
  - name: Agent Portfolios
  - name: Social Feeds
  - name: Balances
  - name: Clubs
  - name: Watchlists
  - name: Top Assets
  - name: App Data
  - name: Market Data
  - name: Identity
  - name: Cash Accounts
  - name: Transfer
  - name: Notifications
  - name: PI Data
  - name: PortfolioSearch
  - name: Price Alerts
  - name: SSO - Applications
  - name: SSO - Scopes
  - name: Sub-Accounts - eToro Trading
  - name: Sub-Accounts
  - name: Trading - Demo
  - name: Trading - Real
  - name: Users Info
  - name: Rankings
  - name: User Stats
  - name: Copy Trading
  - name: Copy Trading - Demo
paths:
  /api/v2/watchlists:
    post:
      tags:
        - Watchlists
      summary: Get user watchlists (BFF V2)
      description: >-
        **Rate limit:** 60 requests per 60 seconds. This is a **dedicated**
        limit for this endpoint — it is **not shared** with (pooled across) any
        other endpoint, so the full rate is available to this endpoint alone.


        ---


        Retrieves the authenticated user's watchlists as a BFF component
        response (V2 facade). The request body selects the userWatchlists
        component and its params.
      operationId: getWatchlistsV2
      parameters:
        - name: x-request-id
          in: header
          required: true
          schema:
            type: string
            format: uuid
            example: 8ce449bf-4624-4bb4-8c3c-ca1e6e19c8d1
          description: A unique request identifier.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BffFacadeRequest'
            example:
              version: 1
              requestId: d1aab7dd-8a63-4a64-9b9f-8b6c0e2e0f2a
              components:
                - type: userWatchlists
                  supportedVariations: []
                  params:
                    itemsPerPageForSingle: 2
                    ensureBuiltinWatchlists: true
                    addRelatedAssets: true
      responses:
        '200':
          description: Successfully retrieved user watchlists as BFF component
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WatchlistComponentResponse'
          headers:
            RateLimit-Limit:
              description: >-
                Maximum number of requests allowed per window. This limit is
                dedicated to this endpoint — it is not shared with (pooled
                across) any other endpoint.
              schema:
                type: integer
              example: 60
            RateLimit-Remaining:
              description: Requests remaining in the current window for this quota.
              schema:
                type: integer
            RateLimit-Reset:
              description: Seconds until the current window resets.
              schema:
                type: integer
            RateLimit-Policy:
              description: Quota policy in the form `<limit>;w=<window-seconds>`.
              schema:
                type: string
              example: 60;w=60
        '400':
          description: Invalid BFF facade request
        '429':
          description: Too Many Requests — the rate limit (60 requests / 60s) was exceeded.
          headers:
            RateLimit-Limit:
              description: >-
                Maximum number of requests allowed per window. This limit is
                dedicated to this endpoint — it is not shared with (pooled
                across) any other endpoint.
              schema:
                type: integer
              example: 60
            RateLimit-Remaining:
              description: Requests remaining in the current window for this quota.
              schema:
                type: integer
            RateLimit-Reset:
              description: Seconds until the current window resets.
              schema:
                type: integer
            RateLimit-Policy:
              description: Quota policy in the form `<limit>;w=<window-seconds>`.
              schema:
                type: string
              example: 60;w=60
            Retry-After:
              description: Seconds to wait before retrying.
              schema:
                type: integer
              example: 60
      security:
        - apiKeyAuth: []
          userKeyAuth: []
        - oauth2:
            - etoro-public:demo:read
        - oauth2:
            - etoro-public:demo:write
        - oauth2:
            - etoro-public:real:read
        - oauth2:
            - etoro-public:real:write
        - oauth2:
            - etoro-public:watchlist:read
        - oauth2:
            - etoro-public:watchlist:write
components:
  schemas:
    BffFacadeRequest:
      type: object
      description: BFF facade request selecting one or more components to resolve
      required:
        - version
        - requestId
        - components
      properties:
        version:
          type: integer
          format: int32
          minimum: 1
          description: BFF request contract version
          example: 1
        requestId:
          type: string
          description: Caller-supplied correlation id for the BFF request
          example: d1aab7dd-8a63-4a64-9b9f-8b6c0e2e0f2a
        components:
          type: array
          description: Components to resolve; must include a userWatchlists entry
          minItems: 1
          items:
            type: object
            required:
              - type
            properties:
              type:
                type: string
                description: Component type
                example: userWatchlists
              supportedVariations:
                type: array
                items:
                  type: string
                example: []
              params:
                type: object
                description: Component-specific parameters
                properties:
                  itemsPerPageForSingle:
                    type: integer
                    format: int32
                    description: Number of items to include per watchlist
                    example: 2
                  ensureBuiltinWatchlists:
                    type: boolean
                    description: Whether to ensure built-in watchlists exist for the user
                    example: true
                  addRelatedAssets:
                    type: boolean
                    description: Whether to include related assets on watchlists
                    example: true
    WatchlistComponentResponse:
      type: object
      description: BFF component envelope returned by watchlist V2 facade endpoints
      properties:
        kind:
          type: string
          example: component
        type:
          type: string
          description: Component type
          example: userWatchlists
        status:
          type: string
          example: ok
        data:
          type: object
          description: >-
            Component payload containing the user's watchlists and enrichment
            data
          properties:
            watchlists:
              type: array
              description: User watchlists, enriched for client rendering
              items:
                allOf:
                  - $ref: '#/components/schemas/WatchlistResponse'
                  - type: object
                    properties:
                      userActions:
                        type: object
                        description: >-
                          Which watchlist operations the caller may offer for
                          this watchlist
                        properties:
                          enableRename:
                            type: boolean
                            example: true
                          enableDelete:
                            type: boolean
                            example: true
                          enableSetAsDefault:
                            type: boolean
                            example: true
                          enableRearrangedWithDragAndDrop:
                            type: boolean
                            example: true
                          enableAddingItems:
                            type: boolean
                            example: true
            enrichmentData:
              type: object
              description: >-
                Shared enrichment data referenced by the watchlist items, keyed
                by item identifier. Instruments are keyed by instrument id;
                users and smart portfolios are keyed by GCID.
              properties:
                instruments:
                  type: object
                  description: >-
                    Market enrichment data for instrument items, keyed by
                    instrument id.
                  additionalProperties:
                    $ref: '#/components/schemas/MarketEnrichData'
                users:
                  type: object
                  description: >-
                    Popular-investor enrichment data for user items, keyed by
                    GCID.
                  additionalProperties:
                    $ref: '#/components/schemas/UserEnrichData'
                smartPortfolios:
                  type: object
                  description: >-
                    Smart-portfolio enrichment data for smart-portfolio items,
                    keyed by GCID.
                  additionalProperties:
                    $ref: '#/components/schemas/SmartPortfolioEnrichData'
            pagination:
              type: object
              description: Pagination applied to the watchlist items
              properties:
                page:
                  type: integer
                  format: int32
                  example: 0
                pageSize:
                  type: integer
                  format: int32
                  example: 100
                totalCount:
                  type: integer
                  format: int32
                  example: 1
                hasNext:
                  type: boolean
                  example: false
        actions:
          type: object
          description: Client actions available on the component, keyed by action name
        meta:
          type: object
          description: Component metadata, including the client cache directive
          properties:
            cache:
              type: object
              properties:
                maxAgeSeconds:
                  type: integer
                  format: int32
                  example: 100
        errors:
          type: array
          items:
            type: object
    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
    MarketEnrichData:
      type: object
      description: Market enrichment data for an instrument referenced by a watchlist item.
      properties:
        market:
          $ref: '#/components/schemas/InstrumentMarketData'
        candles1D:
          type: array
          description: Intraday price candles for the last day.
          items:
            $ref: '#/components/schemas/CandlePoint'
        candles1W:
          type: array
          description: Price candles for the last week.
          items:
            $ref: '#/components/schemas/CandlePoint'
        candles1M:
          type: array
          description: Price candles for the last month.
          items:
            $ref: '#/components/schemas/CandlePoint'
        currentRate:
          type: number
          format: double
          nullable: true
          description: Current market rate of the instrument.
          example: 189.25
        priceChangeAbsolute1D:
          type: number
          format: double
          nullable: true
          description: Absolute price change over the last day.
        priceChangeAbsolute1W:
          type: number
          format: double
          nullable: true
          description: Absolute price change over the last week.
        priceChangeAbsolute1M:
          type: number
          format: double
          nullable: true
          description: Absolute price change over the last month.
        priceChangePercentage1D:
          type: number
          format: double
          nullable: true
          description: Percentage price change over the last day.
          example: 1.24
        priceChangePercentage1W:
          type: number
          format: double
          nullable: true
          description: Percentage price change over the last week.
        priceChangePercentage1M:
          type: number
          format: double
          nullable: true
          description: Percentage price change over the last month.
        marketCap:
          type: integer
          format: int64
          nullable: true
          description: Market capitalization in the instrument's currency.
        marketCapInUSD:
          type: number
          format: double
          nullable: true
          description: Market capitalization in USD.
        volume:
          type: integer
          format: int64
          nullable: true
          description: Traded volume.
        peRatio:
          type: number
          format: double
          nullable: true
          description: Price-to-earnings ratio.
        revenueGrowth:
          type: number
          format: double
          nullable: true
          description: Revenue growth.
        dividendYield:
          type: number
          format: double
          nullable: true
          description: Dividend yield.
        dividendYieldDaily:
          type: number
          format: double
          nullable: true
          description: Daily dividend yield.
        percentPriceChangeYTD:
          type: number
          format: double
          nullable: true
          description: Year-to-date percentage price change.
        oneYearPriceChange:
          type: number
          format: double
          nullable: true
          description: Price change over the last year.
        highPriceLast52Weeks:
          type: number
          format: double
          nullable: true
          description: Highest price over the last 52 weeks.
        lowPriceLast52Weeks:
          type: number
          format: double
          nullable: true
          description: Lowest price over the last 52 weeks.
        tipranksAllConsensus:
          type: string
          nullable: true
          description: TipRanks analyst consensus rating.
        tipranksAllPriceTarget:
          type: number
          format: double
          nullable: true
          description: TipRanks average analyst price target.
        tipranksAllUpside:
          type: number
          format: double
          nullable: true
          description: TipRanks implied upside.
        buyHoldingPct:
          type: number
          format: double
          nullable: true
          description: Share of eToro clients holding a buy position.
        salesOrRevenue:
          type: integer
          format: int64
          nullable: true
          description: Sales or revenue.
        netProfitMargin:
          type: number
          format: double
          nullable: true
          description: Net profit margin.
        beta:
          type: number
          format: double
          nullable: true
          description: Beta relative to the market.
        priceToSales:
          type: number
          format: double
          nullable: true
          description: Price-to-sales ratio.
        umbrellaSector:
          type: string
          nullable: true
          description: High-level sector classification.
        isMarketOpen:
          type: boolean
          nullable: true
          description: Whether the instrument's market is currently open.
        isTradable:
          type: boolean
          description: Whether the instrument is currently tradable.
        tradeButtonStatusData:
          $ref: '#/components/schemas/TradeButtonStatusData'
        52WMin:
          type: number
          format: double
          nullable: true
          description: 52-week minimum price.
        52WMax:
          type: number
          format: double
          nullable: true
          description: 52-week maximum price.
    UserEnrichData:
      type: object
      description: >-
        Enrichment data for a user (popular investor) referenced by a watchlist
        item.
      properties:
        Cid:
          type: integer
          format: int32
          description: Customer id of the user.
          example: 12345
        username:
          type: string
          description: Username.
          example: johndoe
        fullName:
          type: string
          nullable: true
          description: Full name of the user.
        isPi:
          type: boolean
          description: Whether the user is a Popular Investor.
        avatar:
          $ref: '#/components/schemas/WatchlistApi_Avatar'
        changePercentage1M:
          type: number
          format: double
          nullable: true
          description: Performance change over the last month.
        changePercentage3M:
          type: number
          format: double
          nullable: true
          description: Performance change over the last 3 months.
        changePercentage6M:
          type: number
          format: double
          nullable: true
          description: Performance change over the last 6 months.
        changePercentage1Y:
          type: number
          format: double
          nullable: true
          description: Performance change over the last year.
        riskScore1M:
          type: integer
          format: int32
          nullable: true
          description: Risk score over the last month.
        riskScore3M:
          type: integer
          format: int32
          nullable: true
          description: Risk score over the last 3 months.
        riskScore6M:
          type: integer
          format: int32
          nullable: true
          description: Risk score over the last 6 months.
        riskScore1Y:
          type: integer
          format: int32
          nullable: true
          description: Risk score over the last year.
        copiers:
          type: integer
          format: int32
          nullable: true
          description: Number of users copying this investor.
        return1M:
          type: number
          format: double
          nullable: true
          description: Return over the last month.
        return3M:
          type: number
          format: double
          nullable: true
          description: Return over the last 3 months.
        return6M:
          type: number
          format: double
          nullable: true
          description: Return over the last 6 months.
        return1Y:
          type: number
          format: double
          nullable: true
          description: Return over the last year.
    SmartPortfolioEnrichData:
      type: object
      description: Enrichment data for a smart portfolio referenced by a watchlist item.
      properties:
        Cid:
          type: integer
          format: int32
          description: Customer id of the smart portfolio.
          example: 12345
        username:
          type: string
          description: Smart portfolio name.
          example: TechLeaders
        fullName:
          type: string
          nullable: true
          description: Full display name of the smart portfolio.
        isPi:
          type: boolean
          description: Whether the smart portfolio owner is a Popular Investor.
        avatar:
          $ref: '#/components/schemas/WatchlistApi_Avatar'
        changePercentage1M:
          type: number
          format: double
          nullable: true
          description: Performance change over the last month.
        changePercentage3M:
          type: number
          format: double
          nullable: true
          description: Performance change over the last 3 months.
        changePercentage6M:
          type: number
          format: double
          nullable: true
          description: Performance change over the last 6 months.
        changePercentage1Y:
          type: number
          format: double
          nullable: true
          description: Performance change over the last year.
        riskScore1M:
          type: integer
          format: int32
          nullable: true
          description: Risk score over the last month.
        riskScore3M:
          type: integer
          format: int32
          nullable: true
          description: Risk score over the last 3 months.
        riskScore6M:
          type: integer
          format: int32
          nullable: true
          description: Risk score over the last 6 months.
        riskScore1Y:
          type: integer
          format: int32
          nullable: true
          description: Risk score over the last year.
        investorsCount:
          type: integer
          format: int32
          nullable: true
          description: Number of investors in the smart portfolio.
        return1M:
          type: number
          format: double
          nullable: true
          description: Return over the last month.
        return3M:
          type: number
          format: double
          nullable: true
          description: Return over the last 3 months.
        return6M:
          type: number
          format: double
          nullable: true
          description: Return over the last 6 months.
        return1Y:
          type: number
          format: double
          nullable: true
          description: Return over the last year.
    WatchlistItemDto:
      type: object
      description: Represents an item in a watchlist
      required:
        - itemId
        - itemType
      properties:
        itemId:
          type: integer
          format: int32
          description: Unique identifier of the financial instrument
          example: 12345
        itemType:
          type: string
          description: Type of the financial instrument (e.g., 'Instrument', 'Person')
          example: Instrument
        itemRank:
          type: integer
          format: int32
          description: Ranking position of the item in the watchlist
          default: 0
          example: 1
        itemAddedReason:
          type: string
          description: Reason the item was added to the watchlist
          example: Manual
        itemAddedDate:
          type: string
          format: date-time
          description: Date and time the item was added
        market:
          type: object
          description: Market metadata for the instrument when included
          properties:
            id:
              type: string
            symbolName:
              type: string
            displayName:
              type: string
            assetTypeId:
              type: integer
              format: int32
            assetTypeSubCategoryId:
              type: integer
              format: int32
              nullable: true
            exchangeId:
              type: integer
              format: int32
            hasExpirationDate:
              type: boolean
            avatar:
              type: object
              properties:
                small:
                  type: string
                medium:
                  type: string
                large:
                  type: string
                svg:
                  type: object
                  nullable: true
                  description: SVG avatar with background and text colors
                  properties:
                    url:
                      type: string
                    backgroundColor:
                      type: string
                    textColor:
                      type: string
    InstrumentMarketData:
      type: object
      description: Core market metadata for an instrument.
      properties:
        id:
          type: integer
          format: int32
          description: Instrument id.
          example: 100000
        symbolName:
          type: string
          description: Instrument symbol.
          example: AAPL
        displayName:
          type: string
          description: Human-readable instrument name.
          example: Apple
        assetTypeId:
          type: integer
          format: int32
          nullable: true
          description: Asset type id.
        assetTypeSubCategoryId:
          type: integer
          format: int32
          nullable: true
          description: Asset type sub-category id.
        exchangeId:
          type: integer
          format: int32
          nullable: true
          description: Exchange id.
        hasExpirationDate:
          type: boolean
          nullable: true
          description: Whether the instrument has an expiration date.
        avatar:
          $ref: '#/components/schemas/WatchlistApi_Avatar'
    CandlePoint:
      type: object
      description: A single price candle point.
      properties:
        price:
          type: number
          format: double
          description: Price at the candle timestamp.
        timestamp:
          type: string
          format: date-time
          description: Candle timestamp (ISO 8601 UTC).
    TradeButtonStatusData:
      type: object
      description: Trade-button availability and trading metadata for an instrument.
      properties:
        instrumentId:
          type: integer
          format: int32
          description: Instrument id.
        buyButtonEnable:
          type: boolean
          description: Whether the buy button is enabled.
        sellButtonEnable:
          type: boolean
          description: Whether the sell button is enabled.
        allowClosePosition:
          type: boolean
          description: Whether closing a position is allowed.
        tradingAdditionalData:
          $ref: '#/components/schemas/TradingAdditionalData'
        instrumentMetadataSlim:
          $ref: '#/components/schemas/InstrumentMetadataSlim'
        siblingData:
          $ref: '#/components/schemas/SiblingData'
    WatchlistApi_Avatar:
      type: object
      description: Instrument or user avatar in multiple sizes.
      properties:
        small:
          type: string
          nullable: true
          description: URL of the small avatar image.
        medium:
          type: string
          nullable: true
          description: URL of the medium avatar image.
        large:
          type: string
          nullable: true
          description: URL of the large avatar image.
        svg:
          $ref: '#/components/schemas/SvgAvatar'
    TradingAdditionalData:
      type: object
      description: Additional trading configuration for an instrument.
      properties:
        leveragesConfig:
          type: array
          description: Available leverage configurations.
          items:
            $ref: '#/components/schemas/LeverageConfig'
        highLeverage:
          type: object
          nullable: true
          description: High-leverage configuration, when available.
        requiresW8Ben:
          type: boolean
          description: Whether a W-8BEN form is required to trade.
        allowRevolvingDoors:
          type: boolean
          description: Whether revolving-doors trading is allowed.
        minExposureAmount:
          type: number
          format: double
          description: Minimum exposure amount.
    InstrumentMetadataSlim:
      type: object
      description: Slim instrument metadata used by the trade button.
      properties:
        symbol:
          type: string
          description: Instrument symbol.
        symbolFull:
          type: string
          description: Full instrument symbol.
        name:
          type: string
          description: Instrument name.
        avatarUrl:
          type: string
          description: Instrument avatar URL.
        instrumentTypeId:
          type: integer
          format: int32
          description: Instrument type id.
        exchangeId:
          type: integer
          format: int32
          description: Exchange id.
        currencyId:
          type: integer
          format: int32
          description: Currency id.
        exchangeMarket:
          type: string
          description: Exchange market.
        multiplier:
          type: number
          format: double
          description: Price multiplier.
        indexPointValue:
          type: number
          format: double
          description: Index point value.
        expirationDate:
          type: string
          format: date-time
          nullable: true
          description: Expiration date, when applicable.
        lastTradingDate:
          type: string
          format: date-time
          nullable: true
          description: Last trading date, when applicable.
        precision:
          type: integer
          format: int32
          description: Price precision.
        aboveDollarPrecision:
          type: integer
          format: int32
          description: Price precision above one dollar.
    SiblingData:
      type: object
      description: Sibling instrument information.
      properties:
        hasSibling:
          type: boolean
          description: Whether the instrument has a sibling instrument.
        isExtendedHoursInstrument:
          type: boolean
          description: Whether the instrument trades in extended hours.
        siblingInstrumentId:
          type: integer
          format: int32
          nullable: true
          description: Id of the sibling instrument, when present.
    SvgAvatar:
      type: object
      nullable: true
      description: SVG avatar with background and text colors.
      properties:
        url:
          type: string
          nullable: true
          description: URL of the SVG avatar.
        backgroundColor:
          type: string
          nullable: true
          description: Background color.
        textColor:
          type: string
          nullable: true
          description: Text color.
    LeverageConfig:
      type: object
      description: Leverage configuration for a trade direction.
      properties:
        leverageValues:
          type: array
          description: Allowed leverage values.
          items:
            type: integer
            format: int32
        settlementTypeId:
          type: integer
          format: int32
          description: Settlement type id.
        isBuy:
          type: boolean
          description: Whether this configuration applies to buy positions.
        isPotential:
          type: boolean
          description: Whether this configuration is potential.
        defaultLeverage:
          type: integer
          format: int32
          nullable: true
          description: Default leverage.
        minPositionAmountAbsolute:
          type: number
          format: double
          description: Minimum absolute position amount.
        maxStopLossPercentage:
          type: number
          format: double
          description: Maximum stop-loss percentage.
        maxTakeProfitPercentage:
          type: number
          format: double
          description: Maximum take-profit percentage.
        allowTrailingStopLoss:
          type: boolean
          description: Whether trailing stop-loss is allowed.
        allowEditStopLoss:
          type: boolean
          description: Whether editing stop-loss is allowed.
        allowEditTakeProfit:
          type: boolean
          description: Whether editing take-profit is allowed.
        minStopLossPercentage:
          type: number
          format: double
          description: Minimum stop-loss percentage.
        minTakeProfitPercentage:
          type: number
          format: double
          description: Minimum take-profit percentage.
        defaultStopLossPercentage:
          type: number
          format: double
          description: Default stop-loss percentage.
        defaultTakeProfitPercentage:
          type: number
          format: double
          description: Default take-profit percentage.
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        API key of the application. Only valid together with the x-user-key
        header — the pair is an alternative to OAuth bearer authentication,
        never sent alongside it. The pair is granted the same permissions the
        operation's OAuth scopes describe.


        Demo credential for trying the API from these docs:
        `lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663`
      x-default: lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663
    userKeyAuth:
      type: apiKey
      in: header
      name: x-user-key
      description: >-
        User-specific authentication key. Only valid together with the x-api-key
        header — the pair is an alternative to OAuth bearer authentication,
        never sent alongside it.


        Demo credential for trying the API from these docs:
        `eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_`
      x-default: >-
        eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_
    oauth2:
      type: oauth2
      description: >-
        eToro OAuth2 — send the access token as `Authorization: Bearer <token>`.
        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. Mutually exclusive with the
        x-api-key/x-user-key credential pair: never send both.
      flows:
        authorizationCode:
          authorizationUrl: ''
          tokenUrl: ''
          scopes:
            etoro-public:agent-portfolio:read: Grants access to the 'etoro-public:agent-portfolio:read' scope.
            etoro-public:agent-portfolio:write: Grants access to the 'etoro-public:agent-portfolio:write' scope.
            etoro-public:club:read: Grants access to the 'etoro-public:club:read' scope.
            etoro-public:demo:read: Grants access to the 'etoro-public:demo:read' scope.
            etoro-public:demo:write: Grants access to the 'etoro-public:demo:write' scope.
            etoro-public:feed:read: Grants access to the 'etoro-public:feed:read' scope.
            etoro-public:feed:write: Grants access to the 'etoro-public:feed:write' scope.
            etoro-public:money.balance:read: Grants access to the 'etoro-public:money.balance:read' scope.
            etoro-public:money.cash-transactions:read: >-
              Grants access to the 'etoro-public:money.cash-transactions:read'
              scope.
            etoro-public:money.transfer:read: Grants access to the 'etoro-public:money.transfer:read' scope.
            etoro-public:money.transfer:write: Grants access to the 'etoro-public:money.transfer:write' scope.
            etoro-public:money:transfer: Grants access to the 'etoro-public:money:transfer' scope.
            etoro-public:notifications:read: Grants access to the 'etoro-public:notifications:read' scope.
            etoro-public:notifications:write: Grants access to the 'etoro-public:notifications:write' scope.
            etoro-public:pi-data:read: Grants access to the 'etoro-public:pi-data:read' scope.
            etoro-public:price-alerts:read: Grants access to the 'etoro-public:price-alerts:read' scope.
            etoro-public:price-alerts:write: Grants access to the 'etoro-public:price-alerts:write' scope.
            etoro-public:real:read: Grants access to the 'etoro-public:real:read' scope.
            etoro-public:real:write: Grants access to the 'etoro-public:real:write' scope.
            etoro-public:sso-applications:read: Grants access to the 'etoro-public:sso-applications:read' scope.
            etoro-public:sso-applications:write: Grants access to the 'etoro-public:sso-applications:write' scope.
            etoro-public:sso-scopes:read: Grants access to the 'etoro-public:sso-scopes:read' scope.
            etoro-public:sso-scopes:write: Grants access to the 'etoro-public:sso-scopes:write' scope.
            etoro-public:sub-accounts:read: Grants access to the 'etoro-public:sub-accounts:read' scope.
            etoro-public:sub-accounts:write: Grants access to the 'etoro-public:sub-accounts:write' scope.
            etoro-public:trade.demo:read: Grants access to the 'etoro-public:trade.demo:read' scope.
            etoro-public:trade.demo:write: Grants access to the 'etoro-public:trade.demo:write' scope.
            etoro-public:trade.real:read: Grants access to the 'etoro-public:trade.real:read' scope.
            etoro-public:trade.real:write: Grants access to the 'etoro-public:trade.real:write' scope.
            etoro-public:user-info:read: Grants access to the 'etoro-public:user-info:read' scope.
            etoro-public:watchlist:read: Grants access to the 'etoro-public:watchlist:read' scope.
            etoro-public:watchlist:write: Grants access to the 'etoro-public:watchlist:write' scope.

````