Transactions

Build Transaction

post

Creates a new unsigned transaction from the sender’s public key to specified destinations.

Authorizations

api-keyAuth

api-keystringRequired

Body

application/json

fromPublicKeystringRequired

Sender’s public key in hex format.

Example: d1b70d2226308b46da297486adb6b4f1a8c1842cb159ac5ec04f384fe2d6f5da28

Responses

200

Transaction built successfully.

application/json

unsignedTxstringOptional

Serialized unsigned transaction in hex.

Example: 35d1b2a520a0da34c5eb8d712aa9cc

gasAmountintegerOptional

Gas amount estimated for the transaction.

Example: 20000

gasPricestringOptional

Gas price per unit in attoALPH.

Example: 100000000000

txIdstringOptional

Transaction identifier hash.

Example: 503bfb16230888af4924aa8f8250d7d348b862e267d75d3147f1998050b6da69

fromGroupintegerOptional

Source group ID.

Example: 2

toGroupintegerOptional

Destination group ID.

Example: 1

400

Invalid request payload.

application/json

401

Unauthorized

application/json

404

NotFound

application/json

500

InternalServerError

application/json

503

ServiceUnavailable

application/json

post/transactions/build

HTTPcURLJavaScriptPython

POST /transactions/build HTTP/1.1
Host: alephium.nownodes.io
api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 199

{
  "fromPublicKey": "d1b70d2226308b46da297486adb6b4f1a8c1842cb159ac5ec04f384fe2d6f5da28",
  "destinations": [
    {
      "address": "12jK2jHyyJTJyuRMRya7QJSojgVnb5yh4HVzNNw6BTBDF",
      "attoAlphAmount": "2000000000000000"
    }
  ]
}

{
  "unsignedTx": "35d1b2a520a0da34c5eb8d712aa9cc",
  "gasAmount": 20000,
  "gasPrice": "100000000000",
  "txId": "503bfb16230888af4924aa8f8250d7d348b862e267d75d3147f1998050b6da69",
  "fromGroup": 2,
  "toGroup": 1
}

Build Transaction from Multiple Addresses

post

Creates a new unsigned transaction from multiple senders each with their own destinations.

Authorizations

api-keyAuth

api-keystringRequired

Body

application/json

Responses

200

Transaction built successfully.

application/json

unsignedTxstringOptional

Serialized unsigned transaction in hex.

Example: 35d1b2a520a0da34c5eb8d712aa9cc

gasAmountintegerOptional

Gas amount estimated for the transaction.

Example: 20000

gasPricestringOptional

Gas price per unit in attoALPH.

Example: 100000000000

txIdstringOptional

Transaction identifier hash.

Example: 503bfb16230888af4924aa8f8250d7d348b862e267d75d3147f1998050b6da69

fromGroupintegerOptional

Source group ID.

Example: 2

toGroupintegerOptional

Destination group ID.

Example: 1

400

BadRequest

application/json

401

Unauthorized

application/json

404

NotFound

application/json

500

InternalServerError

application/json

503

ServiceUnavailable

application/json

post/transactions/build-multi-addresses

HTTPcURLJavaScriptPython

POST /transactions/build-multi-addresses HTTP/1.1
Host: alephium.nownodes.io
api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 211

{
  "from": [
    {
      "fromPublicKey": "d1b70d2226308b46da297486adb6b4f1a8c1842cb159ac5ec04f384fe2d6f5da28",
      "destinations": [
        {
          "address": "1AujpupFP4KWeZvqA7itsHY9cLJmx4qTzojVZrg8W9y",
          "attoAlphAmount": "2000000000000000000"
        }
      ]
    }
  ]
}

{
  "unsignedTx": "35d1b2a520a0da34c5eb8d712aa9cc",
  "gasAmount": 20000,
  "gasPrice": "100000000000",
  "txId": "503bfb16230888af4924aa8f8250d7d348b862e267d75d3147f1998050b6da69",
  "fromGroup": 2,
  "toGroup": 1
}

Build Sweep Transaction

post

Creates unsigned transaction(s) to sweep all funds from the specified public key’s address to a destination address.

Authorizations

api-keyAuth

api-keystringRequired

Body

application/json

fromPublicKeystringRequired

Public key of the source address to sweep funds from.

Example: d1b70d2226308b46da297486adb6b4f1a8c1842cb159ac5ec04f384fe2d6f5da28

toAddressstringRequired

Destination ALPH address where all funds will be sent.

Example: 1AujpupFP4KWeZvqA7itsHY9cLJmx4qTzojVZrg8W9y

Responses

200

Sweep transaction(s) built successfully.

application/json

fromGroupintegerOptional

Source group ID.

Example: 2

toGroupintegerOptional

Destination group ID.

Example: 1

400

BadRequest

application/json

401

