Create transaction

curl --request POST \
  --url https://api.platform.bitnob.com/transactions \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "amount": "25.5",
  "asset": "USDT_TRX",
  "to_address": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
  "wallet_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "fee_level": "medium",
  "fee_rate": "15",
  "fill_fee_from_unselected": true,
  "inputs": [
    {
      "txid": "de64fb866d99a42d857698ec5c383c9eb8f8a9d2596fdf556a8bba95a5bcc070",
      "vout": "0"
    }
  ],
  "max_fee_rate": "50",
  "network": "mainnet",
  "note": "Invoice 4471 payout",
  "sponsor": true,
  "treat_as_gross_amount": true
}
'

const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    'X-API-Key': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    amount: '25.5',
    asset: 'USDT_TRX',
    to_address: '0x742d35Cc6634C0532925a3b844Bc454e4438f44e',
    wallet_id: 'f47ac10b-58cc-4372-a567-0e02b2c3d479',
    fee_level: 'medium',
    fee_rate: '15',
    fill_fee_from_unselected: true,
    inputs: [
      {
        txid: 'de64fb866d99a42d857698ec5c383c9eb8f8a9d2596fdf556a8bba95a5bcc070',
        vout: '0'
      }
    ],
    max_fee_rate: '50',
    network: 'mainnet',
    note: 'Invoice 4471 payout',
    sponsor: true,
    treat_as_gross_amount: true
  })
};

fetch('https://api.platform.bitnob.com/transactions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.platform.bitnob.com/transactions"

payload = {
    "amount": "25.5",
    "asset": "USDT_TRX",
    "to_address": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
    "wallet_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "fee_level": "medium",
    "fee_rate": "15",
    "fill_fee_from_unselected": True,
    "inputs": [
        {
            "txid": "de64fb866d99a42d857698ec5c383c9eb8f8a9d2596fdf556a8bba95a5bcc070",
            "vout": "0"
        }
    ],
    "max_fee_rate": "50",
    "network": "mainnet",
    "note": "Invoice 4471 payout",
    "sponsor": True,
    "treat_as_gross_amount": True
}
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.platform.bitnob.com/transactions",
  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([
    'amount' => '25.5',
    'asset' => 'USDT_TRX',
    'to_address' => '0x742d35Cc6634C0532925a3b844Bc454e4438f44e',
    'wallet_id' => 'f47ac10b-58cc-4372-a567-0e02b2c3d479',
    'fee_level' => 'medium',
    'fee_rate' => '15',
    'fill_fee_from_unselected' => true,
    'inputs' => [
        [
                'txid' => 'de64fb866d99a42d857698ec5c383c9eb8f8a9d2596fdf556a8bba95a5bcc070',
                'vout' => '0'
        ]
    ],
    'max_fee_rate' => '50',
    'network' => 'mainnet',
    'note' => 'Invoice 4471 payout',
    'sponsor' => true,
    'treat_as_gross_amount' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "Idempotency-Key: <idempotency-key>",
    "X-API-Key: <api-key>"
  ],
]);

$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.platform.bitnob.com/transactions"

	payload := strings.NewReader("{\n  \"amount\": \"25.5\",\n  \"asset\": \"USDT_TRX\",\n  \"to_address\": \"0x742d35Cc6634C0532925a3b844Bc454e4438f44e\",\n  \"wallet_id\": \"f47ac10b-58cc-4372-a567-0e02b2c3d479\",\n  \"fee_level\": \"medium\",\n  \"fee_rate\": \"15\",\n  \"fill_fee_from_unselected\": true,\n  \"inputs\": [\n    {\n      \"txid\": \"de64fb866d99a42d857698ec5c383c9eb8f8a9d2596fdf556a8bba95a5bcc070\",\n      \"vout\": \"0\"\n    }\n  ],\n  \"max_fee_rate\": \"50\",\n  \"network\": \"mainnet\",\n  \"note\": \"Invoice 4471 payout\",\n  \"sponsor\": true,\n  \"treat_as_gross_amount\": true\n}")

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

	req.Header.Add("Idempotency-Key", "<idempotency-key>")
	req.Header.Add("X-API-Key", "<api-key>")
	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))

}

