---
title: "Pairs at records or top/bottom 5% vs their own history (free)"
method: GET
path: "/api/public/extremes"
tags: ["free"]
---

# Pairs at records or top/bottom 5% vs their own history (free)

`GET /api/public/extremes`

## Request

- Base URL: `https://coinlobster.com`
- URL: `https://coinlobster.com/api/public/extremes`
- Auth: none required

Daily scan of every recorded pair for records and 5% extremes in funding, open interest and liquidations, measured against that pair own recorded days, with next-day outcome stats where enough past events exist.

## Response `200`

Success

- object
  - `success` true, required
  - `data` object, required
    - `records` object[]
    - `top5` object[]
  - `meta` Meta: Present on every /api/ai/v1 response.
    - `timestamp` string, date-time: When this response was assembled, not when the data was measured.
    - `credits_used` integer: Credits this call spent. Absent on free surfaces and on keyless calls.
    - `credits_remaining` integer: Account balance after this call.
    - `deprecation` string: Present when the request used a deprecated form, e.g. the key in the query string.

## Other responses

- `429`: Rate limited (60/min per IP)

---

[API](https://skmtc.dev/coinlobster/apis/coinlobster-crypto-data-api.md) · [All operations](https://skmtc.dev/coinlobster/apis/coinlobster-crypto-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/coinlobster/apis/coinlobster-crypto-data-api/revisions/a62c3a47523a?raw)