Create crypto transfer

Creates a cryptocurrency transfer from the sender account to a receiver account. Transfers crypto assets directly between accounts on the specified blockchain.

POST /accounts/{senderAccountId}/transfers/crypto

Create crypto transfer

cURL

curl --request POST \
  --url https://api.venlyfinance.com/v1/accounts/{senderAccountId}/transfers/crypto \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "chain": "AVALANCHE",
  "asset": "<string>",
  "amount": 123,
  "idempotencyKey": "<string>",
  "receiverAccountId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "receiverExternalId": "<string>",
  "description": "<string>",
  "merchantReference": "<string>"
}
'

400

{
  "success": false,
  "errors": [
    {
      "code": "VALIDATION_ERROR",
      "message": "The request contains invalid parameters."
    }
  ]
}

Authorizations

Authorization · string · header · required

OAuth2 client credentials flow. Token endpoints:

• Staging: https://login-staging.venly.io/auth/realms/VenlyFinance/protocol/openid-connect/token
• Production: https://login.venly.io/auth/realms/VenlyFinance/protocol/openid-connect/token

Path Parameters

senderAccountId · string<uuid> · required

The account ID initiating the transfer

Body

application/json

chain · enum<string> · required

Available options: AVALANCHE, BASE

asset · string · required

Cryptocurrency asset identifier (e.g. USDC, ETH)

Minimum string length: 1

amount · number · required

Transfer amount

idempotencyKey · string · required

Unique key to prevent duplicate operations on retry

Minimum string length: 1

receiverAccountId · string<uuid>

ID of the receiving account

receiverExternalId · string

External ID of the receiving account (alternative to receiverAccountId)

description · string

Optional transfer description

merchantReference · string

Optional merchant reference

Response

201

application/json

Crypto transfer created