Fiat

get
Fiat Accounts

https://api.liquid.com/fiat_accounts
Get all fiat account balances.
Request
Response
Request
Response
200: OK
- "reserved_balance" will not be 0.0 when you have live orders. - One SGD equals to "exchange_rate": 0.7326xxx in USD.
[
{
"id": 276614,
"currency": "SGD",
"balance": 0.08457,
"reserved_balance": 0.0,
"pusher_channel": "user_35258_account_sgd",
"lowest_offer_interest_rate": null,
"highest_offer_interest_rate": null,
"currency_symbol": "S$",
"send_to_btc_address": null,
"exchange_rate": 0.7326124957945044620556,
"currency_type": "fiat"
},
{
"id": 286859,
"currency": "JPY",
"balance": 4.50346,
"reserved_balance": 0.0,
"pusher_channel": "user_35258_account_jpy",
"lowest_offer_interest_rate": null,
"highest_offer_interest_rate": null,
"currency_symbol": "¥",
"send_to_btc_address": null,
"exchange_rate": 0.009403630486137013160637,
"currency_type": "fiat"
},
{
"id": 442362,
"currency": "AUD",
"balance": 0.0,
"reserved_balance": 0.0,
"pusher_channel": "user_35258_account_aud",
"lowest_offer_interest_rate": null,
"highest_offer_interest_rate": null,
"currency_symbol": "AU$",
"send_to_btc_address": null,
"exchange_rate": 0.7299093356254630773225,
"currency_type": "fiat"
},
{
"id": 426330,
"currency": "EUR",
"balance": 0.0,
"reserved_balance": 0.0,
"pusher_channel": "user_35258_account_eur",
"lowest_offer_interest_rate": null,
"highest_offer_interest_rate": null,
"currency_symbol": "€",
"send_to_btc_address": null,
"exchange_rate": 1.179785715102790283091,
"currency_type": "fiat"
},
{
"id": 276611,
"currency": "USD",
"balance": 0.00817,
"reserved_balance": 0.0,
"pusher_channel": "user_35258_account_usd",
"lowest_offer_interest_rate": null,
"highest_offer_interest_rate": null,
"currency_symbol": "$",
"send_to_btc_address": null,
"exchange_rate": 1.0,
"currency_type": "fiat"
},
{
"id": 650465,
"currency": "HKD",
"balance": 0.0,
"reserved_balance": 0.0,
"pusher_channel": "user_35258_account_hkd",
"lowest_offer_interest_rate": null,
"highest_offer_interest_rate": null,
"currency_symbol": "HK$",
"send_to_btc_address": null,
"exchange_rate": 0.12890530107203117232904,
"currency_type": "fiat"
},
{
"id": 836941,
"currency": "INR",
"balance": 0.0,
"reserved_balance": 0.0,
"pusher_channel": "user_35258_account_inr",
"lowest_offer_interest_rate": null,
"highest_offer_interest_rate": null,
"currency_symbol": "₹",
"send_to_btc_address": null,
"exchange_rate": 0.013631408433515211309118072,
"currency_type": "fiat"
},
{
"id": 820799,
"currency": "CNY",
"balance": 0.0,
"reserved_balance": 0.0,
"pusher_channel": "user_35258_account_cny",
"lowest_offer_interest_rate": null,
"highest_offer_interest_rate": null,
"currency_symbol": "¥",
"send_to_btc_address": null,
"exchange_rate": 0.14612192413349698988836285,
"currency_type": "fiat"
},
{
"id": 837567,
"currency": "IDR",
"balance": 0.0,
"reserved_balance": 0.0,
"pusher_channel": "user_35258_account_idr",
"lowest_offer_interest_rate": null,
"highest_offer_interest_rate": null,
"currency_symbol": "Rp",
"send_to_btc_address": null,
"exchange_rate": 0.0000567251,
"currency_type": "fiat"
}
]

get
Fiat Deposit Requests

https://api.liquid.com/fund_infos?currency={currency}
Get a history of fiat deposit requests.
Request
Response
Request
Query Parameters
currency
required
string
For example: USD, JPY, EUR
Response
200: OK
{
"models": [
{
"id": 1,
"user_id": 4,
"amount": 1000,
"bank_name": "Test Bank",
"created_at": 1551167985,
"currency": "USD",
"status": "pending",
"notes": "this is a note"
}
],
"current_page": 1,
"total_pages": 1
}

get
Fiat Withdrawals

https://api.liquid.com/transactions/withdrawals?currency={currency}&state={state}
Get a history of fiat withdrawals requests.
Request
Response
Request
Query Parameters
currency
required
string
For example: currency=USD.
state
optional
string
Filter by state: pending, processed, cancelled, reverted, declined.
Response
200: OK
- Shows Nestor Toy wants to withdraw 100 USD to bank Isidro VonRueden.
{
"models": [
{
"id": 1,
"currency": "USD",
"amount": 100,
"state": "pending",
"created_at": 1551256363,
"bank_account": {
"id": 2,
"acc_name": "Nestor Toy",
"bank_branch": "Omnis omnis optio eius.",
"acc_number": "305295372929295",
"address": "9037 Gleason Isle",
"swift": "Vel non eum magnam.",
"bank_statement": {
"bank_statement": {
"url": "/uploads/bank_account/bank_statement/2/sample.pdf",
"thumb": {
"url": "/uploads/bank_account/bank_statement/2/thumb_sample.pdf"
},
"for_post": {
"url": "/uploads/bank_account/bank_statement/2/for_post_sample.pdf"
},
"for_logo": {
"url": "/uploads/bank_account/bank_statement/2/for_logo_sample.pdf"
}
}
},
"status": "pending",
"bank": "Isidro VonRueden",
"country": null,
"bank_statement_filename": "sample.pdf",
"reason_new_or_amendment": "Et molestiae odio iure.",
"joint_acc_name": "",
"joint_address": null,
"joint_country": "Suriname",
"joint_city": null,
"id_document": {
"id_document": {
"url": "/uploads/bank_account/id_document/2/sample.pdf",
"thumb": {
"url": "/uploads/bank_account/id_document/2/thumb_sample.pdf"
},
"for_post": {
"url": "/uploads/bank_account/id_document/2/for_post_sample.pdf"
},
"for_logo": {
"url": "/uploads/bank_account/id_document/2/for_logo_sample.pdf"
}
}
},
"id_document_filename": "sample.pdf",
"proof_address": {
"proof_address": {
"url": "/uploads/bank_account/proof_address/2/sample.pdf",
"thumb": {
"url": "/uploads/bank_account/proof_address/2/thumb_sample.pdf"
},
"for_post": {
"url": "/uploads/bank_account/proof_address/2/for_post_sample.pdf"
},
"for_logo": {
"url": "/uploads/bank_account/proof_address/2/for_logo_sample.pdf"
}
}
},
"proof_address_filename": "sample.pdf"
}
}
],
"current_page": 1,
"total_pages": 1
}

