Create a Transaction

Create a transaction

post

Create a transaction.

Authorizations

Ledger_API_KeyLedger_API_UserLedger_Store_Auth_Token

Body

account_idinteger | nullableOptional

The account's id

Default: null

account_namestringRequired

The account's name.

amountstring | nullableOptional

The amount to be sent, in the currency's lowest unit. For Smart Contract interaction, use "0" instead of null

Default: nullPattern: ^[0-9]*(\.[0-9]+)?$

coin_fieldsone of | nullableOptional

coin specific data

Default: null

or

or

or

or

or

or

or

or

or

max_feesstringRequired

Max fees represent the highest possible fee amount you will pay to broadcast this transaction. The final fees, calculated once the transaction is approved by the last Operator, might be lower, but will never exceed that amount. We recommend estimating max fees through our fee estimation endpoint prior to creating the transaction request. See https://help.vault.ledger.com/developer-portal/content/transactions/tx/ for details.For Solana and Polkadot, max_fees field must be ignored.

Pattern: ^[0-9]*(\.[0-9]+)?$

noteall of | nullableOptional

A title and comments for the transaction.

Default: null

recipientstringRequired

The recipient's address.

speedstring · enumRequired

The transaction's processing speed.

Possible values:

Responses

200

Transaction to approve

application/json

400

Invalid transaction parameters

application/json

post

HTTPcURLJavaScriptPython

POST /transactions HTTP/1.1
Host: 
X-Ledger-API-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 210

{
  "account_id": 1,
  "account_name": "text",
  "amount": "text",
  "coin_fields": {
    "utxo_picking_strategy": "DEEP_OUTPUTS_FIRST"
  },
  "max_fees": "text",
  "note": {
    "content": "text",
    "title": "text"
  },
  "recipient": "text",
  "speed": "CUSTOM"
}

{
  "account_id": 1,
  "account_index": 0,
  "amount": "1432199",
  "block": {
    "details": {
      "ANY_ADDITIONAL_PROPERTY": null
    },
    "hash": "0x3bb33b6cc7c4aeea0e7383ddd8ef238c44abe8e3d73ffa27b78dd130a2a56687",
    "height": 7463221,
    "time": "2020-12-11T12:56:35.370946+00:00"
  },
  "broadcast_on": "2020-12-11T12:56:35.370946+00:00",
  "coin_fields": {
    "fees_per_byte": 10
  },
  "compliance": {
    "registration_ids": {
      "chainalysis": "906ff226-8b64-11eb-8e52-7b35a3dc1742"
    },
    "risk": {
      "provider_details": {
        "chainalysis": [
          {
            "category_id": 3,
            "exposure_type": "DIRECT",
            "provider_id": "906ff226-8b64-11eb-8e52-7b35a3dc1742",
            "risk": "Severe",
            "service": "OFAC SDN Blender.io 2022-05-06",
            "value": 8868.24
          }
        ]
      },
      "risk": "HIGH"
    }
  },
  "confirmations": 28,
  "created_by": 5,
  "created_on": "2025-07-22T14:01:34.626Z",
  "currency": "bitcoin",
  "currency_family": "ethereum",
  "failure_reasons": {
    "client_reason": "human readable message",
    "reason": "detail"
  },
  "fees": 17500,
  "id": 1,
  "interaction_type": "text",
  "labels": [
    {
      "id": 1,
      "info": {
        "color": "#fe3423",
        "description": "Flag resources as potentially harmfull"
      },
      "name": "SPAM"
    }
  ],
  "last_request": 1,
  "max_fees": 2100,
  "metadata": {
    "stake_pubkey": "text"
  },
  "min_confirmations": 6,
  "notes": [
    {
      "content": "some information about this transaction",
      "title": "a note title"
    }
  ],
  "recipient": "tb1q2tvjts80vthcywq9au2yynpezca57mvv0j7lzm",
  "senders": [
    "0x0D9377F84af90e6936973aEF3063fe6e16ca693e"
  ],
  "speed": "NORMAL",
  "status": "PENDING_APPROVAL",
  "tx_hash": "cd199dd0c61ff75c7a442e425771fedfe07e191a76aed64b6a311ec4a369b20e",
  "type": "SEND",
  "uid": "text"
}