Skip to main content
GET
/
v1
/
movers
Top gainers and decliners across the universe.
curl --request GET \
  --url https://api.keplerinsights.us/v1/movers \
  --header 'X-API-Key: <api-key>'
{
  "mode": "<string>",
  "window": "7d",
  "window_start": "2023-11-07T05:31:56Z",
  "window_end": "2023-11-07T05:31:56Z",
  "gainers": [
    {
      "domain": "<string>",
      "company_name": "<string>",
      "composite_now": 123,
      "composite_then": 123,
      "delta": 123,
      "ki_rating_now": "<string>",
      "ki_rating_then": "<string>"
    }
  ],
  "decliners": [
    {
      "domain": "<string>",
      "company_name": "<string>",
      "composite_now": 123,
      "composite_then": 123,
      "delta": 123,
      "ki_rating_now": "<string>",
      "ki_rating_then": "<string>"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.keplerinsights.us/llms.txt

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

The 20 biggest score gainers and 20 biggest decliners over the last 7, 30, or 90 days.

​
Parameters

QueryRequiredValues
windowyes7d, 30d, 90d
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

{
  "window": "30d",
  "window_start": "2026-04-12T18:30:00Z",
  "window_end":   "2026-05-12T18:30:00Z",
  "gainers": [
    {
      "domain": "anthropic.com",
      "company_name": "Anthropic",
      "composite_now": 72.4,
      "composite_then": 64.1,
      "delta": 8.3,
      "ki_rating_now": "KI-1",
      "ki_rating_then": "KI-2+"
    },
    ...
  ],
  "decliners": [
    {
      "domain": "examplecorp.com",
      "company_name": "Example Corp",
      "composite_now": 41.0,
      "composite_then": 53.6,
      "delta": -12.6,
      "ki_rating_now": "KI-3",
      "ki_rating_then": "KI-2"
    },
    ...
  ]
}
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://api.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