Wallet Changelogs
| version | time | content |
|---|---|---|
| V1.0.0 | 2022-02-14 |
init version |
Introduction
Welcome to bit.com API. You can retrieve market data, execute trades and manage your bit.com account through bit.com API.
API rate limits
The public interface implements IP-specified frequency limitation , and the private interface implements user-specified frequency limitation. When a breach happens, a prompt will be returned: “429 too many requests”. About the type of API rate limits, please refer to API summary.Users who need to increase the speed limit please contact the support team via [email protected]
- Rest API rate limits:
Private API(wallet)): 1 requests per second per user.
Private API(transfer): 1 requests second per user.
API summary
- User defined string fields(label etc): valid characters are [A-Z], [a-z], [0-9], "-", "_"
| Path | Method | Description | Scope | Rate Limit Type | Permission |
|---|---|---|---|---|---|
| /v1/wallet/transfer | POST | transfer | private | transfer | transfer |
| /v1/wallet/transfer | GET | query transfer records | private | transfer | read |
| /v1/wallet/spot-withdraw | POST | New withdrawal request | private | wallet | wallet |
| /v1/wallet/withdraw | POST | New withdrawal request | private | wallet | wallet |
| /v1/wallet/um-withdraw | POST | withdrawl from um-account | private | wallet | wallet |
| /v1/wallet/spot-withdrawals | GET | Get withdrawal history | private | wallet | read |
| /v1/wallet/withdraw | GET | GET withdrawal status | private | wallet | read |
| /v1/wallet/withdrawals | GET | GET withdrawal history | private | wallet | read |
| /v1/wallet/um-withdrawals | GET | query um-account withdrawl records | private | wallet | read |
| /v1/wallet/spot-deposits | GET | Get deposit records | private | wallet | read |
| /v1/wallet/deposits | GET | GET deposit records | private | wallet | read |
| /v1/wallet/um-deposits | GET | query um-account deposit records | private | wallet | read |
| /v1/wallet/sub-user-transfer | POST | transfer between parent and sub accounts | private | transfer | transfer |
| /v1/wallet/sub-user-transfer | GET | query sub account transfer records | private | transfer | read |
Wallet
Bit.com has 3 types of accounts: spot accounts, contract accounts, and unified margin accounts.
- In the classic mode, trade with spot and contract accounts.
In the um mode, trade with a unified margin account. - In the UM mode, deposit to spot/contract account, the system will automatically transfer to the um-account.
In the classic model, the user calls the POST /v1/wallet/um-withdraw to withdraw, it will return an error message.
Also in the UM mode, the user calls the POST /v1/wallet/withdraw or POST /v1/wallet/spot-withdraw,it will return an error too. - The transfer between the three accounts of bit.com and the balance account of the matrixport.com, regardless of the account type (classic and UM mode), call the transfer endpoint POST /v1/wallet/transfer.
- POST /v1/wallet/sub-user-transfer should be called to transfer between parent and sub-account.
Transfer can be only called with the parent user. Sub users can’t call transfer and withdrawal.
Withdraw from spot account
POST /v1/wallet/spot-withdraw
curl -X POST "https://betaapi.bitexch.dev/v1/wallet/spot-withdraw" -H "Content-Type: application/json" -H "X-Bit-Access-Key: Your Access Key" -d '{"currency": "BTC", "address": "Your address", "amount": "1.2", "pwd": "Your password", "timestamp": 1589523989378, "signature": "signature"}'
Response
{
"code": 0,
"message": "",
"data": {
"withdraw_id": "b61c2b93-8a25-44d4-9715-023cce61dc50"
}
}
This endpoint means withdraw cash from spot account.
Withdraw address need to be whitelisted first here: https://www.bit.com/propertyCenter/withdraw
Password need to be encoded to base64(sha256(pwd)). For example, if password is 123456, the encoded password will be:jZae727K08KaOmKSgOaGzww/XVqGr/PKEgIMkjrcbJI=
Query Parameter
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| currency | string | true | "" | Currency, BTC |
| address | string | true | "" | Withdrawal address |
| amount | string | true | "" | Withdrawal amount |
| pwd | string | true | "" | Fund password |
| chain | string | false | "" | ETH for USDTERC, TRX for USDTTRC |
Response
| Name | Type | Description |
|---|---|---|
| withdraw_id | string | Withdraw ID, can be used in later inquires |
spot account Withdrawal history
GET /v1/wallet/spot-withdrawals
curl -H "X-Bit-Access-Key: Your Access Key" "https://betaapi.bitexch.dev/v1/wallet/spot-withdrawals?currency=BTC&limit=10&offset=0×tamp=1589522687689&signature=signature"
Response
{
"code": 0,
"data": {
"items": [{
"address": "mfaFpdVCb6UFS5AXUhC8VGXgj9dnJ37nLP",
"amount": "0.001",
"code": 0,
"confirmations": 0,
"currency": "BTC",
"fee": "0.00001",
"state": "confirmed",
"transaction_id": "52e1537002f51acbf5f52b9dfeab6a9e7cc185a669cda2573e768420b0839523",
"created_at": 1608606000000,
"updated_at": 1608606000000,
"is_onchain": true
}, {
"address": "mfaFpdVCb6UFS5AXUhC8VGXgj9dnJ37nLP",
"amount": "0.11",
"code": 13100100,
"confirmations": 0,
"currency": "BTC",
"fee": "0.00001",
"state": "rejected",
"transaction_id": "",
"created_at": 1608606000000,
"updated_at": 1608606000000,
"is_onchain": false
}]
}
}
Retrieves the withdrawal records of spot account.
Query parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| currency | String | true | "" | Currency |
| limit | int | false | 10 | Number of requested items, Max - 50 |
| offset | int | false | 1 | the offset for pagination |
| withdraw_id | string | false | "" | withdraw order id |
Response
| Name | Type | Description |
|---|---|---|
| code | int | Withdraw ID error code, 0 means normal, rest means failed |
| state | string | withdrawal state |
| address | string | Withdraw address |
| amount | string | Withdraw amount |
| confirmations | int | Confirmation counts, 0 for internal transfers since they are offchain |
| currency | string | Currency |
| fee | string | Withdraw fee |
| transaction_id | string | Transaction hash |
| created_at | int | Timestamp of the order created |
| updated_at | int | Timestamp of the order updated |
| is_onchain | bool | Whether the order is onchain |
spot account deposits history
GET /v1/wallet/spot-deposits
curl -H "X-Bit-Access-Key: Your Access Key" "https://betaapi.bitexch.dev/v1/wallet/spot-deposits?currency=BTC&limit=10&offset=0×tamp=1589522687689&signature=signature"
Response
{
"code": 0,
"data": {
"items": [{
"address": "mfaFpdVCb6UFS5AXUhC8VGXgj9dnJ37nLP",
"amount": "0.001",
"code": 0,
"confirmations": 0,
"currency": "BTC",
"state": "confirmed",
"transaction_id": "52e1537002f51acbf5f52b9dfeab6a9e7cc185a669cda2573e768420b0839523",
"created_at": 1608606000000,
"updated_at": 1608606000000,
"is_onchain": true
}]
}
}
Retrieves the deposit records of spot account.
Query parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| currency | String | true | "" | Currency |
| limit | int | false | 10 | Number of requested items, Max - 50 |
| offset | int | false | 1 | the offset for pagination |
Response
| Name | Type | Description |
|---|---|---|
| code | int | Deposit error code, 0 means normal, rest means failed |
| state | string | deposit state |
| address | string | Deposit address |
| amount | string | Deposit amount |
| confirmations | int | Confirmation counts, 0 for internal transfers since they are offchain |
| currency | string | Currency |
| transaction_id | string | Transaction hash |
| created_at | int | Timestamp of the order created |
| updated_at | int | Timestamp of the order updated |
| is_onchain | bool | Whether the order is onchain |
Withdraw from futures&options account
POST /v1/wallet/withdraw
curl -X POST "https://betaapi.bitexch.dev/v1/wallet/withdraw" -H "Content-Type: application/json" -H "X-Bit-Access-Key: Your Access Key" -d '{"currency": "BTC", "address": "Your address", "amount": "1.2", "pwd": "Your password", "timestamp": 1589523989378, "signature": "signature"}'
Response
{
"code": 0,
"message": "",
"data": {
"withdraw_id": "b61c2b93-8a25-44d4-9715-023cce61dc50"
}
}
This endpoint means withdraw cash from derivative account. Withdraw address need to be whitelisted first here: https://www.bit.com/propertyCenter/withdraw Password need to be encoded to base64(sha256(pwd)). For example, if password is 123456, the encoded password will be:jZae727K08KaOmKSgOaGzww/XVqGr/PKEgIMkjrcbJI=
Post json body
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| currency | string | true | "" | Currency, BTC |
| address | string | true | "" | Withdrawal address |
| amount | string | true | "" | Withdrawal amount |
| pwd | string | true | "" | Fund password |
Response
| Name | Type | Description |
|---|---|---|
| withdraw_id | string | Withdraw ID, can be used in later inquries |
Inquire withdraw update
GET /v1/wallet/withdraw
curl -H "X-Bit-Access-Key: Your Access Key" "https://betaapi.bitexch.dev/v1/wallet/withdraw?withdraw_id=b61c2b93-8a25-44d4-9715-023cce61dc50×tamp=1589522687689&signature=signature"
Response
{
"code": 0,
"data": {
"address": "mfaFpdVCb6UFS5AXUhC8VGXgj9dnJ37nLP",
"amount": "0.001",
"code": 0,
"confirmations": 0,
"currency": "BTC",
"fee": "0.00001",
"state": "unconfirmed",
"transaction_id": "52e1537002f51acbf5f52b9dfeab6a9e7cc185a669cda2573e768420b0839523",
"created_at": 1608606000000,
"updated_at": 1608606000000,
"is_onchain": true
},
"message": ""
}
Inquire withdraw state based on withdraw ID
Query parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| withdraw_id | String | true | "" | Withdraw ID |
Response
| Name | Type | Description |
|---|---|---|
| code | int | Withdraw ID error code, 0 means normal, rest means failed |
| state | string | withdrawal state |
| address | string | Withdraw address |
| amount | string | Withdraw amount |
| confirmations | int | Confirmation counts, 0 for internal transafers since they are offchain |
| currency | string | Currency |
| fee | string | Withdraw fee |
| transaction_id | string | Transaction hash |
| created_at | int | Timestamp of the order created |
| updated_at | int | Timestamp of the order updated |
| is_onchain | bool | Whether the order is onchain |
futures&options withdrawal history
GET /v1/wallet/withdrawals
curl -H "X-Bit-Access-Key: Your Access Key" "https://betaapi.bitexch.dev/v1/wallet/withdrawals?currency=BTC&count=10&offset=0×tamp=1589522687689&signature=signature"
Response
{
"code": 0,
"data": {
"count": 2,
"items": [{
"address": "mfaFpdVCb6UFS5AXUhC8VGXgj9dnJ37nLP",
"amount": "0.001",
"code": 0,
"confirmations": 0,
"currency": "BTC",
"fee": "0.00001",
"state": "confirmed",
"transaction_id": "52e1537002f51acbf5f52b9dfeab6a9e7cc185a669cda2573e768420b0839523",
"created_at": 1608606000000,
"updated_at": 1608606000000,
"is_onchain": true
}, {
"address": "mfaFpdVCb6UFS5AXUhC8VGXgj9dnJ37nLP",
"amount": "0.11",
"code": 13100100,
"confirmations": 0,
"currency": "BTC",
"fee": "0.00001",
"state": "rejected",
"transaction_id": "",
"created_at": 1608606000000,
"updated_at": 1608606000000,
"is_onchain": false
}]
}
}
Retrieves the withdrawal records of COIN-M futures&options account.
Query parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| currency | String | true | "" | Currency |
| count | int | false | 10 | Number of requested items, Max - 50 |
| offset | int | false | 0 | the offset for pagination |
Response
| Name | Type | Description |
|---|---|---|
| code | int | Withdraw ID error code, 0 means normal, rest means failed |
| state | string | withdrawal state |
| address | string | Withdraw address |
| amount | string | Withdraw amount |
| confirmations | int | Confirmation counts, 0 for internal transafers since they are offchain |
| currency | string | Currency |
| fee | string | Withdraw fee |
| transaction_id | string | Transaction hash |
| created_at | int | Timestamp of the order created |
| updated_at | int | Timestamp of the order updated |
| is_onchain | bool | Whether the order is onchain |
futures&options account deposits history
GET /v1/wallet/deposits
curl -H "X-Bit-Access-Key: Your Access Key" "https://betaapi.bitexch.dev/v1/wallet/deposits?currency=BTC&count=10&offset=0×tamp=1589522687689&signature=signature"
Response
{
"code": 0,
"data": {
"count": 1,
"items": [{
"address": "mfaFpdVCb6UFS5AXUhC8VGXgj9dnJ37nLP",
"amount": "0.001",
"code": 0,
"confirmations": 0,
"currency": "BTC",
"state": "confirmed",
"transaction_id": "52e1537002f51acbf5f52b9dfeab6a9e7cc185a669cda2573e768420b0839523",
"created_at": 1608606000000,
"updated_at": 1608606000000,
"is_onchain": true
}]
}
}
Retrieves the deposit records of futures&options account.
Query parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| currency | String | true | "" | Currency |
| count | int | false | 10 | Number of requested items, Max - 50 |
| offset | int | false | 0 | the offset for pagination |
Response
| Name | Type | Description |
|---|---|---|
| code | int | Deposit error code, 0 means normal, rest means failed |
| state | string | deposit state |
| address | string | Deposit address |
| amount | string | Deposit amount |
| confirmations | int | Confirmation counts, 0 for internal transafers since they are offchain |
| currency | string | Currency |
| transaction_id | string | Transaction hash |
| created_at | int | Timestamp of the order created |
| updated_at | int | Timestamp of the order updated |
| is_onchain | bool | Whether the order is onchain |
Withdraw from UM account
POST /v1/wallet/um-withdraw
curl -X POST "https://betaapi.bitexch.dev/v1/wallet/um-withdraw" -H "Content-Type: application/json" -H "X-Bit-Access-Key: Your Access Key" -d '{"currency": "BTC", "address": "Your address", "amount": "1.2", "pwd": "Your password", "timestamp": 1589523989378, "signature": "signature"}'
Response
{
"code": 0,
"message": "",
"data": {
"withdraw_id": "b61c2b93-8a25-44d4-9715-023cce61dc50"
}
}
This endpoint means withdraw cash from unified margin account.
Withdraw address need to be whitelisted first here: https://www.bit.com/propertyCenter/withdraw
Password need to be encoded to base64(sha256(pwd)). For example, if password is 123456, the encoded password will be:jZae727K08KaOmKSgOaGzww/XVqGr/PKEgIMkjrcbJI=
Query parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| currency | string | true | "" | Currency, BTC |
| address | string | true | "" | Withdrawal address |
| amount | string | true | "" | Withdrawal amount |
| pwd | string | true | "" | Fund password |
| chain | string | false | "" | ETH for USDTERC, TRX for USDTTRC |
Response
| Name | Type | Description |
|---|---|---|
| withdraw_id | string | Withdraw ID, can be used in later inquires |
UM account withdrawal history
GET /v1/wallet/um-withdrawals
curl -H "X-Bit-Access-Key: Your Access Key" "https://betaapi.bitexch.dev/v1/wallet/um-withdrawals?currency=BTC&limit=10&offset=0×tamp=1589522687689&signature=signature"
Response
{
"code": 0,
"data": {
"count": 2,
"items": [{
"address": "mfaFpdVCb6UFS5AXUhC8VGXgj9dnJ37nLP",
"amount": "0.001",
"code": 0,
"confirmations": 0,
"currency": "BTC",
"fee": "0.00001",
"state": "confirmed",
"transaction_id": "52e1537002f51acbf5f52b9dfeab6a9e7cc185a669cda2573e768420b0839523",
"created_at": 1608606000000,
"updated_at": 1608606000000,
"is_onchain": true
}, {
"address": "mfaFpdVCb6UFS5AXUhC8VGXgj9dnJ37nLP",
"amount": "0.11",
"code": 13100100,
"confirmations": 0,
"currency": "BTC",
"fee": "0.00001",
"state": "rejected",
"transaction_id": "",
"created_at": 1608606000000,
"updated_at": 1608606000000,
"is_onchain": false
}]
}
}
Retrieves the withdrawal records of UM account.
Query parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| currency | String | true | "" | Currency |
| limit | int | false | 10 | Number of requested items, Max - 50 |
| offset | int | false | 0 | the offset for pagination |
| withdraw_id | string | false | "" | withdraw order id |
Response
| Name | Type | Description |
|---|---|---|
| code | int | Withdraw ID error code, 0 means normal, rest means failed |
| state | string | withdrawal state |
| address | string | Withdraw address |
| amount | string | Withdraw amount |
| confirmations | int | Confirmation counts, 0 for internal transfers since they are offchain |
| currency | string | Currency |
| fee | string | Withdraw fee |
| transaction_id | string | Transaction hash |
| created_at | int | Timestamp of the order created |
| updated_at | int | Timestamp of the order updated |
| is_onchain | bool | Whether the order is onchain |
UM account deposits history
GET /v1/wallet/um-deposits
curl -H "X-Bit-Access-Key: Your Access Key" "https://betaapi.bitexch.dev/v1/wallet/um-deposits?currency=BTC&limit=10&offset=0×tamp=1589522687689&signature=signature"
Response
{
"code": 0,
"data": {
"count": 1,
"items": [{
"address": "mfaFpdVCb6UFS5AXUhC8VGXgj9dnJ37nLP",
"amount": "0.001",
"code": 0,
"confirmations": 0,
"currency": "BTC",
"state": "confirmed",
"transaction_id": "52e1537002f51acbf5f52b9dfeab6a9e7cc185a669cda2573e768420b0839523",
"created_at": 1608606000000,
"updated_at": 1608606000000,
"is_onchain": true
}]
}
}
Retrieves the deposit records of UM account.
Query parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| currency | String | true | "" | Currency |
| limit | int | false | 10 | Number of requested items, Max - 50 |
| offset | int | false | 0 | the offset for pagination |
Response
| Name | Type | Description |
|---|---|---|
| code | int | Deposit error code, 0 means normal, rest means failed |
| state | string | deposit state |
| address | string | Deposit address |
| amount | string | Deposit amount |
| confirmations | int | Confirmation counts, 0 for internal transfers since they are offchain |
| currency | string | Currency |
| transaction_id | string | Transaction hash |
| created_at | int | Timestamp of the order created |
| updated_at | int | Timestamp of the order updated |
| is_onchain | bool | Whether the order is onchain |
Transfer
POST /v1/wallet/transfer
curl -X POST "https://betaapi.bitexch.dev/v1/wallet/transfer" -H "Content-Type: application/json" -H "X-Bit-Access-Key: Your Access Key" -d '{"currency": "BTC", "amount": "1.2", "type": 1, "timestamp": 1589523989378, "signature": "signature"}'
Response
{
"code": 0,
"message": ""
}
Bit.com has three types of accounts: spot account, contract account and unified margin account. Bit.com supports transfer between Bit.com accounts and Matrixport cash account.
Classic mode: support 1. Spot to Contract 2. Contract to spot 3. Spot to Matrixport account 4. Matrixport account to spot 5. Contract to Matrixport account 6. Matrixport account to Contract
Unified margin mode: support 7. UM account to Matrixport account 8. Matrixport account to UM account.
When the mode does not match the transfer type, an error will be returned.
Query Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| currency | string | true | Currency, e.g. BTC | |
| amount | string | true | Transfer amount | |
| type | int | true | Transfer type, 1: spot-to-Contract, 2: Contract-to-spot, 3: spot-to-Matrixport, 4: Matrixport-to-spot, 5: contract-to-Matrixport, 6: Matrixport-to-contract, 7: um-to-Matrixport, 8: Matrixport-to-um |
Transfer history
GET /v1/wallet/transfer
curl -H "X-Bit-Access-Key: Your Access Key" "https://betaapi.bitexch.dev/v1/wallet/transfer?currency=BTC&count=10&offset=0×tamp=1589522687689&signature=signature"
Response
{
"code": 0,
"data": {
"count": 2,
"items": [{
"status": "done",
"currency": "BTC",
"amount": "1.2",
"type": 1,
"created_at": 1608606000000,
"id": "123"
}, {
"status": "done",
"currency": "ETH",
"amount": "1.2",
"type": 2,
"created_at": 1608606000000,
"id": "124"
}]
}
}
Query parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| currency | string | false | ||
| limit | int | false | 10 | Number of requested items, Max - 50 |
| offset | int | false | 1 | the offset for pagination |
Response
| Name | Type | Description |
|---|---|---|
| status | string | Transfer status, failed/done/dealing |
| type | int | 1: spot-to-contract, 2: contract-to-spot, 3: spot-to-Matrixport, 4: Matrixport-to-spot, 5: contract-to-Matrixport, 6: Matrixport-to-contract, 7: um-to-Matrixport, 8: Matrixport-to-um |
| currency | string | |
| amount | string | |
| created_at | int | Timestamp of the order created |
| order_id | string | transfer id |
Get deposit address
GET /v1/wallet/um-deposit-address
curl -H "X-Bit-Access-Key: Your Access Key" "https://betaapi.bitexch.dev/v1/wallet/um-deposit-address?currency=BTC&chain=BTC×tamp=1589522687689&signature=signature"
Response
{
"code": 0,
"data": {
"address": "mfaFpdVCb6UFS5AXUhC8VGXgj9dnJ37nLP",
"tag": ""
}
}
Get um deposit address
Query parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| currency | string | true | ||
| chain | string | true |
Response
| Name | Type | Description |
|---|---|---|
| address | string | address |
| tag | string |
Currency info
GET /v1/wallet/currencies
curl -H "X-Bit-Access-Key: Your Access Key" "https://betaapi.bitexch.dev/v1/wallet/currencies?timestamp=1589522687689&signature=signature"
Response
{
"code": 0,
"data": {
"currencies": [{
"currency": "BTC",
"chains": ["BTC","BSC"]
}]
}
}
Get the available tokens that bit.com supports.
Query parameters
None
Response
| Name | Type | Description |
|---|---|---|
| currency | string | currency |
| chains | []string |
Sub Account
Sub-user Transfer (only for parent user)
POST /v1/wallet/sub-user-transfer
curl -X POST "https://betaapi.bitexch.dev/v1/wallet/sub-user-transfer" -H "Content-Type: application/json" -H "X-Bit-Access-Key: Your Access Key" -d '{"currency": "BTC", "amount": "1.2", "type": 1, "from_user": "123", "to_user": "124", "timestamp": 1589523989378, "signature": "signature"}'
Response
{
"code": 0,
"message": ""
}
Query parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| from | int | true | Transfer out user id, parent user id or sub user id | |
| to | int | true | Transfer in user id, parent user id or sub user id | |
| type | int | true | Transfer account type, 1:spot-to-spot 2:contract-to-contract, 3: spot-to-contract, 4: contract-to-spot, 5: um-to-um, 6: um-to-contract, 7: contract-to-um, 8: um-to-spot, 9: spot-to-um | |
| currency | string | true | ||
| amount | string | true |
Note
* This endpoint only supports transfer between parent and sub-accounts. Users must fill the sub-account user id and at least one of the ‘from’ and ‘to’ fields.
If ‘from’ is empty, the transfer will be made from the parent account to the sub-account by default.
If ‘to’ is empty, the transfer will be made from the sub-account to the parent account by default.
- bit.com supports independent migration. As a consequence, the parent account and sub-accounts may adopt different modes.
For example, if the parent account is under um mode and the sub-account is under the classic model, the from the account is the parent and the ‘to’ account is a sub, the transfer type will support 6. um account to contract 8. um, account to spot. If the transfer type does not match the account mode, the transfer will fail.
Sub user transfer history (only for parent user)
GET /v1/wallet/sub-user-transfer
curl -H "X-Bit-Access-Key: Your Access Key" "https://betaapi.bitexch.dev/v1/wallet/sub-user-transfer?currency=BTC&count=10&offset=0×tamp=1589522687689&signature=signature"
Response
{
"code": 0,
"data": {
"count": 2,
"items": [{
"status": "done",
"currency": "BTC",
"amount": "1.2",
"type": 1,
"created_at": 1608606000000,
"id": "123"
}, {
"status": "done",
"currency": "ETH",
"amount": "1.2",
"type": 2,
"created_at": 1608606000000,
"id": "124"
}]
}
}
Query parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| currency | string | false | ||
| limit | int | false | 10 | Number of requested items, Max - 50 |
| page | int | false | 1 | the offset for pagination |
| sub_user_id | int | true |
Response
| Name | Type | Description |
|---|---|---|
| type | int | 1:spot-to-spot 2:contract-to-contract, 3: spot-to-contract, 4: contract-to-spot, 5: um-to-um, 6: um-to-contract, 7: contract-to-um, 8: um-to-spot, 9: spot-to-um |
| currency | string | |
| amount | string | |
| created_at | int | Timestamp of the order created |
| order_id | string | transfer id |
| from | int | |
| to | int |