Accounts

get
Trading Accounts

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.
Request
Response
Request
Path Parameters
trading_account_id
optional
string
Example:/2309839. Get all trading account if this is not specified.
Response
200: OK
[
{
"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"
}
]

get
Bank Accounts

https://api.liquid.com/bank_accounts
Get all bank accounts created.
Request
Response
Request
Response
200: OK
{
"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
}
]
}

get
Account Balances

https://api.liquid.com/accounts/{currency}/reserved_balance_details
- Get crypto accounts and fiat accounts balances. - Reserved balance tells the amount locked up for open orders and open positions.
Request
Response
Request
Path Parameters
currency
optional
string
Specify /EUR for Euros only.
Response
200: OK
{
"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"
},
...
]

get
Authenticated Login History

https://api.liquid.com/logins
Login history
Request
Response
Request
Path Parameters
status
optional
string
- awaiting confirmation - confirmed -success
page
optional
integer
Default page = 1
limit
optional
integer
Default limit = 30
with_attribute
optional
string
Split/Array splitted by , - country - os - browser - user_agent
Response
200: OK
Sample request: /logins?status=success&with_attribute=country,os,browser,user_agent&limit=1
{
"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
}

get
User Fee Tier

https://api.liquid.com/user/fee_tier
Current fee tier information
Request
Response
Request
Path Parameters
optional
string
Response
200: OK
{
"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": []
}