> ## 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. # Discover instruments > Retrieve a paginated list of instruments with optional sorting, field projection, and arbitrary field filters. Filters are applied by adding any of the supported field names as a query parameter (e.g. `exchangeName=NASDAQ`). Suffixing a field name with `Min` or `Max` applies a greater-than or less-than filter respectively (e.g. `peRatioMin=10`, `marketCapMax=1000000000`). The set of supported field names is fixed and is documented under the `Instrument` schema. ## OpenAPI ````yaml /api-reference/openapi.json get /api/v1/instruments/discover 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/instruments/discover: get: tags: - Asset Explorer summary: Discover instruments description: >- Retrieve a paginated list of instruments with optional sorting, field projection, and arbitrary field filters. Filters are applied by adding any of the supported field names as a query parameter (e.g. `exchangeName=NASDAQ`). Suffixing a field name with `Min` or `Max` applies a greater-than or less-than filter respectively (e.g. `peRatioMin=10`, `marketCapMax=1000000000`). The set of supported field names is fixed and is documented under the `Instrument` schema. operationId: discoverInstruments parameters: - name: x-request-id in: header required: true schema: type: string format: uuid example: 935bea95-c913-463b-8c9f-fa8ac7e4e1a9 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. - name: page in: query description: The 1-based page number to retrieve. required: false schema: type: integer format: int32 example: 1 - name: pageSize in: query description: The number of items to return per page. required: false schema: type: integer format: int32 example: 50 - name: sort in: query description: >- Comma-separated list of `Instrument` fields to sort by. Prefix a field with `-` for descending order. Example: `-marketCap,displayName`. required: false schema: type: string - name: fields in: query description: >- Comma-separated list of `Instrument` fields to include in each item. If omitted, all supported fields are returned. Example: `symbol,displayName,currentRate`. required: false schema: type: string responses: '200': description: Successful response containing a paginated list of instruments. content: application/json: schema: $ref: '#/components/schemas/InstrumentSearchResponse' '400': description: Bad request, for example a malformed query parameter. components: schemas: InstrumentSearchResponse: type: object properties: page: type: integer description: The current page number. pageSize: type: integer description: The number of items per page. totalItems: type: integer description: The total number of instruments matching the search criteria. items: type: array items: $ref: '#/components/schemas/Instrument' Instrument: type: object properties: instrumentId: type: integer description: A unique identifier for the instrument. displayname: type: string description: The display name of the instrument. popularityUniques7Day: type: integer description: >- The number of unique users who viewed this instrument in the last 7 days. instrumentTypeID: type: integer description: The type ID of the instrument. instrumentType: type: string description: The type of the instrument. exchangeID: type: integer description: The ID of the exchange where the instrument is traded. symbol: type: string description: The trading symbol of the instrument. isOpen: type: boolean description: Indicates whether the instrument is currently open for trading. internalAssetClassId: type: integer description: The internal asset class ID. internalInstrumentDisplayName: type: string description: The internal display name of the instrument. isInternalInstrument: type: boolean description: Indicates whether the instrument is internal. internalSymbolFull: type: string description: The full internal symbol of the instrument. isHiddenFromClient: type: boolean description: Indicates whether the instrument is hidden from clients. internalInstrumentId: type: integer description: The internal instrument ID. internalCryptoTypeId: type: integer description: The internal crypto type ID. internalExchangeId: type: integer description: The internal exchange ID. internalExchangeName: type: string description: The internal exchange name. internalAssetClassName: type: string description: The internal asset class name. logo35x35: type: string description: The URL of the 35x35 logo. logo50x50: type: string description: The URL of the 50x50 logo. logo150x150: type: string description: The URL of the 150x150 logo. dailyPriceChange: type: number description: The daily price change. absDailyPriceChange: type: number description: The absolute daily price change. weeklyPriceChange: type: number description: The weekly price change. monthlyPriceChange: type: number description: The monthly price change. isDelisted: type: boolean description: Indicates whether the instrument is delisted. isCurrentlyTradable: type: boolean description: Indicates whether the instrument is currently tradable. isExchangeOpen: type: boolean description: Indicates whether the exchange is open. internalClosingPrice: type: number description: The internal closing price. isActiveInPlatform: type: boolean description: Indicates whether the instrument is active in the platform. isBuyEnabled: type: boolean description: Indicates whether buying is enabled for the instrument. currentRate: type: number description: The current rate of the instrument. threeMonthPriceChange: type: number description: The three-month price change. sixMonthPriceChange: type: number description: The six-month price change. oneYearPriceChange: type: number description: The one-year price change. currMonthPriceChange: type: number description: The current month price change. currQuarterPriceChange: type: number description: The current quarter price change. currYearPriceChange: type: number description: The current year price change. lastYearPriceChange: type: number description: The last year price change. lastTwoYearsPriceChange: type: number description: The last two years price change. oneMonthAgoPriceChange: type: number description: The price change from one month ago. twoMonthsAgoPriceChange: type: number description: The price change from two months ago. threeMonthsAgoPriceChange: type: number description: The price change from three months ago. sixMonthsAgoPriceChange: type: number description: The price change from six months ago. oneYearAgoPriceChange: type: number description: The price change from one year ago. cvtBid: type: number description: The converted bid price. cvtAsk: type: number description: The converted ask price. cvtBiNoSpread: type: number description: The converted bid price without spread. cvtAskNoSpread: type: number description: The converted ask price without spread. traders7DayChange: type: number description: The change in the number of traders over the last 7 days. traders14DayChange: type: number description: The change in the number of traders over the last 14 days. traders30DayChange: type: number description: The change in the number of traders over the last 30 days. popularityUniques14Day: type: integer description: >- The number of unique users who viewed this instrument in the last 14 days. popularityUniques30Day: type: integer description: >- The number of unique users who viewed this instrument in the last 30 days. internalIndustryId: type: integer description: The internal industry ID. internalStockIndustryName: type: string description: The internal stock industry name. popularityUniques: type: integer description: Total number of unique users interested in this instrument. holdingPct: type: number description: The holding percentage of this instrument. buyHoldingPct: type: number description: The buy holding percentage. sellHoldingPct: type: number description: The sell holding percentage. buyPctChange24Hours: type: number description: The buy percentage change in the last 24 hours. absBuyPctChange24Hours: type: number description: The absolute buy percentage change in the last 24 hours. industryNameId: type: integer description: The industry name ID. sectorNameId: type: integer description: The sector name ID. ````