--- title: "Gainers/Losers" method: GET path: "/v2/snapshot/locale/us/markets/stocks/{direction}" tags: ["stocks:snapshot"] --- # Gainers/Losers `GET /v2/snapshot/locale/us/markets/stocks/{direction}` Get the most up-to-date market data for the current top 20 gainers or losers of the day in the stocks/equities markets.

Top gainers are those tickers whose price has increased by the highest percentage since the previous day's close. Top losers are those tickers whose price has decreased by the highest percentage since the previous day's close. This output will only include tickers with a trading volume of 10,000 or more.

Note: Snapshot data is cleared at 3:30am EST and gets populated as data is received from the exchanges. ## Path parameters - `direction` 'gainers' | 'losers', required ## Query parameters - `include_otc` boolean ## Response `200` Get the current tickers of the day - object - `status` string, required — The status of this request's response. - `tickers` object[] — An array of snapshot data for the specified tickers. - `day` object — The most recent daily bar for this ticker. - `c` number, double, required — The close price for the symbol in the given time period. - `dv` string — The volume including fractional shares, respresented as a string. - `h` number, double, required — The highest price for the symbol in the given time period. - `l` number, double, required — The lowest price for the symbol in the given time period. - `o` number, double, required — The open price for the symbol in the given time period. - `otc` boolean — Whether or not this aggregate is for an OTC ticker. This field will be left off if false. - `v` number, double, required — The trading volume of the symbol in the given time period. - `vw` number, double, required — The volume weighted average price. - `fmv` number, double — Fair market value is only available on Business plans. It is our proprietary algorithm to generate a real-time, accurate, fair market value of a tradable security. For more information, contact us. - `lastQuote` object — The most recent quote for this ticker. This is only returned if your current plan includes quotes. - `P` number, double, required — The ask price. - `S` integer, required — The ask size in lots. - `p` number, double, required — The bid price. - `s` integer, required — The bid size in lots. - `t` integer, required — The nanosecond accuracy SIP Unix Timestamp. This is the timestamp of when the SIP received this message from the exchange which produced it. - `lastTrade` object — The most recent trade for this ticker. This is only returned if your current plan includes trades. - `c` integer[], required — The trade conditions. - `ds` string, required — The size of the trade including fractional shares, respresented as a string. - `i` string, required — The Trade ID which uniquely identifies a trade. These are unique per combination of ticker, exchange, and TRF. For example: A trade for AAPL executed on NYSE and a trade for AAPL executed on NASDAQ could potentially have the same Trade ID. - `p` number, double, required — The price of the trade. This is the actual dollar value per whole share of this trade. A trade of 100 shares with a price of $2.00 would be worth a total dollar value of $200.00. - `s` integer, required — The size (volume) of the trade. - `t` integer, required — The nanosecond accuracy SIP Unix Timestamp. This is the timestamp of when the SIP received this message from the exchange which produced it. - `x` integer, required — The exchange ID. See Exchanges for Massive's mapping of exchange IDs. - `min` object — The most recent minute bar for this ticker. - `av` integer, required — The accumulated volume. - `c` number, double, required — The close price for the symbol in the given time period. - `dav` string, required — The accumulated volume including fractional shares, respresented as a string. - `dv` string — The volume including fractional shares, respresented as a string. - `h` number, double, required — The highest price for the symbol in the given time period. - `l` number, double, required — The lowest price for the symbol in the given time period. - `n` integer, required — The number of transactions in the aggregate window. - `o` number, double, required — The open price for the symbol in the given time period. - `otc` boolean — Whether or not this aggregate is for an OTC ticker. This field will be left off if false. - `t` integer, required — The Unix millisecond timestamp for the start of the aggregate window. - `v` number, double, required — The trading volume of the symbol in the given time period. - `vw` number, double, required — The volume weighted average price. - `prevDay` object — The previous day's bar for this ticker. - `c` number, double, required — The close price for the symbol in the given time period. - `h` number, double, required — The highest price for the symbol in the given time period. - `l` number, double, required — The lowest price for the symbol in the given time period. - `o` number, double, required — The open price for the symbol in the given time period. - `otc` boolean — Whether or not this aggregate is for an OTC ticker. This field will be left off if false. - `v` number, double, required — The trading volume of the symbol in the given time period. - `vw` number, double, required — The volume weighted average price. - `ticker` string — The exchange symbol that this item is traded under. - `todaysChange` number, double — The value of the change from the previous day. - `todaysChangePerc` number, double — The percentage change since the previous day. - `updated` integer — The last updated timestamp. ## Other responses - `default` — Unexpected error --- [API](https://skmtc.net/massive/apis/polygon-api.md) · [All operations](https://skmtc.net/massive/apis/polygon-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/massive/polygon-api/revisions/ad6f143e43aa/schema)