Skip to main content
POST
/
api
/
v4
/
convert
/
history
Convert History
curl --request POST \
  --url https://whitebit.com/api/v4/convert/history \
  --header 'Content-Type: application/json' \
  --header 'X-TXC-APIKEY: <api-key>' \
  --header 'X-TXC-PAYLOAD: <api-key>' \
  --header 'X-TXC-SIGNATURE: <api-key>' \
  --data '
{
  "fromTicker": "BTC"
}
'
{ "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, "offset": 0 }

Authorizations

​
X-TXC-APIKEY
string
header
required

The public WhiteBIT API key.

​
X-TXC-PAYLOAD
string
header
required

Base64-encoded JSON request body.

​
X-TXC-SIGNATURE
string
header
required

HMAC-SHA512 signature of the payload, hex-encoded. Computed as hex(HMAC-SHA512(payload, api_secret)).

Body

application/json
​
fromTicker
string

From currency. Example: BTC

Example:

"BTC"

​
toTicker
string

To currency. Example: USDT

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()

Example:

"1699260637"

​
to
string

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

Example:

"1699260637"

​
quoteId
string

Quote Id. Example: 4050

Example:

"4050"

​
limit
integer

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

Required range: 1 <= x <= 100
Example:

100

​
offset
integer

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

Required range: x >= 0
Example:

0

​
nonce
integer

Nonce for request

Example:

1699260637

​
request
string

Request path

Example:

"{{request}}"

Response

Successful response

​
records
object[]
​
total
integer

Total number of records

Example:

4

​
limit
integer

Limit used in request

Example:

1

​
offset
integer

Offset used in request

Example:

0