Skip to main content
GET
cURL

What it returns

One analyst’s daily stance on one asset, oldest first. Each sentiment_score ranges from 0 (bearish) to 100 (bullish).

Access

Per-analyst data is available on the Premium and Enterprise plans; a Free key answers 401 PLAN_REQUIRED. Valid handles come from /analysts/top or the analysts page.

Parameters

Notes

  • sentiment_score_key_calls and key_calls_count describe the analyst’s key calls that day; sentiment_score_key_calls is null when there are none.
  • No tracked analyst matching handle answers 404 ANALYST_NOT_FOUND; an analyst excluded from the stance pipeline answers 404 ANALYST_NOT_ELIGIBLE; no rows for the analyst × asset pair in the range answers 404 NO_DATA — see Errors.

Authorizations

X-API-Key
string
header
required

Provisioned with the CryptoQuant Premium plan or an Enterprise agreement (no self-serve). Keys start with unbias_live_.

Query Parameters

handle
string

Analyst handle (required unless analyst_id is given); valid handles come from /analysts/top. Case-insensitive.

analyst_id
string<uuid>

Analyst UUID (alternative to handle; wins when both are given).

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.

days
integer
default:30

Days of history ending yesterday UTC. Positive integer (else 400 INVALID_PARAMETER); silently capped at the plan's max_days_history (36500 on premium / enterprise).

Required range: 1 <= x <= 36500

Response

Series (premium / enterprise: StanceSeries). StanceLatest is the reserved free-plan shape (not served today).

Premium / Enterprise plans: the requested window, oldest first.

analyst_id
string<uuid>
required
asset
string
required

Canonical symbol.

period
object
required
count
integer
required
Required range: x >= 0
data
object[]
required