HttpResponse<String> response = Unirest.post("https://api.platform.bitnob.com/transactions")
  .header("Idempotency-Key", "<idempotency-key>")
  .header("X-API-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"amount\": \"25.5\",\n  \"asset\": \"USDT_TRX\",\n  \"to_address\": \"0x742d35Cc6634C0532925a3b844Bc454e4438f44e\",\n  \"wallet_id\": \"f47ac10b-58cc-4372-a567-0e02b2c3d479\",\n  \"fee_level\": \"medium\",\n  \"fee_rate\": \"15\",\n  \"fill_fee_from_unselected\": true,\n  \"inputs\": [\n    {\n      \"txid\": \"de64fb866d99a42d857698ec5c383c9eb8f8a9d2596fdf556a8bba95a5bcc070\",\n      \"vout\": \"0\"\n    }\n  ],\n  \"max_fee_rate\": \"50\",\n  \"network\": \"mainnet\",\n  \"note\": \"Invoice 4471 payout\",\n  \"sponsor\": true,\n  \"treat_as_gross_amount\": true\n}")
  .asString();

{
  "amount": "25.5",
  "amount_raw": "25500000",
  "asset": "USDC",
  "asset_decimals": 6,
  "block_hash": "0x8f4c1b8e2a7d3f06c5b1a09e8d7c6f5e4d3c2b1a09f8e7d6c5b4a3928170615f",
  "block_number": 21345678,
  "broadcast_at": "2026-05-16T10:30:02Z",
  "chain": "ethereum",
  "completed_at": "2026-05-16T10:30:45Z",
  "confirmations": 12,
  "created_at": "2026-05-16T10:30:00Z",
  "direction": "outbound",
  "execute_at": "2026-05-16T11:30:00Z",
  "fee_amount": "0.0012",
  "fee_amount_raw": "1200000000000000",
  "fee_asset": "ETH",
  "fee_decimals": 18,
  "from_address": "0x3f5CE5FBFe3E9af3971dD833D26bA9b5C936f0bE",
  "gas_station_id": "9b2e7a1c-3d4f-4a8b-9c0d-1e2f3a4b5c6d",
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "network": "mainnet",
  "note": "Invoice 4471 payout",
  "object": "transaction",
  "realized_fee_amount": "0.001",
  "realized_fee_amount_raw": "1000000000000000",
  "realized_fee_asset": "ETH",
  "realized_fee_decimals": 18,
  "signed_at": "2026-05-16T10:30:01Z",
  "sponsored": false,
  "status": "completed",
  "to_address": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
  "tx_hash": "0x9f4c1b8e2a7d3f06c5b1a09e8d7c6f5e4d3c2b1a09f8e7d6c5b4a3928170615f",
  "wallet_id": "a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d"
}

{
  "amount": "25.5",
  "amount_raw": "25500000",
  "asset": "USDC",
  "asset_decimals": 6,
  "block_hash": "0x8f4c1b8e2a7d3f06c5b1a09e8d7c6f5e4d3c2b1a09f8e7d6c5b4a3928170615f",
  "block_number": 21345678,
  "broadcast_at": "2026-05-16T10:30:02Z",
  "chain": "ethereum",
  "completed_at": "2026-05-16T10:30:45Z",
  "confirmations": 12,
  "created_at": "2026-05-16T10:30:00Z",
  "direction": "outbound",
  "execute_at": "2026-05-16T11:30:00Z",
  "fee_amount": "0.0012",
  "fee_amount_raw": "1200000000000000",
  "fee_asset": "ETH",
  "fee_decimals": 18,
  "from_address": "0x3f5CE5FBFe3E9af3971dD833D26bA9b5C936f0bE",
  "gas_station_id": "9b2e7a1c-3d4f-4a8b-9c0d-1e2f3a4b5c6d",
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "network": "mainnet",
  "note": "Invoice 4471 payout",
  "object": "transaction",
  "realized_fee_amount": "0.001",
  "realized_fee_amount_raw": "1000000000000000",
  "realized_fee_asset": "ETH",
  "realized_fee_decimals": 18,
  "signed_at": "2026-05-16T10:30:01Z",
  "sponsored": false,
  "status": "completed",
  "to_address": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
  "tx_hash": "0x9f4c1b8e2a7d3f06c5b1a09e8d7c6f5e4d3c2b1a09f8e7d6c5b4a3928170615f",
  "wallet_id": "a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d"
}

