POST
/
api
/
v2.1
/
wallet-transfers
/
execute
Execute a wallet transfer
curl --request POST \
  --url https://sandbox.finhub.cloud/api/v2.1/wallet-transfers/execute \
  --header 'Content-Type: application/json' \
  --header 'X-Forwarded-For: <x-forwarded-for>' \
  --data '{
  "sourceAssetAddress": "<string>",
  "destinationAssetAddress": "<string>",
  "amount": {
    "value": "<string>",
    "scale": 1,
    "currency": "<string>",
    "isPositive": true,
    "positive": true
  },
  "transferType": "INTERNAL",
  "lineOfBusiness": "<string>",
  "customerId": "<string>",
  "metadata": {}
}'
{
  "transferId": "<string>",
  "sourceAssetId": "<string>",
  "sourceWalletId": "<string>",
  "destinationAssetId": "<string>",
  "destinationWalletId": "<string>",
  "sourceAssetAddress": "<string>",
  "destinationAssetAddress": "<string>",
  "amount": {
    "value": "<string>",
    "scale": 1,
    "currency": "<string>",
    "isPositive": true,
    "positive": true
  },
  "fees": {
    "value": "<string>",
    "scale": 1,
    "currency": "<string>",
    "isPositive": true,
    "positive": true
  },
  "reference": "<string>",
  "transferType": "INTERNAL",
  "status": "CREATED",
  "executionTime": "2022-03-10T16:15:50.000Z",
  "validationResults": [
    {
      "code": "<string>",
      "status": "<string>",
      "message": "<string>",
      "severity": "INFO"
    }
  ],
  "metadata": {}
}

Headers

X-Forwarded-For
string
required

Forwarded client IP address

User-Agent
string

Client user agent information

X-Tenant-ID
string

Tenant identifier for multi-tenant operations

Query Parameters

businessArea
string
capability
string
lineOfBusiness
string
organizationId
string
service
string

Body

application/json

Transfer request details

sourceAssetAddress
string
required
destinationAssetAddress
string
required
amount
object
required
transferType
enum<string>
required
Available options:
INTERNAL,
EXTERNAL,
CROSS_NETWORK,
CROSS_POWER_TENANT
lineOfBusiness
string
required
customerId
string
required
metadata
object

Response

Transfer executed successfully

transferId
string
sourceAssetId
string
sourceWalletId
string
destinationAssetId
string
destinationWalletId
string
sourceAssetAddress
string
destinationAssetAddress
string
amount
object
fees
object
reference
string
transferType
enum<string>
Available options:
INTERNAL,
EXTERNAL,
CROSS_NETWORK,
CROSS_POWER_TENANT
status
enum<string>
Available options:
CREATED,
PENDING,
PROCESSING,
COMPLETED,
FAILED,
CANCELLED,
REJECTED
executionTime
string<date-time>
Example:

"2022-03-10T16:15:50.000Z"

validationResults
object[]
metadata
object