Generate an Unsigned Transaction and Signing Payloads

POST

https://ada.nownodes.io/construction/payloads

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Payloads is called with an array of operations and the response from /construction/metadata. It returns an unsigned transaction blob and a collection of payloads that must be signed by particular AccountIdentifiers using a certain SignatureType. The array of operations provided in transaction construction often times can not specify all "effects" of a transaction (consider invoked transactions in Ethereum). However, they can deterministically specify the "intent" of the transaction, which is sufficient for construction. For this reason, parsing the corresponding transaction in the Data API (when it lands on chain) will contain a superset of whatever operations were provided during construction.

Body

application/json

Request value.

network_identifierNetworkIdentifierrequired

Rosetta network identifier object.

Show child attributes

blockchainstringrequired

Blockchain value.

networkstringrequired

If a blockchain has a specific chain-id or network identifier, it should go in this field. It is up to the client to determine which network-specific identifier is mainnet, preprod, or preview.

sub_network_identifierSubNetworkIdentifier

Sub Network Identifier value.

Show child attributes

networkstringrequired

Network value.

metadataobject

Additional metadata object.

operationsArray<Operation>required

Operations value.

Show child attributes

operation_identifierOperationIdentifierrequired

Operation Identifier value.

Show child attributes

indexinteger<int64>>= 0required

The operation index is used to ensure each operation has a unique identifier within a transaction. This index is only relative to the transaction and NOT GLOBAL. The operations in each transaction should start from index 0. To clarify, there may not be any notion of an operation index in the blockchain being described.

network_indexinteger<int64>>= 0

Some blockchains specify an operation index that is essential for client use. For example, Bitcoin uses a network_index to identify which UTXO was used in a transaction. network_index should not be populated if there is no notion of an operation index in a blockchain (typically most account-based blockchains).

related_operationsArray<OperationIdentifier>

Restrict referenced related_operations to identifier indices < the current operation_identifier.index. This ensures there exists a clear DAG-structure of relations. Since operations are one-sided, one could imagine relating operations in a single transfer or linking operations in a call tree.

Show child attributes

indexinteger<int64>>= 0required

network_indexinteger<int64>>= 0

typestringrequired

Type is the network-specific type of the operation. Ensure that any type that can be returned here is also specified in the NetworkOptionsResponse. This can be very useful to downstream consumers that parse all block data.

statusstring

Status is the network-specific status of the operation. Status is not defined on the transaction object because blockchains with smart contracts may have transactions that partially apply (some operations are successful and some are not). Blockchains with atomic transactions (all operations succeed or all operations fail) will have the same status for each operation. On-chain operations (operations retrieved in the /block and /block/transaction endpoints) MUST have a populated status field (anything on-chain must have succeeded or failed). However, operations provided during transaction construction (often times called "intent" in the documentation) MUST NOT have a populated status field (operations yet to be included on-chain have not yet succeeded or failed).

accountAccountIdentifier

Rosetta account identifier object.

Show child attributes

addressstringrequired

The address may be a cryptographic public key (or some encoding of it) or a provided username.

sub_accountSubAccountIdentifier

Sub Account value.

Show child attributes

addressstringrequired

The SubAccount address may be a cryptographic value or some other identifier (ex: bonded) that uniquely specifies a SubAccount.

metadataobject

If the SubAccount address is not sufficient to uniquely specify a SubAccount, any other identifying information can be stored here. It is important to note that two SubAccounts with identical addresses but differing metadata will not be considered equal by clients.

metadataobject

Blockchains that utilize a username model (where the address is not a derivative of a cryptographic public key) should specify the public key(s) owned by the address in metadata.

Show child attributes

chain_codestring

Hex string encoded extension of bip32 private and public keys with an extra 256 bits of entropy that consists of 32 bytes

amountAmount

Amount value.

Show child attributes

valuestringrequired

Value of the transaction in atomic units represented as an arbitrary-sized signed integer. For example, 1 BTC would be represented by a value of 100000000.

currencyCurrencyrequired

Rosetta currency object.

Show child attributes

symbolstringrequired

Canonical symbol associated with a currency.

decimalsinteger<int32>>= 0required

Number of decimal places in the standard unit representation of the amount. For example, BTC has 8 decimals. Note that it is not possible to represent the value of some currency in atomic units that is not base 10.

metadataany

Additional metadata object.

metadataobject

Additional metadata object.

coin_changeCoinChange

Coin Change value.

Show child attributes

coin_identifierCoinIdentifierrequired

Rosetta coin identifier object.

Show child attributes

identifierstringrequired

Identifier should be populated with a globally unique identifier of a Coin. In Bitcoin, this identifier would be transaction_hash:index.

coin_actionCoinActioncoin_createdcoin_spentrequired

Coin Action value.

metadataOperationMetadata

Additional metadata object.

Show child attributes

withdrawalAmountAmount

If it's a withdrawal operation, the amount will re returned here.

Show child attributes

valuestringrequired

Value of the transaction in atomic units represented as an arbitrary-sized signed integer. For example, 1 BTC would be represented by a value of 100000000.

currencyCurrencyrequired

Rosetta currency object.

Show child attributes

symbolstringrequired

Canonical symbol associated with a currency.

decimalsinteger<int32>>= 0required

metadataany

Additional metadata object.

metadataobject

Additional metadata object.

depositAmountAmount

If it's a registration operation, the amount will re returned here.

Show child attributes

valuestringrequired

