Fee Tier

Tiers

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

Get a user's current tier & traded volume.

200 - This user is at tier (level) 0. - The combined-trading-volume for Spot, Margin, CFD/Infinity 0.0 USD (currency_pair_volume). - Trading volume for Perpetuals 20000.0 USD. - Tracked between "from_time" and "to_time" (30 days).

{
    "fee_tier": 0,
    "from_time": "2020-08-01T14:00:00Z",
    "to_time": "2020-08-31T14:00:00Z",
    "in_currency": "USD",
    "currency_pair_volume": "0.0",
    "perpetual_volume": "20000.0"
}

Fee Types

GET https://api.liquid.com/user/fees?fee_type={fee_type}

View different kinds of fee a user has to pay.

Query Parameters

Name	Type	Description
fee_type	string	Specify trade_fee, trade_fee_commission, withdrawal_fee, bank_fee.

200

Trade Fee

{
    "id": 1192,
    "fee_type": "trade_fee",
    "priority": 600,
    "conditions": {
        "fee_tier": "0",
        "maker_taker": "taker",
        "product_type": "Perpetual"
    },
    "description": "",
    "charge_type": "percentage",
    "charge_value": "0.0012",
    "charge_base_currency": null
}

Trade Fee Commission

Example #1
{
    "id": 1053,
    "fee_type": "trade_fee_commission",
    "priority": 501,
    "conditions": {
        "maker_taker": "taker",
        "product_type": "Perpetual"
    },
    "description": "",
    "charge_type": "percentage",
    "charge_value": "0.3",
    "charge_base_currency": null
}
Example #2
{
    "id": 1052,
    "fee_type": "trade_fee_commission",
    "priority": 501,
    "conditions": {
        "product_type": "CurrencyPair"
    },
    "description": "",
    "charge_type": "percentage",
    "charge_value": "0.3",
    "charge_base_currency": null
}

Withdrawal Fee

Example #1
{
    "id": 265,
    "fee_type": "withdrawal_fee",
    "priority": 500,
    "conditions": {
        "currency": "ETH"
    },
    "description": "",
    "charge_type": "fixed_amount",
    "charge_value": "0.01",
    "charge_base_currency": null
}
Example #2
{
    "id": 253,
    "fee_type": "withdrawal_fee",
    "priority": 1,
    "conditions": {
        "currency": "GBP"
    },
    "description": "",
    "charge_type": "fixed_amount",
    "charge_value": "5.0",
    "charge_base_currency": null
}

Bank Fee

Example #1
{
    "id": 2271,
    "fee_type": "bank_fee",
    "priority": 510,
    "conditions": {
        "currency": "EUR",
        "transfer_type": "SEPA"
    },
    "description": "Bank fee for EUR SEPA withdrawal",
    "charge_type": "fixed_amount",
    "charge_value": "10.0",
    "charge_base_currency": null
}
Example #2
{
    "id": 1116,
    "fee_type": "bank_fee",
    "priority": 500,
    "conditions": {},
    "description": "",
    "charge_type": "fixed_amount",
    "charge_value": "30.0",
    "charge_base_currency": "USD"
}

Check Estimated Order Fees

POST https://api.liquid.com/fees/estimate

View the estimated fees and discount.

Request Body

Name	Type	Description
for_action	string	Specify "for_action": "create_order".
trading_type	string	Within "for_params":{} supported values are: "trading_type": "spot" "trading_type": "margin" "trading_type": "cfd" "trading_type": "perpetual"
side	string	Within "for_params": {} supported values are: "side": "buy" "side": "sell".
quantity	string	Within "for_params": {} supported values are: "quantity": "2" as an example.
price	string	Within "for_params": {} supported values are: "price": "10000"as an example.
order_type	string	Within "for_params": {} supported values are: "order_type": "limit" "order_type": "market" "order_type": "spot" If "market" is specified, then "price" becomes irrelevant, fees will be calculated by best bid/ask.
product_id	string	Within "for_params": {} supported values are: "product_id": "123456" as an example.
funding_currency	string	Within "for_params": {} supported values are: "funding_currency": "USD" as an example. Defaults to USD if not specified.

200 - When Pay With QASH is turned on, user pays 1873.xxxx - 936.xxxx QASH, otherwise pays 67.95504 USD. - Trade fee may be "0.0" when request "order_type" : "limit", this means makers do not pay fees. - Refer to fees table: https://www.liquid.com/fees/

{
    "fee_options": {
        "default": [
            {
                "fee_type": "trade_fee",
                "amount": "67.95504",
                "currency": "USD"
            }
        ],
        "trade_fee_discount": [
            {
                "fee_type": "trade_fee",
                "amount": "1873.58808933002489532192",
                "currency": "QASH"
            },
            {
                "fee_type": "trade_fee_discount",
                "amount": "-936.79404466501244766096",
                "currency": "QASH"
            }
        ]
    }
}

Withdrawal Fees

POST https://api.liquid.com/fees/estimate

View the withdrawal fees for fiat or crypto.

Request Body

Name	Type	Description
for_action	string	Specify "for_action": "withdraw".
currency	string	Within "for_params": {} supported values are: "currency" "USD" as an example.
amount	string	Within "for_params": {} supported values are: "amount": "10000" as an example.
bank_account_id	string	Required when currency is a fiat. Within "for_params": {} supported values are: "bank_account_id": "1" as an example.

200

// When for_params.currency is a fiat //
{
    "fee_options": {
        "default": [
            {
                "fee_type": "withdrawal_fee",
                "amount": "15.0",
                "currency": "EUR"
            },
            {
                "fee_type": "bank_fee",
                "amount": "25.62",
                "currency": "EUR"
            }
        ]
    }
}
// When for_params.currency is BTC //
{
    "fee_options": {
        "default": [
            {
                "fee_type": "withdrawal_fee",
                "amount": "0.0007",
                "currency": "BTC"
            }
        ]
    }
}