# 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 on the <a href="https://twelvedata.com/pricing">Pro</a> plan (individual) and the <a href="https://twelvedata.com/pricing-business">Venture</a> plan (business) and above.

## Parameters

- `market` (string, required)
  Market type
  Example value: `stocks`
  Available values: `stocks`, `etf`, `mutual_funds`, `forex`, `crypto`


- `direction` (string, optional)
  Specifies direction of the snapshot gainers or losers
  Available values: `gainers`, `losers`
  Default value: `gainers`


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


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


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


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



## 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=your_api_key"
```

## 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"
}
```