Value of the transaction in atomic units represented as an arbitrary-sized signed integer. For example, 1 BTC would be represented by a value of 100000000.

currencyCurrencyrequired

Rosetta currency object.

Show child attributes

symbolstringrequired

Canonical symbol associated with a currency.

decimalsinteger<int32>>= 0required

metadataany

Additional metadata object.

metadataobject

Additional metadata object.

refundAmountAmount

If it's a deregistration operation, the amount will re returned here.

Show child attributes

valuestringrequired

Value of the transaction in atomic units represented as an arbitrary-sized signed integer. For example, 1 BTC would be represented by a value of 100000000.

currencyCurrencyrequired

Rosetta currency object.

Show child attributes

symbolstringrequired

Canonical symbol associated with a currency.

decimalsinteger<int32>>= 0required

metadataany

Additional metadata object.

metadataobject

Additional metadata object.

staking_credentialPublicKey

Staking Credential value.

Show child attributes

hex_bytesstringrequired

Hex-encoded public key bytes in the format specified by the CurveType.

curve_typeCurveTypesecp256k1secp256r1edwards25519tweedlerequired

Curve Type value.

pool_key_hashstring

Cardano transaction hash.

epochnumber

Cardano epoch number.

tokenBundleArray<TokenBundleItem>

A token bundle is a heterogeneous (‘mixed’) collection of tokens. Any tokens can be bundled together. Token bundles are the standard - and only - way to represent and store assets on the Cardano blockchain.

Show child attributes

policyIdstringrequired

Policy Id hex string

tokensArray<Amount>required

Tokens value.

Show child attributes

valuestringrequired

Value of the transaction in atomic units represented as an arbitrary-sized signed integer. For example, 1 BTC would be represented by a value of 100000000.

currencyCurrencyrequired

Rosetta currency object.

Show child attributes

symbolstringrequired

Canonical symbol associated with a currency.

decimalsinteger<int32>>= 0required

metadataany

Additional metadata object.

metadataobject

Additional metadata object.

poolRegistrationCertstring

Certificate of a pool registration encoded as hex string

poolRegistrationParamsPoolRegistrationParams

Cardano stake pool identifier or key hash.

Show child attributes

vrfKeyHashstringrequired

Cardano transaction hash.

rewardAddressstringrequired

Cardano reward address.

pledgestringrequired

Lovelace amount to pledge

coststringrequired

Operational costs per epoch lovelace

poolOwnersArray<string>required

Cardano stake pool identifier or key hash.

relaysArray<Relay>required

Relays value.

Show child attributes

typestring

Type value.

ipv4string

Ipv4 value.

ipv6string

Ipv6 value.

dnsNamestring

Dns Name value.

portstring

Port value.

marginPoolMargin

Margin value.

Show child attributes

numeratorstringrequired

Numerator value.

denominatorstringrequired

Denominator value.

margin_percentagestring

Margin Percentage value.

poolMetadataPoolMetadata

Cardano stake pool identifier or key hash.

Show child attributes

urlstringrequired

Url value.

hashstringrequired

Cardano transaction hash.

voteRegistrationMetadataVoteRegistrationMetadata

A Catalyst registration transaction is a regular Cardano transaction with a specific transaction metadata associated with it.

Show child attributes

stakeKeyPublicKeyrequired

The staking key on the Cardano network

Show child attributes

hex_bytesstringrequired

Hex-encoded public key bytes in the format specified by the CurveType.

curve_typeCurveTypesecp256k1secp256r1edwards25519tweedlerequired

Curve Type value.

votingKeyPublicKeyrequired

Catalyst voting key

Show child attributes

hex_bytesstringrequired

Hex-encoded public key bytes in the format specified by the CurveType.

curve_typeCurveTypesecp256k1secp256r1edwards25519tweedlerequired

Curve Type value.

rewardAddressstringrequired

Shelley address to receive rewards

votingNoncenumberrequired

Unsigned integer (of CBOR major type 0). Current slot number

votingSignaturestringrequired

ED25119 signature CBOR byte array of blake2b-256 hash of the registration metadata signed using the staking key

metadataobjectrequired

Additional metadata object.

Show child attributes

ttlstringrequired

Ttl value.

protocol_parametersProtocolParametersrequired

Protocol Parameters value.

Show child attributes

coinsPerUtxoSizestringrequired

Coins Per Utxo Size value.

maxTxSizenumberrequired

Max Tx Size value.

maxValSizenumberrequired

Max Val Size value.

keyDepositstringrequired

key registration cost in Lovelace

maxCollateralInputsnumberrequired

Max Collateral Inputs value.

minFeeCoefficientnumberrequired

Min Fee Coefficient value.

minFeeConstantnumberrequired

Min Fee Constant value.

minPoolCoststringrequired

Cardano stake pool identifier or key hash.

poolDepositstringrequired

pool registration cost in Lovelace

protocolintegerrequired

Protocol value.

public_keysArray<PublicKey>

Public Keys value.

Show child attributes

hex_bytesstringrequired

Hex-encoded public key bytes in the format specified by the CurveType.

curve_typeCurveTypesecp256k1secp256r1edwards25519tweedlerequired

Curve Type value.

Response

200OK

HTTP 200 response for constructionPayloads.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or backend failed while processing the request.

Generate an Unsigned Transaction and Signing Payloads

