Dogecoin Blockchain enables access to the most commonly used Dogecoin 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:
Tatum supports BIP44 HD wallets. It is very convenient and secure, since it can generate 2^31 addresses from 1 mnemonic phrase. Mnemonic phrase consists of 24 special words in 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 Dogecoin wallet with derivation path m'/44'/3'/0'/0. More about BIP44 HD wallets can be found here - https://github.com/litecoin/bips/blob/master/bip-0044.mediawiki. Generate BIP44 compatible Dogecoin 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 required perform operation due to logical error or invalid permissions.
Internal server error. There was an error on the server while processing the request.
{- "mnemonic": "urge pulp usage sister evidence arrest palm math please chief egg abuse",
- "xpub": "xpub6EsCk1uU6cJzqvP9CdsTiJwT2rF748YkPnhv5Qo8q44DG7nn2vbyt48YRsNSUYS44jFCW9gwvD9kLQu9AuqXpTpM1c5hgg9PsuBLdeNncid"
}
Generate Dogecoin deposit address from Extended public key. 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 required perform operation due to logical error or invalid permissions.
Internal server error. There was an error on the server while processing the request.
{- "address": "n36h3pAH7sC3z8KMB47BjbqvW2aJd2oTi7"
}
Generate private key for address from mnemonic for given derivation path index. 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 required perform operation due to 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"
}
2 credits per API call
This endpoint is deprecated. Use the HTTP-based JSON RPC driver instead.
Use this endpoint URL as an http-based JSON RPC driver to connect directly to the node provided by Tatum.
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.
{ }
{- "jsonrpc": "1.0",
- "id": "test",
- "result": 654321
}
Get Dogecoin Blockchain Information. Obtain basic info like testnet / mainnet version of the chain, current block number and it's 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 required perform operation due to logical error or invalid permissions.
Internal server error. There was an error on the server while processing the request.
{- "chain": "test",
- "blocks": 1234314,
- "headers": 1234314,
- "bestblockhash": "6178dda07b94becb118f67b21aa72f60d85c1029e9e9b8ae56a25d684de66078",
- "difficulty": 0.0018856935093586335
}
Get Dogecoin Block hash. Returns hash of the block to get the block detail.
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 required perform operation due to logical error or invalid permissions.
Internal server error. There was an error on the server while processing the request.
{- "hash": "6178dda07b94becb118f67b21aa72f60d85c1029e9e9b8ae56a25d684de66078"
}
Get Dogecoin 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.
{- "hash": "6178dda07b94becb118f67b21aa72f60d85c1029e9e9b8ae56a25d684de66078",
- "height": 1234314,
- "size": 1234314,
- "confirmations": 1234314,
- "weight": 1234314,
- "version": 536870912,
- "previousblockhash": "a3047a060e5d586a9b26779ebe62fc57ce7323745da8f28761ab755454d89c52",
- "merkleRoot": "a1634a42a8e956a5fb5225d06c3af6207e7f6fe5a00fa45229edfd0ddfa587f0",
- "time": 1572865501,
- "bits": 503452237,
- "nonce": 2278594841,
- "txs": [
- {
- "hash": "5f83d51c8d3054012cea3011fa626b85d89442788721afd60719ab1f9ab8f78a",
- "size": 145,
- "vsize": 145,
- "version": 2,
- "vin": [
- {
- "txid": "0db5a2881f26f7dce20222f9c2538dc296ab562e134a72052596bdf4bb6913b4",
- "vout": 1,
- "scriptSig": {
- "asm": "string",
- "hex": "string"
}, - "sequence": 4294967294
}
], - "vout": [
- {
- "value": 1000,
- "n": 1,
- "scriptPubKey": {
- "asm": "OP_HASH160 905c261d73922a21a16f505cefccaa07aaee50cd OP_EQUAL",
- "hex": "a914905c261d73922a21a16f505cefccaa07aaee50cd87",
- "type": "scripthash",
- "addresses": [
- "n4YNG8q5JyxkeWf7zMi1bMyRZbRKK1W7or"
]
}
}
], - "locktime": 1233222
}
]
}
Get Dogecoin 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 required perform operation due to logical error or invalid permissions.
Internal server error. There was an error on the server while processing the request.
{- "hash": "5f83d51c8d3054012cea3011fa626b85d89442788721afd60719ab1f9ab8f78a",
- "size": 145,
- "vsize": 145,
- "version": 2,
- "vin": [
- {
- "txid": "0db5a2881f26f7dce20222f9c2538dc296ab562e134a72052596bdf4bb6913b4",
- "vout": 1,
- "scriptSig": {
- "asm": "string",
- "hex": "string"
}, - "sequence": 4294967294
}
], - "vout": [
- {
- "value": 1000,
- "n": 1,
- "scriptPubKey": {
- "asm": "OP_HASH160 905c261d73922a21a16f505cefccaa07aaee50cd OP_EQUAL",
- "hex": "a914905c261d73922a21a16f505cefccaa07aaee50cd87",
- "type": "scripthash",
- "addresses": [
- "n4YNG8q5JyxkeWf7zMi1bMyRZbRKK1W7or"
]
}
}
], - "locktime": 1233222
}
Get Dogecoin 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 required perform operation due to logical error or invalid permissions.
Internal server error. There was an error on the server while processing the request.
[- {
- "hash": "5f83d51c8d3054012cea3011fa626b85d89442788721afd60719ab1f9ab8f78a",
- "witnessHash": "d819688a3ac77cb6d2751808e5411baf7e20fa3eeeccf65867554a09beddd9a3",
- "fee": "0.00001682",
- "rate": "0.00010011",
- "ps": 1572703011,
- "blockNumber": 1233224,
- "block": "b540bf37450eae0fb9fb7f190009ca890f0dd17cb19521c6241a0dc5e70f67dc",
- "ts": 1572694484,
- "index": 2,
- "version": 2,
- "flag": 1,
- "inputs": [
- {
- "prevout": {
- "hash": "0db5a2881f26f7dce20222f9c2538dc296ab562e134a72052596bdf4bb6913b4",
- "index": 1
}, - "script": "1600148c65244f095f3689aebb70981d102e33036fe786",
- "witness": "0247304402202cad8f03fd061fbdd19d285f528dd7451c3818f4a1d0f5f9f559f141fb910c6e02203fb62fc770cf54ae53e4b488b589f9f096d28c1bd24dc8e4d80783dd58041826012102c44d21e840b24c786a7eff2980e35f51c4abcc9a032e7a132ca258f90ee4a19d",
- "sequence": 4294967294,
- "coin": {
- "version": 2,
- "height": 1232869,
- "value": "0.0989946",
- "script": "a91472593295cfe5e7ea466e43822167cabcb2cb103387",
- "address": "2N3fqsiA5Nk4pZGWcfZApATGhXfn9B74oXK",
- "coinbase": false
}
}
], - "outputs": [
- {
- "value": "0.0015",
- "script": "76a914fc8f50c952da910f473a0533561311ad140c989b88ac",
- "address": "n4YNG8q5JyxkeWf7zMi1bMyRZbRKK1W7or"
}
], - "locktime": 1233222
}
]
Get Dogecoin Balance of the 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 required perform operation due to logical error or invalid permissions.
Internal server error. There was an error on the server while processing the request.
{- "incoming": "0.1234",
- "outgoing": "0.1",
- "incomingPending": "0.0004",
- "outgoingPending": "0.05"
}
50 credits per API call
Get the balance of multiple Dogecoin addresses, up to 30.
The API returns the balance only if the address has up to 50,000 UTXOs (Unspent Transaction Outputs). For an address with more than 50,000 UTXOs, the API returns an error with the 403
response code.
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.
[- {
- "incoming": "0.1234",
- "outgoing": "0.1",
- "incomingPending": "0.0004",
- "outgoingPending": "0.05"
}
]
Get Dogecoin Transaction ids in the mempool.
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 required perform operation due to logical error or invalid permissions.
Internal server error. There was an error on the server while processing the request.
[- "4c7846a8ff8415945e96937dea27bdb3144c15d793648d725602784826052586"
]
1 credit per API call
Get information about a transaction output in a transaction and check whether this output is a UTXO or has been spent.
"UTXO" stands for "Unspent Transaction Output". A UTXO is the amount of DOGE that remains at a Dogecoin address after a cryptocurrency transaction involving this address has been performed. The UTXO can then be used as input for a new cryptocurrency transaction. For more information about the UTXO, see the Bitcoin user documentation.
404
response code.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 required perform operation due to logical error or invalid permissions.
Internal server error. There was an error on the server while processing the request.
{- "scriptPubKey": {
- "asm": "OP_HASH160 905c261d73922a21a16f505cefccaa07aaee50cd OP_EQUAL",
- "hex": "a914905c261d73922a21a16f505cefccaa07aaee50cd87",
- "type": "scripthash",
- "addresses": [
- "n4YNG8q5JyxkeWf7zMi1bMyRZbRKK1W7or"
]
}, - "version": 2,
- "height": 1233224,
- "value": 1000,
- "coinbase": false,
- "bestblock": "5f83d51c8d3054012cea3011fa626b85d89442788721afd60719ab1f9ab8f78a"
}
2 credits per API call
Send DOGE to blockchain addresses.
Dogecoin transactions are based on UTXOs. "UTXO" stands for "Unspent Transaction Output". A UTXO is the amount of DOGE that remains at a Bitcoin Cash address after a cryptocurrency transaction involving this address has been performed. The UTXO can then be used as input for a new cryptocurrency transaction. For more information the UTXO, see the Bitcoin user documentation. To check UTXOs in a transaction, see the API for getting information about a transaction output (UTXO) in a Dogecoin transaction
You build a DOGE transaction by sending DOGE from UTXOs. Each UTXO is included in the transaction.
When an UTXO is entered into a transaction, the whole UTXO amount is included and must be spent. For example, address A receives two transactions, T1 with 1 DOGE and T2 with 2 DOGE. A transaction that consumes the UTXOs from both T1 and T2 will have an available amount of 3 DOGE to spend:1 DOGE (from T1) + 2 DOGE (from T2) = 3 DOGE (to spend in total)
You can send the assets to one or multiple recipients in one transaction. If you send the assets to multiple addresses, each address must have its own amount to receive.
Paying the gas fee and receiving the change
When the amount that the recipients should receive is lower than the amount from the UTXOs, the difference between these two amounts is by default used as the gas fee for the transaction. Because this amount may be considerable and you may not want to spend it all on the gas fee, you can explicitly specify the fee amount and the blockchain address where any extra funds remaining after covering the fee will be sent (the fee
and changeAddress
parameters in the request body, correspondingly).
Signing a transaction
When sending DOGE, you are charged a fee for the transaction, and you must sign the transaction with the private key of the blockchain address from which the fee will be deducted.
Providing the private key in the API is not a secure way of signing transactions, because the private key can be stolen or exposed. Your private keys should never leave your security perimeter. You should use the private keys only for testing a solution you are building on the testnet of a blockchain.
For signing transactions on the mainnet, we strongly recommend that you use the Tatum Key Management System (KMS) and provide the signature ID instead of the private key in the API. Alternatively, you can use the Tatum JavaScript client.
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 required perform operation due to logical error or invalid permissions.
Internal server error. There was an error on the server while processing the request.
{- "fromAddress": [
- {
- "address": "2MzNGwuKvMEvKMQogtgzSqJcH2UW3Tc5oc7",
- "privateKey": "cVX7YtgL5muLTPncHFhP95oitV1mqUUA5VeSn8HeCRJbPqipzobf"
}
], - "to": [
- {
- "address": "2MzNGwuKvMEvKMQogtgzSqJcH2UW3Tc5oc7",
- "value": 0.02969944
}
]
}
{- "txId": "c83f8818db43d9ba4accfe454aa44fc33123d47a4f89d47b314d6748eb0e9bc9"
}
Broadcast signed transaction to Dogecoin blockchain. This method is used internally from Tatum KMS or Tatum client libraries. It is possible to create custom signing mechanism and use this method only 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 required perform operation due to logical error or invalid permissions.
Internal server error. There was an error on the server while processing the request.
{- "txData": "62BD544D1B9031EFC330A3E855CC3A0D51CA5131455C1AB3BCAC6D243F65460D"
}
{- "txId": "c83f8818db43d9ba4accfe454aa44fc33123d47a4f89d47b314d6748eb0e9bc9"
}