> ## 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 curated lists

> Retrieves curated investment lists available to the authenticated user.



## OpenAPI

````yaml /api-reference/openapi.json get /api/v1/curated-lists
openapi: 3.0.1
info:
  title: eToro Api
  version: v1.206.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).
servers:
  - url: https://public-api.etoro.com
    description: eToro Public API
security: []
tags:
  - name: Agent Portfolios
  - name: Watchlists
  - name: Feeds
  - name: Asset Explorer
  - name: Market Data
  - name: Identity
  - name: Notifications
  - name: PI Data
  - name: Comments
  - name: Trading Demo
  - name: Trading Real
  - name: Users Info
  - name: Deprecated
paths:
  /api/v1/curated-lists:
    get:
      tags:
        - Watchlists
      summary: Get curated lists
      description: Retrieves curated investment lists available to the authenticated user.
      operationId: getCuratedLists
      parameters:
        - name: x-request-id
          in: header
          required: true
          schema:
            type: string
            format: uuid
            example: 2f96a5c5-5f4d-421c-8bbd-9b001dd55725
          description: A unique request identifier.
        - name: x-api-key
          in: header
          required: true
          schema:
            type: string
            format: password
            example: lhgfaslk21490FAScVPkdsb53F9dNkfHG4faZSG5vfjndfcfgdssdgsdHF4663
          description: API key for authentication.
        - name: x-user-key
          in: header
          required: true
          schema:
            type: string
            format: password
            example: >-
              eyJlYW4iOiJVbnJlZ2lzdGVyZWRBcHBsaWNhdGlvbiIsImVrIjoiOE5sZ2cwcW5EUVdROUFNWGpXT2lmOWktZnpidG5KcUlqWGJ3WHJZZkpZcldrbG90ZEhvLVBjSWhQaU8xU1ZtMW84aU1WZGZqN2xWNzFjLXFxLmcybXE1dnh4Q1hUT25xaWRUaTFlcEhmVk1fIn0_
          description: User-specific authentication key.
      responses:
        '200':
          description: Successfully retrieved curated lists
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CuratedListsResponse'
        '204':
          description: No curated lists available
components:
  schemas:
    CuratedListsResponse:
      type: object
      description: Response containing curated investment lists
      properties:
        curatedLists:
          type: array
          description: List of curated investment lists
          items:
            $ref: '#/components/schemas/CuratedList'
    CuratedList:
      type: object
      description: Represents a curated investment list
      properties:
        uuid:
          type: string
          description: Unique identifier of the curated list
          example: '12345'
        name:
          type: string
          description: Display name of the curated list
          example: Tech Watchlist
        description:
          type: string
          description: Description of the curated list
          example: A list of tech stocks
        listImageUrl:
          type: string
          description: URL of the list's image
          example: https://example.com/tech-watchlist.jpg
        items:
          type: array
          description: Items in the curated list
          items:
            $ref: '#/components/schemas/CuratedListItem'
          example:
            - instrumentId: 12345
    CuratedListItem:
      type: object
      description: Represents an item in a curated list
      properties:
        instrumentId:
          type: integer
          format: int32
          description: ID of the financial instrument
          example: 12345

````