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