Accounts

Trading Accounts

GET https://api.liquid.com/trading_accounts/{trading_account_id}

A trading account is created based on a combination of a pair a funding currency: 1. BTCUSD and USD as funding currency. 2. BTCUSD and QASH as funding currency. The above are two separate trading accounts.

Path Parameters

NameTypeDescription

trading_account_id

string

Example:/2309839. Get all trading account if this is not specified.

[
    {
        "id": 2309839,
        "leverage_level": 2,
        "max_leverage_level": 2,
        "current_leverage_level": 2,
        "pnl": 0.0,
        "equity": 53236.47069,
        "margin": 0.0,
        "free_margin": 53236.47069,
        "trader_id": 735092,
        "status": "active",
        "product_code": "CASH",
        "currency_pair_code": "BTCUSD",
        "position": 0.0,
        "balance": 53236.47069,
        "created_at": 1585549581,
        "updated_at": 1585549581,
        "pusher_channel": "trading_account_2309839",
        "margin_percent": 0.1,
        "product_id": "1",
        "funding_currency": "USD"
    },
    {
        "id": 2310428,
        "leverage_level": 2,
        "max_leverage_level": 2,
        "current_leverage_level": 2,
        "pnl": 0.0,
        "equity": 0.0,
        "margin": 0.0,
        "free_margin": 0.0,
        "trader_id": 735092,
        "status": "active",
        "product_code": "CASH",
        "currency_pair_code": "BTCJPY",
        "position": 0.0,
        "balance": 0.0,
        "created_at": 1585565229,
        "updated_at": 1585565229,
        "pusher_channel": "trading_account_2310428",
        "margin_percent": 0.1,
        "product_id": "5",
        "funding_currency": "JPY"
    },
    {
        "id": 2310429,
        "leverage_level": 2,
        "max_leverage_level": 2,
        "current_leverage_level": 2,
        "pnl": 0.0,
        "equity": 53236.47069,
        "margin": 0.0,
        "free_margin": 53236.47069,
        "trader_id": 735092,
        "status": "active",
        "product_code": "CASH",
        "currency_pair_code": "P-BTCJPY",
        "position": 0.0,
        "balance": 53236.47069,
        "created_at": 1585565239,
        "updated_at": 1585565239,
        "pusher_channel": "trading_account_2310429",
        "margin_percent": 0.1,
        "product_id": "571",
        "funding_currency": "USD"
    },
    {
        "id": 2332035,
        "leverage_level": 2,
        "max_leverage_level": 2,
        "current_leverage_level": 2,
        "pnl": 0.0,
        "equity": 53236.47069,
        "margin": 0.0,
        "free_margin": 53236.47069,
        "trader_id": 735092,
        "status": "active",
        "product_code": "CASH",
        "currency_pair_code": "P-BTCUSD",
        "position": 0.0,
        "balance": 53236.47069,
        "created_at": 1587361744,
        "updated_at": 1587361744,
        "pusher_channel": "trading_account_2332035",
        "margin_percent": 0.1,
        "product_id": "572",
        "funding_currency": "USD"
    },
    {
        "id": 2333856,
        "leverage_level": 2,
        "max_leverage_level": 2,
        "current_leverage_level": 2,
        "pnl": 0.0,
        "equity": 0.0,
        "margin": 0.0,
        "free_margin": 0.0,
        "trader_id": 735092,
        "status": "active",
        "product_code": "CASH",
        "currency_pair_code": "P-BTCUSD",
        "position": 0.0,
        "balance": 0.0,
        "created_at": 1587448997,
        "updated_at": 1587448997,
        "pusher_channel": "trading_account_2333856",
        "margin_percent": 0.1,
        "product_id": "572",
        "funding_currency": "ETH"
    },
    {
        "id": 2333857,
        "leverage_level": 2,
        "max_leverage_level": 2,
        "current_leverage_level": 2,
        "pnl": 0.0,
        "equity": 0.0,
        "margin": 0.0,
        "free_margin": 0.0,
        "trader_id": 735092,
        "status": "active",
        "product_code": "CASH",
        "currency_pair_code": "P-BTCUSD",
        "position": 0.0,
        "balance": 0.0,
        "created_at": 1587450088,
        "updated_at": 1587450088,
        "pusher_channel": "trading_account_2333857",
        "margin_percent": 0.1,
        "product_id": "572",
        "funding_currency": "BTC"
    },
    {
        "id": 2334092,
        "leverage_level": 2,
        "max_leverage_level": 2,
        "current_leverage_level": 2,
        "pnl": 0.0,
        "equity": 0.0,
        "margin": 0.0,
        "free_margin": 0.0,
        "trader_id": 735092,
        "status": "active",
        "product_code": "CASH",
        "currency_pair_code": "BTCUSD",
        "position": 0.0,
        "balance": 0.0,
        "created_at": 1587454219,
        "updated_at": 1587454219,
        "pusher_channel": "trading_account_2334092",
        "margin_percent": 0.1,
        "product_id": "1",
        "funding_currency": "BTC"
    },
    {
        "id": 2334154,
        "leverage_level": 2,
        "max_leverage_level": 2,
        "current_leverage_level": 2,
        "pnl": 0.0,
        "equity": 0.0,
        "margin": 0.0,
        "free_margin": 0.0,
        "trader_id": 735092,
        "status": "active",
        "product_code": "CASH",
        "currency_pair_code": "BTCUSD",
        "position": 0.0,
        "balance": 0.0,
        "created_at": 1587454677,
        "updated_at": 1587454677,
        "pusher_channel": "trading_account_2334154",
        "margin_percent": 0.1,
        "product_id": "1",
        "funding_currency": "ETH"
    },
    {
        "id": 2339341,
        "leverage_level": 25,
        "max_leverage_level": 1,
        "current_leverage_level": 25,
        "pnl": 0.0,
        "equity": 53236.47069,
        "margin": 0.0,
        "free_margin": 53236.47069,
        "trader_id": 735092,
        "status": "active",
        "product_code": "CASH",
        "currency_pair_code": "BTCJPY",
        "position": 0.0,
        "balance": 53236.47069,
        "created_at": 1591156194,
        "updated_at": null,
        "pusher_channel": "trading_account_2339341",
        "margin_percent": 0.1,
        "product_id": "5",
        "funding_currency": "USD"
    }
]

