Transactions

List of transactions which resulted in balance changes

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

Query Parameters

Name	Type	Description
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

200: OK

{
    "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
}

200: OK Valid request. No data output.

{
    "models": [],
    "next": null,
    "previous": null
}

422: Unprocessable Entity

// Specified currency must be capitalised 
{
    "errors": {
        "currency": [
            "not_valid"
        ]
    }
}

Transaction History (Will be deprecated)

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

Get a list of transactions by specifying the currency.

Query Parameters

Name	Type	Description
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.

200

{
    "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
}