# Random

**POST /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>.



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



## Parameters

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



### Body: application/json (object)

- **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.
- **withdrawal** (string)
  When provided, instruments the server to automatically withdraw rewards from the source wallet when they are deemed
  sufficient (i.e. they contribute to the balance for at least as much as they cost).

  As a consequence, the resulting transaction may or may not have a withdrawal object. Summarizing:

  withdrawal field | reward balance | result
  ---              | ---            | ---
  `null`           | too small      | ✓ no withdrawals generated
  `null`           | big enough     | ✓ no withdrawals generated
  `"self"`         | too small      | ✓ no withdrawals generated
  `"self"`         | big enough     | ✓ withdrawal generated
- **metadata** (object | null)



## Responses
### 400
Bad Request

#### Body: 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: application/json (object)
- **message** (string)
  May occur when submitting a withdrawal while another withdrawal is pending.
- **code** (string)


### 404
Not Found

#### Body: 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)


### 406
Not Acceptable

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


### 415
Unsupported Media Type

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


### 200
OK

#### Body: 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])
  A delegation certificate belonging to wallet

  Only for 'join_pool' the 'pool' property is required.
- **deposits_taken** (array[object])
  Coins, in Lovelace. Only relates to 'Ada'. Refer to `assets` for multi-assets wallets instead.
- **deposits_returned** (array[object])
  Coins, in Lovelace. Only relates to 'Ada'. Refer to `assets` for multi-assets wallets instead.
- **metadata** (string(base64))
  Transaction metadata, serialized according to the expected on-chain binary format, base64-encoded.


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