GET /v1/market

Macro regime, recent market-cap history, top-50 snapshot rows, and signal coverage for the same UTC day as candidates.

GET /api/v1/market

Example

curl -s \
  -H "Authorization: Bearer kv_live_YOUR_KEY" \
  "https://app.kvantrank.com/api/v1/market"

Response fields

meta

FieldTypeDescription
meta.productstringProduct identifier (Kvantrank Data API).
meta.taglinestringShort product summary.
meta.docsstringURL to public API documentation.
meta.date_utcstringUTC date of the managed pipeline snapshot (YYYY-MM-DD).
meta.generated_at_utcstringWhen the snapshot was generated (ISO 8601).

market

FieldTypeDescription
market.fear_greednumber | nullFear and Greed index for crypto.
market.altseasonnumber | nullAltseason index (higher = more alt outperformance).
market.total_mcapnumber | nullTotal crypto market cap (USD).
market.total_mcap_changenumber | null24-hour change in total market cap (%).

market_history[]

FieldTypeDescription
market_history[].date_utcstringUTC date for the history row.
market_history[].total_mcapnumber | nullTotal market cap on that day.
market_history[].fear_greednumber | nullFear and Greed index.
market_history[].altseasonnumber | nullAltseason index.

top_coins[]

FieldTypeDescription
top_coins[].coingecko_idstringCoinGecko id.
top_coins[].symbolstringTicker symbol.
top_coins[].namestringDisplay name.
top_coins[].mcap_ranknumber | nullRank in the top-50 snapshot (1-50).
top_coins[].price_usdnumber | nullSpot USD price.
top_coins[].price_change_24hnumber | null24-hour price change (%).

signals

FieldTypeDescription
signals.coins_trackednumber | nullCoins in the tracked universe.
signals.candidatesnumber | nullCoins in the breakout candidate band.
signals.social_providerstring | nullActive social signal provider for the run.
signals.google_news_countnumber | nullNews articles counted in the run.
signals.gemini_catalyst_countnumber | nullCatalyst labels generated in the run.

Snapshot fields (price, cap, volume) align to the same UTC pipeline run as Kvantrank scores. Intraday charting may need a separate live feed.