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]+)?$

recipientstringRequired

The recipient's address.

speedstring · enumRequired

The transaction's processing speed.

Possible values:

Responses

200

Transaction to approve

application/json

account_idintegerRequiredExample: 1

account_indexintegerRequiredExample: 0

amountstring · nullableOptional

the transaction amount, in base units

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

broadcast_onstring · date-time · nullableOptionalDefault: nullExample: 2020-12-11T12:56:35.370946+00:00

coin_fieldsone of · nullableOptionalDefault: nullExample: {"fees_per_byte":10}

or

or

or

or

or

or

or

or

or

confirmationsintegerRequiredExample: 28

created_byintegerRequiredExample: 5

created_onstring · date-timeRequired

currencystring · enumRequiredExample: bitcoinPossible values:

currency_familystring · enumRequiredExample: ethereumPossible values:

feesstring · nullableOptional

the transaction fee paid, in base units

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

idintegerRequired

interaction_typestring · nullableOptionalDefault: null

last_requestinteger · nullableOptionalDefault: null

max_feesstring · nullableOptional

Max fees represent the highest possible fee amount you will pay to broadcast this transaction, in base units. The final fees, calculated once the transaction is approved by the last Operator, might be lower, but will never exceed that amount. See https://help.vault.ledger.com/Content/transactions/tx.html for details

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

metadataone of · nullableOptionalDefault: null

or

min_confirmationsintegerRequiredExample: 6

recipientstring · nullableOptionalDefault: nullExample: tb1q2tvjts80vthcywq9au2yynpezca57mvv0j7lzm

sendersstring[] · nullableOptional

Only available once the transaction has been submitted to the blockchain

Default: nullExample: ["0x0D9377F84af90e6936973aEF3063fe6e16ca693e"]

speedstring · enum · nullableOptionalDefault: nullExample: NORMALPossible values:

statusstring · enumRequiredExample: PENDING_APPROVALPossible values:

tx_hashstring · nullableOptionalDefault: nullExample: cd199dd0c61ff75c7a442e425771fedfe07e191a76aed64b6a311ec4a369b20e

typestring · enumRequiredExample: SENDPossible values:

uidstring · nullableOptionalDefault: null

400

Invalid transaction parameters

application/json

post

/transactions

HTTPcURLJavaScriptPython

POST /transactions HTTP/1.1
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": "2026-03-15T03:47:09.791Z",
  "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"
}