# 🏦Currencies API

#### Endpoint

**POST**\
`https://malum.co/api/v3/account/currencies`

#### Headers

To authenticate your request, use the following header structure:

```css
MALUM: {Business ID}:{Secret Key}
```

* **Business ID**: Your unique Malum account identifier.
* **Secret Key**: Your API secret key for secure access.

#### Success Response

When the request is successful, the API will return a list of available currencies and their details in the following format:

```json
{
    "status": "success",
    "message": "Currencies retrieved.",
    "data": [{
        "short": "BTC",
        "network": "BTC",
        "min_withdraw": "0.000286",
        "tx_fee": "0.00022"
    }, {
        "short": "ETH",
        "network": "ETH",
        "min_withdraw": "0.001",
        "tx_fee": "0.00066"
    }, {
        "short": "LTC",
        "network": "LTC",
        "min_withdraw": "0.01",
        "tx_fee": "0.001"
    }, {
        "short": "USDC",
        "network": "ETH",
        "min_withdraw": "10",
        "tx_fee": "5.577"
    }, {
        "short": "USDC",
        "network": "POLYGON",
        "min_withdraw": "0.5",
        "tx_fee": "0.011"
    }, {
        "short": "USDC",
        "network": "BSC",
        "min_withdraw": "1",
        "tx_fee": "0.33"
    }, {
        "short": "USDT",
        "network": "ETH",
        "min_withdraw": "10",
        "tx_fee": "5.577"
    }, {
        "short": "USDT",
        "network": "TRON",
        "min_withdraw": "2.431",
        "tx_fee": "1.87"
    }, {
        "short": "USDT",
        "network": "BSC",
        "min_withdraw": "1",
        "tx_fee": "0.33"
    }, {
        "short": "USDT",
        "network": "POLYGON",
        "min_withdraw": "0.5",
        "tx_fee": "0.011"
    }],
    "timestamp": 1728679774
}
```

**Fields:**

* **short**: The cryptocurrency symbol (e.g., "BTC" for Bitcoin, "ETH" for Ethereum).
* **network**: The network on which the cryptocurrency operates (e.g., "BTC" for Bitcoin, "ETH" for Ethereum).
* **min\_withdraw**: The minimum amount of the cryptocurrency that can be withdrawn.
* **tx\_fee**: The network transaction fee for withdrawing that cryptocurrency.

#### Error Response

In case of failure, the API will return an error in the following format:

```json
{
    "status": "failed",
    "error": "Something went wrong for some reason even tho there cant be something wrong on this endpoint",
    "timestamp": 1728679812
}
```

#### Example Request

```bash
curl --location --request POST 'https://malum.co/api/v3/account/currencies' \
--header 'MALUM: yourBusinessID:yourSecretKey' \
--header 'Content-Type: application/json'
```

#### Example Success Response

```json
{
    "status": "success",
    "message": "Currencies retrieved.",
    "data": [{
        "short": "BTC",
        "network": "BTC",
        "min_withdraw": "0.000286",
        "tx_fee": "0.00022"
    }, {
        "short": "ETH",
        "network": "ETH",
        "min_withdraw": "0.001",
        "tx_fee": "0.00066"
    }, {
        "short": "LTC",
        "network": "LTC",
        "min_withdraw": "0.01",
        "tx_fee": "0.001"
    }, {
        "short": "USDC",
        "network": "ETH",
        "min_withdraw": "10",
        "tx_fee": "5.577"
    }, {
        "short": "USDC",
        "network": "POLYGON",
        "min_withdraw": "0.5",
        "tx_fee": "0.011"
    }, {
        "short": "USDC",
        "network": "BSC",
        "min_withdraw": "1",
        "tx_fee": "0.33"
    }, {
        "short": "USDT",
        "network": "ETH",
        "min_withdraw": "10",
        "tx_fee": "5.577"
    }, {
        "short": "USDT",
        "network": "TRON",
        "min_withdraw": "2.431",
        "tx_fee": "1.87"
    }, {
        "short": "USDT",
        "network": "BSC",
        "min_withdraw": "1",
        "tx_fee": "0.33"
    }, {
        "short": "USDT",
        "network": "POLYGON",
        "min_withdraw": "0.5",
        "tx_fee": "0.011"
    }],
    "timestamp": 1728679774
}
```

#### Example Error Response

```json
{
    "status": "failed",
    "error": "Something went wrong for some reason even tho there cant be something wrong on this endpoint",
    "timestamp": 1728679812
}
```

#### Notes

* This API provides up-to-date information about available cryptocurrencies and their transaction requirements.
* The network fees and minimum withdrawable amounts may vary over time, so ensure you retrieve fresh data when performing transactions.