> ## Documentation Index
> Fetch the complete documentation index at: https://finance.chiefpriest.design/llms.txt
> Use this file to discover all available pages before exploring further.

# Market Losers

> Get the biggest stock market losers of the day

## Endpoint

<CodeGroup>
  ```bash GET Request theme={null}
  GET /api/v1/market/losers
  ```

  ```bash cURL Example theme={null}
  curl "https://stocks-dev.up.railway.app/api/v1/market/losers"
  ```

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

  response = requests.get("https://stocks-dev.up.railway.app/api/v1/market/losers")
  data = response.json()
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://stocks-dev.up.railway.app/api/v1/market/losers');
  const data = await response.json();
  ```
</CodeGroup>

## Response

<ResponseField name="losers" type="array">
  Array of stocks with the biggest price decreases

  <Expandable title="Loser Object">
    <ResponseField name="symbol" type="string">
      Stock symbol
    </ResponseField>

    <ResponseField name="name" type="string">
      Company name
    </ResponseField>

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

    <ResponseField name="change" type="number">
      Price change in dollars
    </ResponseField>

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

    <ResponseField name="volume" type="number">
      Trading volume
    </ResponseField>

    <ResponseField name="marketCap" type="number">
      Market capitalization
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="timestamp" type="string">
  Response timestamp in ISO format
</ResponseField>

## Example Response

```json theme={null}
{
  "losers": [
    {
      "symbol": "CVNA",
      "name": "Carvana Co.",
      "price": 45.23,
      "change": -8.97,
      "changesPercentage": -16.54,
      "volume": 12450000,
      "marketCap": 8500000000
    },
    {
      "symbol": "ROKU",
      "name": "Roku, Inc.",
      "price": 62.18,
      "change": -7.82,
      "changesPercentage": -11.17,
      "volume": 8900000,
      "marketCap": 6800000000
    },
    {
      "symbol": "NFLX",
      "name": "Netflix, Inc.",
      "price": 425.67,
      "change": -45.33,
      "changesPercentage": -9.63,
      "volume": 5600000,
      "marketCap": 189000000000
    }
  ],
  "timestamp": "2025-06-28T18:42:12.471731"
}
```

## Use Cases

<AccordionGroup>
  <Accordion title="Market Sentiment Analysis">
    Monitor overall market sentiment by tracking the biggest losers:

    ```python theme={null}
    response = requests.get("/api/v1/market/losers")
    losers = response.json()["losers"]

    # Calculate average decline
    avg_decline = sum(stock["changesPercentage"] for stock in losers) / len(losers)
    print(f"Average decline among top losers: {avg_decline:.2f}%")
    ```
  </Accordion>

  <Accordion title="Contrarian Investment Strategy">
    Identify potential buying opportunities in oversold stocks:

    ```python theme={null}
    def find_oversold_opportunities(losers, min_volume=1000000):
        opportunities = []
        for stock in losers:
            if (stock["changesPercentage"] < -10 and 
                stock["volume"] > min_volume and
                stock["marketCap"] > 1000000000):  # Large cap only
                opportunities.append(stock)
        return opportunities
    ```
  </Accordion>

  <Accordion title="Risk Management">
    Monitor portfolio holdings for significant declines:

    ```python theme={null}
    portfolio = ["AAPL", "MSFT", "GOOGL"]
    losers_symbols = [stock["symbol"] for stock in losers]

    portfolio_losers = [symbol for symbol in portfolio if symbol in losers_symbols]
    if portfolio_losers:
        print(f"Portfolio holdings in today's losers: {portfolio_losers}")
    ```
  </Accordion>
</AccordionGroup>

## Related Endpoints

<CardGroup cols={2}>
  <Card title="Market Gainers" icon="trending-up" href="/api-reference/market/gainers">
    Get the biggest market gainers
  </Card>

  <Card title="Most Active" icon="activity" href="/api-reference/market/active">
    Find the most actively traded stocks
  </Card>
</CardGroup>