Cardano Blockchain enables access to the most commonly used Cardano methods. These methods bring a small level of abstraction
and are used for applications that communicate with the blockchain directly. Some of the methods are used alongside Tatum Private Ledger
to connect the blockchain and the private ledger, like wallet generation or getting information about transactions.
Tatum supports 2 chains:
Gets Ada blockchain information. Obtains basic info like the testnet / mainnet version of the chain, the current block number and its hash.
OK
Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
Forbidden. The request is authenticated, but it is not possible to perform the required operation due to a logical error or invalid permissions.
Internal server error. There was an error on the server while processing the request.
curl -i -X GET \ https://api-eu1.tatum.io/v3/ada/info \ -H 'x-api-key: YOUR_API_KEY_HERE'
{- "testnet": "test",
- "tip": {
- "number": 2749845,
- "slotNo": 31798572,
- "epoch": {
- "number": 143
}
}
}
100 credits per API call
This endpoint is deprecated. Use the HTTP-based JSON RPC driver instead.
Use this endpoint URL as an GraphQL to connect directly to the Ada node provided by Tatum. You can find full documentation on the Cardano GraphQL API.
Any valid GraphQL method content body.
OK
Bad Request. Validation failed for the given object in the HTTP Body or Request parameters.
Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
Internal server error. There was an error on the server while processing the request.
{- "query": "{ cardano { tip { number slotNo epoch { number } }} }"
}
{- "data": {
- "cardano": {
- "tip": {
- "number": 3250222,
- "slotNo": 48226361,
- "epoch": {
- "number": 181
}
}
}
}
}
Tatum supports BIP44 HD wallets. Because they can generate 2^31 addresses from 1 mnemonic phrase, they are very convenient and secure. A mnemonic phrase consists of 24 special words in a defined order and can restore access to all generated addresses and private keys.
Each address is identified by 3 main values:
Tatum follows BIP44 specification and generates for ADA wallet with derivation path m/1852'/1815'/0'. More about BIP44 HD wallets can be found here - https://github.com/bitcoin/bips/blob/master/bip-0044.mediawiki. Generate BIP44 compatible Ada wallet.
OK
Bad Request. Validation failed for the given object in the HTTP Body or Request parameters.
Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
Forbidden. The request is authenticated, but it is not possible to perform the required operation due to a logical error or invalid permissions.
Internal server error. There was an error on the server while processing the request.
curl -i -X GET \ 'https://api-eu1.tatum.io/v3/ada/wallet?mnemonic=string' \ -H 'x-api-key: YOUR_API_KEY_HERE'
{- "mnemonic": "urge pulp usage sister evidence arrest palm math please chief egg abuse",
- "xpub": "xpub6EsCk1uU6cJzqvP9CdsTiJwT2rF748YkPnhv5Qo8q44DG7nn2vbyt48YRsNSUYS44jFCW9gwvD9kLQu9AuqXpTpM1c5hgg9PsuBLdeNncid"
}
Generates a Ada deposit address from an Extended public key. The deposit address is generated for the specific index - each extended public key can generate up to 2^31 addresses starting from index 0 until 2^31 - 1.
OK
Bad Request. Validation failed for the given object in the HTTP Body or Request parameters.
Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
Forbidden. The request is authenticated, but it is not possible to perform the required operation due to a logical error or invalid permissions.
Internal server error. There was an error on the server while processing the request.
curl -i -X GET \ 'https://api-eu1.tatum.io/v3/ada/address/{xpub}/{index}' \ -H 'x-api-key: YOUR_API_KEY_HERE'
{- "address": "addr1qyyxyhaa2e7kxeqcc72w7f747zqlgwwwstlzsg9umuxc40wnhawldxl4nan95rhtlcnju9q2r8j9qz8vslwsmrkj5r4spxhep9"
}
Generates a private key for an address from a mnemonic for a given derivation path index. The private key is generated for the specific index - each mnemonic can generate up to 2^32 private keys starting from index 0 until 2^31 - 1.
OK
Bad Request. Validation failed for the given object in the HTTP Body or Request parameters.
Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
Forbidden. The request is authenticated, but it is not possible to perform the required operation due to a logical error or invalid permissions.
Internal server error. There was an error on the server while processing the request.
{- "index": 0,
- "mnemonic": "urge pulp usage sister evidence arrest palm math please chief egg abuse"
}
{- "key": "cTmS2jBWXgFaXZ2xG9jhn67TiyTshnMp3UedamzEhGm6BZV1vLgQ"
}
Gets Ada block detail by block hash or height.
OK
Bad Request. Validation failed for the given object in the HTTP Body or Request parameters.
Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
Block not found.
Internal server error. There was an error on the server while processing the request.
curl -i -X GET \ 'https://api-eu1.tatum.io/v3/ada/block/{hash}' \ -H 'x-api-key: YOUR_API_KEY_HERE'
{- "hash": "6178dda07b94becb118f67b21aa72f60d85c1029e9e9b8ae56a25d684de66078",
- "number": 1234314,
- "epochNo": 536870912,
- "slotNo": "a3047a060e5d586a9b26779ebe62fc57ce7323745da8f28761ab755454d89c52",
- "merkleRoot": "a1634a42a8e956a5fb5225d06c3af6207e7f6fe5a00fa45229edfd0ddfa587f0",
- "forgedAt": "2020-10-20T08:21:50.107Z",
- "fees": 503452237,
- "slotInEpoch": 2278594841,
- "transactions": [
- {
- "hash": "5f83d51c8d3054012cea3011fa626b85d89442788721afd60719ab1f9ab8f78a",
- "fee": "0.00001682",
- "block": 1233224,
- "includedAt": "2020-10-20T08:21:50.107Z",
- "inputs": [
- {
- "txHash": "0db5a2881f26f7dce20222f9c2538dc296ab562e134a72052596bdf4bb6913b4",
- "sourceTxHash": "0db5a2881f26f7dce20222f9c2538dc296ab562e134a72052596bdf4bb6913b4",
- "sourceTxIndex": 1,
- "value": "989946",
- "address": "addr1qxm3vd0msv9ph8elhy7xrv975z88y6lr3d8vdgy3fwr2e22uvu2ffa2ctx3pdl4rjjja5p7al2k356x5yx8cn03am88s2807d9"
}
], - "outputs": [
- {
- "value": "15000",
- "index": 1,
- "txHash": "76a914fc8f50c952da910f473a0533561311ad140c989b88ac",
- "address": "addr1qxm3vd0msv9ph8elhy7xrv975z88y6lr3d8vdgy3fwr2e22uvu2ffa2ctx3pdl4rjjja5p7al2k356x5yx8cn03am88s2807d9"
}
]
}
]
}
Get Ada Transaction detail by transaction hash.
OK
Bad Request. Validation failed for the given object in the HTTP Body or Request parameters.
Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
Forbidden. The request is authenticated, but it is not possible to perform the required operation due to a logical error or invalid permissions.
Internal server error. There was an error on the server while processing the request.
curl -i -X GET \ 'https://api-eu1.tatum.io/v3/ada/transaction/{hash}' \ -H 'x-api-key: YOUR_API_KEY_HERE'
{- "hash": "5f83d51c8d3054012cea3011fa626b85d89442788721afd60719ab1f9ab8f78a",
- "fee": "0.00001682",
- "block": 1233224,
- "includedAt": "2020-10-20T08:21:50.107Z",
- "inputs": [
- {
- "txHash": "0db5a2881f26f7dce20222f9c2538dc296ab562e134a72052596bdf4bb6913b4",
- "sourceTxHash": "0db5a2881f26f7dce20222f9c2538dc296ab562e134a72052596bdf4bb6913b4",
- "sourceTxIndex": 1,
- "value": "989946",
- "address": "addr1qxm3vd0msv9ph8elhy7xrv975z88y6lr3d8vdgy3fwr2e22uvu2ffa2ctx3pdl4rjjja5p7al2k356x5yx8cn03am88s2807d9"
}
], - "outputs": [
- {
- "value": "15000",
- "index": 1,
- "txHash": "76a914fc8f50c952da910f473a0533561311ad140c989b88ac",
- "address": "addr1qxm3vd0msv9ph8elhy7xrv975z88y6lr3d8vdgy3fwr2e22uvu2ffa2ctx3pdl4rjjja5p7al2k356x5yx8cn03am88s2807d9"
}
]
}
Gets a Ada transaction by address.
OK
Bad Request. Validation failed for the given object in the HTTP Body or Request parameters.
Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
Forbidden. The request is authenticated, but it is not possible to perform the required operation due to a logical error or invalid permissions.
Internal server error. There was an error on the server while processing the request.
curl -i -X GET \ 'https://api-eu1.tatum.io/v3/ada/transaction/address/{address}?pageSize=10&offset=0' \ -H 'x-api-key: YOUR_API_KEY_HERE'
[- {
- "hash": "5f83d51c8d3054012cea3011fa626b85d89442788721afd60719ab1f9ab8f78a",
- "fee": "0.00001682",
- "block": 1233224,
- "includedAt": "2020-10-20T08:21:50.107Z",
- "inputs": [
- {
- "txHash": "0db5a2881f26f7dce20222f9c2538dc296ab562e134a72052596bdf4bb6913b4",
- "sourceTxHash": "0db5a2881f26f7dce20222f9c2538dc296ab562e134a72052596bdf4bb6913b4",
- "sourceTxIndex": 1,
- "value": "989946",
- "address": "addr1qxm3vd0msv9ph8elhy7xrv975z88y6lr3d8vdgy3fwr2e22uvu2ffa2ctx3pdl4rjjja5p7al2k356x5yx8cn03am88s2807d9"
}
], - "outputs": [
- {
- "value": "15000",
- "index": 1,
- "txHash": "76a914fc8f50c952da910f473a0533561311ad140c989b88ac",
- "address": "addr1qxm3vd0msv9ph8elhy7xrv975z88y6lr3d8vdgy3fwr2e22uvu2ffa2ctx3pdl4rjjja5p7al2k356x5yx8cn03am88s2807d9"
}
]
}
]
Gets a Ada UTXOs by address.
OK
Bad Request. Validation failed for the given object in the HTTP Body or Request parameters.
Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
Forbidden. The request is authenticated, but it is not possible to perform the required operation due to a logical error or invalid permissions.
Internal server error. There was an error on the server while processing the request.
curl -i -X GET \ 'https://api-eu1.tatum.io/v3/ada/{address}/utxos' \ -H 'x-api-key: YOUR_API_KEY_HERE'
[- {
- "value": "15000",
- "index": 1,
- "txHash": "76a914fc8f50c952da910f473a0533561311ad140c989b88ac",
- "address": "addr1qxm3vd0msv9ph8elhy7xrv975z88y6lr3d8vdgy3fwr2e22uvu2ffa2ctx3pdl4rjjja5p7al2k356x5yx8cn03am88s2807d9"
}
]
Send Ada to blockchain addresses. It is possible to build a blockchain transaction in 2 ways:
OK
Bad Request. Validation failed for the given object in the HTTP Body or Request parameters.
Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
Forbidden. The request is authenticated, but it is not possible to perform the required operation due to a logical error or invalid permissions.
Internal server error. There was an error on the server while processing the request.
{- "changeAddress": "cVX7YtgL5muLTPncHFhP95oitV1mqUUA5VeSn8HeCRJbPqipzobf",
- "fee": "0.5",
- "fromAddress": [
- {
- "address": "2N9bBiH2qrTDrPCzrNhaFGdkNKS86PJAAAS",
- "privateKey": "cVX7YtgL5muLTPncHFhP95oitV1mqUUA5VeSn8HeCRJbPqipzobf"
}
], - "to": [
- {
- "address": "2MzNGwuKvMEvKMQogtgzSqJcH2UW3Tc5oc7",
- "value": 0.02969944
}
]
}
{- "txId": "c83f8818db43d9ba4accfe454aa44fc33123d47a4f89d47b314d6748eb0e9bc9",
- "failed": false
}
Broadcasts a signed transaction to the Ada blockchain. This method is used internally from Tatum KMS, Tatum Middleware or Tatum Client Libraries. It is possible to create a custom signing mechanism and only use this method for broadcasting data to the blockchain.
OK
Bad Request. Validation failed for the given object in the HTTP Body or Request parameters.
Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
Forbidden. The request is authenticated, but it is not possible to perform the required operation due to a logical error or invalid permissions.
Internal server error. There was an error on the server while processing the request.
{- "txData": "62BD544D1B9031EFC330A3E855CC3A0D51CA5131455C1AB3BCAC6D243F65460D",
- "signatureId": "1f7f7c0c-3906-4aa1-9dfe-4b67c43918f6"
}
{- "txId": "c83f8818db43d9ba4accfe454aa44fc33123d47a4f89d47b314d6748eb0e9bc9",
- "failed": false
}
Gets a Ada account by address.
OK
Bad Request. Validation failed for the given object in the HTTP Body or Request parameters.
Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
Forbidden. The request is authenticated, but it is not possible to perform the required operation due to a logical error or invalid permissions.
Internal server error. There was an error on the server while processing the request.
curl -i -X GET \ 'https://api-eu1.tatum.io/v3/ada/account/{address}' \ -H 'x-api-key: YOUR_API_KEY_HERE'
[- {
- "summary": {
- "utxosCount": 0,
- "assetBalances": [
- {
- "asset": {
- "assetId": "string",
- "assetName": "string",
- "name": "string",
- "description": "string",
- "logo": "string",
- "metadataHash": "string",
- "url": "string"
}, - "quantity": "string"
}
]
}
}
]