Skip to main content
GET
cURL

What it returns

/calls?asset=&limit= — the newest directional calls (analyst, stance, the post’s ≤ 200-character excerpt, source link, analyst page), newest first, limit 1–50. A call = one directional (bullish / bearish) post about this asset by a tracked, eligible analyst; neutral posts are not calls.

Access

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

Notes

  • excerpt = the first ≤ 200 characters of the post (original language); quote it with its source_url and the analyst’s profile_url. The full statement is provided under an Integration agreement only (contact sales@cryptoquant.com) — see Raw source text.
  • Carries 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.

limit
integer
default:10

Rows to return, clamped to 1–50 silently; unparsable = 10.

Required range: 1 <= x <= 50
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

Newest calls

asset
string
required
asset_name
string
required
count
integer
required
Required range: x >= 0
calls
object[]
required

Newest first.

definition
string
required

What a call is — quote with the list.

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).

top_analysts_url
string<uri>

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

methodology_url
string<uri>

How the numbers are made.