Unauthorized

application/json

404

NotFound

application/json

500

InternalServerError

application/json

503

ServiceUnavailable

application/json

post/transactions/sweep-address/build

HTTPcURLJavaScriptPython

POST /transactions/sweep-address/build HTTP/1.1
Host: alephium.nownodes.io
api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 144

{
  "fromPublicKey": "d1b70d2226308b46da297486adb6b4f1a8c1842cb159ac5ec04f384fe2d6f5da28",
  "toAddress": "1AujpupFP4KWeZvqA7itsHY9cLJmx4qTzojVZrg8W9y"
}

{
  "unsignedTxs": [
    {
      "txId": "503bfb16230888af4924aa8f8250d7d348b862e267d75d3147f1998050b6da69",
      "unsignedTx": "35d1b2a520a0da34c5eb8d712aa9cc",
      "gasAmount": 20000,
      "gasPrice": "100000000000"
    }
  ],
  "fromGroup": 2,
  "toGroup": 1
}

Submit Signed Transaction

post

Submits a signed transaction to the ALPH network for processing.

Authorizations

api-keyAuth

api-keystringRequired

Body

application/json

unsignedTxstringRequired

Serialized unsigned transaction data in hex or base64 format.

Example: 35d1b2a520a0da34c5eb8d712aa9cc

signaturestringRequired

Signature of the unsigned transaction.

Example: 9e1a35b2931bd04e6780d01c36e3e5337941aa80f173cfe4f4e249c44ab135272b834c1a639db9c89d673a8a30524042b0469672ca845458a5a0cf2cad53221b

Responses

200

Transaction successfully submitted.

application/json

txIdstringOptional

Transaction ID of the submitted transaction.

Example: 503bfb16230888af4924aa8f8250d7d348b862e267d75d3147f1998050b6da69

fromGroupintegerOptional

Source group number from which the transaction was sent.

Example: 2

toGroupintegerOptional

Destination group number to which the transaction is targeted.

Example: 1

400

BadRequest

application/json

401

Unauthorized

application/json

404

NotFound

application/json

500

InternalServerError

application/json

503

ServiceUnavailable

application/json

post/transactions/submit

HTTPcURLJavaScriptPython

POST /transactions/submit HTTP/1.1
Host: alephium.nownodes.io
api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 190

{
  "unsignedTx": "35d1b2a520a0da34c5eb8d712aa9cc",
  "signature": "9e1a35b2931bd04e6780d01c36e3e5337941aa80f173cfe4f4e249c44ab135272b834c1a639db9c89d673a8a30524042b0469672ca845458a5a0cf2cad53221b"
}

{
  "txId": "503bfb16230888af4924aa8f8250d7d348b862e267d75d3147f1998050b6da69",
  "fromGroup": 2,
  "toGroup": 1
}

Decode an unsigned transaction

post

Decodes a serialized unsigned transaction string and returns the detailed transaction data, including groups involved, inputs, outputs, gas parameters, and token information.

Authorizations

api-keyAuth

api-keystringRequired

Body

application/json

unsignedTxstringRequired

Serialized unsigned transaction string to decode.

Example: 35d1b2a520a0da34c5eb8d712aa9cc

Responses

200

Successfully decoded unsigned transaction details.

application/json

fromGroupintegerRequired

Group number from which the transaction originates.

Example: 1

toGroupintegerRequired

Group number to which the transaction is sent.

Example: 2

400

BadRequest

application/json

401

Unauthorized

application/json

404

NotFound

application/json

500

InternalServerError

application/json

503

ServiceUnavailable

application/json

post/transactions/decode-unsigned-tx

HTTPcURLJavaScriptPython

POST /transactions/decode-unsigned-tx HTTP/1.1
Host: alephium.nownodes.io
api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 47

{
  "unsignedTx": "35d1b2a520a0da34c5eb8d712aa9cc"
}

{
  "fromGroup": 1,
  "toGroup": 2,
  "unsignedTx": {
    "txId": "503bfb16230888af4924aa8f8250d7d348b862e267d75d3147f1998050b6da69",
    "version": 1,
    "networkId": 1,
    "gasAmount": 20000,
    "gasPrice": "100000000000",
    "inputs": [
      {
        "outputRef": {
          "hint": 23412,
          "key": "798e9e137aec7c2d59d9655b4ffa640f301f628bf7c365083bb255f6aa5f89ef"
        },
        "unlockScript": "00d1b70d2226308b46da297486adb6b4f1a8c1842cb159ac5ec04f384fe2d6f5da28"
      }
    ],
    "fixedOutputs": [
      {
        "hint": 1,
        "key": "798e9e137aec7c2d59d9655b4ffa640f301f628bf7c365083bb255f6aa5f89ef",
        "attoAlphAmount": "2000000000000000000",
        "address": "1AujpupFP4KWeZvqA7itsHY9cLJmx4qTzojVZrg8W9y",
        "tokens": [
          {
            "id": "2d11fd6c12435ffb07aaed4d190a505b621b927a5f6e51b61ce0ebe186397bdd",
            "amount": "42000000000000000000"
          }
        ],
        "lockTime": 1611041396892,
        "message": "798e9e137aec7c2d59d9655b4ffa640f301f628bf7c365083bb255f6aa5f89ef"
      }
    ]
  }
}