{
  "error": {
    "code": "<string>",
    "details": {},
    "message": "<string>",
    "param": "<string>",
    "request_id": "<string>",
    "type": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "details": {},
    "message": "<string>",
    "param": "<string>",
    "request_id": "<string>",
    "type": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "details": {},
    "message": "<string>",
    "param": "<string>",
    "request_id": "<string>",
    "type": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "details": {},
    "message": "<string>",
    "param": "<string>",
    "request_id": "<string>",
    "type": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "details": {},
    "message": "<string>",
    "param": "<string>",
    "request_id": "<string>",
    "type": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "details": {},
    "message": "<string>",
    "param": "<string>",
    "request_id": "<string>",
    "type": "<string>"
  }
}

Transactions

Create transaction

Creates a new transaction. The transaction is automatically signed using your API key credentials and submitted for broadcast. Requires the Idempotency-Key header.

Outcomes:

201 Created: signed and submitted; poll status until a terminal state.
202 Accepted: not yet executing — the body’s status says why:
- pending_authorization: organization policy requires approval; the transaction executes once approvers approve.
- delayed: a policy time-lock holds the transaction until execute_at, when the worker executes it automatically. In both cases the transaction is durably persisted (funds locked) — poll GET /v1/transactions/{id} for the resolution.

Bitcoin coin control: set inputs to pin the exact UTXOs to spend (enumerate selectable coins via GET /v1/wallets/{id}/utxos?spendable=true); set fill_fee_from_unselected to let the rest of the wallet top up the fee. Coin control is not supported with treat_as_gross_amount, or when the transaction would require approval or a policy time-delay.

POST

transactions

Create transaction

curl --request POST \
  --url https://api.platform.bitnob.com/transactions \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "amount": "25.5",
  "asset": "USDT_TRX",
  "to_address": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
  "wallet_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "fee_level": "medium",
  "fee_rate": "15",
  "fill_fee_from_unselected": true,
  "inputs": [
    {
      "txid": "de64fb866d99a42d857698ec5c383c9eb8f8a9d2596fdf556a8bba95a5bcc070",
      "vout": "0"
    }
  ],
  "max_fee_rate": "50",
  "network": "mainnet",
  "note": "Invoice 4471 payout",
  "sponsor": true,
  "treat_as_gross_amount": true
}
'

const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    'X-API-Key': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    amount: '25.5',
    asset: 'USDT_TRX',
    to_address: '0x742d35Cc6634C0532925a3b844Bc454e4438f44e',
    wallet_id: 'f47ac10b-58cc-4372-a567-0e02b2c3d479',
    fee_level: 'medium',
    fee_rate: '15',
    fill_fee_from_unselected: true,
    inputs: [
      {
        txid: 'de64fb866d99a42d857698ec5c383c9eb8f8a9d2596fdf556a8bba95a5bcc070',
        vout: '0'
      }
    ],
    max_fee_rate: '50',
    network: 'mainnet',
    note: 'Invoice 4471 payout',
    sponsor: true,
    treat_as_gross_amount: true
  })
};

fetch('https://api.platform.bitnob.com/transactions', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.platform.bitnob.com/transactions"

payload = {
    "amount": "25.5",
    "asset": "USDT_TRX",
    "to_address": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
    "wallet_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "fee_level": "medium",
    "fee_rate": "15",
    "fill_fee_from_unselected": True,
    "inputs": [
        {
            "txid": "de64fb866d99a42d857698ec5c383c9eb8f8a9d2596fdf556a8bba95a5bcc070",
            "vout": "0"
        }
    ],
    "max_fee_rate": "50",
    "network": "mainnet",
    "note": "Invoice 4471 payout",
    "sponsor": True,
    "treat_as_gross_amount": True
}
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.platform.bitnob.com/transactions",
  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([
    'amount' => '25.5',
    'asset' => 'USDT_TRX',
    'to_address' => '0x742d35Cc6634C0532925a3b844Bc454e4438f44e',
    'wallet_id' => 'f47ac10b-58cc-4372-a567-0e02b2c3d479',
    'fee_level' => 'medium',
    'fee_rate' => '15',
    'fill_fee_from_unselected' => true,
    'inputs' => [
        [
                'txid' => 'de64fb866d99a42d857698ec5c383c9eb8f8a9d2596fdf556a8bba95a5bcc070',
                'vout' => '0'
        ]
    ],
    'max_fee_rate' => '50',
    'network' => 'mainnet',
    'note' => 'Invoice 4471 payout',
    'sponsor' => true,
    'treat_as_gross_amount' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "Idempotency-Key: <idempotency-key>",
    "X-API-Key: <api-key>"
  ],
]);

