# Random

**POST /byron-wallets/{walletId}/coin-selections/random**

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

Select coins to cover the given set of payments.

Uses the <a href="https://iohk.io/blog/self-organisation-in-coin-selection/">
Random-Improve coin selection algorithm</a>.

<b>Note: </b> Not supported for Byron random wallets.



## 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 submitting a withdrawal while another withdrawal is pending.
- **code** (string)
  

### 200: OK

#### Body Parameters: application/json (object)
- **inputs** (array[object])
  A list of transaction inputs
- **outputs** (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.

- **change** (array[object])
  A list of transaction change outputs.
- **collateral** (array[object])
  A list of transaction inputs used for collateral
- **withdrawals** (array[object])
  A list of withdrawals from stake addresses.
- **certificates** (array[object])
  
- **deposits_taken** (array[object])
  A list of deposits associated with a transaction.
- **deposits_returned** (array[object])
  A list of deposits associated with a transaction.
- **metadata** (string(base64))
  Transaction metadata, serialized according to the expected on-chain binary format, base64-encoded.


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