Please note that this REST method requires the BTC Blockbook enabled on your Quicknode endpoint.

Path Parameters

address

string

REQUIRED

A Bitcoin address to query.

Query Parameters

page

integer

The page number to retrieve for paginated results.

size

integer

The number of transactions per page.

fromHeight

integer

Filter transactions from this block height (inclusive).

details

string

Level of detail for returned transactions. Must be one of: basic, txids, or txs.

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).

Returns

page

integer

Current page number

totalPages

integer

Total number of pages

itemsOnPage

integer

Number of items on each page

address

string

The queried address

balance

string

Current confirmed balance in satoshis

totalReceived

string

Total amount received in satoshis

totalSent

string

Total amount sent in satoshis

unconfirmedBalance

string

Unconfirmed balance in satoshis

unconfirmedTxs

integer

Number of unconfirmed transactions

txs

integer

Total number of transactions

txids

array

List of transaction IDs associated with the address

Request

1
curl -X GET "https://docs-demo.btc.quiknode.pro/address/bc1qwfgdjyy95aay2686fn74h6a4nu9eev6np7q4fn204dkj3274frlqrskvx0?page=1&size=1000&fromHeight=0&details=txids" \
2
  -H "Content-Type: application/json" \
3
  -H "Accept: application/json"

1
curl -X GET "https://docs-demo.btc.quiknode.pro/address/bc1qwfgdjyy95aay2686fn74h6a4nu9eev6np7q4fn204dkj3274frlqrskvx0?page=1&size=1000&fromHeight=0&details=txids" \
2
  -H "Content-Type: application/json" \
3
  -H "Accept: application/json"

1
async function main() {
2
    const response = await fetch('https://docs-demo.btc.quiknode.pro/address/bc1qwfgdjyy95aay2686fn74h6a4nu9eev6np7q4fn204dkj3274frlqrskvx0?page=1&size=1000&fromHeight=0&details=txids', {
3
        method: 'GET',
4
        headers: {'Content-Type': 'application/json', 'Accept': 'application/json'}
5
    })
6
    const data = await response.json()
7
    console.log(data)
8
}
9

10
main()

1
async function main() {
2
    const response = await fetch('https://docs-demo.btc.quiknode.pro/address/bc1qwfgdjyy95aay2686fn74h6a4nu9eev6np7q4fn204dkj3274frlqrskvx0?page=1&size=1000&fromHeight=0&details=txids', {
3
        method: 'GET',
4
        headers: {'Content-Type': 'application/json', 'Accept': 'application/json'}
5
    })
6
    const data = await response.json()
7
    console.log(data)
8
}
9

10
main()

1
import requests
2
import json
3

4
url = "https://docs-demo.btc.quiknode.pro/address/bc1qwfgdjyy95aay2686fn74h6a4nu9eev6np7q4fn204dkj3274frlqrskvx0?page=1&size=1000&fromHeight=0&details=txids"
5

6
headers = {
7
  'Content-Type': 'application/json',
8
  'Accept': 'application/json'
9
}
10

11
response = requests.request("GET", url, headers=headers)
12

13
print(response.text)

1
import requests
2
import json
3

4
url = "https://docs-demo.btc.quiknode.pro/address/bc1qwfgdjyy95aay2686fn74h6a4nu9eev6np7q4fn204dkj3274frlqrskvx0?page=1&size=1000&fromHeight=0&details=txids"
5

6
headers = {
7
  'Content-Type': 'application/json',
8
  'Accept': 'application/json'
9
}
10

11
response = requests.request("GET", url, headers=headers)
12

13
print(response.text)

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

5
uri = URI("https://docs-demo.btc.quiknode.pro/address/bc1qwfgdjyy95aay2686fn74h6a4nu9eev6np7q4fn204dkj3274frlqrskvx0?page=1&size=1000&fromHeight=0&details=txids")
6

7
request = Net::HTTP::Get.new(uri)
8
request["Content-Type"] = "application/json"
9
request["Accept"] = "application/json"
10

11
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
12
  http.request(request)
13
end
14

15
puts response.body

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

5
uri = URI("https://docs-demo.btc.quiknode.pro/address/bc1qwfgdjyy95aay2686fn74h6a4nu9eev6np7q4fn204dkj3274frlqrskvx0?page=1&size=1000&fromHeight=0&details=txids")
6

7
request = Net::HTTP::Get.new(uri)
8
request["Content-Type"] = "application/json"
9
request["Accept"] = "application/json"
10

11
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
12
  http.request(request)
13
end
14

15
puts response.body

Response

1
{
2
  "page": 1,
3
  "totalPages": 2239,
4
  "itemsOnPage": 1000,
5
  "address": "bc1qwfgdjyy95aay2686fn74h6a4nu9eev6np7q4fn204dkj3274frlqrskvx0",
6
  "balance": "58481617684",
7
  "totalReceived": "258362172527834",
8
  "totalSent": "258303690910150",
9
  "unconfirmedBalance": "283071683",
10
  "unconfirmedTxs": 2,
11
  "txs": 2238268,
12
  "txids": [
13
    "cff070284ec7c8f5e768ee9d3cd1a475887a5abceefd52280d0b984e867a4e6a",
14
    "36cbe7640c21570f74113be468b47315291c915a849344e0f4078dca78ac5760",
15
    "959bb7b066f8e8cfccb6f089eccdc1d1d84ed5199a2d35771465b2558e2d5339"
16
  ]
17
}

1
{
2
  "page": 1,
3
  "totalPages": 2239,
4
  "itemsOnPage": 1000,
5
  "address": "bc1qwfgdjyy95aay2686fn74h6a4nu9eev6np7q4fn204dkj3274frlqrskvx0",
6
  "balance": "58481617684",
7
  "totalReceived": "258362172527834",
8
  "totalSent": "258303690910150",
9
  "unconfirmedBalance": "283071683",
10
  "unconfirmedTxs": 2,
11
  "txs": 2238268,
12
  "txids": [
13
    "cff070284ec7c8f5e768ee9d3cd1a475887a5abceefd52280d0b984e867a4e6a",
14
    "36cbe7640c21570f74113be468b47315291c915a849344e0f4078dca78ac5760",
15
    "959bb7b066f8e8cfccb6f089eccdc1d1d84ed5199a2d35771465b2558e2d5339"
16
  ]
17
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free