API Reference

In total: 3 services, 31 entities, 37 actions

All entity sets support $filter, $select, $expand, $top, $skip, $count, $orderby
All actions are POST with JSON body
All services gated by @requires: 'authenticated-user'

ServicePath
CardanoODataService/odata/v4/cardano-odata/
CardanoTransactionService/odata/v4/cardano-transaction/
CardanoSignService/odata/v4/cardano-sign/

CardanoODataService /odata/v4/cardano-odata/

Read-only blockchain queries via lazy on-demand indexing with TTL refresh.

Entities

NetworkInformation · Blocks · Epochs · Pools · Dreps · Transactions · TransactionInputs · TransactionOutputs · TransactionInputAssets · TransactionOutputAssets · Accounts · Addresses · AddressAssets · AddressUTxOs · AddressTransactions · UTxOAssets · TransactionMetadata · LedgerProtocolParameters

Actions

ActionParamsReturns
GetNetworkInformation-NetworkInformation
GetBlockByHashhash: Blake2b256Blocks
GetEpochByNumberepochNumber: IntegerEpochs
GetPoolByIdpoolId: StringPools
GetDrepByIddrepId: StringDreps
GetAccountByStakeAddressstakeAddress: Bech32Accounts
GetTransactionByHashhash: Blake2b256Transactions
GetMetadataByTxHashtx_hash: Blake2b256TransactionMetadata[]
GetAddressByBech32address: Bech32Addresses
GetUTxOsByAddressaddress: Bech32AddressUTxOs[]
GetAssetsByAddressaddress: Bech32AddressAssets[]
GetLatestTransactionsByAddressaddress: Bech32, limit: IntegerAddressTransactions[]
GetLatestBlock-Blocks
GetLatestEpoch-Epochs
GetLedgerProtocolParameters-LedgerProtocolParameters
ParseTransactionCborcbor: LargeString (≤ 128 KiB hex)ParsedTransaction (pure, no network/DB)

CardanoTransactionService /odata/v4/cardano-transaction/

Build, track, submit. Two builders: csl, buildooor.

Entities

TransactionBuilds · TransactionBuildInputs · TransactionBuildOutputs · TransactionBuildInputAssets · TransactionBuildOutputAssets · TransactionSubmissions · TransactionSubmissionErrors · AddressTransactionBuilds

Actions

BuildSimpleAdaTransaction · BuildTransactionWithMetadata · BuildMultiAssetTransaction · BuildMintTransaction · BuildPlutusSpendTransaction · SetCollateral

Lookup:

ActionParamsReturns
GetBuildDetailsbuildId: UUIDTransactionBuilds
GetTransactionBuildsByAddressaddress: Bech32AddressTransactionBuilds[]

Submit:

ActionParamsReturns
SubmitTransactionbuildId: UUID, signedTxCbor: StringTransactionSubmissions
SubmitSignedTransactionsignedTxCbor: String, network: String(10)TransactionSubmissions
CheckSubmissionStatus (bound on TransactionSubmissions(id))-TransactionSubmissions

Utilities (v1.7.5):

ActionParamsReturns
DeriveScriptAddressvalidatorScript, scriptParamsJson?, network?{ scriptAddress, scriptHash }
ExtractPaymentKeyHashaddress: Bech32{ paymentKeyHash }

Full Build-action parameter tables: Transaction Workflow.


CardanoSignService /odata/v4/cardano-sign/

Entities

SigningRequests · SignatureVerifications · AddressSigningRequests · TransactionBuilds · TransactionSubmissions

Actions

Workflow:

ActionParamsReturns
CreateSigningRequestbuildId: UUID, message: StringSigningRequests
GetSigningRequestsigningRequestId: UUIDSigningRequests
GetSigningRequestsByAddressaddress: Bech32AddressSigningRequests[]
VerifySignaturesigningRequestId, signedTxCbor, signerType, signerInfo, address?SignatureVerifications
SubmitVerifiedTransaction(same 5 params)TransactionSubmissions

HSM (PKCS#11):

ActionParamsReturns
SignWithHsmbuildId: UUID, address?: Bech32SigningRequests
SignAndSubmitWithHsmbuildId: UUID, address?: Bech32TransactionSubmissions
GetHsmStatus-{ connected, keyId, keyLabel, publicKeyHash, cardanoAddress }

Optional address on the four signing actions enables consumer-side ownership verification.

Lifecycle: created → pending → verified → submitted.


See Also