Skip to main content

Documentation Index

Fetch the complete documentation index at: https://nexus.gerowallet.io/docs/llms.txt

Use this file to discover all available pages before exploring further.

The Transactions API provides endpoints for querying transaction data and submitting new transactions to the Cardano blockchain. You can retrieve transaction details, UTXOs, and raw CBOR data.

Available endpoints

Get transaction

Retrieve detailed transaction information by hash

Get transaction UTXOs

Get inputs and outputs for a transaction

Get UTXOs by reference

Batch retrieve UTXOs by transaction hash and index

Get raw transaction

Get transaction in raw CBOR format

Submit transaction

Submit a signed transaction to the network

Networks

All transaction endpoints support multiple Cardano networks:
NetworkDescription
MAINNETCardano mainnet (production)
PREPRODPre-production testnet
PREVIEWPreview testnet
TESTNETLegacy testnet
SANCHOGovernance testnet

Transaction data structure

Transaction responses include:
  • hash - Transaction hash (64 hex characters)
  • block - Block hash containing the transaction
  • block_height - Block height
  • slot - Slot number
  • index - Transaction index within the block
  • inputs - Array of transaction inputs
  • outputs - Array of transaction outputs
  • fees - Transaction fees in lovelace
  • deposit - Deposit amount (for staking operations)
  • size - Transaction size in bytes
  • invalid_before - Validity start slot
  • invalid_hereafter - Validity end slot
  • utxo_count - Number of UTXOs
  • withdrawal_count - Number of reward withdrawals
  • asset_mint_burn_count - Number of minted/burned assets
  • redeemer_count - Number of script redeemers
  • valid_contract - Whether smart contract execution succeeded

Submit transactions

To submit a transaction:
  1. Build and sign your transaction using a library like cardano-serialization-lib
  2. Serialize the transaction to CBOR hex format
  3. Send the hex string to the submit endpoint
curl -X POST "https://nexus-dev.gerowallet.io/v1/transactions/submit?network=MAINNET" \
  -H "Authorization: Bearer your-token" \
  -H "Content-Type: application/json" \
  -d '"84a400818258203b40265111d8bb3c3c...serialized_cbor_hex..."'

Batch UTXO retrieval

For building transactions, you often need to fetch multiple UTXOs. Use the batch endpoint to retrieve up to 100 UTXOs in a single request:
[
  { "txHash": "abc123...", "outputIndex": 0 },
  { "txHash": "def456...", "outputIndex": 1 }
]
This is more efficient than making individual requests for each UTXO.