How to transfer assets

Transfer assets between accounts

Assets can be transferred between accounts if the accounts can be accessed by the same user or the sending account is whitelisted to deposit to the receiving account and the user has full-control or manage level access to the sending account. If the receiving account is not controlled by the same user then the receiving account must whitelist the receiving account via account transfer authorizations.

For the sake of this guide it will be assumed that the user has access to both accounts. Assets can then be as transferred using internal-asset-transfers as seen below. Based on the account-policy the transfer will settle instantly or will need to be reviewed via internal-asset-transfer-reviews. Once an internal-asset-transfer settles corresponding asset transactions will be created for both accounts.

Request

POST v2/internal-asset-transfers
{
"data" : {
"type" : "internal-asset-transfers",
"attributes" : {
"unit-count" : "5",
"asset-id" : "{{btc-asset-id}}",
"from-account-id" : "{{account-id}}",
"to-account-id" : "{{account-id-2}}",
"reference" : "For Trade Settlement"
}
}
}
**Response**
```json
{
"data": {
"type": "internal-asset-transfers",
"id": "f9fea9e8-3605-4c96-852a-9bcf57eaadf6",
"attributes": {
"created-at": "2019-12-06T19:33:11Z",
"preserve-tax-lots": true,
"reference": "For Trade Settlement",
"status": "settled",
"unit-count": 5,
"updated-at": "2019-12-06T19:33:11Z"
},
"links": {
"self": "/v2/internal-asset-transfers/f9fea9e8-3605-4c96-852a-9bcf57eaadf6"
},
"relationships": {
"asset": {
"links": {
"related": "/v2/assets/798debbc-ec84-43ea-8096-13e2ebcf4749"
}
},
"from-account": {
"links": {
"related": "/v2/accounts/2053f64b-3631-4e64-a611-0bd09e687af6"
}
},
"from-asset-transaction": {
"links": {
"related": "/v2/asset-transactions/07db00d8-e375-478d-a01b-bc0d8b834684"
}
},
"to-account": {
"links": {
"related": "/v2/accounts/df4277d8-cd12-4c5c-94c6-c25cff6cec7f"
}
},
"to-asset-transaction": {
"links": {
"related": "/v2/asset-transactions/9a9b2db3-6c75-4b8a-9bf3-ff8a33f88f57"
}
}
}
},
"included": []
}

See also

  • Assets

  • Internal-Asset-Transfers

  • Internal-Asset-Transfer-Reviews

  • Account Asset Totals

  • Asset-Transactions

  • Asset Transaction Tax Lots

Last updated on