Liquid API
  • Introduction
  • Version History
  • Rate Limiting
  • Authentication
  • Response Data
  • Errors
  • Pagination
  • Public Rest API
    • Product Data
    • Loan Book
    • Fees
  • Private REST API
    • Get Orders
    • Create Orders
    • Edit Orders
    • Cancel Orders
    • Executions
    • Transactions
    • Trading
    • Fiat
    • Crypto
    • Loans
    • Fee Tier
    • Accounts
  • Websocket (Liquid Tap)
    • Introduction
    • Authentication
    • Public Channels
    • Private Channels
    • Ping Pong
  • OAuth
    • OAuth
Powered by GitBook
On this page
  • Tiers
  • Fee Types
  • Check Estimated Order Fees
  • Withdrawal Fees

Was this helpful?

  1. Private REST API

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

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

Last updated 4 years ago

Was this helpful?