---
title: "Search tokens"
method: GET
path: "/reddit/crypto/v1/search"
tags: ["Reddit Crypto"]
---

# Search tokens

`GET /reddit/crypto/v1/search`

## Request

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

Search known crypto assets by symbol, name or alias. Results prioritize exact symbol matches first, then prefixes, then name/alias matches and include a compact `summary` block for the last 7 UTC calendar days.
Summary `mentions` includes inherited thread-context mentions.

## 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

- CryptoSearchResponse: Search response for crypto assets.
  - `query` string, required: Original search query
  - `count` integer, required: Total number of matching assets before the limit is applied
  - `period_days` integer, required: Fixed lookback window used for each summary block
  - `results` CryptoSearchItem[], required: Top matching crypto assets capped by the requested limit
    - `symbol` string, required
    - `name` string, required
    - `market_cap_rank` integer, nullable
    - `market_cap_usd` number, nullable
    - `aliases` string[]
    - `summary` CryptoSearchSummary, required: Compact last-7-days summary attached to crypto search results.
      - `mentions` integer, required: Attributed mentions in the last 7 UTC calendar days, including inherited thread-context mentions
      - `buzz_score` number, nullable, required: Buzz score over the last 7 UTC calendar days
      - `trend` 'rising' | 'falling' | 'stable', nullable: Activity momentum over the current 3 UTC days vs previous 3 UTC days using mentions, upvotes and subreddit breadth; not price movement. For `from`/`to`, anchors at `to` (or now when `to` is today).
      - `sentiment_score` number, nullable: Average sentiment score over the last 7 UTC calendar days

## Other responses

- `401`: Authentication failed
- `422`: Invalid search query parameters
- `429`: Rate limit exceeded
- `503`: Database temporarily unavailable
- `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)