Create a Tempo transfer transaction

POST

operations

tempo

transfer

TypeScript

const response: Promise<FireblocksResponse<CreateTempoTransferResponse>> = fireblocks.transactionsBeta.createTempoTransfer(transactionsBetaApiCreateTempoTransferRequest);

curl --request POST \
  --url https://api.fireblocks.io/v1/operations/tempo/transfer \
  --header 'Content-Type: application/json' \
  --data '
{
  "assetId": "PATHUSD_TEMPO_54V8",
  "source": {
    "type": "VAULT_ACCOUNT",
    "id": "0"
  },
  "note": "Created via API",
  "externalTxId": "unique-id-123",
  "feeCurrency": "PATHUSD_TEMPO_54V8",
  "destination": {
    "type": "VAULT_ACCOUNT",
    "id": "1"
  },
  "amount": "0.01",
  "treatAsGrossAmount": false,
  "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"
    }
  ],
  "failOnLowFee": false,
  "gasLimit": "21000",
  "replaceTxByHash": "0x9fc76417374aa880d4449a1f7f31ec597f00b1f6f3dd2d66f4c9c6c445836d8",
  "feePayerAccountId": "3",
  "nonceStrategy": "SEQUENTIAL",
  "nonceLane": 1,
  "memo": "invoice-1234"
}
'

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    assetId: 'PATHUSD_TEMPO_54V8',
    source: {type: 'VAULT_ACCOUNT', id: '0'},
    note: 'Created via API',
    externalTxId: 'unique-id-123',
    feeCurrency: 'PATHUSD_TEMPO_54V8',
    destination: {type: 'VAULT_ACCOUNT', id: '1'},
    amount: '0.01',
    treatAsGrossAmount: false,
    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'}],
    failOnLowFee: false,
    gasLimit: '21000',
    replaceTxByHash: '0x9fc76417374aa880d4449a1f7f31ec597f00b1f6f3dd2d66f4c9c6c445836d8',
    feePayerAccountId: '3',
    nonceStrategy: 'SEQUENTIAL',
    nonceLane: 1,
    memo: 'invoice-1234'
  })
};

