---
title: "Convert History"
method: POST
path: "/api/v4/convert/history"
---

# Convert History

`POST /api/v4/convert/history`

The endpoint returns convert history, sorted by `id` descending (newest first).

The `from`–`to` window is capped at 30 days per request, even though data is retained for 6 months. A wider range is rejected with code `30` (`api.validation.dateTime.maxRange`).

<Warning>
Rate limit: 10000 requests/10 sec.
</Warning>

<Note>
Error `message` values may be returned as translation keys (for example `api.validation.dateTime.maxRange`) rather than finalized English strings. Treat the `code` and the field name under `errors` as the stable contract.
</Note>

**Note:** The endpoint can retrieve data not older than 6 months from the current month. For older data, use the Report on the History page.

## Request body

- object
  - `fromTicker` string — From currency. Example: BTC
  - `toTicker` string — To currency. Example: USDT
  - `from` string — From time filter (Unix seconds). Must be no more than 30 days before `to` and no older than 6 months. Example: 1699260637. Default: now()
  - `to` string — To time filter (Unix seconds). Must be no more than 30 days after `from`. Example: 1699260637. Default: now()
  - `quoteId` string — Quote Id. Example: 4050
  - `limit` integer — How many records to receive. Allowed range: 1–100. Default: 100
  - `offset` integer — Number of records to skip for pagination. Minimum: 0. Default: 0
  - `nonce` integer — Nonce for request
  - `request` string — Request path

## Response `200`

Successful response

- object
  - `records` object[]
    - `id` string — Convert record ID
    - `date` integer — Conversion timestamp
    - `give` string — Amount given
    - `receive` string — Amount received
    - `rate` string — Conversion rate
    - `path` object[]
      - `from` string
      - `to` string
      - `rate` string
  - `total` integer — Total number of records
  - `limit` integer — Limit used in request
  - `offset` integer — Offset used in request

## Other responses

- `400` — Inner validation failed
- `422` — Validation failed

---

[API](https://skmtc.net/whitebit/apis/whitebit-private-http-api-v4.md) · [All operations](https://skmtc.net/whitebit/apis/whitebit-private-http-api-v4/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/whitebit/whitebit-private-http-api-v4/versions/76c9def9942f/schema)