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

# Search tokens

`GET /reddit/crypto/v1/search`

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.net/adanos/apis/adanos-market-sentiment-api.md) · [All operations](https://skmtc.net/adanos/apis/adanos-market-sentiment-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/adanos/adanos-market-sentiment-api/revisions/351caf64ba81/schema)