---
title: "Search stocks"
method: GET
path: "/polymarket/stocks/v1/search"
tags: ["Polymarket Stocks"]
---

# Search stocks

`GET /polymarket/stocks/v1/search`

## Request

- Base URL: `https://api.adanos.com`
- URL: `https://api.adanos.com/polymarket/stocks/v1/search`
- Auth: API key in header `X-API-Key`

Search the Instrument Graph's stocks and ETFs by key, company name, alias or listing symbol, then enrich the matches with Polymarket activity. `ticker` is the Graph key every Polymarket endpoint accepts (a stock's company key, an ETF's product key); a listing symbol such as `HXSCL` finds its company here but is not accepted by other endpoints. Results prioritize exact key matches first, then prefixes, then name/alias matches, with Polymarket trade counts breaking ties, and include a compact `summary` block for the last 7 UTC calendar days.

## Query parameters

- `q` string, required: Search query (minimum 2 non-$ characters after trimming)
- `limit` integer: Maximum number of results to return

## Response `200`

Successful Response

- PolymarketSearchResponse: Search results for Polymarket stocks.
  - `query` string, required: Original search query
  - `count` integer, required: Total number of matching results before the limit is applied
  - `period_days` integer, required: Fixed lookback window used for each summary block
  - `results` PolymarketSearchResultItem[], required: Top matching stocks capped by the requested limit
    - `ticker` string, required: Instrument Graph key: the company key for a stock (AAPL, BNY), the product key for an ETF (EWG); the key every Polymarket endpoint accepts
    - `name` string, required: Instrument Graph company name; the product name for an ETF
    - `type` string, nullable: Instrument Graph asset type: Stock or ETF
    - `exchange` string, nullable: Exchange of the key's primary listing
    - `sector` string, nullable: Issuer sector; null for ETFs
    - `country` string, nullable: Issuer country, else the primary listing's country
    - `aliases` string[]: Instrument Graph names and listing symbols the company is matched by
    - `summary` PolymarketSearchSummary, required: Compact last-7-days summary attached to Polymarket search results.
      - `trade_count` integer, required: Trade count in the last 7 UTC calendar days
      - `buzz_score` number, nullable, required: Buzz score over the last 7 UTC calendar days
      - `trend` 'rising' | 'falling' | 'stable', nullable: Flow momentum over the current 3 UTC days vs previous 3 UTC days using trades, volume, market breadth and liquidity; not price movement. For `from`/`to`, anchors at `to` (or now when `to` is today).
      - `sentiment_score` number, nullable: Orderbook-aware implied sentiment over the last 7 UTC calendar days

## Other responses

- `401`: Authentication failed
- `422`: Invalid search query parameters
- `429`: Rate limit exceeded
- `503`: Instrument Graph key lookup or database service unavailable; no legacy fallback is used
- `504`: Analytics request deadline exceeded

---

[API](https://skmtc.dev/adanos/apis/adanos-market-sentiment-api.md) - [All operations](https://skmtc.dev/adanos/apis/adanos-market-sentiment-api/llms.txt) - [OpenAPI document](https://skmtc.dev/adanos/apis/adanos-market-sentiment-api/revisions/7e8bdb1e7e75?raw)