curl -X POST 'https://ada.nownodes.io/construction/payloads' \
  -H 'Content-Type: application/json' \
  -d '{
    "network_identifier": {
      "blockchain": "cardano",
      "network": "mainnet",
      "sub_network_identifier": {
        "network": "shard 1",
        "metadata": {
          "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
        }
      }
    },
    "operations": [
      {
        "operation_identifier": {
          "index": 5,
          "network_index": 0
        },
        "related_operations": [
          {
            "index": 1
          },
          {
            "index": 2
          }
        ],
        "type": "Transfer",
        "status": "Reverted",
        "account": {
          "address": "0x3a065000ab4183c6bf581dc1e55a605455fc6d61",
          "sub_account": {
            "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
            "metadata": {}
          },
          "metadata": {
            "chain_code": "chain_code_example"
          }
        },
        "amount": {
          "value": "1238089899992",
          "currency": {
            "symbol": "BTC",
            "decimals": 8,
            "metadata": {}
          },
          "metadata": {}
        },
        "coin_change": {
          "coin_identifier": {
            "identifier": "0x2f23fd8cca835af21f3ac375bac601f97ead75f2e79143bdf71fe2c4be043e8f:1"
          },
          "coin_action": "coin_created"
        },
        "metadata": {
          "staking_credential": {
            "hex_bytes": "1B400D60AAF34EAF6DCBAB9BBA46001A23497886CF11066F7846933D30E5AD3F",
            "curve_type": "edwards25519"
          },
          "payment_key": {
            "hex_bytes": "1B400D60AAF34EAF6DCBAB9BBA46001A23497886CF11066F7846933D30E5AD3F",
            "curve_type": "edwards25519"
          },
          "asm": "304502201fd8abb11443f8b1b9a04e0495e0543d05611473a790c8939f089d073f90509a022100f4677825136605d732e2126d09a2d38c20c75946cd9fc239c0497e84c634e3dd01 03301a8259a12e35694cc22ebc45fee635f4993064190f6ce96e7fb19a03bb6be2",
          "hex": "48304502201fd8abb11443f8b1b9a04e0495e0543d05611473a790c8939f089d073f90509a022100f4677825136605d732e2126d09a2d38c20c75946cd9fc239c0497e84c634e3dd012103301a8259a12e35694cc22ebc45fee635f4993064190f6ce96e7fb19a03bb6be2"
        }
      }
    ],
    "metadata": {
      "ttl": "ttl_example",
      "protocol_parameters": {
        "coinsPerUtxoSize": "coinsperutxosize_example",
        "maxTxSize": 1,
        "maxValSize": 1,
        "keyDeposit": "keydeposit_example",
        "maxCollateralInputs": 1,
        "minFeeCoefficient": 1,
        "minFeeConstant": 1,
        "minPoolCost": "pool108zdflss3ayqlm5c7vr6mtqj2uwl99vk28ur8dv4zswdzt6yauc",
        "poolDeposit": "pool108zdflss3ayqlm5c7vr6mtqj2uwl99vk28ur8dv4zswdzt6yauc",
        "protocol": 1
      }
    },
    "public_keys": [
      {
        "hex_bytes": "hex_bytes_example",
        "curve_type": "secp256k1"
      }
    ]
  }'