fetch('https://api.fireblocks.io/v1/operations/tempo/transfer', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fireblocks.io/v1/operations/tempo/transfer",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'assetId' => 'PATHUSD_TEMPO_54V8',
    'source' => [
        'type' => 'VAULT_ACCOUNT',
        'id' => '0'
    ],
    'note' => 'Created via API',
    'externalTxId' => 'unique-id-123',
    'feeCurrency' => 'PATHUSD_TEMPO_54V8',
    'destination' => [
        'type' => 'VAULT_ACCOUNT',
        'id' => '1'
    ],
    'amount' => '0.01',
    'treatAsGrossAmount' => false,
    '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'
        ]
    ],
    'failOnLowFee' => false,
    'gasLimit' => '21000',
    'replaceTxByHash' => '0x9fc76417374aa880d4449a1f7f31ec597f00b1f6f3dd2d66f4c9c6c445836d8',
    'feePayerAccountId' => '3',
    'nonceStrategy' => 'SEQUENTIAL',
    'nonceLane' => 1,
    'memo' => 'invoice-1234'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.fireblocks.io/v1/operations/tempo/transfer"

	payload := strings.NewReader("{\n  \"assetId\": \"PATHUSD_TEMPO_54V8\",\n  \"source\": {\n    \"type\": \"VAULT_ACCOUNT\",\n    \"id\": \"0\"\n  },\n  \"note\": \"Created via API\",\n  \"externalTxId\": \"unique-id-123\",\n  \"feeCurrency\": \"PATHUSD_TEMPO_54V8\",\n  \"destination\": {\n    \"type\": \"VAULT_ACCOUNT\",\n    \"id\": \"1\"\n  },\n  \"amount\": \"0.01\",\n  \"treatAsGrossAmount\": false,\n  \"feeLevel\": \"MEDIUM\",\n  \"travelRuleMessage\": \"{}\",\n  \"travelRuleMessageId\": \"trm_12345678-1234-1234-1234-123456789012\",\n  \"useGasless\": true,\n  \"configurations\": {\n    \"expiresAfterSeconds\": 3600\n  },\n  \"maxFeePerGas\": \"50\",\n  \"maxPriorityFeePerGas\": \"2\",\n  \"destinations\": [\n    {\n      \"destination\": {\n        \"type\": \"VAULT_ACCOUNT\",\n        \"id\": \"2\"\n      },\n      \"amount\": \"0.01\"\n    }\n  ],\n  \"failOnLowFee\": false,\n  \"gasLimit\": \"21000\",\n  \"replaceTxByHash\": \"0x9fc76417374aa880d4449a1f7f31ec597f00b1f6f3dd2d66f4c9c6c445836d8\",\n  \"feePayerAccountId\": \"3\",\n  \"nonceStrategy\": \"SEQUENTIAL\",\n  \"nonceLane\": 1,\n  \"memo\": \"invoice-1234\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.fireblocks.io/v1/operations/tempo/transfer")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"assetId\": \"PATHUSD_TEMPO_54V8\",\n  \"source\": {\n    \"type\": \"VAULT_ACCOUNT\",\n    \"id\": \"0\"\n  },\n  \"note\": \"Created via API\",\n  \"externalTxId\": \"unique-id-123\",\n  \"feeCurrency\": \"PATHUSD_TEMPO_54V8\",\n  \"destination\": {\n    \"type\": \"VAULT_ACCOUNT\",\n    \"id\": \"1\"\n  },\n  \"amount\": \"0.01\",\n  \"treatAsGrossAmount\": false,\n  \"feeLevel\": \"MEDIUM\",\n  \"travelRuleMessage\": \"{}\",\n  \"travelRuleMessageId\": \"trm_12345678-1234-1234-1234-123456789012\",\n  \"useGasless\": true,\n  \"configurations\": {\n    \"expiresAfterSeconds\": 3600\n  },\n  \"maxFeePerGas\": \"50\",\n  \"maxPriorityFeePerGas\": \"2\",\n  \"destinations\": [\n    {\n      \"destination\": {\n        \"type\": \"VAULT_ACCOUNT\",\n        \"id\": \"2\"\n      },\n      \"amount\": \"0.01\"\n    }\n  ],\n  \"failOnLowFee\": false,\n  \"gasLimit\": \"21000\",\n  \"replaceTxByHash\": \"0x9fc76417374aa880d4449a1f7f31ec597f00b1f6f3dd2d66f4c9c6c445836d8\",\n  \"feePayerAccountId\": \"3\",\n  \"nonceStrategy\": \"SEQUENTIAL\",\n  \"nonceLane\": 1,\n  \"memo\": \"invoice-1234\"\n}"

response = http.request(request)
puts response.read_body

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

{
  "message": "<string>",
  "code": 123
}

Headers

Idempotency-Key

string

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.

Body

application/json

Request body for creating a Tempo transfer transaction.

assetId

string

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.

Example:

"PATHUSD_TEMPO_54V8"

source

object

required

The transfer's source.

Show child attributes

Example:

{ "type": "VAULT_ACCOUNT", "id": "0" }

note

string

A custom note that can be associated with the transaction.

Example:

"Created via API"

externalTxId

string

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

Example:

"unique-id-123"

feeCurrency

string

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.

Example:

"PATHUSD_TEMPO_54V8"

destination

object

The transfer's destination. Mutually exclusive with destinations.

Show child attributes

Example:

{ "type": "VAULT_ACCOUNT", "id": "1" }

amount

string

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).

Example:

"0.01"

treatAsGrossAmount

boolean

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

Example:

false

feeLevel

enum<string>

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

Available options:

LOW,

MEDIUM,

HIGH

Example:

"MEDIUM"

travelRuleMessage

string

Beta. An opaque travel-rule payload.

Example:

"{}"

travelRuleMessageId

string

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

Example:

"trm_12345678-1234-1234-1234-123456789012"

useGasless

boolean

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

Example:

true

configurations

object

Show child attributes

maxFeePerGas

string

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

Example:

"50"

maxPriorityFeePerGas

string

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

