# 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": "" }, "medium":{ "fee_rate": 19.137, "blocks": 2, "unit": "" }, "fast":{ "fee_rate": 28.7055, "blocks": 1, "unit": "" } } ``` ## Errors Errors in this API are the same as the ones specified in the wallet API docs. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://balance-1.gitbook.io/balance-custody-api/v1/transaction-fees.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.