$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.platform.bitnob.com/transactions"

	payload := strings.NewReader("{\n  \"amount\": \"25.5\",\n  \"asset\": \"USDT_TRX\",\n  \"to_address\": \"0x742d35Cc6634C0532925a3b844Bc454e4438f44e\",\n  \"wallet_id\": \"f47ac10b-58cc-4372-a567-0e02b2c3d479\",\n  \"fee_level\": \"medium\",\n  \"fee_rate\": \"15\",\n  \"fill_fee_from_unselected\": true,\n  \"inputs\": [\n    {\n      \"txid\": \"de64fb866d99a42d857698ec5c383c9eb8f8a9d2596fdf556a8bba95a5bcc070\",\n      \"vout\": \"0\"\n    }\n  ],\n  \"max_fee_rate\": \"50\",\n  \"network\": \"mainnet\",\n  \"note\": \"Invoice 4471 payout\",\n  \"sponsor\": true,\n  \"treat_as_gross_amount\": true\n}")

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

	req.Header.Add("Idempotency-Key", "<idempotency-key>")
	req.Header.Add("X-API-Key", "<api-key>")
	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))

}

HttpResponse<String> response = Unirest.post("https://api.platform.bitnob.com/transactions")
  .header("Idempotency-Key", "<idempotency-key>")
  .header("X-API-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"amount\": \"25.5\",\n  \"asset\": \"USDT_TRX\",\n  \"to_address\": \"0x742d35Cc6634C0532925a3b844Bc454e4438f44e\",\n  \"wallet_id\": \"f47ac10b-58cc-4372-a567-0e02b2c3d479\",\n  \"fee_level\": \"medium\",\n  \"fee_rate\": \"15\",\n  \"fill_fee_from_unselected\": true,\n  \"inputs\": [\n    {\n      \"txid\": \"de64fb866d99a42d857698ec5c383c9eb8f8a9d2596fdf556a8bba95a5bcc070\",\n      \"vout\": \"0\"\n    }\n  ],\n  \"max_fee_rate\": \"50\",\n  \"network\": \"mainnet\",\n  \"note\": \"Invoice 4471 payout\",\n  \"sponsor\": true,\n  \"treat_as_gross_amount\": true\n}")
  .asString();

{
  "amount": "25.5",
  "amount_raw": "25500000",
  "asset": "USDC",
  "asset_decimals": 6,
  "block_hash": "0x8f4c1b8e2a7d3f06c5b1a09e8d7c6f5e4d3c2b1a09f8e7d6c5b4a3928170615f",
  "block_number": 21345678,
  "broadcast_at": "2026-05-16T10:30:02Z",
  "chain": "ethereum",
  "completed_at": "2026-05-16T10:30:45Z",
  "confirmations": 12,
  "created_at": "2026-05-16T10:30:00Z",
  "direction": "outbound",
  "execute_at": "2026-05-16T11:30:00Z",
  "fee_amount": "0.0012",
  "fee_amount_raw": "1200000000000000",
  "fee_asset": "ETH",
  "fee_decimals": 18,
  "from_address": "0x3f5CE5FBFe3E9af3971dD833D26bA9b5C936f0bE",
  "gas_station_id": "9b2e7a1c-3d4f-4a8b-9c0d-1e2f3a4b5c6d",
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "network": "mainnet",
  "note": "Invoice 4471 payout",
  "object": "transaction",
  "realized_fee_amount": "0.001",
  "realized_fee_amount_raw": "1000000000000000",
  "realized_fee_asset": "ETH",
  "realized_fee_decimals": 18,
  "signed_at": "2026-05-16T10:30:01Z",
  "sponsored": false,
  "status": "completed",
  "to_address": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
  "tx_hash": "0x9f4c1b8e2a7d3f06c5b1a09e8d7c6f5e4d3c2b1a09f8e7d6c5b4a3928170615f",
  "wallet_id": "a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d"
}

