---
title: "Recent events (JSON)"
method: GET
path: "/api/v1/stream/recent"
tags: ["Event Stream"]
---

# Recent events (JSON)

`GET /api/v1/stream/recent`

## Request

- Base URL: `https://cryptodataapi.com`
- URL: `https://cryptodataapi.com/api/v1/stream/recent`
- Auth: API key in header `X-API-Key`

The newest events from the live stream as JSON, oldest first. Same event
shape as `GET /stream`. `last_id` is the id to pass as `since_id` when
opening the stream, so a client can backfill and then go live without a gap
or a duplicate. Any key, Free included.

## Query parameters

- `limit` integer: Newest N events (1-500).
- `types` string, nullable: Comma-separated event types: liquidation, whale_transfer, whale_position, funding, oi_delta, price_move. Default: all.
- `symbols` string, nullable: Comma-separated base coins (BTC,ETH,SOL). Default: all.
- `min_usd` number: Drop events smaller than this USD size. Applies to events that carry `usd` (liquidation, whale_transfer, whale_position, oi_delta); funding and price_move always pass.

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

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