> ## Documentation Index
> Fetch the complete documentation index at: https://readme.amana-dev.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List top movers

> List the instruments with the biggest price moves, optionally filtered by sector or industry.

## Query parameters

<ParamField query="count" type="integer" default="10">
  Minimum: `1`

  Maximum: `100`
</ParamField>

<ParamField query="sector" type="string">
  Sector filter. comma separated numbers
</ParamField>

<ParamField query="industry" type="string">
  Industry filter. comma separated numbers
</ParamField>

## Response

`200` Success.

<ResponseField name="response" type="object[]">
  <Expandable title="properties">
    <ResponseField name="_id" type="string">
      Unique identifier for the symbol
    </ResponseField>

    <ResponseField name="logo" type="string<uri>">
      URL to symbol logo/image
    </ResponseField>

    <ResponseField name="friendlyName" type="string">
      User friendly name of the symbol
    </ResponseField>

    <ResponseField name="percent" type="number">
      Percentage change
    </ResponseField>

    <ResponseField name="chg" type="number">
      Absolute change
    </ResponseField>

    <ResponseField name="price" type="number">
      Current price
    </ResponseField>

    <ResponseField name="digits" type="integer">
      Number of decimal places for the price
    </ResponseField>

    <ResponseField name="delayed" type="boolean">
      Indicates if the data is delayed
    </ResponseField>

    <ResponseField name="leveraged" type="boolean">
      Indicates if the symbol is leveraged
    </ResponseField>

    <ResponseField name="sharia" type="boolean">
      Indicates if the symbol is Sharia compliant
    </ResponseField>

    <ResponseField name="close" type="number">
      Previous closing price
    </ResponseField>
  </Expandable>
</ResponseField>

## Possible Errors

| Error | Possible cause | What to do |
| - | - | - |
| 400 | Invalid or missing field | Check the request against the schema. |
| 401 | Token missing or expired | Log in again or use the refresh token. |
| 403 | IP not whitelisted, or account restricted | Confirm your IP is whitelisted; otherwise contact Amana. |
| 429 / 5xx | Rate limit, or temporary issue on our side | Retry with backoff; contact support if it persists. |

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://gateway.amana.io/topmovers' \
    --header 'Authorization: Bearer <token>'
  ```

  ```python Python theme={null}
  import requests

  url = "https://gateway.amana.io/topmovers"
  headers = {"Authorization": "Bearer <token>"}

  response = requests.request("GET", url, headers=headers)
  print(response.json())
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://gateway.amana.io/topmovers', {
    method: 'GET',
    headers: {"Authorization": "Bearer <token>"},
  });
  console.log(await response.json());
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "_id": "<string>",
      "logo": "https://example.com",
      "friendlyName": "<string>",
      "percent": 123.45,
      "chg": 123.45,
      "price": 123.45,
      "digits": 123,
      "delayed": true,
      "leveraged": true,
      "sharia": true,
      "close": 123.45
    }
  ]
  ```

  ```json 400 theme={null}
  {
    "error": "<string>",
    "message": "<string>"
  }
  ```

  ```json 401 theme={null}
  {
    "error": "<string>",
    "message": "<string>"
  }
  ```

  ```json 403 theme={null}
  {
    "error": "<string>",
    "message": "<string>"
  }
  ```

  ```json 429 theme={null}
  {
    "error": "<string>",
    "message": "<string>"
  }
  ```

  ```json 500 theme={null}
  {
    "error": "<string>",
    "message": "<string>"
  }
  ```
</ResponseExample>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.