---
title: "L2 Files"
method: GET
path: "/v1/l2/files"
tags: ["Order Book (L2)"]
---

# L2 Files

`GET /v1/l2/files`

## Request

- Base URL: `https://api.candlefeed.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.candlefeed.ai/v1/l2/files`
- Auth: API key in header `X-API-Key`

Presigned download links (15-minute SigV4 URLs) for published, QC-approved daily L2 files.

Pro and Enterprise get every day. Other plans get sample days (the 1st of each month), up to
10 GiB of new files per account per UTC month; issuing a file again in the same month is free.
Days that are not published, not approved or being re-checked are listed in `missing`.

## Query parameters

- `dataset` string, required: book (L2 diffs + REST snapshots) or trades (raw tick trades)
- `symbol` string, required: Binance USD-M perpetual, e.g. BTCUSDT
- `start` string, required: First UTC day, YYYY-MM-DD
- `end` string, nullable: Last UTC day, inclusive; defaults to start. At most 31 days per call.

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/candlefeed/apis/candlefeed-api.md) · [All operations](https://skmtc.dev/candlefeed/apis/candlefeed-api/llms.txt) · [OpenAPI document](https://skmtc.dev/candlefeed/apis/candlefeed-api/revisions/8dc15dc4e380?raw)