const response = await fetch('https://ada.nownodes.io/construction/payloads', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "network_identifier": {
        "blockchain": "cardano",
        "network": "mainnet",
        "sub_network_identifier": {
          "network": "shard 1",
          "metadata": {
            "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
          }
        }
      },
      "operations": [
        {
          "operation_identifier": {
            "index": 5,
            "network_index": 0
          },
          "related_operations": [
            {
              "index": 1
            },
            {
              "index": 2
            }
          ],
          "type": "Transfer",
          "status": "Reverted",
          "account": {
            "address": "0x3a065000ab4183c6bf581dc1e55a605455fc6d61",
            "sub_account": {
              "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
              "metadata": {}
            },
            "metadata": {
              "chain_code": "chain_code_example"
            }
          },
          "amount": {
            "value": "1238089899992",
            "currency": {
              "symbol": "BTC",
              "decimals": 8,
              "metadata": {}
            },
            "metadata": {}
          },
          "coin_change": {
            "coin_identifier": {
              "identifier": "0x2f23fd8cca835af21f3ac375bac601f97ead75f2e79143bdf71fe2c4be043e8f:1"
            },
            "coin_action": "coin_created"
          },
          "metadata": {
            "staking_credential": {
              "hex_bytes": "1B400D60AAF34EAF6DCBAB9BBA46001A23497886CF11066F7846933D30E5AD3F",
              "curve_type": "edwards25519"
            },
            "payment_key": {
              "hex_bytes": "1B400D60AAF34EAF6DCBAB9BBA46001A23497886CF11066F7846933D30E5AD3F",
              "curve_type": "edwards25519"
            },
            "asm": "304502201fd8abb11443f8b1b9a04e0495e0543d05611473a790c8939f089d073f90509a022100f4677825136605d732e2126d09a2d38c20c75946cd9fc239c0497e84c634e3dd01 03301a8259a12e35694cc22ebc45fee635f4993064190f6ce96e7fb19a03bb6be2",
            "hex": "48304502201fd8abb11443f8b1b9a04e0495e0543d05611473a790c8939f089d073f90509a022100f4677825136605d732e2126d09a2d38c20c75946cd9fc239c0497e84c634e3dd012103301a8259a12e35694cc22ebc45fee635f4993064190f6ce96e7fb19a03bb6be2"
          }
        }
      ],
      "metadata": {
        "ttl": "ttl_example",
        "protocol_parameters": {
          "coinsPerUtxoSize": "coinsperutxosize_example",
          "maxTxSize": 1,
          "maxValSize": 1,
          "keyDeposit": "keydeposit_example",
          "maxCollateralInputs": 1,
          "minFeeCoefficient": 1,
          "minFeeConstant": 1,
          "minPoolCost": "pool108zdflss3ayqlm5c7vr6mtqj2uwl99vk28ur8dv4zswdzt6yauc",
          "poolDeposit": "pool108zdflss3ayqlm5c7vr6mtqj2uwl99vk28ur8dv4zswdzt6yauc",
          "protocol": 1
        }
      },
      "public_keys": [
        {
          "hex_bytes": "hex_bytes_example",
          "curve_type": "secp256k1"
        }
      ]
    }),
});

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://ada.nownodes.io/construction/payloads')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
    "network_identifier": {
      "blockchain": "cardano",
      "network": "mainnet",
      "sub_network_identifier": {
        "network": "shard 1",
        "metadata": {
          "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
        }
      }
    },
    "operations": [
      {
        "operation_identifier": {
          "index": 5,
          "network_index": 0
        },
        "related_operations": [
          {
            "index": 1
          },
          {
            "index": 2
          }
        ],
        "type": "Transfer",
        "status": "Reverted",
        "account": {
          "address": "0x3a065000ab4183c6bf581dc1e55a605455fc6d61",
          "sub_account": {
            "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
            "metadata": {}
          },
          "metadata": {
            "chain_code": "chain_code_example"
          }
        },
        "amount": {
          "value": "1238089899992",
          "currency": {
            "symbol": "BTC",
            "decimals": 8,
            "metadata": {}
          },
          "metadata": {}
        },
        "coin_change": {
          "coin_identifier": {
            "identifier": "0x2f23fd8cca835af21f3ac375bac601f97ead75f2e79143bdf71fe2c4be043e8f:1"
          },
          "coin_action": "coin_created"
        },
        "metadata": {
          "staking_credential": {
            "hex_bytes": "1B400D60AAF34EAF6DCBAB9BBA46001A23497886CF11066F7846933D30E5AD3F",
            "curve_type": "edwards25519"
          },
          "payment_key": {
            "hex_bytes": "1B400D60AAF34EAF6DCBAB9BBA46001A23497886CF11066F7846933D30E5AD3F",
            "curve_type": "edwards25519"
          },
          "asm": "304502201fd8abb11443f8b1b9a04e0495e0543d05611473a790c8939f089d073f90509a022100f4677825136605d732e2126d09a2d38c20c75946cd9fc239c0497e84c634e3dd01 03301a8259a12e35694cc22ebc45fee635f4993064190f6ce96e7fb19a03bb6be2",
          "hex": "48304502201fd8abb11443f8b1b9a04e0495e0543d05611473a790c8939f089d073f90509a022100f4677825136605d732e2126d09a2d38c20c75946cd9fc239c0497e84c634e3dd012103301a8259a12e35694cc22ebc45fee635f4993064190f6ce96e7fb19a03bb6be2"
        }
      }
    ],
    "metadata": {
      "ttl": "ttl_example",
      "protocol_parameters": {
        "coinsPerUtxoSize": "coinsperutxosize_example",
        "maxTxSize": 1,
        "maxValSize": 1,
        "keyDeposit": "keydeposit_example",
        "maxCollateralInputs": 1,
        "minFeeCoefficient": 1,
        "minFeeConstant": 1,
        "minPoolCost": "pool108zdflss3ayqlm5c7vr6mtqj2uwl99vk28ur8dv4zswdzt6yauc",
        "poolDeposit": "pool108zdflss3ayqlm5c7vr6mtqj2uwl99vk28ur8dv4zswdzt6yauc",
        "protocol": 1
      }
    },
    "public_keys": [
      {
        "hex_bytes": "hex_bytes_example",
        "curve_type": "secp256k1"
      }
    ]
  }'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

import requests

