Cardano - REST API

REST API endpoints supported on Cardano Mainnet and Cardano Preprod through Tatum RPC Gateway, with base URLs and an example request.

Call Cardano REST endpoints through Tatum RPC Gateway. Append the endpoint path to the network's base URL and send your API key in the x-api-key header. See Authentication.

Base URLs

NetworkBase URL
Cardano Mainnethttps://cardano-mainnet.gateway.tatum.io
Cardano Preprodhttps://cardano-preprod.gateway.tatum.io

Example request

curl --request POST 'https://cardano-mainnet.gateway.tatum.io/network/list' \
  --header 'content-type: application/json' \
  --header 'x-api-key: {YOUR_API_KEY}' \
  --data '{}'

Endpoints

20 endpoints. Parameters and responses are described in the Cardano Rosetta API reference.

EndpointDescription
POST /account/balanceReturns the balances of an account at a given or the latest block.
POST /account/coinsReturns the unspent coins (UTXOs) of an account.
POST /blockReturns a block by its index or hash.
POST /block/transactionReturns a transaction in a block by its identifier.
POST /callInvokes a network-specific procedure call with network-specific parameters.
POST /construction/combineCreates a signed transaction from an unsigned transaction and its signatures.
POST /construction/deriveReturns the account identifier associated with a public key.
POST /construction/hashReturns the hash of a signed transaction.
POST /construction/metadataReturns the network metadata needed to construct a transaction.
POST /construction/parseParses an unsigned or signed transaction into its operations.
POST /construction/payloadsCreates an unsigned transaction and the payloads to sign from operations and metadata.
POST /construction/preprocessCreates the options request for /construction/metadata from the intended operations.
POST /construction/submitSubmits a signed transaction to the network.
POST /events/blocksReturns the sequence of block added and removed events in a given range.
POST /mempoolLists the identifiers of all transactions in the mempool.
POST /mempool/transactionReturns a mempool transaction by its identifier.
POST /network/listLists the networks supported by the Rosetta server.
POST /network/optionsReturns the version and the supported operation types, statuses and errors of a network.
POST /network/statusReturns the current status of a network, including the latest block and peers.
POST /search/transactionsSearches for transactions that match the given conditions.

The gateway lists its supported endpoints at runtime:

Endpoint unavailable?

If you need an endpoint we don't support yet, contact support.