List Fees

The method GET /fees enables you to retrieve information on the following:

Customer fees for all available order books
Withdrawal and deposit fees for applicable currencies

HTTP Request

GET https://api-stage.bitso.com/api/v3/fees

Header Parameters

You must specify the following authorization parameters in your request:

Parameter	Description	Required
`key`	See the section, Authentication	Yes
`signature`	See the section, Authentication	Yes
`nonce`	See the section, Authentication	Yes

JSON Response Payload

The endpoint returns a JSON object that includes the following keys:

fees: Contains a JSON array. Every element in the array is a JSON object that includes the fields listed in the table below.
withdrawal_fees: Is a JSON object keyed by currency with its corresponding value representing the net fee amount charged for the withdrawal and denominated in the corresponding currency.
deposit_fees: Contains a JSON array. Every element in the array is a JSON object that includes the fields listed in the second table.

The fields included in the objects of the fees key are as follows:

Field Name	Description	Type	Units
`book`	The order book symbol	String	Major_Minor
`current_volume`	The current trading volume, denominated in minor currency.	String	Minor
`fee_decimal`	DEPRECATED The customer trading fee as a decimal (same as `maker_fee_decimal`). This was the field used before Bitso had a Maker/Taker fee schedule.	String
`fee_percent`	DEPRECATED The customer trading fee as a percentage (same as `maker_fee_percent`). This was the field used before Bitso had a Maker/Taker fee schedule.	String
`maker_fee_decimal`	The customer maker trading fee as a decimal.	String
`maker_fee_percent`	The customer maker trading fee as a percentage.	String
`nextFee`	DEPRECATED It was replaced by `next_maker_fee_percent` and reports the same value. It appears only for backwards compatibility.	String
`next_maker_fee_percent`	The customer maker trading fee as a percentage. It is the fee customers can get when they attain the `next_volume`.	String
`nextTakerFee`	DEPRECATED It was replaced by `next_taker_fee_percent`and reports the same value. It appears only for backwards compatibility.	String
`next_taker_fee_percent`	The customer taker trading fee as a percentage. It is the fee customers can get when they attain the `next_volume`.	String
`nextVolume`	DEPRECATED It was replaced by `next_volume` and reports the same value. It appears only for backwards compatibility.	String
`next_volume`	The next volume customers need to attain so that they can get lower trading fees. These fees are reported in the fields `next_maker_fee_percent` and `next_taker_fee_percent`.	String	Minor
`taker_fee_decimal`	The customer taker trading fee as a decimal.	String
`taker_fee_percent`	The customer taker trading fee as a percentage.	String
`volume_currency`	The ticker of the minor currency. The volume figures reported are denominated in this currency.	String	Minor

The fields included in the objects of the deposit_fees key are as follows:

Field Name	Description	Type
`currency`	The ticker of the currency used in the deposit.	String
`method`	The method used to complete the deposit.	String
`fee`	The net fee amount charged for the deposit.	String
`is_fixed`	A flag to indicate whether the fee is predetermined.	Boolean

The following response object exemplifies the JSON object returned, showing only a few of its elements:

{
   "success":true,
   "payload":{
      "fees":[
         {
            "book":"btc_mxn",
            "fee_percent":"0.6500",
            "fee_decimal":"0.00650000",
            "taker_fee_percent":"0.6500",
            "taker_fee_decimal":"0.00650000",
            "maker_fee_percent":"0.5000",
            "maker_fee_decimal":"0.00500000",
            "volume_currency":"mxn",
            "current_volume":"4375.99",
            "next_volume":"1500000.00",
            "next_maker_fee_percent":"0.490",
            "next_taker_fee_percent":"0.637",
            "nextVolume":"1500000.00",
            "nextFee":"0.490",
            "nextTakerFee":"0.637"
         },
         {
            "book":"eth_btc",
            "fee_percent":"0.0980",
            "fee_decimal":"0.00098000",
            "taker_fee_percent":"0.0980",
            "taker_fee_decimal":"0.00098000",
            "maker_fee_percent":"0.0750",
            "maker_fee_decimal":"0.00075000",
            "volume_currency":"btc",
            "current_volume":"0.00000000",
            "next_volume":"8.00000000",
            "next_maker_fee_percent":"0.072",
            "next_taker_fee_percent":"0.094",
            "nextVolume":"8.00000000",
            "nextFee":"0.072",
            "nextTakerFee":"0.094"
         }
      ],
      "deposit_fees":[
         {
            "currency":"cop",
            "method":"bdb",
            "fee":"0.00",
            "is_fixed":false
         },
         {
            "currency":"ars",
            "method":"bind",
            "fee":"0.01",
            "is_fixed":false
         }
      ],
      "withdrawal_fees":{
         "aave":"0.00100000",
         "ada":"0.50000000",
         "algo":"0.01000000"
      }
   }
}