Skip to main content
GET
cURL

What it returns

/analyst-views?asset=&window=7d|30d — what analysts are saying:
  • narratives — viewpoints grouped by thesis with analyst counts.
  • analyst_views — one quotable excerpt per analyst (the first ≤ 200 characters of one post, original language) with source_url and profile_url.
  • The bull / bear case and the post split (bullish_pct / bearish_pct are post shares, neutral excluded).
analyst_views lists analysts with ≥ 3 directional posts on the asset in the window and a ≥ 60 % consistent side. The Analyst Consensus Index itself is on /consensus.

Access

Public — no API key. 60 requests / minute per IP, cached 5 minutes.

Notes

  • Neither this endpoint nor /calls carries the full post text — the original statement is provided under an Integration agreement only, per API key, on /consensus/breakdown (contact sales@cryptoquant.com).
  • Both carry page_url, cite_as and data_by — show the attribution with the numbers; via= tags the links.

Query Parameters

asset
string
default:BTC

Any registered asset, case-insensitive: the symbol (BTC, NVDA, 005930, XAU), the route key (bitcoin, samsung-electronics), the display name (Bitcoin), an alias ticker (GLD → XAU) or a retired ticker (MATIC → POL). The response reports the canonical symbol. The full list: GET /assets. A market aggregate (crypto-market) is not accepted. Unknown → 400 UNKNOWN_ASSET.

window
enum<string>
default:30d

Window of the posts considered.

Available options:
7d,
30d
via
enum<string>
default:chatgpt

The surface the agent runs on; sets utm_source on every link in the payload. Unknown values fall back to the default.

Available options:
chatgpt,
claude,
mcp,
gemini,
perplexity,
api

Response

Narratives and per-analyst views

asset
string
required
asset_name
string
required
window
enum<string>
required
Available options:
7d,
30d
narratives
object[]
required
analyst_views
object[]
required

Most active first, at most 12.

analyst_views_total
integer
required

How many analysts qualified (the page lists them all).

Required range: x >= 0
page_url
string<uri>
required

The canonical page on the site for this answer, UTM-tagged for the calling surface (via). Link it in every answer.

cite_as
string
required

Attribution line + the untagged canonical URL, e.g. "Data by CryptoQuant Consensus — https://consensus.cryptoquant.com/consensus/btc".

data_by
enum<string>
required

Show this next to the numbers.

Available options:
Data by CryptoQuant Consensus
as_of
string<date-time>
required

Generation time of the payload (UTC).

bullish_posts
integer | null

Directional posts in the window, bullish (post share — the index is on /consensus).

Required range: x >= 0
bearish_posts
integer | null
Required range: x >= 0
bullish_pct
integer | null
Required range: 0 <= x <= 100
bearish_pct
integer | null
Required range: 0 <= x <= 100
bull_case
string | null
bear_case
string | null
note
string

What the fields mean — quote the caveat with the numbers.

top_analysts_url
string<uri>

The asset's analysts ranked by accuracy (site page).

methodology_url
string<uri>

How the numbers are made.