Transactions

Create Transfer

Changed on Oct 25, 2026

Create basic transfer transaction.

post/api/v1/transactions/transfer

Request

Base URL: https://api.fordefi.com
URL: https://api.fordefi.com/api/v1/transactions/transfer
Auth: HTTP bearer

Headers

x-signaturestring

Signature of the body. Base64 encoded string. If the request is made programatically by an API user, signing of the request is required and is intended to protect you from malicious backends. x_signature is valid for 120 seconds.

Example:SGVsbG8=

x-timestampinteger

Timestamp of the signature. Integer. Specify an Epoch date. If the request is made programatically by an API user, the timestamp of the request is required and is intended to protect you from replay attacks.

x-idempotence-idstring uuid

Optional idempotence ID of a transaction.

Request body

vault_idstring uuid required

The ID of the vault to transfer from.

memostring

The memo of the transaction. Supported on chains: Canton, Cosmos, Ripple, Solana, Stacks, Stellar, Utxo, Tron, Ton. On Solana it must be non-empty and at most 256 bytes of UTF-8.

fee_priority'low' | 'medium' | 'high'

notestring

An optional transaction note.

considered_as_stuck_after_secondsinteger

The number of seconds after signing or pushing the transaction before it is eligible to be considered stuck. If omitted, the chain default is used.

Example request

{
  "amount": {
    "value": "1000000000000000000"
  },
  "asset_identifier": {
    "details": {
      "token": {
        "base58_repr": "4fYNw3dojWmQ4dXtSGE9epjRGy9pFSx62YypT7avPYvA"
      }
    }
  }
}

Response

Successful Response

Changes

Oct 25, 20266072439d9e20 Revision changes
- breaking
  added to the / response property oneOf list for the response status
- warning
  added the new canton_withdraw_of enum value to the /// response property for the response status
- warning
  added the new canton_withdraw_of enum value to the /// response property for the response status
- warning
  added the new canton_withdraw_of enum value to the /// response property for the response status
- warning
  added the new canton_withdraw_of enum value to the /// response property for the response status
- warning
  added the new canton_withdraw_of enum value to the /// response property for the response status
- warning
  added the new canton_withdraw_of enum value to the /// response property for the response status
- warning
  added the new canton_withdraw_of enum value to the /// response property for the response status
- warning
  added the new canton_withdraw_of enum value to the /// response property for the response status
- warning
  added the new canton_withdraw_of enum value to the /// response property for the response status
- warning
  added the new canton_withdraw_of enum value to the /// response property for the response status
- warning
  added the new canton_withdraw_of enum value to the /// response property for the response status
- warning
  added the new canton_withdraw_of enum value to the /// response property for the response status
- warning
  added the new canton_withdraw_of enum value to the /// response property for the response status
- warning
  added the new canton_withdraw_of enum value to the /// response property for the response status
- warning
  added the new canton_withdraw_of enum value to the /// response property for the response status
- warning
  added the new canton_withdraw_of enum value to the /// response property for the response status
- warning
  added the new canton_withdraw_of enum value to the /// response property for the response status
- warning
  added the new canton_withdraw_of enum value to the /// response property for the response status
- warning
  added the new canton_withdraw_of enum value to the /// response property for the response status
- warning
  added the new canton_withdraw_of enum value to the /// response property for the response status
- warning
  added the new canton_withdraw_of enum value to the /// response property for the response status
- warning
  added the new canton_withdraw_of enum value to the /// response property for the response status
- warning
  added the new canton_withdraw_of enum value to the /// response property for the response status
- warning
  added the new canton_withdraw_of enum value to the /// response property for the response status
- warning
  added the new canton_withdraw_of enum value to the /// response property for the response status
- warning
  added the new canton_withdraw_of enum value to the /// response property for the response status
- warning
  added the new canton_withdrawn_by enum value to the /// response property for the response status
- warning
  added the new canton_withdrawn_by enum value to the /// response property for the response status
- warning
  added the new canton_withdrawn_by enum value to the /// response property for the response status
- warning
  added the new canton_withdrawn_by enum value to the /// response property for the response status
- warning
  added the new canton_withdrawn_by enum value to the /// response property for the response status
- warning
  added the new canton_withdrawn_by enum value to the /// response property for the response status
