Wallet methods
Wallet object
- id string
The identifier of a wallet.
- label string
The tag or name assigned to a wallet for easier locating it in the system.
The value length can’t exceed 32 characters.
- status number
The current status of a wallet:
1
— Not active. The wallet hasn’t been activated due to some technical or blockchain issues.2
— In progress. The wallet is now being registered in the system or requires the activation and currently unavailable.3
— Active. The wallet has been activated (if required) and can be used.
- type number
The wallet type. Possible values:
1
— Merchant2
— Enterprise
- created_at string
The date and time of wallet creation, with milliseconds precision and timezone included:
YYYY-MM-DDThh:mm:ss[.SSSSSS]±hh:mm
.- balance_confirmed string
The balance available for financial operations.
- balance_pending string
The sum of all deposit- and payout-related transactions that haven’t yet received the required number of confirmation blocks. This value is positive for incoming and negative for outgoing transactions. This balance can’t currently be used for financial operations.
- balance_unusable string
The amount of incoming transfers blocked by AML. This balance can’t currently be used for financial operations.
- minimal_transfer_amount string
For Enterprise wallets only.
The minimum amount of the incoming transfer, in the wallet currency.
Payments below the specified amount are automatically rejected. This can be useful if the transaction blockchain fee exceeds the transaction amount.
- destination object
For Enterprise wallets only.
The field contains two string fields:
address_type
— refer to Address types for supported values.address
— public wallet address, that can be used to directly top up wallet balance.
- currency object
The wallet currency.
The object contains the
id
field corresponding to the currency ISO code. Refer to Currency codes for possible values.- parent object
For wallets denominated in tokens.
The Parent wallet of a wallet denominated in tokens. For other wallets, returns
null
.The object contains the parent wallet
id
.
{
"type": "wallet",
"id": "448",
"attributes": {
"label": "My Wallet",
"status": 3,
"type": 2,
"created_at": "2020-11-06T06:03:44.301815Z",
"balance_confirmed": "0.23221548",
"balance_pending": "0.00000000",
"balance_unusable": "0.00364702",
"minimal_transfer_amount": "0.00000546",
"destination": {
"address_type": "p2sh-segwit",
"address": "2N3Ac2cZzRVoqfJGu1bFaAebq3izTgr1WLv"
}
},
"relationships": {
"currency": {
"data": {
"type": "currency",
"id": "2005"
}
},
"parent": {
"data": {
"type": "wallet",
"id": "14"
}
}
}
}
Get wallet
Request
- id string
The wallet identifier.
Filtering by any object parameters can be applied according to the JSON API Specification.
To query wallets of multiple types, follow this example:
GET [base]/wallet/?filter[type.in]=1,2
GET[base]/wallet/{id}
$ curl --request GET \
--url https://[base]/wallet/ \
--header 'authorization: Bearer eyJ0eXAiOiJKV1QiLC...' \
--header 'content-type: application/vnd.api+json'
import requests
url = 'https://[base]/wallet/'
headers = {
'authorization': 'Bearer <Change to your access token>',
'content-type': 'application/vnd.api+json',
}
requests.get(url, headers=headers)
<?php
use GuzzleHttp\Client;
use GuzzleHttp\Exception\RequestException;
$client = new GuzzleHttp\Client();
try {
$res = $client->get('https://[base]/wallet/', [
'headers' => [
'Authorization' => 'Bearer <Change to your access token>',
'Content-Type' => 'application/vnd.api+json',
],
]);
echo $res->getBody();
} catch (RequestException $e) {}
Response
In case of a successful response, a wallet object or an array of objects (if id
was not specified) is returned.
The wallets list is paginated and default page size is 10.
Response codes
200 Success.
400 Bad request. You have no permission to view the wallet with given id
.
404 The wallet with given id
was not found.