{
  "amount": "25.5",
  "amount_raw": "25500000",
  "asset": "USDC",
  "asset_decimals": 6,
  "block_hash": "0x8f4c1b8e2a7d3f06c5b1a09e8d7c6f5e4d3c2b1a09f8e7d6c5b4a3928170615f",
  "block_number": 21345678,
  "broadcast_at": "2026-05-16T10:30:02Z",
  "chain": "ethereum",
  "completed_at": "2026-05-16T10:30:45Z",
  "confirmations": 12,
  "created_at": "2026-05-16T10:30:00Z",
  "direction": "outbound",
  "execute_at": "2026-05-16T11:30:00Z",
  "fee_amount": "0.0012",
  "fee_amount_raw": "1200000000000000",
  "fee_asset": "ETH",
  "fee_decimals": 18,
  "from_address": "0x3f5CE5FBFe3E9af3971dD833D26bA9b5C936f0bE",
  "gas_station_id": "9b2e7a1c-3d4f-4a8b-9c0d-1e2f3a4b5c6d",
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "network": "mainnet",
  "note": "Invoice 4471 payout",
  "object": "transaction",
  "realized_fee_amount": "0.001",
  "realized_fee_amount_raw": "1000000000000000",
  "realized_fee_asset": "ETH",
  "realized_fee_decimals": 18,
  "signed_at": "2026-05-16T10:30:01Z",
  "sponsored": false,
  "status": "completed",
  "to_address": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
  "tx_hash": "0x9f4c1b8e2a7d3f06c5b1a09e8d7c6f5e4d3c2b1a09f8e7d6c5b4a3928170615f",
  "wallet_id": "a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d"
}

{
  "error": {
    "code": "<string>",
    "details": {},
    "message": "<string>",
    "param": "<string>",
    "request_id": "<string>",
    "type": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "details": {},
    "message": "<string>",
    "param": "<string>",
    "request_id": "<string>",
    "type": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "details": {},
    "message": "<string>",
    "param": "<string>",
    "request_id": "<string>",
    "type": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "details": {},
    "message": "<string>",
    "param": "<string>",
    "request_id": "<string>",
    "type": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "details": {},
    "message": "<string>",
    "param": "<string>",
    "request_id": "<string>",
    "type": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "details": {},
    "message": "<string>",
    "param": "<string>",
    "request_id": "<string>",
    "type": "<string>"
  }
}

Authorizations

X-API-Key

string

header

required

Headers

API-Version

enum<string>

default:v1

API version (defaults to the latest supported version if omitted).

Available options:

v1

Idempotency-Key

string

required

Unique key (1-255 printable ASCII chars) used to safely retry write operations. Same key + body returns the cached response; same key + different body returns 409.

Required string length: 1 - 255

Body

application/json

amount

string

required

Amount to send as a human-readable decimal in the asset's display unit

Example:

"25.5"

asset

string

required

Asset to send — the asset ID (e.g. USDT_TRX, USDC_ETH, TRX) or, for a single-chain wallet, the bare symbol (e.g. USDT) which resolves to the wallet's chain. See GET /assets for the full list.

Example:

"USDT_TRX"

to_address

string

required

Recipient address

Example:

"0x742d35Cc6634C0532925a3b844Bc454e4438f44e"

wallet_id

string<uuid>

required

Identifier of the wallet to send from

Example:

"f47ac10b-58cc-4372-a567-0e02b2c3d479"

fee_level

enum<string>

Fee priority level: low, medium, or high

Available options:

low,

medium,

high

Example:

"medium"

fee_rate

string

Explicit Bitcoin fee rate in sat/vB; overrides fee_level. Bitcoin only

Example:

"15"

fill_fee_from_unselected

boolean

Top up from the rest of the wallet if pinned inputs don't cover amount+fee. Bitcoin only.

inputs

object[]

Bitcoin UTXOs to spend ({txid, vout}). Coin control — Bitcoin only. Not supported with treat_as_gross_amount, or when the transaction would require approval or a policy time-delay (returns 400).

