# Trending Stocks API > The tickers people are actually searching for right now, served from Yahoo Finance's public trending feed. This is an attention and retail-interest signal, not a price-mover list: the trending endpoint returns the most-searched symbols in a region (US, UK, Germany, France, India, Brazil and more), and enriches each one with its live price, day change and exchange — so you see what is grabbing attention and how it is moving. The ticker endpoint answers the question "is this symbol trending right now, and where does it rank". The regions endpoint lists the supported markets. This is the search-attention / sentiment data-cut for stocks — what retail is watching — distinct from the price-based market-movers, the live-quote and the intraday-candle APIs in the catalogue. Trending reflects search interest and shifts through the trading day. Live, no key on the upstream, nothing stored. ## Authentication All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys. ```bash curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/trendingstocks-api/..." ``` ## Pricing - **Free** (Free) — 33,000 calls/Mo, 5 req/s - **Starter** ($5/Mo) — 350,000 calls/Mo, 15 req/s - **Pro** ($16/Mo) — 1,450,000 calls/Mo, 40 req/s - **Scale** ($38/Mo) — 5,200,000 calls/Mo, 100 req/s ## Endpoints ### Trending #### `GET /v1/regions` — Supported market regions **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/trendingstocks-api/v1/regions" ``` **Response:** ```json { "data": { "count": 14, "source": "Yahoo Finance", "regions": [ { "code": "US" }, { "code": "GB" }, { "code": "DE" }, { "code": "FR" }, { "code": "IT" }, { "code": "ES" }, { "code": "CA" }, { "code": "AU" }, { "code": "IN" }, { "code": "BR" }, { "code": "HK" }, { "code": "JP" }, { "code": "SG" }, { "code": "NZ" } ] }, "meta": { "timestamp": "2026-06-12T01:41:17.909Z", "request_id": "d4634a3a-d3e5-48c9-960d-ea08be5d36c4" }, "status": "ok", "message": "Regions retrieved successfully", "success": true } ``` #### `GET /v1/ticker` — Is a symbol trending now, and at what rank **Parameters:** - `symbol` (query, required, string) — Ticker symbol Example: `AAPL` - `region` (query, optional, string) — Market region Example: `US` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/trendingstocks-api/v1/ticker?symbol=AAPL®ion=US" ``` **Response:** ```json { "data": { "rank": null, "region": "US", "source": "Yahoo Finance", "symbol": "AAPL", "is_trending": false }, "meta": { "timestamp": "2026-06-12T01:41:18.082Z", "request_id": "0abb0a98-7fc8-4b46-ae02-9f7a54f351bf" }, "status": "ok", "message": "Ticker retrieved successfully", "success": true } ``` #### `GET /v1/trending` — Most-searched tickers with live price & change **Parameters:** - `region` (query, optional, string) — US, GB, DE, FR, IT, ES, CA, AU, IN, BR, HK, JP, SG, NZ Example: `US` - `limit` (query, optional, string) — Max tickers (max 25) Example: `15` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/trendingstocks-api/v1/trending?region=US&limit=15" ``` **Response:** ```json { "data": { "count": 15, "region": "US", "source": "Yahoo Finance", "trending": [ { "rank": 1, "type": "EQUITY", "price": 135, "change": 0, "symbol": "SPCX", "currency": "USD", "exchange": "NasdaqGS", "change_pct": 0, "previous_close": 135 }, { "rank": 2, "type": "EQUITY", "price": 218.8, "change": -14.58, "symbol": "ADBE", "currency": "USD", "exchange": "NasdaqGS", "change_pct": -6.25, "previous_close": 233.38 }, { "rank": 3, "type": "EQUITY", "price": 114.78, "change": 9.73, "symbol": "RKLB", "currency": "USD", "exchange": "NasdaqGS", "change_pct": 9.26, "previous_close": 105.05 }, { "rank": 4, "type": "EQUITY", "price": 5.73, "change": 1.02, "symbol": "SPCE", "currency": "USD", "exchange": "NYSE", "change_pct": 21.66, "previous_close": 4.71 }, { "rank …(truncated, see openapi.json for full schema) ``` ### Meta #### `GET /v1/meta` — Spec **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/trendingstocks-api/v1/meta" ``` **Response:** ```json { "data": { "note": "region is US (default), GB, DE, FR, IT, ES, CA, AU, IN, BR, HK, JP, SG or NZ. Each trending symbol is enriched with its live price and day change from the chart feed; symbols whose price cannot be fetched are returned with the symbol only. Trending reflects search interest, which moves through the day.", "source": "Yahoo Finance trending + chart (query1.finance.yahoo.com, live)", "service": "trendingstocks-api", "endpoints": { "GET /v1/meta": "This document.", "GET /v1/ticker": "Is a symbol trending now, and at what rank (symbol=AAPL, region=US).", "GET /v1/regions": "Supported market regions.", "GET /v1/trending": "Most-searched tickers in a region with live price & day change (region=US, limit=15)." }, "description": "The tickers people are searching for right now, from Yahoo Finance's trending feed — an attention / retail-interest signal, not a price-mover list. trending returns the most-searched symbols in a region, each enriched with its live price, day change and exchange; ticker answers whether a symbol is currently trending and where it ranks; regions lists the supported markets. Live, no key, nothing stored. The search-attention / sentiment data-cut for stocks, distinct from the price-based market-movers, live-quote and intraday-candle APIs.", "top_us_symbol": "SPCX", "upstream_status": "ok" }, "meta": { "timestamp …(truncated, see openapi.json for full schema) ``` --- Marketplace page: https://www.oanor.com/api/trendingstocks-api OpenAPI spec: https://www.oanor.com/api/trendingstocks-api/openapi.json