Example:

"2"

destinations

object[]

Multiple destinations for a single transfer. Mutually exclusive with destination.

Show child attributes

Example:

[
  {
    "destination": { "type": "VAULT_ACCOUNT", "id": "2" },
    "amount": "0.01"
  }
]

failOnLowFee

boolean

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

Example:

false

gasLimit

string

The gas limit for the transaction.

Example:

"21000"

replaceTxByHash

string

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

Example:

"0x9fc76417374aa880d4449a1f7f31ec597f00b1f6f3dd2d66f4c9c6c445836d8"

feePayerAccountId

string

Vault account ID of the fee payer sponsoring this transfer.

Example:

"3"

nonceStrategy

enum<string>

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.

Available options:

SEQUENTIAL,

USER_DEFINED_LANE,

EXPIRING

Example:

"SEQUENTIAL"

nonceLane

integer

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

Required range: 1 <= x <= 16

Example:

1

memo

string

Beta. Tempo TIP-20 memo (max 32 bytes).

Example:

"invoice-1234"

Response

Transaction created.

string

The Fireblocks transaction ID.

Example:

"d5c9a1b2-3e4f-4a5b-8c6d-7e8f9a0b1c2d"

status

string

The current status of the transaction.

Example:

"SUBMITTED"

⌘I

TypeScript

const response: Promise<FireblocksResponse<CreateTempoTransferResponse>> = fireblocks.transactionsBeta.createTempoTransfer(transactionsBetaApiCreateTempoTransferRequest);

curl --request POST \
  --url https://api.fireblocks.io/v1/operations/tempo/transfer \
  --header 'Content-Type: application/json' \
  --data '
{
  "assetId": "PATHUSD_TEMPO_54V8",
  "source": {
    "type": "VAULT_ACCOUNT",
    "id": "0"
  },
  "note": "Created via API",
  "externalTxId": "unique-id-123",
  "feeCurrency": "PATHUSD_TEMPO_54V8",
  "destination": {
    "type": "VAULT_ACCOUNT",
    "id": "1"
  },
  "amount": "0.01",
  "treatAsGrossAmount": false,
  "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"
    }
  ],
  "failOnLowFee": false,
  "gasLimit": "21000",
  "replaceTxByHash": "0x9fc76417374aa880d4449a1f7f31ec597f00b1f6f3dd2d66f4c9c6c445836d8",
  "feePayerAccountId": "3",
  "nonceStrategy": "SEQUENTIAL",
  "nonceLane": 1,
  "memo": "invoice-1234"
}
'

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    assetId: 'PATHUSD_TEMPO_54V8',
    source: {type: 'VAULT_ACCOUNT', id: '0'},
    note: 'Created via API',
    externalTxId: 'unique-id-123',
    feeCurrency: 'PATHUSD_TEMPO_54V8',
    destination: {type: 'VAULT_ACCOUNT', id: '1'},
    amount: '0.01',
    treatAsGrossAmount: false,
    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'}],
    failOnLowFee: false,
    gasLimit: '21000',
    replaceTxByHash: '0x9fc76417374aa880d4449a1f7f31ec597f00b1f6f3dd2d66f4c9c6c445836d8',
    feePayerAccountId: '3',
    nonceStrategy: 'SEQUENTIAL',
    nonceLane: 1,
    memo: 'invoice-1234'
  })
};

