Create a Transaction

Create a transaction

post

Create a transaction.

Authorizations

Ledger_API_Key & Ledger_API_UserLedger_API_Key & Ledger_API_User & Ledger_Store_Auth_TokenLedger_API_UserLedger_API_User & Ledger_Store_Auth_Token

X-Ledger-API-KeystringRequired

If you've set up your API Key when initializing your LAM, you'll need to include it as a header along with the api user header. For more details, see step 5 of the get started documentation.

X-Ledger-API-UserstringRequired

(required) Username of a registered API User

Body

application/json

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

/transactions

HTTPcURLJavaScriptPython

POST /transactions HTTP/1.1
Host: 
X-Ledger-API-Key: YOUR_API_KEY
X-Ledger-API-User: 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-11-14T17:56:50.631Z",
  "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"
}