Main Wallets

You need a main wallet in a supported currency to be able to issue sub wallets and perform crypto transactions in that currency.

Create Main Wallet

To get started, simply submit the currency of the main wallet you want to create.

curl --request POST \
     --url https://api.oneliquidity.technology/wallets/v1/main \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer {{token}}' \
     --header 'Content-Type: application/json' \
     --data '{"currency":"BTC"}'

Our ok response will include the wallet ID, currency and an array of address & network objects associated with the wallet.

{
    "message": "Ok",
    "data": {
        "walletId": "0b54594e-3df3-558a-89af-556c0fd503a8",
        "addresses": [
            {
                "network": "bitcoin",
                "address": "2N3zr9ddTySbaiid6p1N8B14Be5mBdr5yGE"
            }
        ],
        "currency": "BTC"
    }
}

API Reference ➡️

Get Main Wallet

To get the main wallet of a currency, submit the request with the currency as a query parameter.

curl --request GET \
     --url 'https://api.oneliquidity.technology/wallets/v1/main?currency=btc' \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer {{token}}'

Our ok response will include details about the main wallet including the number of sub wallets associated with it and the current balance in the wallet.

{
    "message": "Ok",
    "data": {
        "walletId": "0b54594e-3df3-558a-89af-556c0fd503a8",
        "integratorPk": "b43d305c-98df-4980-8d73-f85f6c36bace",
        "currency": "BTC",
        "updatedAt": "2022-09-11T16:03:57.675Z",
        "createdAt": "2022-09-11T16:03:57.675Z",
        "addresses": [
            {
                "network": "bitcoin",
                "address": "2N3zr9ddTySbaiid6p1N8B14Be5mBdr5yGE"
            }
        ],
        "subWalletCount": 0,
        "metadata": {},
        "status": "active",
        "balances": {
            "pendingBalance": {
                "amount": 0
            },
            "postedBalance": {
                "amount": 0
            }
        }
    }
}

API Reference ➡️

Get All Main Wallets

You can also get all the main wallets you have created with us. Include optional lek & limit query parameters for pagination.

curl --request GET \
     --url https://api.oneliquidity.technology/wallets/v1/main/all \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer {{token}}'

Our ok response will include details about all your main wallets including the number of sub wallets associated with each.

{
    "message": "Ok",
    "data": [
        {
            "walletId": "0b54594e-3df3-558a-89af-556c0fd503a8",
            "integratorPk": "b43d305c-98df-4980-8d73-f85f6c36bace",
            "currency": "BTC",
            "updatedAt": "2022-09-11T16:03:57.675Z",
            "createdAt": "2022-09-11T16:03:57.675Z",
            "addresses": [
                {
                    "network": "bitcoin",
                    "address": "2N3zr9ddTySbaiid6p1N8B14Be5mBdr5yGE"
                }
            ],
            "subWalletCount": 0
        },
        {
            "walletId": "23a42cf6-7f34-5cd9-8b20-7a7edfdea36d",
            "integratorPk": "b43d305c-98df-4980-8d73-f85f6c36bace",
            "currency": "USDT",
            "updatedAt": "2022-09-04T20:47:46.920Z",
            "createdAt": "2022-08-20T22:33:04.537Z",
            "addresses": [
                {
                    "network": "bep20",
                    "address": "0x64c861A819773F51A4d0735cdfef8A0B4e1e08EA"
                }
            ],
            "subWalletCount": 7
        },
        {
            "walletId": "128159c3-dd0a-5d24-8a62-10960d5187ea",
            "integratorPk": "b43d305c-98df-4980-8d73-f85f6c36bace",
            "currency": "ETH",
            "updatedAt": "2022-09-04T20:44:02.919Z",
            "createdAt": "2022-09-04T09:59:43.862Z",
            "addresses": [
                {
                    "network": "erc20",
                    "address": "0xE6138A68A53249409E1Cc78C788c11861b9A3840"
                }
            ],
            "subWalletCount": 2
        }
    ]
}

API Reference ➡️