Skip to main content
GET
Top gainers and decliners across the universe.
The 20 biggest score gainers and 20 biggest decliners over the last 7, 30, or 90 days.

Parameters

A request with no window or an invalid value returns 400 { error: "window must be one of [...] " }.

When to use it

  • Daily / weekly “what’s moving” digest.
  • Spotting accelerating or distressed companies you don’t already track.
  • Validating that a thesis (e.g. “fintech is heating up”) is showing in the data.

Response

delta = composite_now − composite_then. Both lists are sorted by |delta| DESC.

Eligibility for movers

A domain is eligible if it has at least two scoring runs: one inside the window and one before it. Newly-scored domains with no prior history are excluded — they have nothing to move against.

Caching

The full response is cached server-side for 5 minutes per (pipeline_version, window) pair. Two callers requesting ?window=30d 30 seconds apart get bit-identical responses.

No pagination

There’s no limit or cursor. Movers always returns 20 + 20. If you want a deeper view, compose /v1/distribution + per-domain /v1/score/{domain}/history.

Authorizations

X-API-Key
string
header
required

Live keys are prefixed ki_live_, test keys ki_test_. Issue + revoke keys at https://console.keplerinsights.us. Never embed a key in client-side code — every endpoint is backend-to-API only.

Query Parameters

window
enum<string>
default:30d
required
Available options:
7d,
30d,
90d

Response

Top movers.

mode
string
window
enum<string>
Available options:
7d,
30d,
90d
window_start
string<date-time>
window_end
string<date-time>
gainers
object[]
Maximum array length: 20
decliners
object[]
Maximum array length: 20