---
title: "Performs crypto transfer"
method: POST
path: "/ledger/crypto-transfer"
tags: ["ledger-transfer"]
---

# Performs crypto transfer

`POST /ledger/crypto-transfer`

This operation allow the client to perform crypto transfer to an external wallet.

N.B. The amount field is the withdrawal amount only (fees are not included). The applicable
fee, including any platform fee, is computed server-side and is not a client-supplied input.

## Request body

- CryptoTransferRequest — Request object for crypto payment initiation request. The sourceAccountId can be a main account or sub-account.
  - `sourceAccountId` string, uuid, required — The source account ID from which funds will be debited. This can be a main account or sub-account.
  - `amount` number, required — Transaction amount, specified in the source account's currency.
  - `narration` string — Notes
  - `destination` CryptoTransferDestination, required — The destination details of the transfer. Either beneficiaryId or address must be provided.
    - `tokenNetworkCode` string, required — The token network code for the transfer
    - `beneficiaryId` string, uuid — The ID of the saved crypto beneficiary to which the transfer will be made.
    - `address` string
    - `memo` string — Optional, for networks that require memo.
  - `twoFaMethod` 'AUTHENTICATOR_APP' | 'EMAIL' | 'SMS'

## Response `201`

Request received, do 2FA

- TransferResponse — The payment initiation response
  - `id` string, required
  - `status` 'PENDING' | 'IN_PROGRESS' | 'FAILED' | 'SUCCESS', required — Status of the transaction, indicating its current state in the processing lifecycle. - PENDING: The transaction has been created but not yet processed. - IN_PROGRESS: The transaction is currently being processed. - FAILED: The transaction processing has failed. - SUCCESS: The transaction has been successfully processed.
  - `awaiting2fA` boolean, required — Indicates if transfer is awaiting 2FA confirmation. This applies mostly to transaction initiated via dashboard
  - `twoFaMethod` User2FAMethod[] — List of 2fa enabled

## Other responses

- `400` — Request could not be validated
- `401` — Client is not authorized to make request
- `403` — Expected permission is not available.
- `default` — Internal Server Error

---

[API](https://skmtc.net/nestechops/apis/onboard-external-api-gateway.md) · [All operations](https://skmtc.net/nestechops/apis/onboard-external-api-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nestechops/onboard-external-api-gateway/revisions/35fe01ca087b/schema)