Bank Accounts

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

Get all bank accounts created.

{
    "models": [
        {
            "id": 68200,
            "acc_name": "Jon Myer",
            "bank_branch": "Branch Mary",
            "acc_number": "12345544563",
            "address": ".",
            "swift": "YUIN898",
            "bank_statement": {
                "bank_statement": {
                    "url": "https://quoine.s3.amazonaws.com/uploads/bank_account/bank_statement/68200/Screen_Shot_2020-09-21_at_11.20.51.png?X-Amz-Expires=600&X-Amz-Date=20200922T064732Z&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAJZFLHXYSOGOI6ZJA/20200922/us-east-1/s3/aws4_request&X-Amz-SignedHeaders=host&X-Amz-Signature=a3e936266a06dd93a22a0d82bfdd2925b5e927f595ad4c307639cb946608ec8b",
                    "thumb": {
                        "url": "https://quoine.s3.amazonaws.com/uploads/bank_account/bank_statement/68200/thumb_Screen_Shot_2020-09-21_at_11.20.51.png?X-Amz-Expires=600&X-Amz-Date=20200922T064732Z&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAJZFLHXYSOGOI6ZJA/20200922/us-east-1/s3/aws4_request&X-Amz-SignedHeaders=host&X-Amz-Signature=0dce0b00c9124b64a601266a96bbbc881a16f82300d1012b7fbf058e14ae6a35"
                    },
                    "for_post": {
                        "url": "https://quoine.s3.amazonaws.com/uploads/bank_account/bank_statement/68200/for_post_Screen_Shot_2020-09-21_at_11.20.51.png?X-Amz-Expires=600&X-Amz-Date=20200922T064732Z&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAJZFLHXYSOGOI6ZJA/20200922/us-east-1/s3/aws4_request&X-Amz-SignedHeaders=host&X-Amz-Signature=7dc5f91e7df6687b4a2f4863923ab776ae47782a7569375b3cdb54f3c8ec5074"
                    },
                    "for_logo": {
                        "url": "https://quoine.s3.amazonaws.com/uploads/bank_account/bank_statement/68200/for_logo_Screen_Shot_2020-09-21_at_11.20.51.png?X-Amz-Expires=600&X-Amz-Date=20200922T064732Z&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAJZFLHXYSOGOI6ZJA/20200922/us-east-1/s3/aws4_request&X-Amz-SignedHeaders=host&X-Amz-Signature=8573869a3eda987761f5369bf80ad4bfe1880f4b3cc94028ac8f79aae35c445c"
                    }
                }
            },
            "status": "approved",
            "bank": "test01",
            "country": "ID",
            "bank_statement_filename": "Screen_Shot_2020-09-21_at_11.20.51.png",
            "reason_new_or_amendment": ".",
            "joint_acc_name": null,
            "joint_address": null,
            "joint_country": null,
            "joint_city": null,
            "id_document": {
                "id_document": {
                    "url": "no-avatar.png",
                    "thumb": {
                        "url": "no-avatar.png"
                    },
                    "for_post": {
                        "url": "no-avatar.png"
                    },
                    "for_logo": {
                        "url": "no-avatar.png"
                    }
                }
            },
            "id_document_filename": null,
            "proof_address": {
                "proof_address": {
                    "url": "no-avatar.png",
                    "thumb": {
                        "url": "no-avatar.png"
                    },
                    "for_post": {
                        "url": "no-avatar.png"
                    },
                    "for_logo": {
                        "url": "no-avatar.png"
                    }
                }
            },
            "proof_address_filename": null
        }
    ]
}

