# 🏦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.


---

# 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://docs.malum.co/account-api/currencies-api.md?ask=<question>
```

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.