> For the complete documentation index, see [llms.txt](https://balance-1.gitbook.io/balance-custody-api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://balance-1.gitbook.io/balance-custody-api/v1/transaction-fees.md).

# Transaction fees

The fees are approximate, and may change slightly at the time of transaction generation.

We cannot guarantee that any given fee will result in a transaction being included in a block.

* [Supported Assets](#supported-currencies)
* [Fee Units](#fee-units)
* [API URL](#api-url)
* [Authentication](#authentication)
* [API Endpoints](#api-endpoints)
  * [`GET /api/v1/transaction_fees`](#get-api-v1-transaction_fees)
  * [`GET /api/v1/transaction_fees/:currency`](#get-api-v1-transaction_fees-currency)
* [Errors](#errors)

## Supported Assets

When using an assset as a parameter to our API endpoints, the lowercase ticker symbol (i.e. `btc`) must be used. For a full list of supported assets, see the [Supported Assets](/balance-custody-api/supported-assets.md) article.

## Fee Units

Fee units returned in this API correspond to the following units:

* **BTC**: sats/vB
* **BCH**: sats/byte
* **ADA**: ada
* **LTC**: litoshi/byte
* **ETH**: Gwei
* **EIGEN**: Gwei
* **LsETH**: Gwei
* **FIL**: nanoFIL
* **XRP**: XRP/op
* **XLM**: XLM/op
* **PAX**: Gwei
* **USDC**: Gwei
* **PAXG**: Gwei
* **EURS**: Gwei

## API URL

You will receive your integration URL from your point of contact at Balance, and will look like:

```
YOUR_CUSTOM_SUBDOMAIN.balancecustody.ca
```

***

## Authentication

The data exposed through this API is not sensitive and therefore any call to the endpoints is unauthenticated.

***

## API Endpoints

These `curl` examples work out of the box as the API does not require any headers to be set.

#### `GET /api/v1/transaction_fees`

List all available currencies with their affiliated fee setting values. No parameters accepted.

**Request**

```bash
curl https://your_custom_subdomain.balancecustody.ca/api/v1/transaction_fees
```

**Response**

Returns a JSON struct for all currencies with their affiliated fee setting values.

Status: `200`

Data:

```json
{
  "btc": {
    "slow":   { "fee_rate": 1.0,       "blocks": 25, "unit": "sat/b" },
    "medium": { "fee_rate": 19.137,    "blocks": 2,  "unit": "sat/b" },
    "fast":   { "fee_rate": 28.7055,   "blocks": 1,  "unit": "sat/b" }
  },
  "bch": {
    "slow":   { "fee_rate": 1.0,       "blocks": 1,  "unit": "sat/b" },
    "medium": { "fee_rate": 3.0,       "blocks": 1,  "unit": "sat/b" },
    "fast":   { "fee_rate": 5.0,       "blocks": 1,  "unit": "sat/b" }
  },
  "ltc": {
    "slow":   { "fee_rate": 1.0,       "blocks": 1,  "unit": "sat/b" },
    "medium": { "fee_rate": 1.5645,    "blocks": 1,  "unit": "sat/b" },
    "fast":   { "fee_rate": 5.215,     "blocks": 1,  "unit": "sat/b" }
  },
  "eth": {
    "slow":   { "fee_rate": 0.5,       "blocks": 1,  "unit": "gwei" },
    "medium": { "fee_rate": 1.0,       "blocks": 1,  "unit": "gwei" },
    "fast":   { "fee_rate": 3.0,       "blocks": 1,  "unit": "gwei" }
  },
  "eigen": {
    "slow":   { "fee_rate": 0.5,       "blocks": 1,  "unit": "gwei" },
    "medium": { "fee_rate": 1.0,       "blocks": 1,  "unit": "gwei" },
    "fast":   { "fee_rate": 3.0,       "blocks": 1,  "unit": "gwei" }
  },
  "lseth": {
    "slow":   { "fee_rate": 0.5,       "blocks": 1,  "unit": "gwei" },
    "medium": { "fee_rate": 1.0,       "blocks": 1,  "unit": "gwei" },
    "fast":   { "fee_rate": 3.0,       "blocks": 1,  "unit": "gwei" }
  },
  "fil": {
    "slow":   { "fee_rate": 7.5606e-05,"blocks": 1,  "unit": "nanoFIL" },
    "medium": { "fee_rate": 0.00012601,"blocks": 1,  "unit": "nanoFIL" },
    "fast":   { "fee_rate": 0.00025202,"blocks": 1,  "unit": "nanoFIL" }
  },
  "xrp": {
    "slow":   { "fee_rate": 1.0e-05,   "blocks": 1,  "unit": "xrp/op" },
    "medium": { "fee_rate": 0.005,     "blocks": 1,  "unit": "xrp/op" },
    "fast":   { "fee_rate": 0.01,      "blocks": 1,  "unit": "xrp/op" }
  },
  "xlm": {
    "slow":   { "fee_rate": 1.0e-05,   "blocks": 1,  "unit": "xlm/op" },
    "medium": { "fee_rate": 1.0e-05,   "blocks": 1,  "unit": "xlm/op" },
    "fast":   { "fee_rate": 0.0008,    "blocks": 1,  "unit": "xlm/op" }
  },
  "pax": {
    "slow":   { "fee_rate": 0.5,       "blocks": 1,  "unit": "gwei" },
    "medium": { "fee_rate": 1.0,       "blocks": 1,  "unit": "gwei" },
    "fast":   { "fee_rate": 3.0,       "blocks": 1,  "unit": "gwei" }
  },
  "usdc": {
    "slow":   { "fee_rate": 0.5,       "blocks": 1,  "unit": "gwei" },
    "medium": { "fee_rate": 1.0,       "blocks": 1,  "unit": "gwei" },
    "fast":   { "fee_rate": 3.0,       "blocks": 1,  "unit": "gwei" }
  },
  "paxg": {
    "slow":   { "fee_rate": 0.5,       "blocks": 1,  "unit": "gwei" },
    "medium": { "fee_rate": 1.0,       "blocks": 1,  "unit": "gwei" },
    "fast":   { "fee_rate": 3.0,       "blocks": 1,  "unit": "gwei" }
  },
  "eurs": {
    "slow":   { "fee_rate": 0.5,       "blocks": 1,  "unit": "gwei" },
    "medium": { "fee_rate": 1.0,       "blocks": 1,  "unit": "gwei" },
    "fast":   { "fee_rate": 3.0,       "blocks": 1,  "unit": "gwei" }
  },
  "ada": {
    "slow":   { "fee_rate": 0.15,      "blocks": 1,  "unit": "ada" },
    "medium": { "fee_rate": 0.3,       "blocks": 1,  "unit": "ada" },
    "fast":   { "fee_rate": 0.6,       "blocks": 1,  "unit": "ada" }
  }
}
```

#### `GET /api/v1/transaction_fees/:currency`

Show details for a single currency. No parameters accepted.

**Request**

```bash
curl https://your_custom_subdomain.balancecustody.ca/api/v1/transaction_fees/btc
```

**Response**

Returns a single currency's transaction fees JSON struct.

Status: `200`

Data:

```json
{
   "slow":{
      "fee_rate": 1.0,
      "blocks": 25,
      "unit": "<currency_fee_unit>"
   },
   "medium":{
      "fee_rate": 19.137,
      "blocks": 2,
      "unit": "<currency_fee_unit>"
   },
   "fast":{
      "fee_rate": 28.7055,
      "blocks": 1,
      "unit": "<currency_fee_unit>"
   }
}
```

## Errors

Errors in this API are the same as the ones specified in the wallet API docs.