--- title: "Search for Instruments" method: GET path: "/api/v1/market-data/search" tags: ["Market Data"] --- # Search for Instruments `GET /api/v1/market-data/search` **Rate limit:** 120 requests per 60 seconds. This is a **shared quota** — the same budget is consumed by a group of related endpoints, so calling any of them reduces what is left for the others (you cannot call each at the full rate independently). Endpoints sharing this quota: - `GET /api/v1/market-data/exchanges` - `GET /api/v1/market-data/instrument-types` - `GET /api/v1/market-data/instruments` - `GET /api/v1/market-data/instruments/history/closing-price` - `GET /api/v1/market-data/instruments/rates` - `GET /api/v1/market-data/instruments/{instrumentId}/history/candles/{direction}/{interval}/{candlesCount}` - `GET /api/v1/market-data/stocks-industries` --- Retrieve a paginated list of instruments. Any field in the Instrument response schema can be projected via the required `fields` parameter and/or used as a query-string filter (e.g. `fields=instrumentId,displayname&displayname=Bitcoin`). Use `pageSize`/`pageNumber` to paginate and `sort` to order. Filters that do not match an indexed instrument field are ignored. ## Query parameters - `pageSize` integer - `pageNumber` integer - `fields` string, required - `sort` string ## Headers - `x-request-id` string, uuid, required - `x-api-key` string, password, required - `x-user-key` string, password, required ## Response `200` Successful response containing the list of instruments. - InstrumentSearchResponse - `page` integer — The current page number. - `pageSize` integer — The number of items per page. - `totalItems` integer — The total number of instruments matching the search criteria. - `items` Instrument[] - `instrumentId` integer — A unique identifier for the instrument. - `displayname` string — The display name of the instrument. - `popularityUniques7Day` integer — The number of unique users who viewed this instrument in the last 7 days. - `instrumentTypeID` integer — The type ID of the instrument. - `instrumentType` string — The type of the instrument. - `exchangeID` integer — The ID of the exchange where the instrument is traded. - `isOpen` boolean — Indicates whether the instrument is currently open for trading. - `internalAssetClassId` integer — The internal asset class ID. - `internalInstrumentDisplayName` string — The internal display name of the instrument. - `isInternalInstrument` boolean — Indicates whether the instrument is internal. - `internalSymbolFull` string — The full internal symbol of the instrument. - `isHiddenFromClient` boolean — Indicates whether the instrument is hidden from clients. - `internalInstrumentId` integer — The internal instrument ID. - `internalCryptoTypeId` integer — The internal crypto type ID. - `internalExchangeId` integer — The internal exchange ID. - `internalExchangeName` string — The internal exchange name. - `internalAssetClassName` string — The internal asset class name. - `logo35x35` string — The URL of the 35x35 logo. - `logo50x50` string — The URL of the 50x50 logo. - `logo150x150` string — The URL of the 150x150 logo. - `dailyPriceChange` number — The daily price change. - `absDailyPriceChange` number — The absolute daily price change. - `weeklyPriceChange` number — The weekly price change. - `monthlyPriceChange` number — The monthly price change. - `isDelisted` boolean — Indicates whether the instrument is delisted. - `isCurrentlyTradable` boolean — Indicates whether the instrument is currently tradable. - `isExchangeOpen` boolean — Indicates whether the exchange is open. - `internalClosingPrice` number — The internal closing price. - `isActiveInPlatform` boolean — Indicates whether the instrument is active in the platform. - `isBuyEnabled` boolean — Indicates whether buying is enabled for the instrument. - `currentRate` number — The current rate of the instrument. - `threeMonthPriceChange` number — The three-month price change. - `sixMonthPriceChange` number — The six-month price change. - `oneYearPriceChange` number — The one-year price change. - `currMonthPriceChange` number — The current month price change. - `currQuarterPriceChange` number — The current quarter price change. - `currYearPriceChange` number — The current year price change. - `lastYearPriceChange` number — The last year price change. - `lastTwoYearsPriceChange` number — The last two years price change. - `oneMonthAgoPriceChange` number — The price change from one month ago. - `twoMonthsAgoPriceChange` number — The price change from two months ago. - `threeMonthsAgoPriceChange` number — The price change from three months ago. - `sixMonthsAgoPriceChange` number — The price change from six months ago. - `oneYearAgoPriceChange` number — The price change from one year ago. - `cvtBid` number — The converted bid price. - `cvtAsk` number — The converted ask price. - `cvtBiNoSpread` number — The converted bid price without spread. - `cvtAskNoSpread` number — The converted ask price without spread. - `traders7DayChange` number — The change in the number of traders over the last 7 days. - `traders14DayChange` number — The change in the number of traders over the last 14 days. - `traders30DayChange` number — The change in the number of traders over the last 30 days. - `popularityUniques14Day` integer — The number of unique users who viewed this instrument in the last 14 days. - `popularityUniques30Day` integer — The number of unique users who viewed this instrument in the last 30 days. - `internalIndustryId` integer — The internal industry ID. - `internalStockIndustryName` string — The internal stock industry name. - `popularityUniques` integer — Total number of unique users interested in this instrument. - `holdingPct` number — The holding percentage of this instrument. - `buyHoldingPct` number — The buy holding percentage. - `sellHoldingPct` number — The sell holding percentage. - `buyPctChange24Hours` number — The buy percentage change in the last 24 hours. - `absBuyPctChange24Hours` number — The absolute buy percentage change in the last 24 hours. - `industryNameId` integer — The industry name ID. - `sectorNameId` integer — The sector name ID. ## Other responses - `429` — Too Many Requests — the shared rate limit (120 requests / 60s) was exceeded. --- [API](https://skmtc.dev/etoro/apis/etoro-api.md) · [All operations](https://skmtc.dev/etoro/apis/etoro-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/etoro/etoro-api/revisions/69c1fb266c35/schema)