Transfer asset
Important:
Request headers are required. See API basics introduction for more information.
Transfer asset
Endpoint
POST /transfer
- Creates a new
Transfer
request for an asset that is owned by a given user UID (set by the X-API-KEY), to a specific wallet address. - Returns a new
Transfer
(transfer uid
) associated.
Note:
The transfer request is partly asynchronous - this will immediately return the
transfer uid
and perform the transfer of the underlying NFT on the blockchain asynchronously.To know when the transfer has been executed on the blockchain, you can subscribe to the Webhook events or poll any of the Get transfer details endpoints.
Important:
For executing a transfer, the following conditions must have been filled:
- The asset must be minted.
- The asset must be transferable (not already transferring or burned).
- The asset must be owned by the specified user.
Request body
Request body fields | Type | Description | Required/Optional |
---|---|---|---|
asset_uid | String | The UID of the asset to be transferred. | Required |
from_user_uid | String | The UID of the user who is transferring the asset. | Required |
to_address | String | The recipient's wallet address. | Required |
Request example
Sample: request body
{
"asset_uid": "764893807463",
"from_user_uid": "110985463782",
"to_address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
}
Response
Response example
Sample: 201 Transferred Response
You will receive a uid
which refers to the transfer details uid:
{
"success": true,
"data": {
"uid": "324167489835", // (transfer uid)
}
}
You can use this uid
to call and reference the other Transfer endpoints. For example GET /transfer/{uid}
with this uid
will return the transfer details.
Example
The following example creates a transfer for the asset 123123123123 from user 111111111111 to the address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045.
# API_KEY is your api key
# TOKEN is the access token generated with your api key secret
curl -i \
-X POST \
-d "{\"asset_uid\":\"123123123123\",\"from_user_uid\":\"111111111111\",\"to_address\":\"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045\"}" \
-H "Content-Type: application/json" \
-H "X-Api-Key: API_KEY" \
-H "Authorization: Bearer TOKEN" \
"https://api.getoriginal.com/v1/transfer"
Updated 9 months ago