# Market movers

The market movers endpoint provides a ranked list of the top-gaining and losing assets for the current trading day. It returns detailed data on the highest percentage price increases and decreases since the previous day's close. This endpoint supports international equities, forex, and cryptocurrencies, enabling users to quickly identify significant market movements across various asset classes.

**API credits cost:** `100` per request

> **Note:** This API endpoint is available starting with the [Pro](https://twelvedata.com/pricing) plan.

## Parameters

- `market` (string, required)
  Maket type


- `direction` (string, optional)
  Specifies direction of the snapshot gainers or losers


- `outputsize` (integer, optional)
  Specifies the size of the snapshot.
Can be in a range from `1` to `50`


- `country` (string, optional)
  Country of the snapshot, applicable to non-currencies only.
Takes country name or alpha code


- `price_greater_than` (string, optional)
  Takes values with price grater than specified value


- `dp` (string, optional)
  Specifies the number of decimal places for floating values.
Should be in range [0,11] inclusive



## Response

- `values` (array of object)
  Market movers list
  - `symbol` (string)
    The exchange symbol ticker
  - `name` (string)
    The official name of the instrument
  - `exchange` (string)
    Exchange where instrument is traded
  - `mic_code` (string)
    Market identifier code (MIC) under ISO 10383 standard
  - `datetime` (string)
    The last updated datetime timestamp
  - `last` (number)
    The latest available price for the symbol today
  - `high` (number)
    The highest price for the symbol today
  - `low` (number)
    The lowest price for the symbol today
  - `volume` (integer)
    The trading volume of the symbol today
  - `change` (number)
    The value of the change since the previous day
  - `percent_change` (number)
    The percentage change since the previous day

- `status` (string)
  Response status


## Example Request

```bash
curl "https://api.twelvedata.com/market_movers/stocks?apikey=demo"
```

## Example Response

```json
{
    "values": [
        {
            "symbol": "BSET",
            "name": "Bassett Furniture Industries Inc",
            "exchange": "NASDAQ",
            "mic_code": "XNAS",
            "datetime": "2023-10-01 12:00:00Z",
            "last": 17.25,
            "high": 18,
            "low": 16.5,
            "volume": 108297,
            "change": 3.31,
            "percent_change": 23.74462
        }
    ],
    "status": "ok"
}
```