Transactions

List of transactions which resulted in balance changes

GET https://api.liquid.com/balance_history

Query Parameters

NameTypeDescription

source_action

String

Types of events:

funding

funding_fee

withdrawal

withdrawal_fee

trade

loan

repay

cfd_pnl

claim_trade

loan_trade

trade_fee

rebate_trade_fee

...

source_object_id

String/int

must specify source_object_type & source_object_id

source_object_type

String

Example:

execution

trade

loan

quickExchange

currency

String

Symbol of asset. Example BTC, ETH, XRP

timestamp_lte

String/Decimal

Only show transactions at or before this timestamp (Unix timestamps in seconds)

Can be paired with timestamp_gte

timestamp_gte

String/Decimal

Only show transactions at or after this timestamp (Unix timestamps in seconds)

Can be paired with timestamp_lte

limit

String/Int

Supported values

Default: 1000

Max: 1000

Min: 10

source_group

String

Supported values: trading,lending, funding, withdrawal, qex, earn

{
    "models": [
        {
            "id": 2642989162,
            "currency": "USD",
            "amount": "-14.32229",
            "source_action": "trade",
            "source_object_type": "Execution",
            "source_object_id": 450284991,
            "timestamp": "1632493065.665",
            "balance": "0.56398"
        },
        {
            "id": 2642989074,
            "currency": "USD",
            "amount": "-173.1",
            "source_action": "trade",
            "source_object_type": "Execution",
            "source_object_id": 450284975,
            "timestamp": "1632493064.420",
            "balance": "14.88627"
        },
        {
            "id": 2642987639,
            "currency": "USD",
            "amount": "187.88",
            "source_action": "quick_exchange",
            "source_object_type": null,
            "source_object_id": null,
            "timestamp": "1632492965.091",
            "balance": "187.98627"
        },
        {
            "id": 2636344725,
            "currency": "USD",
            "amount": "-19.32131",
            "source_action": "trade",
            "source_object_type": "Execution",
            "source_object_id": 449147139,
            "timestamp": "1632105240.197",
            "balance": "0.10627"
        },
        {
            "id": 2636344133,
            "currency": "USD",
            "amount": "-7.33952",
            "source_action": "trade",
            "source_object_type": "Execution",
            "source_object_id": 449147057,
            "timestamp": "1632105239.109",
            "balance": "19.42758"
        },
        {
            "id": 2636344129,
            "currency": "USD",
            "amount": "-8.6559",
            "source_action": "trade",
            "source_object_type": "Execution",
            "source_object_id": 449147056,
            "timestamp": "1632105239.093",
            "balance": "26.7671"
        },
        {
            "id": 2634006881,
            "currency": "USD",
            "amount": "15.67453",
            "source_action": "cfd_pnl",
            "source_object_type": "TradeClosing",
            "source_object_id": 283292467,
            "timestamp": "1631765032.397",
            "balance": "35.423"
        },
        {
            "id": 2634006862,
            "currency": "USD",
            "amount": "14.31595",
            "source_action": "cfd_pnl",
            "source_object_type": "TradeClosing",
            "source_object_id": 283292466,
            "timestamp": "1631765032.348",
            "balance": "19.74847"
        },
        {
            "id": 2633885745,
            "currency": "USD",
            "amount": "-0.00531",
            "source_action": "cfd_fee",
            "source_object_type": "Trade",
            "source_object_id": 156294516,
            "timestamp": "1631750524.425",
            "balance": "5.43252"
        },
        {
            "id": 2633883369,
            "currency": "USD",
            "amount": "-0.00554",
            "source_action": "cfd_fee",
            "source_object_type": "Trade",
            "source_object_id": 156267866,
            "timestamp": "1631750496.824",
            "balance": "5.43783"
        }
    ],
    "next": "/balance_history?currency=USD&limit=10&until=1631750496.824&last_id=2633883369&timestamp_lte=1632493065.665",
    "previous": null
}

Transaction History (Will be deprecated)

GET https://api.liquid.com/transactions?currency={currency}

Get a list of transactions by specifying the currency.

Query Parameters

NameTypeDescription

currency

string

Specify e.g. currency=USD, USD must be in uppercase letters.

transaction_type

string

Filter with repay, funding, interest_transfer, trade, loan, trade_fee

limit

string

Specify limit=10 to get 10 results.

page

string

Use together with limit. A page=2 with limit=10 returns result of 11th to 20th.

{
    "models": [
        {
            "id": 1,
            "transaction_type": "funding",
            "from_fiat_account_id": null,
            "to_fiat_account_id": 4,
            "from_role": null,
            "to_role": null,
            "currency": "USD",
            "gross_amount": "0.00015",
            "net_amount": "0.00015",
            "fee": "0.0",
            "notes": "",
            "fx_rate": null,
            "loan": null,
            "created_at": 1581932354
        }
    ],
    "current_page": 1,
    "total_pages": 1
}

Last updated