Skip to main content
POST
/
wallets
/
{walletId}
/
transfers
curl --request POST \
  --url https://api.dfns.io/wallets/{walletId}/transfers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-DFNS-USERACTION: <api-key>' \
  --data '{
  "kind": "Native",
  "to": "0xe5a2ebc128e262ab1e3bd02bffbe16911adfbffb",
  "amount": "1"
}'
{
  "id": "<string>",
  "walletId": "<string>",
  "network": "Algorand",
  "requester": {
    "userId": "<string>",
    "tokenId": "<string>"
  },
  "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",
      "beneficiaryVASPdid": "<string>",
      "beneficiaryProof": {},
      "originator": {},
      "beneficiary": {}
    },
    "feeSponsorId": "<string>"
  },
  "metadata": {
    "asset": {
      "symbol": "<string>",
      "decimals": 123,
      "verified": true,
      "quotes": {
        "EUR": 123,
        "USD": 123
      }
    }
  },
  "status": "Pending",
  "reason": "<string>",
  "txHash": "<string>",
  "fee": "<string>",
  "dateRequested": "<string>",
  "datePolicyResolved": "<string>",
  "dateBroadcasted": "<string>",
  "dateConfirmed": "<string>",
  "approvalId": "<string>",
  "externalId": "<string>",
  "feeSponsorId": "<string>"
}

​
Authentication

✅ Organization User (CustomerEmployee)
✅ Delegated User (EndUser)
✅ Service Account

​
Required Permissions

Wallets:Transfers:Create: Always required
FeeSponsors:Use: Required if feeSponsorId is specified.

Authorizations

​
Authorization
string
header
required
​
X-DFNS-USERACTION
string
header
required

Path Parameters

​
walletId
string
required
Minimum length: 1

Body

application/json
  • Native Asset
  • Algorand Standard Asset
  • Aptos Fungible Asset (AIP-21)
  • Cardano Asset
  • Canton Standard Token (CIP-56)
  • Sui Coin
  • EVM Fungible Token (ERC-20)
  • EVM Non Fungible Token (ERC-721)
  • Hedera Non-Fungible Token (HIP-17)
  • Hedera Tokens (HTS)
  • Stellar Classic Assets (SEP-41)
  • Starknet EVM Fungible Token (ERC-20)
  • Starknet Non Fungible Token (ERC-721-like)
  • Solana Program Library Token (SPL and SPL 2022)
  • TON Jetton (TEP-74)
  • TRON Native Fungible Token (TRC-10)
  • TRON Smart Contract Fungible Token (TRC-20)
  • TRON Non Fungible Token (TRC-721)
​
kind
enum<string>
required
Available options:
Native
​
to
string
required
​
amount
string
required
​
memo
string
​
priority
enum<string>
Available options:
Slow,
Standard,
Fast
​
createDestinationAccount
boolean
​
offer
boolean
​
expiresAt
string<date-time>
​
externalId
string
Required string length: 1 - 50
​
travelRule
object
​
feeSponsorId
string
Required string length: 1 - 50

Response

200 - application/json
​
id
string
required
​
walletId
string
required
​
network
enum<string>
required
Available options:
Algorand,
AlgorandTestnet,
Aptos,
AptosTestnet,
ArbitrumOne,
ArbitrumSepolia,
AvalancheC,
AvalancheCFuji,
BabylonGenesis,
BabylonTestnet5,
Base,
BaseSepolia,
Berachain,
BerachainBepolia,
Bitcoin,
BitcoinSignet,
BitcoinTestnet3,
BitcoinCash,
Bob,
BobSepolia,
Bsc,
BscTestnet,
Canton,
CantonTestnet,
Cardano,
CardanoPreprod,
Celo,
CeloAlfajores,
Codex,
CodexSepolia,
CosmosHub4,
CosmosIcsTestnet,
Dogecoin,
Ethereum,
EthereumGoerli,
EthereumSepolia,
EthereumHolesky,
EthereumHoodi,
FantomOpera,
FantomTestnet,
FlareC,
FlareCCoston2,
FlowEvm,
FlowEvmTestnet,
Hedera,
HederaTestnet,
Ink,
InkSepolia,
InternetComputer,
Ion,
IonTestnet,
Iota,
IotaTestnet,
Kaspa,
Kusama,
KusamaAssetHub,
Litecoin,
Near,
NearTestnet,
Optimism,
OptimismSepolia,
Origyn,
Plasma,
PlasmaTestnet,
Plume,
PlumeSepolia,
Paseo,
PaseoAssetHub,
Polkadot,
PolkadotAssetHub,
Polygon,
PolygonAmoy,
Polymesh,
PolymeshTestnet,
Race,
RaceSepolia,
SeiAtlantic2,
SeiPacific1,
Solana,
SolanaDevnet,
Starknet,
StarknetSepolia,
Stellar,
StellarTestnet,
Sui,
SuiTestnet,
Tsc,
TscTestnet1,
Tezos,
TezosGhostnet,
Ton,
TonTestnet,
Tron,
TronNile,
Westend,
WestendAssetHub,
XrpLedger,
XrpLedgerTestnet
​
requester
object
required
​
requestBody
object
required
  • Native Asset
  • Algorand Standard Asset
  • Aptos Fungible Asset (AIP-21)
  • Cardano Asset
  • Canton Standard Token (CIP-56)
  • Sui Coin
  • EVM Fungible Token (ERC-20)
  • EVM Non Fungible Token (ERC-721)
  • Hedera Non-Fungible Token (HIP-17)
  • Hedera Tokens (HTS)
  • Stellar Classic Assets (SEP-41)
  • Starknet EVM Fungible Token (ERC-20)
  • Starknet Non Fungible Token (ERC-721-like)
  • Solana Program Library Token (SPL and SPL 2022)
  • TON Jetton (TEP-74)
  • TRON Native Fungible Token (TRC-10)
  • TRON Smart Contract Fungible Token (TRC-20)
  • TRON Non Fungible Token (TRC-721)
​
metadata
object
required
​
status
enum<string>
required
Available options:
Pending,
Executing,
Broadcasted,
Confirmed,
Failed,
Rejected
​
dateRequested
string
required
​
reason
string
​
txHash
string
​
fee
string
​
datePolicyResolved
string
​
dateBroadcasted
string
​
dateConfirmed
string
​
approvalId
string
​
externalId
string
​
feeSponsorId
string