# Estimate Fee

**POST /byron-wallets/{walletId}/payment-fees**

<p align="right">status: <strong>stable</strong></p>

Estimate fee for the transaction.



## Servers
- https://localhost:8090/v2: https://localhost:8090/v2 ()



## Parameters

#### Path parameters
- **walletId** (string(hex))
  


## Body parameters
Content-type: application/json

- **payments** (array[object])
  A list of target outputs with amounts specified.

When creating a new transaction, the wallet software ensures that all
user-specified transaction outputs have ada amounts that satisfy the ledger
minimum UTxO rule:

- If a user-specified transaction output has an ada `amount` that is
  **zero**, the wallet software will automatically assign a minimal amount
  of ada to the output so that it satisfies the ledger minimum UTxO rule.

- If a user-specified transaction output has an ada `amount` that is
  **non-zero**, the wallet software will verify that the specified amount
  is large enough to satisfy the ledger minimum UTxO rule. If the amount is
  not large enough, the wallet software will return a `utxo_too_small`
  error, together with a revised ada amount that does satisfy the minimum
  UTxO rule.


## Responses
### 415: Unsupported Media Type

#### Body Parameters: application/json (object)
- **message** (string)
  May occur when providing an invalid 'Content-Type' header.
- **code** (string)
  

### 406: Not Acceptable

#### Body Parameters: application/json (object)
- **message** (string)
  May occur when providing an invalid 'Accept' header.
- **code** (string)
  

### 404: Not Found

#### Body Parameters: application/json (object)
- **message** (string)
  May occur when a given walletId does not match with any known
wallets (because it has been deleted, or has never existed).

- **code** (string)
  
- **info** (object)
  

### 400: Bad Request

#### Body Parameters: application/json (object)
- **message** (string)
  May occur when a request is not well-formed; that is, it fails to parse
successfully. This could be the case when some required parameters
are missing or, when malformed values are provided.

- **code** (string)
  

### 403: Forbidden

#### Body Parameters: application/json (object)
- **message** (string)
  May occur when trying to perform an operation not supported by this type of wallet.
- **code** (string)
  

### 202: Accepted

#### Body Parameters: application/json (object)
- **estimated_min** (object)
  Coins, in Lovelace. Only relates to 'Ada'. Refer to `assets` for multi-assets wallets instead.
- **estimated_max** (object)
  Coins, in Lovelace. Only relates to 'Ada'. Refer to `assets` for multi-assets wallets instead.
- **minimum_coins** (array[object])
  A list of minimum coin values that each output in a payment must satisfy. The values themselves depends on two things:

  - (a) Some updatable protocol parameters fixed by the network.
  - (b) The nature of the outputs (i.e. the kind of assets it includes).

The list is a direct 1:1 mapping of the requested outputs. Said differently, it has the **same number of items** and **items
are ordered in the same way** as **requested outputs** are ordered. In the case where there's no explicitly requested outputs (e.g.
when calculating fee for delegation), this list is empty.

For example, an output containing only `Ada` may require to be of at least `1 Ada`. An output containing only an hypothetical `AppleCoin`
may require to also carry a minimum of `1.2 Ada`. Note that no matter what, a minimum coin value is always given in Lovelace / Ada.

> ℹ️ This mechanism is used by the protocol to protect against flooding of the network with worthless assets. By requiring a minimum coin value to every
UTxO, they are given an intrinsic value indexed itself on the value of Ada.

- **deposit** (object)
  Coins, in Lovelace. Only relates to 'Ada'. Refer to `assets` for multi-assets wallets instead.


[Powered by Bump.sh](https://bump.sh)