Get detailed information of a transaction by transaction ID

get

Retrieves detailed information about a specific transaction, including unsigned transaction data, script execution status, contract inputs and outputs, and signatures.

Authorizations

api-keyAuth

api-keystringRequired

Path parameters

txIdstringRequired

Transaction ID (hash) to get details for.

Example: 98401002e2d85e8be4765ae29ac768f4f110ee46e3a0fab3e7a754e4bcffa3c4

Query parameters

fromGroupintegerOptional

Originating group number of the transaction.

Example: 3

toGroupintegerOptional

Target group number of the transaction.

Example: 1

Responses

200

Successful transaction detail retrieval

application/json

scriptExecutionOkbooleanOptional

Indicates if the transaction’s scripts executed successfully

Example: true

contractInputsobject[]Optional

Inputs related to smart contract calls

generatedOutputsobject[]Optional

Outputs generated by contract execution

inputSignaturesobject[]Optional

Signatures on inputs

scriptSignaturesobject[]Optional

Signatures related to script execution

400

BadRequest

application/json

401

Unauthorized

application/json

404

NotFound

application/json

500

InternalServerError

application/json

503

ServiceUnavailable

application/json

get/transactions/details/{txId}

HTTPcURLJavaScriptPython

GET /transactions/details/{txId} HTTP/1.1
Host: alephium.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "unsigned": {
    "txId": "98401002e2d85e8be4765ae29ac768f4f110ee46e3a0fab3e7a754e4bcffa3c4",
    "version": 0,
    "networkId": 0,
    "gasAmount": 20000,
    "gasPrice": "1000000000",
    "inputs": [],
    "fixedOutputs": [
      {
        "hint": -1023270969,
        "key": "f777a262eacace6f015ae547ece4c9de2ebe12bac116942d72c0c67140abdfed",
        "attoAlphAmount": "191472590469365818",
        "address": "19WzSnmNC1SQ6v7RpFFXhpcMcFSiwM4nKTSdbwgSJfSHy",
        "tokens": [],
        "lockTime": 1754944650065,
        "message": "030100"
      }
    ]
  },
  "scriptExecutionOk": true,
  "contractInputs": [],
  "generatedOutputs": [],
  "inputSignatures": [],
  "scriptSignatures": []
}

Get the status of a transaction by transaction ID and group parameters

get

Returns the current status of a transaction, including confirmation status, block hash where it is included, index within the block, and confirmation counts across groups.

Authorizations

api-keyAuth

api-keystringRequired

Query parameters

txIdstringRequired

Transaction ID (hash) to check status for

Example: 98401002e2d85e8be4765ae29ac768f4f110ee46e3a0fab3e7a754e4bcffa3c4

fromGroupintegerRequired

Originating group number of the transaction

Example: 3

toGroupintegerRequired

Target group number of the transaction

Example: 1

Responses

200

Transaction status information

application/json

typestringOptional

Status type of the transaction (e.g., Confirmed, Pending, Failed)

Example: Confirmed

blockHashstringOptional

Hash of the block that contains this transaction

Example: 0000000000005c8d2761b8c0967d5e0dcbfe47a5678a80f676a54276d956e3ed

txIndexintegerOptional

Index of the transaction within the block

Example: 0

chainConfirmationsintegerOptional

Number of confirmations on the blockchain for this transaction

Example: 208

fromGroupConfirmationsintegerOptional

Number of confirmations on the originating group

Example: 202

toGroupConfirmationsintegerOptional

Number of confirmations on the target group

Example: 209

400

BadRequest

application/json

401

Unauthorized

application/json

404

NotFound

application/json

500

InternalServerError

application/json

503

ServiceUnavailable

application/json

get/transactions/status

HTTPcURLJavaScriptPython

GET /transactions/status?txId=98401002e2d85e8be4765ae29ac768f4f110ee46e3a0fab3e7a754e4bcffa3c4&fromGroup=3&toGroup=1 HTTP/1.1
Host: alephium.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "type": "Confirmed",
  "blockHash": "0000000000005c8d2761b8c0967d5e0dcbfe47a5678a80f676a54276d956e3ed",
  "txIndex": 0,
  "chainConfirmations": 208,
  "fromGroupConfirmations": 202,
  "toGroupConfirmations": 209
}