Account Balances

GET https://api.liquid.com/accounts/{currency}

- Get crypto accounts and fiat accounts balances. - Reserved balance tells the amount locked up for open orders and open positions, use /accounts/{currency}/reserved_balance_details

Path Parameters

NameTypeDescription

currency

string

Specify /EUR for Euros only.

{
    "crypto_accounts": [
        {
            "id": 2008910,
            "currency": "UBTC",
            "balance": "0.0",
            "reserved_balance": "0.0",
            "pusher_channel": "user_735092_account_ubtc",
            "lowest_offer_interest_rate": null,
            "highest_offer_interest_rate": null,
            "address": null,
            "currency_symbol": "฿",
            "minimum_withdraw": null,
            "currency_type": "crypto"
        },
        {
            "id": 2008624,
            "currency": "TPAY",
            "balance": "0.0",
            "reserved_balance": "0.0",
            "pusher_channel": "user_735092_account_tpay",
            "lowest_offer_interest_rate": null,
            "highest_offer_interest_rate": null,
            "address": null,
            "currency_symbol": "t",
            "minimum_withdraw": null,
            "currency_type": "crypto"
        },
        ...
    ],
    "fiat_accounts": [
        {
            "id": 1183053,
            "currency": "EUR",
            "balance": "0.0",
            "reserved_balance": "0.0",
            "pusher_channel": "user_735092_account_eur",
            "lowest_offer_interest_rate": null,
            "highest_offer_interest_rate": null,
            "currency_symbol": "€",
            "send_to_btc_address": null,
            "exchange_rate": "1.126130318257697742654",
            "currency_type": "fiat"
        },
        {
            "id": 1142942,
            "currency": "JPY",
            "balance": "0.0",
            "reserved_balance": "0.0",
            "pusher_channel": "user_735092_account_jpy",
            "lowest_offer_interest_rate": null,
            "highest_offer_interest_rate": null,
            "currency_symbol": "¥",
            "send_to_btc_address": null,
            "exchange_rate": "0.00891949410553778155768",
            "currency_type": "fiat"
        },
        ...
    ]
}

// reserved_balance_details //
[
    {
        "object_type": "Order",
        "object_id": 2274365524,
        "amount": "180000.0"
    },
    {
        "object_type": "Trade",
        "object_id": 2274365522,
        "amount": "170000.0"
    },
    {
        "object_type": "LoanBid",
        "object_id": 2274362001,
        "amount": "150.0"
    },
    ...
]

Authenticated Login History

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

Login history

Path Parameters

NameTypeDescription

status

string

- awaiting confirmation - confirmed -success

page

integer

Default page = 1

limit

integer

Default limit = 30

with_attribute

string

Split/Array splitted by , - country - os - browser - user_agent

{
    "models": [
        {
            "ip_address": "115.74.21.19",
            "country_code": "VN",
            "country": "Viet Nam",
            "os": "iOS 14.7.1",
            "browser": " ",
            "user_agent": "LQD-PRODUCTION/1.16.4 (com.quoine.liquid.production; build:10090; iOS 14.7.1) Alamofire/4.8.2",
            "created_at": "2021-03-31T09:11:48.143012Z"
        }
    ],
    "previous_page": null,
    "next_page": 2,
    "current_page": 1,
    "per_page": 1
}

User Fee Tier

GET https://api.liquid.com/user/fee_tier

Current fee tier information

Path Parameters

NameTypeDescription

string

{
    "id": 336746,
    "currency": "USD",
    "balance": 6.02004,
    "free_balance": 5.23888,
    "pnl": 39.63716,
    "margin": 0.65097,
    "orders_margin": 0.0,
    "free_margin": 45.00623,
    "equity": 45.6572,
    "user_id": 52141,
    "maintenance_margin": "0.32549",
    "reserved_balance": "0.0",
    "ico_locking_trackers": []
}

Last updated