GET /v1/candidates

GET /api/v1/candidates

Query parameters

• limit (integer, default 50, max 200): Number of candidates to return.

Example

curl -s \
  -H "Authorization: Bearer kv_live_YOUR_KEY" \
  "https://app.kvantrank.com/api/v1/candidates?limit=20"

Response fields

meta

Field	Type	Description
meta.product	string	Product identifier (Kvantrank Data API).
meta.tagline	string	Short product summary.
meta.docs	string	URL to public API documentation.
meta.date_utc	string	UTC date of the managed pipeline snapshot (YYYY-MM-DD).
meta.generated_at_utc	string	When the snapshot was generated (ISO 8601).
meta.universe	object	Rank-band and shortlist settings for the snapshot.

candidates[]

Field	Type	Description
candidates[].coingecko_id	string	CoinGecko coin id (stable identifier).
candidates[].symbol	string	Ticker symbol.
candidates[].name	string	Display name.
candidates[].mcap_rank	number | null	Market-cap rank on the snapshot day.
candidates[].market.price_usd	number | null	Spot USD price from the pipeline snapshot.
candidates[].market.market_cap	number | null	Market capitalization (USD).
candidates[].market.vol_24h	number | null	24-hour traded volume (USD).
candidates[].market.price_change_24h	number | null	24-hour price change (%).
candidates[].market.price_change_7d	number | null	7-day price change (%).
candidates[].market.vol_spike	number | null	Volume spike signal vs recent baseline.
candidates[].market.ath_change_pct	number | null	Distance from all-time high (%).
candidates[].success_index	number | null	Composite success index for the coin.
candidates[].prediction_confidence	number | null	Model confidence for breakout labeling.
candidates[].hype_score	number | null	Cross-sectional attention score (0-100).
candidates[].breakout_score	number | null	Breakout candidacy score (0-100).
candidates[].hype_momentum_7d	number | null	7-day change in hype score.
candidates[].rank_delta_7d	number | null	7-day improvement in market-cap rank (positive = climbing).
candidates[].top20	boolean	True when the coin is in the current top-20 hype shortlist.
candidates[].catalyst.label	string | null	Short catalyst category label.
candidates[].catalyst.title	string | null	Headline for the catalyst event.
candidates[].catalyst.summary	string	One-paragraph catalyst context.
candidates[].catalyst.date	string | null	Event or article date when available.
candidates[].catalyst.source	string | null	Source provider or label.
candidates[].catalyst.url	string | null	Link to supporting source.
candidates[].catalyst.confidence	number | null	Model confidence for the catalyst label.
candidates[].catalyst.category	string | null	Catalyst taxonomy bucket.