Please note that this RPC method requires the Doge Blockbook enabled on your Quicknode endpoint.

Parameters

address

string

REQUIRED

An extended public key, or an output descriptor wrapping one. Supported descriptor form: pkh(...). Must be an account-level key, not a master key. Example: pkh(xpub...).

Descriptors containing a / are not supported and return an error.

This includes:

• key origin prefixes: pkh([73c5da0a/44'/3'/0']xpub...)
• multipath selectors: pkh(xpub.../<0;1>/*)
• explicit branch paths: pkh(xpub.../0/*)

Percent-encoding the slash does not help. Note the origin prefix cannot be shortened either, since it contains slashes of its own.

Use the bare form instead - pkh(xpub...) - which is fully supported. The branch selector is unnecessary: Blockbook automatically scans both the receive (0) and change (1) branches for the account.

object

object

The options object with the following fields:

page

integer

The page you would like to retrieve.

size

integer

The number of transactions you would like on each page

fromHeight

integer

Filter of the returned transactions from block height

toHeight

integer

Filter of the returned transactions to block height

details

string

Must be one of: basic|txids|txs

secondary

string

The secondary (fiat) currency in which the token and total balances are returned in addition to crypto values. Must be one of: usd|eur

filter

string

Filter transactions by token. Provide a token's contract address, or 0 to return only transactions with no token transfers.

contract

string

Limit returned token balances and transactions to the specified token contract address.

protocols

string

Comma-separated list of token protocols to include (for example erc20).

gap

integer

The gap limit used when deriving addresses from an extended public key (xpub). Defaults to 20.

Returns

page

integer

The page number returned in this response.

totalPages

integer

The number of pages available for your original query

itemsOnPage

integer

The maximum number of transactions returned in this response

address

string

The address you provided in the original query.

balance

string

The current balance of the address using confirmed unspent transaction outputs only, denominated in koinus (1 DOGE = 100,000,000 koinus). Balance is updated after 1 confirmation.

totalReceived

string

The total value received for the address using confirmed transactions only, denominated in koinus.

totalSent

string

The total value sent for the address using confirmed transactions only, denominated in koinus.

unconfirmedBalance

string

The current balance of the address using unconfirmed unspent transaction outputs only, denominated in koinus.

unconfirmedTxs

integer

The current number of unconfirmed transactions for this address.

txs

integer

The total number of transactions for this address.

txids

array

(only appears when details is set to txids) An array of transaction ids for the provided address.

txid

string

The transaction id

transactions

array

(only appears when details is set to txs) An array of transactions for the provided address.

txid

string

The transaction id

version

integer

The transaction version (1 or 2)

lockTime

integer

The earliest time a transaction could have been mined into a block.

vin

array

An array of transaction objects used as inputs for the current transaction

txid

string

The transaction id

vout

integer

The output index

sequence

integer

The transaction sequence

n

integer

The nonce of this transaction

addresses

array

An array of addresses in this transaction

isAddress

boolean

Boolean value of whether there is an address or not

isOwn

boolean

Boolean value of whether the transaction is from the original address provided

value

string

The value of this transaction in koinus

vout

array

An array of output transaction objects for the current transaction

value

string

The value of this transaction in the smallest unit of DOGE (koinu)

n

integer

The nonce of this transaction

hex

string

The raw hexadecimal representation of the transaction

spent

boolean

Boolean value of whether the transaction has been spent

addresses

array

An array of addresses in this transaction

isAddress

boolean

Boolean value of whether there is an address or not

blockHash

string

The hash of the block at which the transaction was included

height

integer

The block height at which the transaction output was created

confirmations

integer

The number of confirmations since this transaction was included in a block

blockTime

integer

The unix timestamp of when the block was confirmed

size

integer

The size of the transaction in bytes

vsize

integer

The virtual size of the transaction in bytes (read more)

value

string

The total value of the transaction in koinus

valueIn

string

The value transmitted in the transaction less fees denominated in koinus

fees

string

The fees for the transaction denominated in koinus

hex

string

The raw hexadecimal representation of the transaction

Request

1
curl -X POST "https://docs-demo.doge-mainnet.quiknode.pro/" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "jsonrpc": "2.0",
5
  "method": "bb_getXPUB",
6
  "params": [
7
    "dgub8tML3LgTrd81sv3YLffYXKXXwRBxE2bM1Y2Ct56LHuJfYkEDFSLjA7MKDQizCaAERGesrhb7T1H9fmSAerRBr8Wx7PsgZqbUU6RVzpPDzFp",
8
    {
9
      "page": 1,
10
      "size": 1000,
11
      "fromHeight": 0,
12
      "toHeight": 0,
13
      "details": "txids"
14
    }
15
  ],
16
  "id": 1
17
}'

1
curl -X POST "https://docs-demo.doge-mainnet.quiknode.pro/" \
2
  -H "Content-Type: application/json" \
3
  -d '{
4
  "jsonrpc": "2.0",
5
  "method": "bb_getXPUB",
6
  "params": [
7
    "dgub8tML3LgTrd81sv3YLffYXKXXwRBxE2bM1Y2Ct56LHuJfYkEDFSLjA7MKDQizCaAERGesrhb7T1H9fmSAerRBr8Wx7PsgZqbUU6RVzpPDzFp",
8
    {
9
      "page": 1,
10
      "size": 1000,
11
      "fromHeight": 0,
12
      "toHeight": 0,
13
      "details": "txids"
14
    }
15
  ],
16
  "id": 1
17
}'

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'bb_getXPUB',
4
    params: ["dgub8tML3LgTrd81sv3YLffYXKXXwRBxE2bM1Y2Ct56LHuJfYkEDFSLjA7MKDQizCaAERGesrhb7T1H9fmSAerRBr8Wx7PsgZqbUU6RVzpPDzFp",{"page":1,"size":1000,"fromHeight":0,"toHeight":0,"details":"txids"}],
5
    id: 1
6
}
7

8
async function main() {
9
    const response = await fetch('https://docs-demo.doge-mainnet.quiknode.pro/', {
10
        method: 'POST',
11
        headers: {'Content-Type': 'application/json'},
12
        body: JSON.stringify(body)
13
    })
14
    const data = await response.json()
15
    console.log(data)
16
}
17

18
main()

1
const body = {
2
    jsonrpc: '2.0',
3
    method: 'bb_getXPUB',
4
    params: ["dgub8tML3LgTrd81sv3YLffYXKXXwRBxE2bM1Y2Ct56LHuJfYkEDFSLjA7MKDQizCaAERGesrhb7T1H9fmSAerRBr8Wx7PsgZqbUU6RVzpPDzFp",{"page":1,"size":1000,"fromHeight":0,"toHeight":0,"details":"txids"}],
5
    id: 1
6
}
7

8
async function main() {
9
    const response = await fetch('https://docs-demo.doge-mainnet.quiknode.pro/', {
10
        method: 'POST',
11
        headers: {'Content-Type': 'application/json'},
12
        body: JSON.stringify(body)
13
    })
14
    const data = await response.json()
15
    console.log(data)
16
}
17

18
main()

1
import requests
2
import json
3

4
url = "https://docs-demo.doge-mainnet.quiknode.pro/"
5

6
payload = json.dumps({
7
  "jsonrpc": "2.0",
8
  "method": "bb_getXPUB",
9
  "params": [
10
    "dgub8tML3LgTrd81sv3YLffYXKXXwRBxE2bM1Y2Ct56LHuJfYkEDFSLjA7MKDQizCaAERGesrhb7T1H9fmSAerRBr8Wx7PsgZqbUU6RVzpPDzFp",
11
    {
12
      "page": 1,
13
      "size": 1000,
14
      "fromHeight": 0,
15
      "toHeight": 0,
16
      "details": "txids"
17
    }
18
  ],
19
  "id": 1
20
})
21
headers = {
22
  'Content-Type': 'application/json'
23
}
24

25
response = requests.request("POST", url, headers=headers, data=payload)
26

27
print(response.text)

1
import requests
2
import json
3

4
url = "https://docs-demo.doge-mainnet.quiknode.pro/"
5

6
payload = json.dumps({
7
  "jsonrpc": "2.0",
8
  "method": "bb_getXPUB",
9
  "params": [
10
    "dgub8tML3LgTrd81sv3YLffYXKXXwRBxE2bM1Y2Ct56LHuJfYkEDFSLjA7MKDQizCaAERGesrhb7T1H9fmSAerRBr8Wx7PsgZqbUU6RVzpPDzFp",
11
    {
12
      "page": 1,
13
      "size": 1000,
14
      "fromHeight": 0,
15
      "toHeight": 0,
16
      "details": "txids"
17
    }
18
  ],
19
  "id": 1
20
})
21
headers = {
22
  'Content-Type': 'application/json'
23
}
24

25
response = requests.request("POST", url, headers=headers, data=payload)
26

27
print(response.text)

1
require "uri"
2
require "json"
3
require "net/http"
4

5
uri = URI("https://docs-demo.doge-mainnet.quiknode.pro/")
6

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "bb_getXPUB",
11
  params: ["dgub8tML3LgTrd81sv3YLffYXKXXwRBxE2bM1Y2Ct56LHuJfYkEDFSLjA7MKDQizCaAERGesrhb7T1H9fmSAerRBr8Wx7PsgZqbUU6RVzpPDzFp",{"page":1,"size":1000,"fromHeight":0,"toHeight":0,"details":"txids"}]
12
}
13

14
request = Net::HTTP::Post.new(uri)
15
request["Content-Type"] = "application/json"
16
request.body = JSON.generate(payload)
17

18
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
19
  http.request(request)
20
end
21

22
puts response.body

1
require "uri"
2
require "json"
3
require "net/http"
4

5
uri = URI("https://docs-demo.doge-mainnet.quiknode.pro/")
6

7
payload = {
8
  jsonrpc: "2.0",
9
  id: 1,
10
  method: "bb_getXPUB",
11
  params: ["dgub8tML3LgTrd81sv3YLffYXKXXwRBxE2bM1Y2Ct56LHuJfYkEDFSLjA7MKDQizCaAERGesrhb7T1H9fmSAerRBr8Wx7PsgZqbUU6RVzpPDzFp",{"page":1,"size":1000,"fromHeight":0,"toHeight":0,"details":"txids"}]
12
}
13

14
request = Net::HTTP::Post.new(uri)
15
request["Content-Type"] = "application/json"
16
request.body = JSON.generate(payload)
17

18
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
19
  http.request(request)
20
end
21

22
puts response.body

Response

1
{
2
  "jsonrpc": "2.0",
3
  "id": 1,
4
  "result": {
5
    "page": 1,
6
    "totalPages": 1,
7
    "itemsOnPage": 3,
8
    "address": "dgub8tML3LgTrd81sv3YLffYXKXXwRBxE2bM1Y2Ct56LHuJfYkEDFSLjA7MKDQizCaAERGesrhb7T1H9fmSAerRBr8Wx7PsgZqbUU6RVzpPDzFp",
9
    "balance": "0",
10
    "totalReceived": "0",
11
    "totalSent": "0",
12
    "unconfirmedBalance": "0",
13
    "unconfirmedTxs": 0,
14
    "txs": 0
15
  }
16
}

1
{
2
  "jsonrpc": "2.0",
3
  "id": 1,
4
  "result": {
5
    "page": 1,
6
    "totalPages": 1,
7
    "itemsOnPage": 3,
8
    "address": "dgub8tML3LgTrd81sv3YLffYXKXXwRBxE2bM1Y2Ct56LHuJfYkEDFSLjA7MKDQizCaAERGesrhb7T1H9fmSAerRBr8Wx7PsgZqbUU6RVzpPDzFp",
9
    "balance": "0",
10
    "totalReceived": "0",
11
    "totalSent": "0",
12
    "unconfirmedBalance": "0",
13
    "unconfirmedTxs": 0,
14
    "txs": 0
15
  }
16
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free