Merchant API (Private)

All private merchant API requires the use of Multichain's project API Key in the header.

API Ratelimit ✋ : 10 calls/second

Create Subwallet

POST https://api.multichain.info/app/v1/subwallet/create

Generate a new subwallet address for all network or a single network.

Query Parameters

Name	Type	Description
network	string	Specify the network type. E.g. "ETHEREUM" or "TRON" or leave empty to generate all subwallet address type available.

Headers

Name	Type	Description
multichain-api-key	string	Input your Multichain's project API key here.

200 If no network type specified, all available network type wallets will be generated see in response.

{
    "subwallets": {
        "ETHEREUM": "0x923eE1F30C9CAe2E86b2438Cc8a1910fFF28f1d8",
        "TRON": "TTyBHncVGXPRcKePpL5u8RD4YauhwdKmJP"
    }
}

400 Invalid or missing api key, or project had been disabled. Please enable project api key in user dashboard.

{
    "status": false,
    "message": "Invalid project api key or project had been disabled, please enable it in your dashboard settings."
}

Get Asset Info

GET https://api.multichain.info/app/v1/assets

Get all user-specific asset info, inclusive of latest fees.

Query Parameters

Name	Type	Description
assetUid	string	Get assetUid from Public API -> "Get All Asset Info" endpoint.

Headers

Name	Type	Description
multichain-api-key	string	Input your Multichain's project API Key here.

200 Note: "platformFeeFraction" is the percentage in fraction. E.g. 0.05 x 100 = 5% Platform Fee.

{
    "success": true,
    "assets": [
        {
            "uid": "ETHEREUM",
            "priceUsd": 2933.77,
            "name": "Ether",
            "symbol": "ETH",
            "type": "coin",
            "network": "ETHEREUM",
            "decimal": 18,
            "minimumDeposit": "0.000081899999664",
            "networkFee": "0.015",
            "platformFeeFraction": "0.005"
        },
        {
            "uid": "ETHEREUM.0xf6ff95d53e08c9660dc7820fd5a775484f77183a",
            "priceUsd": 0,
            "name": "USD Coin",
            "symbol": "USDC",
            "type": "ERC20",
            "network": "ETHEREUM",
            "contract": "0xf6ff95d53e08c9660dc7820fd5a775484f77183a",
            "decimal": 8,
            "minimumDeposit": "1",
            "networkFee": "1",
            "platformFeeFraction": "0.01"
        },
        {
            "uid": "TRON.TRQVqT62DgzqDKusJLRqwaP7CinwvYXfGQ",
            "priceUsd": 1.01,
            "name": "Tether USD",
            "symbol": "USDT",
            "type": "TRC20",
            "network": "TRON",
            "contract": "TRQVqT62DgzqDKusJLRqwaP7CinwvYXfGQ",
            "decimal": 6,
            "minimumDeposit": "0",
            "networkFee": "1",
            "platformFeeFraction": "0.01"
        }
    ]
}

400 No API key specified in header.

{
    "success": false,
    "message": "Invalid merchant endpoint or no API Key found in header."
}

Get Deposit History

GET https://api.multichain.info/app/v1/subwallet/deposit/history

Get address or all project deposit history by assetUid. Please be mindful when using this API due to its computational load.

Query Parameters

Name	Type	Description
limit	string	Default/Max: 200
page	string	View paginated data
address	string	Enter subwallet address
assetUid	String	Get uid from Public API -> "Get All Asset Info" endpoint.

Headers

Name	Type	Description
multichain-api-key	string	Input your Multichain's project API Key here.

200