fetch('https://api.fireblocks.io/v1/operations/tempo/transfer', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fireblocks.io/v1/operations/tempo/transfer",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'assetId' => 'PATHUSD_TEMPO_54V8',
    'source' => [
        'type' => 'VAULT_ACCOUNT',
        'id' => '0'
    ],
    'note' => 'Created via API',
    'externalTxId' => 'unique-id-123',
    'feeCurrency' => 'PATHUSD_TEMPO_54V8',
    'destination' => [
        'type' => 'VAULT_ACCOUNT',
        'id' => '1'
    ],
    'amount' => '0.01',
    'treatAsGrossAmount' => false,
    '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'
        ]
    ],
    'failOnLowFee' => false,
    'gasLimit' => '21000',
    'replaceTxByHash' => '0x9fc76417374aa880d4449a1f7f31ec597f00b1f6f3dd2d66f4c9c6c445836d8',
    'feePayerAccountId' => '3',
    'nonceStrategy' => 'SEQUENTIAL',
    'nonceLane' => 1,
    'memo' => 'invoice-1234'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.fireblocks.io/v1/operations/tempo/transfer"

	payload := strings.NewReader("{\n  \"assetId\": \"PATHUSD_TEMPO_54V8\",\n  \"source\": {\n    \"type\": \"VAULT_ACCOUNT\",\n    \"id\": \"0\"\n  },\n  \"note\": \"Created via API\",\n  \"externalTxId\": \"unique-id-123\",\n  \"feeCurrency\": \"PATHUSD_TEMPO_54V8\",\n  \"destination\": {\n    \"type\": \"VAULT_ACCOUNT\",\n    \"id\": \"1\"\n  },\n  \"amount\": \"0.01\",\n  \"treatAsGrossAmount\": false,\n  \"feeLevel\": \"MEDIUM\",\n  \"travelRuleMessage\": \"{}\",\n  \"travelRuleMessageId\": \"trm_12345678-1234-1234-1234-123456789012\",\n  \"useGasless\": true,\n  \"configurations\": {\n    \"expiresAfterSeconds\": 3600\n  },\n  \"maxFeePerGas\": \"50\",\n  \"maxPriorityFeePerGas\": \"2\",\n  \"destinations\": [\n    {\n      \"destination\": {\n        \"type\": \"VAULT_ACCOUNT\",\n        \"id\": \"2\"\n      },\n      \"amount\": \"0.01\"\n    }\n  ],\n  \"failOnLowFee\": false,\n  \"gasLimit\": \"21000\",\n  \"replaceTxByHash\": \"0x9fc76417374aa880d4449a1f7f31ec597f00b1f6f3dd2d66f4c9c6c445836d8\",\n  \"feePayerAccountId\": \"3\",\n  \"nonceStrategy\": \"SEQUENTIAL\",\n  \"nonceLane\": 1,\n  \"memo\": \"invoice-1234\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.fireblocks.io/v1/operations/tempo/transfer")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"assetId\": \"PATHUSD_TEMPO_54V8\",\n  \"source\": {\n    \"type\": \"VAULT_ACCOUNT\",\n    \"id\": \"0\"\n  },\n  \"note\": \"Created via API\",\n  \"externalTxId\": \"unique-id-123\",\n  \"feeCurrency\": \"PATHUSD_TEMPO_54V8\",\n  \"destination\": {\n    \"type\": \"VAULT_ACCOUNT\",\n    \"id\": \"1\"\n  },\n  \"amount\": \"0.01\",\n  \"treatAsGrossAmount\": false,\n  \"feeLevel\": \"MEDIUM\",\n  \"travelRuleMessage\": \"{}\",\n  \"travelRuleMessageId\": \"trm_12345678-1234-1234-1234-123456789012\",\n  \"useGasless\": true,\n  \"configurations\": {\n    \"expiresAfterSeconds\": 3600\n  },\n  \"maxFeePerGas\": \"50\",\n  \"maxPriorityFeePerGas\": \"2\",\n  \"destinations\": [\n    {\n      \"destination\": {\n        \"type\": \"VAULT_ACCOUNT\",\n        \"id\": \"2\"\n      },\n      \"amount\": \"0.01\"\n    }\n  ],\n  \"failOnLowFee\": false,\n  \"gasLimit\": \"21000\",\n  \"replaceTxByHash\": \"0x9fc76417374aa880d4449a1f7f31ec597f00b1f6f3dd2d66f4c9c6c445836d8\",\n  \"feePayerAccountId\": \"3\",\n  \"nonceStrategy\": \"SEQUENTIAL\",\n  \"nonceLane\": 1,\n  \"memo\": \"invoice-1234\"\n}"

response = http.request(request)
puts response.read_body

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

{
  "message": "<string>",
  "code": 123
}

Introduction

Errors & Statuses

Data Objects

API Endpoints

Headers

Body

Response