# Yahoo Finance Trending API (yahoo_finance.trending)

- Canonical page: https://everyinfra.com/en/yahoo-finance-api/trending
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "yahoo_finance", "action": "trending", "params": {...}}
- Price: $0.001389 per call ($1.39 per 1,000 requests); failed calls and empty results are not charged
- Returns: list, default 10, max 200 per call
- Mode: sync; add "mode": "async" for slow tasks

Yahoo Finance Trending reads one of Yahoo Finance's preset market lists, chosen with `screener`, and returns a row per instrument: ticker, name, price and currency, the change in price and in percent, volume, market capitalization, exchange, price-to-earnings ratio and the 52-week range. Leave `screener` out and you get the day's top gainers. Traders, newsletter writers and fintech apps use it to see what is moving, seed watchlists and feed daily market summaries.

The lists cover stocks (gainers, losers, most active, most shorted, small caps and growth themes), cryptocurrencies, private companies and funds, and their names must be written in capitals, such as DAY_LOSERS or MOST_ACTIVES. Read `currency` and `exchange` on every row instead of assuming one market. `change_percent` is already a percentage, while `change` is the move in the price's own currency. None of this is investment advice.

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=yahoo_finance&action=trending

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| screener | not declared | no | not declared | Specifies the uppercase preset list key for the Yahoo Finance trending action. Supported equity screeners include DAY_GAINERS (default), DAY_LOSERS, MOST_ACTIVES, MOST_SHORTED_STOCKS, UNDERVALUED_GROWTH_STOCKS, GROWTH_TECHNOLOGY_STOCKS, AGGRESSIVE_SMALL_CAPS, and SMALL_CAP_GAINERS; crypto lists include ALL_CRYPTOCURRENCIES_US, DAY_GAINERS_CRYPTOCURRENCIES, DAY_LOSERS_CRYPTOCURRENCIES, and MOST_ACTIVES_CRYPTOCURRENCIES; private company lists include HIGHEST_VALUATION_PRIVATE_COMPANY, WEEK_GAINERS_PRIVATE_COMPANY, RECENTLY_FUNDED_PRIVATE_COMPANY, and MOST_FUNDED_PRIVATE_COMPANY; fund lists include TOP_MUTUAL_FUNDS, DAY_GAINERS_MUTUAL_FUNDS, PORTFOLIO_ANCHORS, SOLID_LARGE_GROWTH_FUNDS, SOLID_MIDCAP_GROWTH_FUNDS, CONSERVATIVE_FOREIGN_FUNDS, and HIGH_YIELD_BOND. Category availability does not guarantee current data or constitute financial advice. |
| limit | integer (1–200) | no | 10 | The most rows to return in this call, an integer from 1 to 200. The default applies when you leave it out, and a call can return fewer rows. Larger values return 422 before any charge. |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| id | The record's unique ID on the platform. Unique only within one platform; IDs can repeat across platforms. |
| symbol | platform-native meaning |
| name | Name of the object itself, for account, product and business capabilities. |
| price | Price as a number without a currency symbol; see currency. |
| change | platform-native meaning |
| change_percent | platform-native meaning |
| volume | platform-native meaning |
| market_cap | platform-native meaning |
| currency | Currency code of the price (for example CNY, USD). If price is present but currency is null, do not assume a currency. |
| exchange | platform-native meaning |
| pe_ratio | platform-native meaning |
| fifty_two_week_range | platform-native meaning |
| platform | Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok). |

## Example

```bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "yahoo_finance",
  "action": "trending",
  "params": {}
}'
```

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "yahoo_finance",
        "action": "trending",
        "params": {},
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

Real response to the example request above, captured 2026-09-26T08:56:04Z. `results` and `count` are real with personal information (names, handles, avatars, profile links, contact details) removed; the list keeps the first 2 of 10. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "yahoo_finance",
  "action": "trending",
  "results": [
    {
      "id": "PPLI",
      "symbol": "PPLI",
      "name": "People Incorporated",
      "price": 40,
      "change": 4.07,
      "change_percent": 11.3276,
      "volume": 3093055,
      "market_cap": 2978557184,
      "currency": "USD",
      "exchange": "NasdaqGS",
      "pe_ratio": 6.76819,
      "fifty_two_week_range": "29.56 - 48.32",
      "platform": "yahoo_finance"
    },
    {
      "id": "ALM",
      "symbol": "ALM",
      "name": "Almonty Industries Inc.",
      "price": 13.72,
      "change": 1.32,
      "change_percent": 10.6452,
      "volume": 11512843,
      "market_cap": 3957955840,
      "currency": "USD",
      "exchange": "NasdaqCM",
      "pe_ratio": 62.363636,
      "fifty_two_week_range": "5.435 - 24.41",
      "platform": "yahoo_finance"
    }
  ],
  "count": 10,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## FAQ

### Which lists can I choose with `screener`?

For stocks: DAY_GAINERS (the default), DAY_LOSERS, MOST_ACTIVES, MOST_SHORTED_STOCKS, UNDERVALUED_GROWTH_STOCKS, GROWTH_TECHNOLOGY_STOCKS, AGGRESSIVE_SMALL_CAPS and SMALL_CAP_GAINERS. Crypto lists include ALL_CRYPTOCURRENCIES_US and MOST_ACTIVES_CRYPTOCURRENCIES, private-company lists include RECENTLY_FUNDED_PRIVATE_COMPANY and MOST_FUNDED_PRIVATE_COMPANY, and fund lists include TOP_MUTUAL_FUNDS and HIGH_YIELD_BOND. Write every name in capitals, exactly as shown.

### How should I compare `change` and `change_percent`?

`change` is the price move in the row's own currency and `change_percent` the same move expressed as a percentage. Rank by `change_percent` when a list mixes cheap and expensive instruments, because a large absolute move on a high-priced share can be a small one in percentage terms, and check `currency` before you add up or compare `change` across rows.

### Do I need to pass a ticker?

No. This capability has no required parameter: send nothing to get the day's gainers, or set `screener` to another list. To dig into a stock you find, pass its `symbol` to Yahoo Finance Historical prices, News or Options chains, each of which reads one ticker per call.

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=yahoo_finance
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md