payload = {
  "network_identifier": {
    "blockchain": "cardano",
    "network": "mainnet",
    "sub_network_identifier": {
      "network": "shard 1",
      "metadata": {
        "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
      }
    }
  },
  "operations": [
    {
      "operation_identifier": {
        "index": 5,
        "network_index": 0
      },
      "related_operations": [
        {
          "index": 1
        },
        {
          "index": 2
        }
      ],
      "type": "Transfer",
      "status": "Reverted",
      "account": {
        "address": "0x3a065000ab4183c6bf581dc1e55a605455fc6d61",
        "sub_account": {
          "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
          "metadata": {}
        },
        "metadata": {
          "chain_code": "chain_code_example"
        }
      },
      "amount": {
        "value": "1238089899992",
        "currency": {
          "symbol": "BTC",
          "decimals": 8,
          "metadata": {}
        },
        "metadata": {}
      },
      "coin_change": {
        "coin_identifier": {
          "identifier": "0x2f23fd8cca835af21f3ac375bac601f97ead75f2e79143bdf71fe2c4be043e8f:1"
        },
        "coin_action": "coin_created"
      },
      "metadata": {
        "staking_credential": {
          "hex_bytes": "1B400D60AAF34EAF6DCBAB9BBA46001A23497886CF11066F7846933D30E5AD3F",
          "curve_type": "edwards25519"
        },
        "payment_key": {
          "hex_bytes": "1B400D60AAF34EAF6DCBAB9BBA46001A23497886CF11066F7846933D30E5AD3F",
          "curve_type": "edwards25519"
        },
        "asm": "304502201fd8abb11443f8b1b9a04e0495e0543d05611473a790c8939f089d073f90509a022100f4677825136605d732e2126d09a2d38c20c75946cd9fc239c0497e84c634e3dd01 03301a8259a12e35694cc22ebc45fee635f4993064190f6ce96e7fb19a03bb6be2",
        "hex": "48304502201fd8abb11443f8b1b9a04e0495e0543d05611473a790c8939f089d073f90509a022100f4677825136605d732e2126d09a2d38c20c75946cd9fc239c0497e84c634e3dd012103301a8259a12e35694cc22ebc45fee635f4993064190f6ce96e7fb19a03bb6be2"
      }
    }
  ],
  "metadata": {
    "ttl": "ttl_example",
    "protocol_parameters": {
      "coinsPerUtxoSize": "coinsperutxosize_example",
      "maxTxSize": 1,
      "maxValSize": 1,
      "keyDeposit": "keydeposit_example",
      "maxCollateralInputs": 1,
      "minFeeCoefficient": 1,
      "minFeeConstant": 1,
      "minPoolCost": "pool108zdflss3ayqlm5c7vr6mtqj2uwl99vk28ur8dv4zswdzt6yauc",
      "poolDeposit": "pool108zdflss3ayqlm5c7vr6mtqj2uwl99vk28ur8dv4zswdzt6yauc",
      "protocol": 1
    }
  },
  "public_keys": [
    {
      "hex_bytes": "hex_bytes_example",
      "curve_type": "secp256k1"
    }
  ]
}

response = requests.post('https://ada.nownodes.io/construction/payloads', json=payload)
data = response.json()

const response = await fetch('https://ada.nownodes.io/construction/payloads', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "network_identifier": {
        "blockchain": "cardano",
        "network": "mainnet",
        "sub_network_identifier": {
          "network": "shard 1",
          "metadata": {
            "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
          }
        }
      },
      "operations": [
        {
          "operation_identifier": {
            "index": 5,
            "network_index": 0
          },
          "related_operations": [
            {
              "index": 1
            },
            {
              "index": 2
            }
          ],
          "type": "Transfer",
          "status": "Reverted",
          "account": {
            "address": "0x3a065000ab4183c6bf581dc1e55a605455fc6d61",
            "sub_account": {
              "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
              "metadata": {}
            },
            "metadata": {
              "chain_code": "chain_code_example"
            }
          },
          "amount": {
            "value": "1238089899992",
            "currency": {
              "symbol": "BTC",
              "decimals": 8,
              "metadata": {}
            },
            "metadata": {}
          },
          "coin_change": {
            "coin_identifier": {
              "identifier": "0x2f23fd8cca835af21f3ac375bac601f97ead75f2e79143bdf71fe2c4be043e8f:1"
            },
            "coin_action": "coin_created"
          },
          "metadata": {
            "staking_credential": {
              "hex_bytes": "1B400D60AAF34EAF6DCBAB9BBA46001A23497886CF11066F7846933D30E5AD3F",
              "curve_type": "edwards25519"
            },
            "payment_key": {
              "hex_bytes": "1B400D60AAF34EAF6DCBAB9BBA46001A23497886CF11066F7846933D30E5AD3F",
              "curve_type": "edwards25519"
            },
            "asm": "304502201fd8abb11443f8b1b9a04e0495e0543d05611473a790c8939f089d073f90509a022100f4677825136605d732e2126d09a2d38c20c75946cd9fc239c0497e84c634e3dd01 03301a8259a12e35694cc22ebc45fee635f4993064190f6ce96e7fb19a03bb6be2",
            "hex": "48304502201fd8abb11443f8b1b9a04e0495e0543d05611473a790c8939f089d073f90509a022100f4677825136605d732e2126d09a2d38c20c75946cd9fc239c0497e84c634e3dd012103301a8259a12e35694cc22ebc45fee635f4993064190f6ce96e7fb19a03bb6be2"
          }
        }
      ],
      "metadata": {
        "ttl": "ttl_example",
        "protocol_parameters": {
          "coinsPerUtxoSize": "coinsperutxosize_example",
          "maxTxSize": 1,
          "maxValSize": 1,
          "keyDeposit": "keydeposit_example",
          "maxCollateralInputs": 1,
          "minFeeCoefficient": 1,
          "minFeeConstant": 1,
          "minPoolCost": "pool108zdflss3ayqlm5c7vr6mtqj2uwl99vk28ur8dv4zswdzt6yauc",
          "poolDeposit": "pool108zdflss3ayqlm5c7vr6mtqj2uwl99vk28ur8dv4zswdzt6yauc",
          "protocol": 1
        }
      },
      "public_keys": [
        {
          "hex_bytes": "hex_bytes_example",
          "curve_type": "secp256k1"
        }
      ]
    }),
});

const data = await response.json();

const endpoint = "https://ada.nownodes.io/construction/payloads";
const apiKey = "YOUR_API_KEY";

async function nownodesRequest(payload) {
  const response = await fetch(endpoint, {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "api-key": apiKey,
    },
    body: JSON.stringify(payload),
  });

  return response.json();
}

