Fiat

Fiat Accounts

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

Get all fiat account balances.

200 - "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"
    }
]

Fiat Deposit Requests

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

Get a history of fiat deposit requests.

Query Parameters

Name	Type	Description
currency	string	For example: USD, JPY, EUR

200

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

Fiat Withdrawals

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

Get a history of fiat withdrawals requests.

Query Parameters

Name	Type	Description
currency	string	For example: currency=USD.
state	string	Filter by state: pending, processed, cancelled, reverted, declined.

200 - 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
}

Create Fiat Account

POST https://api.liquid.com/fiat_accounts

Create a fiat account by specifying the currency.

Request Body

Name	Type	Description
currency	string	For euro: {"currency": "EUR"}

200

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

Create a Fiat Deposit Request

POST https://api.liquid.com/fund_infos

Request Body

Name	Type	Description
amount	string	"amount": "1000"
currency	string	"currency": "USD"
bank_name	string	"bank_name": "Test Bank"

200

{
    "fund_info": {
        "id": 1,
        "user_id": 4,
        "amount": 1000,
        "bank_name": "Test Bank",
        "created_at": 1551251113,
        "currency": "USD",
        "status": "pending"
    }
}

Create a Fiat Withdrawal

POST https://api.liquid.com/withdrawals

Request Body

Name	Type	Description
auth_code	string	See the explanation below.
withdrawal.currency	string	"currency": "USD"
withdrawal.amount	string	"amount": "1000"
withdrawal.bank_account_id	string	"bank_account_id": "53742"

200

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

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