{
    "success": true,
    "meta": {
        "transactionCount": 13,
        "limit": 5,
        "currPage": 1,
        "lastPage": 3,
        "nextPage": 2
    },
    "transactions": [
        {
            "isNotified": true,
            "assetUid": "ETHEREUM.0xf6ff95d53e08c9660dc7820fd5a775484f77183a",
            "status": "SUCCESS",
            "hash": "0xd54209b2d3d55410e82c9e04011d3248466f4d5232c92eb9e53b7d5033e2e1c1",
            "fromAddress": "0x418e1663462db5772e3f06cae0e67048482161ba",
            "toAddress": "0xa22f4ee8dc785344712177f5a9cffa9fc641df4b",
            "value": "100",
            "networkFee": "2",
            "platformFee": "1",
            "createdAt": 1623828485,
            "url": "https://ropsten.etherscan.io/tx/0xd54209b2d3d55410e82c9e04011d3248466f4d5232c92eb9e53b7d5033e2e1c1"
        },
        {
            "isNotified": false,
            "assetUid": "ETHEREUM.0xf6ff95d53e08c9660dc7820fd5a775484f77183a",
            "status": "SUCCESS",
            "hash": "0x8c83131cf409f7e3c80948325f46afc102b8446e07b4c503ef0c3e3bf82b53df",
            "fromAddress": "0x418e1663462db5772e3f06cae0e67048482161ba",
            "toAddress": "0xd395a040a8e021fe5a6045e0283086d00f34bcd8",
            "value": "10",
            "networkFee": "2.3",
            "platformFee": "0.1",
            "createdAt": 1622031091,
            "url": "https://ropsten.etherscan.io/tx/0x8c83131cf409f7e3c80948325f46afc102b8446e07b4c503ef0c3e3bf82b53df"
        },
        {
            "isNotified": false,
            "assetUid": "ETHEREUM.0xf6ff95d53e08c9660dc7820fd5a775484f77183a",
            "status": "SUCCESS",
            "hash": "0xea74ce566bd43f8e1977a1b1897c58e828603aaa0f01bfef7f274d3a29af0507",
            "fromAddress": "0x418e1663462db5772e3f06cae0e67048482161ba",
            "toAddress": "0x0e086c68001d2cfce18b05e01193411ff29acb78",
            "value": "0.99",
            "networkFee": "1.15",
            "platformFee": "0.0099",
            "createdAt": 1621876524,
            "url": "https://ropsten.etherscan.io/tx/0xea74ce566bd43f8e1977a1b1897c58e828603aaa0f01bfef7f274d3a29af0507"
        },
        {
            "isNotified": false,
            "assetUid": "ETHEREUM.0xf6ff95d53e08c9660dc7820fd5a775484f77183a",
            "status": "SUCCESS",
            "hash": "0x0a9f312b5dff6419f0a66c55bd568f3c2e886b7099a756ce031c47293eaa3b43",
            "fromAddress": "0x418e1663462db5772e3f06cae0e67048482161ba",
            "toAddress": "0xd395a040a8e021fe5a6045e0283086d00f34bcd8",
            "value": "5.55",
            "networkFee": "2.3",
            "platformFee": "0.0555",
            "createdAt": 1621876524,
            "url": "https://ropsten.etherscan.io/tx/0x0a9f312b5dff6419f0a66c55bd568f3c2e886b7099a756ce031c47293eaa3b43"
        },
        {
            "isNotified": false,
            "assetUid": "ETHEREUM.0xf6ff95d53e08c9660dc7820fd5a775484f77183a",
            "status": "SUCCESS",
            "hash": "0x3a691a9d7af738b9ec71b275487596620e47e7f6285d3e53c32c769af59e4aae",
            "fromAddress": "0x418e1663462db5772e3f06cae0e67048482161ba",
            "toAddress": "0x0e086c68001d2cfce18b05e01193411ff29acb78",
            "value": "1",
            "networkFee": "2.3",
            "platformFee": "0.01",
            "createdAt": 1621876524,
            "url": "https://ropsten.etherscan.io/tx/0x3a691a9d7af738b9ec71b275487596620e47e7f6285d3e53c32c769af59e4aae"
        }
    ]
}

Note: "uid" should be specified as "assetUid" query param in "Get Deposit History". Example of a assetUid (uid):

"ETHEREUM.0xf6ff95d53e08c9660dc7820fd5a775484f77183a"

⚡Get assetUid (uid) from calling this public endpoint here .