const result = await nownodesRequest({
    "network_identifier": {
      "blockchain": "cardano",
      "network": "mainnet",
      "sub_network_identifier": {
        "network": "shard 1",
        "metadata": {
          "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
        }
      }
    },
    "operations": [
      {
        "operation_identifier": {
          "index": 5,
          "network_index": 0
        },
        "related_operations": [
          {
            "index": 1
          },
          {
            "index": 2
          }
        ],
        "type": "Transfer",
        "status": "Reverted",
        "account": {
          "address": "0x3a065000ab4183c6bf581dc1e55a605455fc6d61",
          "sub_account": {
            "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
            "metadata": {}
          },
          "metadata": {
            "chain_code": "chain_code_example"
          }
        },
        "amount": {
          "value": "1238089899992",
          "currency": {
            "symbol": "BTC",
            "decimals": 8,
            "metadata": {}
          },
          "metadata": {}
        },
        "coin_change": {
          "coin_identifier": {
            "identifier": "0x2f23fd8cca835af21f3ac375bac601f97ead75f2e79143bdf71fe2c4be043e8f:1"
          },
          "coin_action": "coin_created"
        },
        "metadata": {
          "staking_credential": {
            "hex_bytes": "1B400D60AAF34EAF6DCBAB9BBA46001A23497886CF11066F7846933D30E5AD3F",
            "curve_type": "edwards25519"
          },
          "payment_key": {
            "hex_bytes": "1B400D60AAF34EAF6DCBAB9BBA46001A23497886CF11066F7846933D30E5AD3F",
            "curve_type": "edwards25519"
          },
          "asm": "304502201fd8abb11443f8b1b9a04e0495e0543d05611473a790c8939f089d073f90509a022100f4677825136605d732e2126d09a2d38c20c75946cd9fc239c0497e84c634e3dd01 03301a8259a12e35694cc22ebc45fee635f4993064190f6ce96e7fb19a03bb6be2",
          "hex": "48304502201fd8abb11443f8b1b9a04e0495e0543d05611473a790c8939f089d073f90509a022100f4677825136605d732e2126d09a2d38c20c75946cd9fc239c0497e84c634e3dd012103301a8259a12e35694cc22ebc45fee635f4993064190f6ce96e7fb19a03bb6be2"
        }
      }
    ],
    "metadata": {
      "ttl": "ttl_example",
      "protocol_parameters": {
        "coinsPerUtxoSize": "coinsperutxosize_example",
        "maxTxSize": 1,
        "maxValSize": 1,
        "keyDeposit": "keydeposit_example",
        "maxCollateralInputs": 1,
        "minFeeCoefficient": 1,
        "minFeeConstant": 1,
        "minPoolCost": "pool108zdflss3ayqlm5c7vr6mtqj2uwl99vk28ur8dv4zswdzt6yauc",
        "poolDeposit": "pool108zdflss3ayqlm5c7vr6mtqj2uwl99vk28ur8dv4zswdzt6yauc",
        "protocol": 1
      }
    },
    "public_keys": [
      {
        "hex_bytes": "hex_bytes_example",
        "curve_type": "secp256k1"
      }
    ]
  });
console.log(result);