- warning
  added the new canton_withdrawn_by enum value to the /// response property for the response status
- warning
  added the new canton_withdrawn_by enum value to the /// response property for the response status
- warning
  added the new canton_withdrawn_by enum value to the /// response property for the response status
- warning
  added the new canton_withdrawn_by enum value to the /// response property for the response status
- warning
  added the new canton_withdrawn_by enum value to the /// response property for the response status
- warning
  added the new canton_withdrawn_by enum value to the /// response property for the response status
- warning
  added the new canton_withdrawn_by enum value to the /// response property for the response status
- warning
  added the new canton_withdrawn_by enum value to the /// response property for the response status
- warning
  added the new canton_withdrawn_by enum value to the /// response property for the response status
- warning
  added the new canton_withdrawn_by enum value to the /// response property for the response status
- warning
  added the new canton_withdrawn_by enum value to the /// response property for the response status
- warning
  added the new canton_withdrawn_by enum value to the /// response property for the response status
- warning
  added the new canton_withdrawn_by enum value to the /// response property for the response status
- warning
  added the new canton_withdrawn_by enum value to the /// response property for the response status
- warning
  added the new canton_withdrawn_by enum value to the /// response property for the response status
- warning
  added the new canton_withdrawn_by enum value to the /// response property for the response status
- warning
  added the new canton_withdrawn_by enum value to the /// response property for the response status
- warning
  added the new canton_withdrawn_by enum value to the /// response property for the response status
- warning
  added the new canton_withdrawn_by enum value to the /// response property for the response status
- warning
  added the new canton_withdrawn_by enum value to the /// response property for the response status
- warning
  added the new rejected enum value to the / response property for the response status
- warning
  added the new withdrawn enum value to the / response property for the response status
- info
  added withdraw_transfer discriminator mapping keys to the / response property for the response status
Oct 25, 202632ca4fb745f4 Revision changes
- warning
  added the new cancelled enum value to the / response property for the response status
- warning
  added the new cancelled enum value to the /// response property for the response status
- warning
  added the new cancelled enum value to the /// response property for the response status
- warning
  added the new first_time_transfer_destination enum value to the //// response property for the response status
- warning
  added the new first_time_transfer_destination enum value to the //// response property for the response status
- warning
  added the new first_time_transfer_destination enum value to the //// response property for the response status
- warning
  added the new first_time_transfer_destination enum value to the //// response property for the response status
- warning
  added the new first_time_transfer_destination enum value to the //// response property for the response status
- warning
  added the new first_time_transfer_destination enum value to the //// response property for the response status
- warning
  added the new first_time_transfer_destination enum value to the //// response property for the response status
- warning
  added the new first_time_transfer_destination enum value to the //// response property for the response status
- warning
  added the new first_time_transfer_destination enum value to the //// response property for the response status
- warning
  added the new first_time_transfer_destination enum value to the //// response property for the response status
- warning
  added the new first_time_transfer_destination enum value to the //// response property for the response status
- warning
  added the new first_time_transfer_destination enum value to the //// response property for the response status
- warning
  added the new first_time_transfer_destination enum value to the //// response property for the response status
- warning
  added the new first_time_transfer_destination enum value to the //// response property for the response status
- warning
  added the new first_time_transfer_destination enum value to the //// response property for the response status
- warning
  added the new first_time_transfer_destination enum value to the //// response property for the response status
- warning
  added the new first_time_transfer_destination enum value to the //// response property for the response status
- warning
  added the new first_time_transfer_destination enum value to the //// response property for the response status
- warning
  added the new first_time_transfer_destination enum value to the //// response property for the response status
- warning
  added the new first_time_transfer_destination enum value to the //// response property for the response status
- warning
  added the new first_time_transfer_destination enum value to the //// response property for the response status
- warning
  added the new first_time_transfer_destination enum value to the //// response property for the response status
- warning
  added the new first_time_transfer_destination enum value to the //// response property for the response status
- warning
  added the new first_time_transfer_destination enum value to the //// response property for the response status
- warning
  added the new first_time_transfer_destination enum value to the //// response property for the response status
- warning
  added the new first_time_transfer_destination enum value to the //// response property for the response status

Operation history (17 revisions)