FIfireblocks
Tempo (Beta)

Create a Tempo transfer transaction

Creates a new Tempo transfer transaction.

post/operations/tempo/transfer

Request

Headers

Idempotency-Keystring

A unique identifier for the request. If the request is sent multiple times with the same idempotency key, the server will return the same response as the first request. The idempotency key is valid for 24 hours.

Request body

notestring

A custom note that can be associated with the transaction.

externalTxIdstring

Unique ID provided by the customer, used to identify the transaction.

feeCurrencystring

The asset ID used to pay the transaction fee, if different from assetId. Maps to FeeParams.feeCurrency. Must be a valid fee token for assetId (e.g. a TIP-20 gas token for the base asset); an invalid pairing surfaces as 400 INVALID_FEE_CURRENCY_PARAM.

assetIdstring required

The ID of the asset to transfer. Must be a non-deprecated asset supported on a Tempo-eligible blockchain; an unknown, deprecated, or unsupported asset surfaces as 400 UNSUPPORTED_ASSET.

amountstring

The amount to transfer, as a numeric string. Required when destination is set; must be omitted when destinations is set (each entry carries its own amount instead).

treatAsGrossAmountboolean

If true, the specified amount includes the fee (fee is deducted from amount).

feeLevel'LOW' | 'MEDIUM' | 'HIGH'

The fee level to use, mutually exclusive with an explicit custom fee.

travelRuleMessagestring

Beta. An opaque travel-rule payload.

travelRuleMessageIdstring

Beta. An identifier of a TravelRule message, already sent to the TravelRule provider.

useGaslessboolean

Opt in to fee-payer-sponsored (gasless) transfer.

maxFeePerGasstring

The maximum total fee per gas the sender is willing to pay, in wei.

maxPriorityFeePerGasstring

The maximum priority fee (tip) per gas the sender is willing to pay, in wei.

failOnLowFeeboolean

Beta. If true, fail the transaction rather than sending it with a low fee.

gasLimitstring

The gas limit for the transaction.

replaceTxByHashstring

Beta. The hash of the EVM transaction to replace (RBF).

feePayerAccountIdstring

Vault account ID of the fee payer sponsoring this transfer.

nonceStrategy'SEQUENTIAL' | 'USER_DEFINED_LANE' | 'EXPIRING'

Tempo's 2-dimensional nonce strategy: SEQUENTIAL runs under a single nonce lane (lane 0); USER_DEFINED_LANE runs in parallel under a specified lane (1–16), and requires nonceLane; EXPIRING marks the transaction with an expiry of up to 5 minutes (Tempo-defined) and does not use nonceLane.

nonceLaneinteger

The nonce lane to use, 1–16. Required and only meaningful when nonceStrategy is USER_DEFINED_LANE; not used for SEQUENTIAL or EXPIRING.

Example request

{
  "note": "Created via API",
  "externalTxId": "unique-id-123",
  "feeCurrency": "PATHUSD_TEMPO_54V8",
  "assetId": "PATHUSD_TEMPO_54V8",
  "source": {
    "type": "VAULT_ACCOUNT",
    "id": "0"
  },
  "destination": {
    "type": "VAULT_ACCOUNT",
    "id": "1"
  },
  "amount": "0.01",
  "feeLevel": "MEDIUM",
  "travelRuleMessage": "{}",
  "travelRuleMessageId": "trm_12345678-1234-1234-1234-123456789012",
  "useGasless": true,
  "configurations": {
    "expiresAfterSeconds": 3600
  },
  "maxFeePerGas": "50",
  "maxPriorityFeePerGas": "2",
  "destinations": [
    {
      "destination": {
        "type": "VAULT_ACCOUNT",
        "id": "2"
      },
      "amount": "0.01"
    }
  ],
  "gasLimit": "21000",
  "replaceTxByHash": "0x9fc76417374aa880d4449a1f7f31ec597f00b1f6f3dd2d66f4c9c6c445836d8",
  "feePayerAccountId": "3",
  "nonceStrategy": "SEQUENTIAL",
  "nonceLane": 1
}

Response

Transaction created.

idstring

The Fireblocks transaction ID.

statusstring

The current status of the transaction.

Example response

{
  "id": "d5c9a1b2-3e4f-4a5b-8c6d-7e8f9a0b1c2d",
  "status": "SUBMITTED"
}

Changes

No recorded changes to this operation across all 1 revision of this API.