const response = await fetch('https://ada.nownodes.io/construction/payloads', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "network_identifier": {
        "blockchain": "cardano",
        "network": "mainnet",
        "sub_network_identifier": {
          "network": "shard 1",
          "metadata": {
            "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
          }
        }
      },
      "operations": [
        {
          "operation_identifier": {
            "index": 5,
            "network_index": 0
          },
          "related_operations": [
            {
              "index": 1
            },
            {
              "index": 2
            }
          ],
          "type": "Transfer",
          "status": "Reverted",
          "account": {
            "address": "0x3a065000ab4183c6bf581dc1e55a605455fc6d61",
            "sub_account": {
              "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
              "metadata": {}
            },
            "metadata": {
              "chain_code": "chain_code_example"
            }
          },
          "amount": {
            "value": "1238089899992",
            "currency": {
              "symbol": "BTC",
              "decimals": 8,
              "metadata": {}
            },
            "metadata": {}
          },
          "coin_change": {
            "coin_identifier": {
              "identifier": "0x2f23fd8cca835af21f3ac375bac601f97ead75f2e79143bdf71fe2c4be043e8f:1"
            },
            "coin_action": "coin_created"
          },
          "metadata": {
            "staking_credential": {
              "hex_bytes": "1B400D60AAF34EAF6DCBAB9BBA46001A23497886CF11066F7846933D30E5AD3F",
              "curve_type": "edwards25519"
            },
            "payment_key": {
              "hex_bytes": "1B400D60AAF34EAF6DCBAB9BBA46001A23497886CF11066F7846933D30E5AD3F",
              "curve_type": "edwards25519"
            },
            "asm": "304502201fd8abb11443f8b1b9a04e0495e0543d05611473a790c8939f089d073f90509a022100f4677825136605d732e2126d09a2d38c20c75946cd9fc239c0497e84c634e3dd01 03301a8259a12e35694cc22ebc45fee635f4993064190f6ce96e7fb19a03bb6be2",
            "hex": "48304502201fd8abb11443f8b1b9a04e0495e0543d05611473a790c8939f089d073f90509a022100f4677825136605d732e2126d09a2d38c20c75946cd9fc239c0497e84c634e3dd012103301a8259a12e35694cc22ebc45fee635f4993064190f6ce96e7fb19a03bb6be2"
          }
        }
      ],
      "metadata": {
        "ttl": "ttl_example",
        "protocol_parameters": {
          "coinsPerUtxoSize": "coinsperutxosize_example",
          "maxTxSize": 1,
          "maxValSize": 1,
          "keyDeposit": "keydeposit_example",
          "maxCollateralInputs": 1,
          "minFeeCoefficient": 1,
          "minFeeConstant": 1,
          "minPoolCost": "pool108zdflss3ayqlm5c7vr6mtqj2uwl99vk28ur8dv4zswdzt6yauc",
          "poolDeposit": "pool108zdflss3ayqlm5c7vr6mtqj2uwl99vk28ur8dv4zswdzt6yauc",
          "protocol": 1
        }
      },
      "public_keys": [
        {
          "hex_bytes": "hex_bytes_example",
          "curve_type": "secp256k1"
        }
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "network_identifier": {
    "blockchain": "cardano",
    "network": "mainnet",
    "sub_network_identifier": {
      "network": "shard 1",
      "metadata": {
        "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
      }
    }
  },
  "operations": [
    {
      "operation_identifier": {
        "index": 5,
        "network_index": 0
      },
      "related_operations": [
        {
          "index": 1
        },
        {
          "index": 2
        }
      ],
      "type": "Transfer",
      "status": "Reverted",
      "account": {
        "address": "0x3a065000ab4183c6bf581dc1e55a605455fc6d61",
        "sub_account": {
          "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
          "metadata": {}
        },
        "metadata": {
          "chain_code": "chain_code_example"
        }
      },
      "amount": {
        "value": "1238089899992",
        "currency": {
          "symbol": "BTC",
          "decimals": 8,
          "metadata": {}
        },
        "metadata": {}
      },
      "coin_change": {
        "coin_identifier": {
          "identifier": "0x2f23fd8cca835af21f3ac375bac601f97ead75f2e79143bdf71fe2c4be043e8f:1"
        },
        "coin_action": "coin_created"
      },
      "metadata": {
        "staking_credential": {
          "hex_bytes": "1B400D60AAF34EAF6DCBAB9BBA46001A23497886CF11066F7846933D30E5AD3F",
          "curve_type": "edwards25519"
        },
        "payment_key": {
          "hex_bytes": "1B400D60AAF34EAF6DCBAB9BBA46001A23497886CF11066F7846933D30E5AD3F",
          "curve_type": "edwards25519"
        },
        "asm": "304502201fd8abb11443f8b1b9a04e0495e0543d05611473a790c8939f089d073f90509a022100f4677825136605d732e2126d09a2d38c20c75946cd9fc239c0497e84c634e3dd01 03301a8259a12e35694cc22ebc45fee635f4993064190f6ce96e7fb19a03bb6be2",
        "hex": "48304502201fd8abb11443f8b1b9a04e0495e0543d05611473a790c8939f089d073f90509a022100f4677825136605d732e2126d09a2d38c20c75946cd9fc239c0497e84c634e3dd012103301a8259a12e35694cc22ebc45fee635f4993064190f6ce96e7fb19a03bb6be2"
      }
    }
  ],
  "metadata": {
    "ttl": "ttl_example",
    "protocol_parameters": {
      "coinsPerUtxoSize": "coinsperutxosize_example",
      "maxTxSize": 1,
      "maxValSize": 1,
      "keyDeposit": "keydeposit_example",
      "maxCollateralInputs": 1,
      "minFeeCoefficient": 1,
      "minFeeConstant": 1,
      "minPoolCost": "pool108zdflss3ayqlm5c7vr6mtqj2uwl99vk28ur8dv4zswdzt6yauc",
      "poolDeposit": "pool108zdflss3ayqlm5c7vr6mtqj2uwl99vk28ur8dv4zswdzt6yauc",
      "protocol": 1
    }
  },
  "public_keys": [
    {
      "hex_bytes": "hex_bytes_example",
      "curve_type": "secp256k1"
    }
  ]
}

response = requests.post('https://ada.nownodes.io/construction/payloads', json=payload)
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://ada.nownodes.io/construction/payloads')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
    "network_identifier": {
      "blockchain": "cardano",
      "network": "mainnet",
      "sub_network_identifier": {
        "network": "shard 1",
        "metadata": {
          "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
        }
      }
    },
    "operations": [
      {
        "operation_identifier": {
          "index": 5,
          "network_index": 0
        },
        "related_operations": [
          {
            "index": 1
          },
          {
            "index": 2
          }
        ],
        "type": "Transfer",
        "status": "Reverted",
        "account": {
          "address": "0x3a065000ab4183c6bf581dc1e55a605455fc6d61",
          "sub_account": {
            "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
            "metadata": {}
          },
          "metadata": {
            "chain_code": "chain_code_example"
          }
        },
        "amount": {
          "value": "1238089899992",
          "currency": {
            "symbol": "BTC",
            "decimals": 8,
            "metadata": {}
          },
          "metadata": {}
        },
        "coin_change": {
          "coin_identifier": {
            "identifier": "0x2f23fd8cca835af21f3ac375bac601f97ead75f2e79143bdf71fe2c4be043e8f:1"
          },
          "coin_action": "coin_created"
        },
        "metadata": {
          "staking_credential": {
            "hex_bytes": "1B400D60AAF34EAF6DCBAB9BBA46001A23497886CF11066F7846933D30E5AD3F",
            "curve_type": "edwards25519"
          },
          "payment_key": {
            "hex_bytes": "1B400D60AAF34EAF6DCBAB9BBA46001A23497886CF11066F7846933D30E5AD3F",
            "curve_type": "edwards25519"
          },
          "asm": "304502201fd8abb11443f8b1b9a04e0495e0543d05611473a790c8939f089d073f90509a022100f4677825136605d732e2126d09a2d38c20c75946cd9fc239c0497e84c634e3dd01 03301a8259a12e35694cc22ebc45fee635f4993064190f6ce96e7fb19a03bb6be2",
          "hex": "48304502201fd8abb11443f8b1b9a04e0495e0543d05611473a790c8939f089d073f90509a022100f4677825136605d732e2126d09a2d38c20c75946cd9fc239c0497e84c634e3dd012103301a8259a12e35694cc22ebc45fee635f4993064190f6ce96e7fb19a03bb6be2"
        }
      }
    ],
    "metadata": {
      "ttl": "ttl_example",
      "protocol_parameters": {
        "coinsPerUtxoSize": "coinsperutxosize_example",
        "maxTxSize": 1,
        "maxValSize": 1,
        "keyDeposit": "keydeposit_example",
        "maxCollateralInputs": 1,
        "minFeeCoefficient": 1,
        "minFeeConstant": 1,
        "minPoolCost": "pool108zdflss3ayqlm5c7vr6mtqj2uwl99vk28ur8dv4zswdzt6yauc",
        "poolDeposit": "pool108zdflss3ayqlm5c7vr6mtqj2uwl99vk28ur8dv4zswdzt6yauc",
        "protocol": 1
      }
    },
    "public_keys": [
      {
        "hex_bytes": "hex_bytes_example",
        "curve_type": "secp256k1"
      }
    ]
  }'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

