🏦Currencies API

The Currencies API allows you to retrieve a list of all available cryptocurrencies, their networks, the minimum withdrawable amount, and associated network transaction fees. This API is useful for und

Endpoint

POST https://malum.co/api/v3/account/currencies

Headers

To authenticate your request, use the following header structure:

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:

{
    "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:

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

Example Request

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

Example Success Response

{
    "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

{
    "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.