post
Create Fiat Account

https://api.liquid.com/fiat_accounts
Create a fiat account by specifying the currency.
Request
Response
Request
Body Parameters
currency
required
string
For euro: {"currency": "EUR"}
Response
200: OK
{
"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.0187953469193813009417",
"currency_type": "fiat"
}

post
Create a Fiat Deposit Request

https://api.liquid.com/fund_infos
Request
Response
Request
Body Parameters
amount
required
string
"amount": "1000"
currency
required
string
"currency": "USD"
bank_name
required
string
"bank_name": "Test Bank"
Response
200: OK
{
"fund_info": {
"id": 1,
"user_id": 4,
"amount": 1000,
"bank_name": "Test Bank",
"created_at": 1551251113,
"currency": "USD",
"status": "pending"
}
}

post
Create a Fiat Withdrawal

https://api.liquid.com/withdrawals
Request
Response
Request
Body Parameters
auth_code
required
string
See the explanation below.
withdrawal.currency
required
string
"currency": "USD"
withdrawal.amount
required
string
"amount": "1000"
withdrawal.bank_account_id
required
string
"bank_account_id": "53742"
Response
200: OK
{
"id": 60142,
"currency": "USD",
"amount": "1000.0",
"state": "pending",
"created_at": 1568692166,
"bank_account": {
"id": 53724,
"acc_name": "Quoine Ltd",
"bank_branch": "Tokyo",
"acc_number": "123456789",
"address": ".",
"swift": "123",
"bank_statement": {
"bank_statement": {
"url": "https://quoine.s3.amazonaws.com/uploads/bank_account/bank_statement/53724/Screen_Shot_2019-09-17_at_10.48.37_AM.png?X-Amz-Expires=600&X-Amz-Date=20190917T034926Z&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAJZFLHXYSOGOI6ZJA/20190917/us-east-1/s3/aws4_request&X-Amz-SignedHeaders=host&X-Amz-Signature=3b3cdf5f1b656f69718347672d3cdc1f842fb84dd92d443f11a77a7d59c248c9",
"thumb": {
"url": "https://quoine.s3.amazonaws.com/uploads/bank_account/bank_statement/53724/thumb_Screen_Shot_2019-09-17_at_10.48.37_AM.png?X-Amz-Expires=600&X-Amz-Date=20190917T034926Z&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAJZFLHXYSOGOI6ZJA/20190917/us-east-1/s3/aws4_request&X-Amz-SignedHeaders=host&X-Amz-Signature=aec255c0b6fbc325866d203797ce8b965755175cc8b5736e9323fd44d7a4a0ff"
},
"for_post": {
"url": "https://quoine.s3.amazonaws.com/uploads/bank_account/bank_statement/53724/for_post_Screen_Shot_2019-09-17_at_10.48.37_AM.png?X-Amz-Expires=600&X-Amz-Date=20190917T034926Z&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAJZFLHXYSOGOI6ZJA/20190917/us-east-1/s3/aws4_request&X-Amz-SignedHeaders=host&X-Amz-Signature=2539cfae252adcafb552820c6061d79bcf8504aa3abb9fc73e1daaa797bafce1"
},
"for_logo": {
"url": "https://quoine.s3.amazonaws.com/uploads/bank_account/bank_statement/53724/for_logo_Screen_Shot_2019-09-17_at_10.48.37_AM.png?X-Amz-Expires=600&X-Amz-Date=20190917T034926Z&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAJZFLHXYSOGOI6ZJA/20190917/us-east-1/s3/aws4_request&X-Amz-SignedHeaders=host&X-Amz-Signature=598d7f5270e4ff7b390f6d8e55062a1fffc3200e868cedb3c67a33a5f7f7a4e8"
}
}
},
"status": "pending",
"bank": "Bank of Japan",
"country": "JA",
"bank_statement_filename": "Screen_Shot_2019-09-17_at_10.48.37_AM.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
}
}

NO-TOUCH MODE

Creating a fiat withdrawal requires user to interactively input 2FA code. This might get in the way if user is trying to build a fully automated system.

No-touch mode allows human interaction (auth token and email confirmation) to be omitted. No-touch mode can be enabled by adding at least one confirmed Whitelist IP.

Request Body
Request Body
// "auth_code" must be "000000" for NO-TOUCH MODE //
{
"auth_code": "000000",
"withdrawal":
{
"currency": "USD",
"amount": "1000",
"bank_account_id": "53742"
}
}