Request Body

{
  "network_identifier": {
    "blockchain": "cardano",
    "network": "mainnet",
    "sub_network_identifier": {
      "network": "shard 1",
      "metadata": {
        "producer": "0x52bc44d5378309ee2abf1539bf71de1b7d7be3b5"
      }
    }
  },
  "operations": [
    {
      "operation_identifier": {
        "index": 5,
        "network_index": 0
      },
      "related_operations": [
        {
          "index": 1
        },
        {
          "index": 2
        }
      ],
      "type": "Transfer",
      "status": "Reverted",
      "account": {
        "address": "0x3a065000ab4183c6bf581dc1e55a605455fc6d61",
        "sub_account": {
          "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
          "metadata": {}
        },
        "metadata": {
          "chain_code": "chain_code_example"
        }
      },
      "amount": {
        "value": "1238089899992",
        "currency": {
          "symbol": "BTC",
          "decimals": 8,
          "metadata": {}
        },
        "metadata": {}
      },
      "coin_change": {
        "coin_identifier": {
          "identifier": "0x2f23fd8cca835af21f3ac375bac601f97ead75f2e79143bdf71fe2c4be043e8f:1"
        },
        "coin_action": "coin_created"
      },
      "metadata": {
        "staking_credential": {
          "hex_bytes": "1B400D60AAF34EAF6DCBAB9BBA46001A23497886CF11066F7846933D30E5AD3F",
          "curve_type": "edwards25519"
        },
        "payment_key": {
          "hex_bytes": "1B400D60AAF34EAF6DCBAB9BBA46001A23497886CF11066F7846933D30E5AD3F",
          "curve_type": "edwards25519"
        },
        "asm": "304502201fd8abb11443f8b1b9a04e0495e0543d05611473a790c8939f089d073f90509a022100f4677825136605d732e2126d09a2d38c20c75946cd9fc239c0497e84c634e3dd01 03301a8259a12e35694cc22ebc45fee635f4993064190f6ce96e7fb19a03bb6be2",
        "hex": "48304502201fd8abb11443f8b1b9a04e0495e0543d05611473a790c8939f089d073f90509a022100f4677825136605d732e2126d09a2d38c20c75946cd9fc239c0497e84c634e3dd012103301a8259a12e35694cc22ebc45fee635f4993064190f6ce96e7fb19a03bb6be2"
      }
    }
  ],
  "metadata": {
    "ttl": "ttl_example",
    "protocol_parameters": {
      "coinsPerUtxoSize": "coinsperutxosize_example",
      "maxTxSize": 1,
      "maxValSize": 1,
      "keyDeposit": "keydeposit_example",
      "maxCollateralInputs": 1,
      "minFeeCoefficient": 1,
      "minFeeConstant": 1,
      "minPoolCost": "pool108zdflss3ayqlm5c7vr6mtqj2uwl99vk28ur8dv4zswdzt6yauc",
      "poolDeposit": "pool108zdflss3ayqlm5c7vr6mtqj2uwl99vk28ur8dv4zswdzt6yauc",
      "protocol": 1
    }
  },
  "public_keys": [
    {
      "hex_bytes": "hex_bytes_example",
      "curve_type": "secp256k1"
    }
  ]
}

{
  "metadata": {
    "network": "mainnet"
  },
  "unsigned_transaction": "84a4008182582004cba8a56386ee2a23563e8f05b6e80c7074b56b099945abaecae8040c3b1650",
  "payloads": []
}

{
  "code": 4000,
  "message": "Invalid request",
  "retriable": false
}

{
  "status_code": 400,
  "message": "Bad Request",
  "error": "bad_request"
}

Unknown API_key

Missing API_key

{
  "status_code": 500,
  "message": "Internal Server Error",
  "error": "internal_server_error"
}