Fee Tier

Tiers

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

Get a user's current tier & traded volume.

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

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

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.

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

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

Last updated