Fee Tier

get
Tiers
https://api.liquid.com/user/fee_tier
Get a user's current tier & traded volume.
Request
Response
Request
​
Response
200: OK
- 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"
}
get
Fee Types
https://api.liquid.com/user/fees?fee_type={fee_type}
View different kinds of fee a user has to pay.
Request
Response
Request
Query Parameters
fee_type
required
string
Specify trade_fee, trade_fee_commission, withdrawal_fee, bank_fee. 
Response
200: OK
Trade Fee
Trade Fee Commission
Withdrawal Fee
Bank Fee
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"
}
post
Check Estimated Order Fees
https://api.liquid.com/fees/estimate
View the estimated fees and discount.
Request
Response
Request
Body Parameters
for_action
required
string
Specify "for_action": "create_order".
trading_type
required
string
Within "for_params":{} supported values are:
"trading_type": "spot" 
"trading_type": "margin"
"trading_type": "cfd"
"trading_type": "perpetual"
side
required
string
Within "for_params": {} supported values are:
"side": "buy" 
"side": "sell".
quantity
required
string
Within "for_params": {} supported values are:
"quantity": "2" as an example.
price
required
string
Within "for_params": {} supported values are:
"price": "10000"as an example.
order_type
required
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
required
string
Within "for_params": {} supported values are:
"product_id": "123456" as an example.
funding_currency
optional
string
Within "for_params": {} supported values are:
"funding_currency": "USD" as an example.
Defaults to USD if not specified.
Response
200: OK
- 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"
            }
        ]
    }
}
post
Withdrawal Fees
https://api.liquid.com/fees/estimate
View the withdrawal fees for fiat or crypto.
Request
Response
Request
Body Parameters
for_action
required
string
Specify "for_action": "withdraw".
currency
required
string
Within "for_params": {} supported values are:
"currency" "USD" as an example.
amount
required
string
Within "for_params": {} supported values are:
"amount": "10000" as an example.
bank_account_id
required
string
Required when currency is a fiat.
Within "for_params": {} supported values are:
"bank_account_id": "1" as an example.
Response
200: OK
// 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"
            }
        ]
    }
}
Private REST API - Previous
Loans
Next - Private REST API
Accounts
Last updated 7 months ago
Fee Tier

getTiers

getFee Types

postCheck Estimated Order Fees

postWithdrawal Fees

get
Tiers

get
Fee Types

post
Check Estimated Order Fees

post
Withdrawal Fees
