Transfer Asset

Edit online

Transfers an asset from the specified wallet to a destination address.

For fungible tokens, the transfer amount must be provided in the smallest denomination of the token. For example:
  • Bitcoin must use Satoshi
  • Ethereum must use Wei
You can select the appropriate transfer option in the request body. Some blockchains may require additional steps, such as destination account creation (for example, Stellar). Refer to the specific blockchain documentation for prerequisites.Binance chain users may use ERC transfers for BEP tokens and Native transfers for BNB.
HTTP request
POST /wallets/{walletId}/transfers
Authorization requirements
Header Type Required Description
Authorization string Yes Bearer token used to authenticate the request. See Authentication flows for instructions on generating this token.
X-DFNS-USERACTION string Yes User action signature used to authorize change-inducing requests. See User Action Signing flows for instructions on generating this signature.
Path parameter
Parameter Type Required Description
walletId string Yes ID of the source wallet. Length: 1 to 64.
Request body
Native trasnfer
Field Type Required
kind enum (string) Yes
to string Yes
amount string Yes
memo string No
priority enum (string) No
createDestinationAccount boolean No
offer boolean No
expiresAt string (date-time) No
externalId string No
travelRule object No
feeSponsorId string No
Response
200: Success

Example response:

{
  "id": "xfr-20g4k-nsdpo-mg6arrifgvid4orn",
  "walletId": "wa-5pfuu-9euek-h0odgb6snva8ph3k",
  "network": "Algorand",
  "requester": {
    "userId": "us-6b58p-r53sr-rlrd3l5cj3uc4ome",
    "tokenId": "to-202a0-cdo33-o65mbt6q758lvvnt"
  },
  "requestBody": {
    "kind": "Native",
    "to": "<string>",
    "amount": "<string>",
    "memo": "<string>",
    "priority": "Slow",
    "createDestinationAccount": true,
    "offer": true,
    "expiresAt": "2023-11-07T05:31:56Z",
    "externalId": "<string>",
    "travelRule": {
      "kind": "Notabene",
      "originator": {},
      "beneficiary": {},
      "beneficiaryVASPdid": "<string>",
      "beneficiaryProof": {}
    },
    "feeSponsorId": "fs-5vqdl-gliqk-b4rfukqauov1sp7j"
  },
  "metadata": {
    "asset": {
      "symbol": "<string>",
      "decimals": 123,
      "verified": true,
      "quotes": {
        "EUR": 123,
        "USD": 123
      }
    }
  },
  "status": "Pending",
  "dateRequested": "2023-04-14T20:41:28.715Z",
  "reason": "<string>",
  "txHash": "<string>",
  "fee": "<string>",
  "datePolicyResolved": "2023-04-14T20:41:28.715Z",
  "dateBroadcasted": "2023-04-14T20:41:28.715Z",
  "dateConfirmed": "2023-04-14T20:41:28.715Z",
  "approvalId": "ap-2a9in-tt2a1-983lho480p35ejd0",
  "externalId": "<string>",
  "feeSponsorId": "fs-5vqdl-gliqk-b4rfukqauov1sp7j"
}