Documentation

Balance History

post
https://api.bitfinex.com/v1/history

View all of your balance ledger entries.

📘

Wallet Filtering Restrictions

When filtering by a specific wallet ("trading", "exchange", "deposit") type, the time_since will be forced to <= time_until - 1.day if time_since <= time_until - 1.day. This is due to performance restrictions on the increasing size of data sets within the database.
Users are encouraged to update their code to use the newer REST v2 ledgers endpoint.

Response Details

KeyTypeDescription
currency[string]Currency
amount[decimal]Positive (credit) or negative (debit)
balance[decimal]Wallet balance after the current entry
description[string]Description of the entry. Includes the wallet in which the operation took place
timestamp[time]Timestamp of the entry

Ratelimit: 15 req/min

Query Params
string
required

The currency to look for. For an up-to-date listing of supported currencies see: https://api.bitfinex.com/v2/conf/pub:map:currency:label

date-time

Return only the history after this timestamp. (Max 3 months before until)

date-time

Return only the history before this timestamp. (Default now)

int32
Defaults to 500

Limit the number of entries to return.

string

Return only entries that took place in this wallet. Accepted inputs are: “trading”, “exchange”, “deposit”.

Responses

Updated about 1 year ago

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 1 year ago