Skip to main content
POST
/
api
/
v4
/
main-account
/
history
Get deposit/withdraw history
curl --request POST \
  --url https://whitebit.com/api/v4/main-account/history \
  --header 'Content-Type: application/json' \
  --header 'X-TXC-APIKEY: <api-key>' \
  --data '
{
  "transactionMethod": 1,
  "ticker": "BTC",
  "offset": 0,
  "limit": 100,
  "status": [
    3,
    7
  ],
  "request": "{{request}}",
  "nonce": "{{nonce}}"
}
'
{
  "limit": 100,
  "offset": 0,
  "records": [
    {
      "address": "3ApEASLcrQtZpg1TsssFgYF5V5YQJAKvuE",
      "uniqueId": null,
      "createdAt": 1593437922,
      "currency": "Bitcoin",
      "ticker": "BTC",
      "method": 1,
      "amount": "0.0006",
      "description": "",
      "memo": "",
      "fee": "0",
      "status": 15,
      "network": null,
      "transactionHash": "a275a514013e4e0f927fd0d1bed215e7f6f2c4c6ce762836fe135ec22529d886",
      "transactionId": "5e112b38-9652-11ed-a1eb-0242ac120002",
      "details": {
        "partial": {
          "requestAmount": "50000",
          "processedAmount": "39000",
          "processedFee": "273",
          "normalizeTransaction": ""
        }
      },
      "confirmations": {
        "actual": 1,
        "required": 2
      }
    }
  ],
  "total": 300
}

Authorizations

​
X-TXC-APIKEY
string
header
required

API key authentication using signed requests

Body

application/json
​
request
string
required

Request signature

​
nonce
string
required

Unique request identifier

​
transactionMethod
enum<integer>

Method. Example: 1 to display deposits / 2 to display withdraws. Do not send this parameter in order to receive both deposits and withdraws.

Available options:
1,
2
​
ticker
string

Currency's ticker.

​
address
string

Can be used for filtering transactions by specific address.

​
memo
string

Can be used for filtering transactions by specific memo

​
addresses
string[]

Can be used for filtering transactions by specific array of addresses.

Maximum array length: 20
​
uniqueId
string

Can be used for filtering transactions by specific unique id

​
limit
integer
default:50

LIMIT is a special clause used to limit records a particular query can return.

Required range: 1 <= x <= 100
​
offset
integer
default:0

If you want the request to return entries starting from a particular line, you can use OFFSET clause to tell it where it should start.

Required range: 0 <= x <= 10000
​
status
integer[]

Can be used for filtering transactions by status codes.

⚠️ Caution: You must use this parameter with appropriate transactionMethod and use valid status codes for this method. You can find them in the endpoint description above. Example: "status": [3,7]

Response

All validations succeeded and creating transaction is started

​
limit
integer
​
offset
integer
​
records
object[]
​
total
integer

Total number of transactions, use this for calculating 'limit' and 'offset'