Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/kagisearch/kite-public/llms.txt

Use this file to discover all available pages before exploring further.

Kagi News embeds contextual live-data panels directly in the news feed so you can glance at market prices, sports scores, and weather without leaving the app. Each widget fetches its data through the Kagi News API proxy and refreshes automatically on a schedule appropriate to how quickly that data changes. All widget data is served through the /api/widgets/ route, which proxies to upstream sources so your browser never contacts external APIs directly.

Cryptocurrency Prices

The Crypto widget shows a grid of live prices for eight major cryptocurrencies: Bitcoin (BTC), Ethereum (ETH), Binance Coin (BNB), Solana (SOL), XRP, Cardano (ADA), Avalanche (AVAX), and Polkadot (DOT).Each tile displays:
  • Coin logo and symbol
  • Current USD price (formatted to 0, 2, or 4 decimal places depending on magnitude)
  • 24-hour percentage change with an up/down trend icon
  • A 7-day sparkline chart
Prices are fetched in parallel via:
GET /api/widgets/crypto/price?id=<coingecko-id>
The grid auto-refreshes every 2 minutes. A manual refresh button is also available in the widget header.

Formula 1

The F1 widget shows the current season’s race schedule and driver standings. The collapsed view previews the next three upcoming races; expanding the widget reveals the full calendar with round numbers, circuit locations, dates, and winners for completed races.The header summarises the next race countdown: Today, Tomorrow, or In N days.Data endpoints:
GET /api/widgets/f1/schedule
GET /api/widgets/f1/standings
The schedule refreshes every 5 minutes. Each race entry has a status of 'upcoming', 'live', or 'completed', and completed races include the winner’s name and constructor.

NFL Scores

The NFL widget shows game scores and Polymarket prediction-market odds for current NFL games. The collapsed view shows up to three games as compact score cards; expanding shows all games with full detail.Live games are highlighted with a red background and show the current quarter and game clock. Each game card can show either the live score or Polymarket win-probability odds (as percentages) depending on data availability.Data endpoints:
GET /api/widgets/nfl/scores
GET /api/widgets/nfl/standings
GET /api/widgets/nfl/polymarket
Scores refresh every 30 seconds; Polymarket odds refresh every 5 minutes. The widget also displays over/under lines and market volume/liquidity from Polymarket when available. Odds are sourced from polymarket.com/sports/nfl.

NHL Scores

The NHL widget mirrors the NFL widget’s structure for ice hockey. It shows game scores, standings, and Polymarket prediction-market odds for NHL games.Data endpoints:
GET /api/widgets/nhl/scores
GET /api/widgets/nhl/standings
GET /api/widgets/nhl/polymarket
The same refresh cadence applies: scores every 30 seconds, odds every 5 minutes.

Weather

The Weather widget shows current conditions and a short forecast for your location.Data endpoint:
GET /api/widgets/weather?location=<location>
Location is determined automatically from your browser or device. The widget refreshes every 30 minutes.

​
API reference

For full request/response schemas for each widget endpoint, see the Widgets API reference.

​
How widgets are loaded

Each widget component fetches its data independently using the browser fetch API against the /api/widgets/ proxy. This means:
  • Widgets load in parallel and do not block the main news feed.
  • If a widget’s data endpoint fails, the widget shows an error state without affecting any other part of the page.
  • All requests inherit the same session credentials as the rest of the app.
Each widget component sets up its own setInterval for periodic refresh and cleans up the interval in its onMount return callback, so there are no background timers when a widget is removed from the DOM.

Build docs developers (and LLMs) love

Get started for freeTalk to us