Sign in

v1

latestOpenAPI 3.0.32026-07-2613529376.3 KB

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.

post/api/v4/convert/history

Request body

fromTickerstring

From currency. Example: BTC

toTickerstring

To currency. Example: USDT

fromstring

From time filter (Unix seconds). Must be no more than 30 days before to and no older than 6 months. Example: 1699260637. Default: now()

tostring

To time filter (Unix seconds). Must be no more than 30 days after from. Example: 1699260637. Default: now()

quoteIdstring

Quote Id. Example: 4050

limitinteger

How many records to receive. Allowed range: 1–100. Default: 100

offsetinteger

Number of records to skip for pagination. Minimum: 0. Default: 0

nonceinteger

Nonce for request

requeststring

Request path

Example request

{
  "fromTicker": "BTC",
  "toTicker": "USDT",
  "from": "1699260637",
  "to": "1699260637",
  "quoteId": "4050",
  "limit": 100,
  "nonce": 1699260637,
  "request": "{{request}}"
}

Response

Successful response

totalinteger

Total number of records

limitinteger

Limit used in request

offsetinteger

Offset used in request

Example response

{
  "records": [
    {
      "id": "4030",
      "date": 1699020642,
      "give": "0.00002901",
      "receive": "1",
      "rate": "34470.87211306",
      "path": [
        {
          "from": "BTC",
          "to": "USDT",
          "rate": "34470.87211306"
        }
      ]
    }
  ],
  "total": 4,
  "limit": 1
}