Maximum array length: 250

Show child attributes

max_fee_rate

string

Bitcoin fee-rate ceiling in sat/vB; caps the effective rate. Bitcoin only

Example:

"50"

network

string

deprecated

Deprecated. The environment determines the network (live→mainnet, sandbox→testnet); an omitted value defaults to the wallet's network. Ignored when it contradicts the environment.

Example:

"mainnet"

note

string

Optional partner-supplied note to attach to the transaction

Example:

"Invoice 4471 payout"

Whether to have the network fee sponsored

treat_as_gross_amount

boolean

Whether the amount is treated as gross (fee deducted from it) rather than net

Response

Created

amount

string

Transferred amount as a human-readable decimal in the asset's display unit

Example:

"25.5"

amount_raw

string

Transferred amount as an integer in the asset's smallest base unit

Example:

"25500000"

asset

string

Symbol of the transferred asset

Example:

"USDC"

asset_decimals

integer

Number of decimals used to convert the asset's base units to its display unit

Example:

6

block_hash

string

Hash of the block the transaction was included in

Example:

"0x8f4c1b8e2a7d3f06c5b1a09e8d7c6f5e4d3c2b1a09f8e7d6c5b4a3928170615f"

block_number

integer

Number of the block the transaction was included in

Example:

21345678

broadcast_at

string<date-time>

ISO-8601 timestamp when the transaction was broadcast to the network

Example:

"2026-05-16T10:30:02Z"

chain

string

Blockchain the transaction was made on

Example:

"ethereum"

completed_at

string<date-time>

ISO-8601 timestamp when the transaction reached a completed state

Example:

"2026-05-16T10:30:45Z"

confirmations

integer

Number of block confirmations for the transaction

Example:

12

created_at

string<date-time>

ISO-8601 timestamp when the transaction was created

Example:

"2026-05-16T10:30:00Z"

direction

string

Transaction direction relative to the wallet (e.g. inbound, outbound)

Example:

"outbound"

error_message

string

Human-readable error message when the transaction failed

execute_at

string<date-time>

When a policy-delayed transaction (status=delayed) is scheduled to execute. Present only while the transaction is time-locked.

Example:

"2026-05-16T11:30:00Z"

fee_amount

string

Estimated network fee as a human-readable decimal in the fee asset's display unit

Example:

"0.0012"

fee_amount_raw

string

Estimated network fee as an integer in the fee asset's smallest base unit

Example:

"1200000000000000"

fee_asset

string

Symbol of the asset fees are denominated in (usually the chain's native coin)

Example:

"ETH"

fee_decimals

integer

Number of decimals used to convert the fee asset's base units to its display unit

Example:

18

from_address

string

Sender address

Example:

"0x3f5CE5FBFe3E9af3971dD833D26bA9b5C936f0bE"

gas_station_id

string

Identifier of the gas station used to fund the transaction's fees

Example:

"9b2e7a1c-3d4f-4a8b-9c0d-1e2f3a4b5c6d"

string

Unique identifier of the transaction

Example:

"7c9e6679-7425-40de-944b-e07fc1f90ae7"

network

string

Network the transaction was made on (e.g. mainnet)

Example:

"mainnet"

note

string

Optional partner-supplied note attached to the transaction

Example:

"Invoice 4471 payout"

object

string

Object type, always "transaction"

Example:

"transaction"

realized_fee_amount

string

Actual network fee paid as a human-readable decimal in the fee asset's display unit

Example:

"0.001"

realized_fee_amount_raw

string

Actual network fee paid as an integer in the fee asset's smallest base unit

Example:

"1000000000000000"

realized_fee_asset

string

Symbol of the asset the realized fee is denominated in

Example:

"ETH"

realized_fee_decimals

integer

Number of decimals used to convert the realized fee asset's base units to its display unit

Example:

18

signed_at

string<date-time>

ISO-8601 timestamp when the transaction was signed

Example:

"2026-05-16T10:30:01Z"

Get started

Meta

Assets

Vaults

Wallets

Transactions

Gas stations

Sponsored transfers

Consolidation

Policies

KYT

Insights

Users

Subscriptions

Webhooks

RPC

Create transaction

Authorizations

Headers

Body

Response