> ## 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. # Search for Instruments > Retrieve a list of instruments based on various search criteria. Each field in the response can be utilized as a filter or projection. ## OpenAPI ````yaml /api-reference/openapi.json get /api/v1/market-data/search 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/market-data/search: get: tags: - Market Data summary: Search for Instruments description: >- Retrieve a list of instruments based on various search criteria. Each field in the response can be utilized as a filter or projection. operationId: searchForInstruments parameters: - name: x-request-id in: header required: true schema: type: string format: uuid example: f477fbe1-3459-4f42-9869-dda182c79fc4 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: searchText in: query description: Text to search for within instrument names. required: false schema: type: string - name: pageSize in: query description: The number of results to return per page. required: false schema: type: integer - name: pageNumber in: query description: The page number to retrieve for pagination. required: false schema: type: integer - name: fields in: query description: >- A comma-separated list of fields to include in the response. Example: pop=popularityUniques7Day,displayname required: true schema: type: string - name: sort in: query description: >- The field to sort by, with direction (asc/desc). Example: popularityUniques7Day desc required: false schema: type: string responses: '200': description: Successful response containing the list of instruments. content: application/json: schema: $ref: '#/components/schemas/InstrumentSearchResponse' 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. ````