/extended/v3/principals/{principal}/balance-changes REST API Endpoint

Path Parameters

principal

string

REQUIRED

Loading...

Query Parameters

limit

integer

Loading...

cursor

string

Loading...

tx_id

array

REQUIRED

Loading...

Returns

total

integer

Loading...

limit

integer

Loading...

cursor

object

Loading...

next

string

Loading...

previous

string

Loading...

current

string

Loading...

results

array

Loading...

tx_id

string

Loading...

asset

object

Loading...

Loading...

type

string

Loading...

Loading...

type

string

Loading...

identifier

string

Loading...

type

string

Loading...

balance_change

object

Loading...

sent

string

Loading...

received

string

Loading...

net

string

Loading...

Request

1
curl --request GET \
2
  'https://docs-demo.stacks-mainnet.quiknode.pro/extended/v3/principals/SP5KCQ6CQAS73AMM002HMK94CCYEA4P3C94VX3K4/balance-changes?limit=1&tx_id=0x7793237893fe95cd64e8ba44c798ae7e42a51d90515f16d7bf4810a1f512c0a8' \
3
  --header 'accept: application/json'
4

1
curl --request GET \
2
  'https://docs-demo.stacks-mainnet.quiknode.pro/extended/v3/principals/SP5KCQ6CQAS73AMM002HMK94CCYEA4P3C94VX3K4/balance-changes?limit=1&tx_id=0x7793237893fe95cd64e8ba44c798ae7e42a51d90515f16d7bf4810a1f512c0a8' \
3
  --header 'accept: application/json'
4

1
const response = await fetch(
2
	'https://docs-demo.stacks-mainnet.quiknode.pro/extended/v3/principals/SP5KCQ6CQAS73AMM002HMK94CCYEA4P3C94VX3K4/balance-changes?limit=1&tx_id=0x7793237893fe95cd64e8ba44c798ae7e42a51d90515f16d7bf4810a1f512c0a8',
3
	{
4
		method: 'GET',
5
		headers: { accept: 'application/json' },
6
	}
7
)
8

9
if (!response.ok) {
10
	throw new Error(`Request failed with status ${response.status}`)
11
}
12

13
console.log(await response.json())
14

1
const response = await fetch(
2
	'https://docs-demo.stacks-mainnet.quiknode.pro/extended/v3/principals/SP5KCQ6CQAS73AMM002HMK94CCYEA4P3C94VX3K4/balance-changes?limit=1&tx_id=0x7793237893fe95cd64e8ba44c798ae7e42a51d90515f16d7bf4810a1f512c0a8',
3
	{
4
		method: 'GET',
5
		headers: { accept: 'application/json' },
6
	}
7
)
8

9
if (!response.ok) {
10
	throw new Error(`Request failed with status ${response.status}`)
11
}
12

13
console.log(await response.json())
14

1
import requests
2

3
url = "https://docs-demo.stacks-mainnet.quiknode.pro/extended/v3/principals/SP5KCQ6CQAS73AMM002HMK94CCYEA4P3C94VX3K4/balance-changes?limit=1&tx_id=0x7793237893fe95cd64e8ba44c798ae7e42a51d90515f16d7bf4810a1f512c0a8"
4
response = requests.get(url, headers={"accept": "application/json"}, timeout=30)
5
response.raise_for_status()
6

7
print(response.json())
8

1
import requests
2

3
url = "https://docs-demo.stacks-mainnet.quiknode.pro/extended/v3/principals/SP5KCQ6CQAS73AMM002HMK94CCYEA4P3C94VX3K4/balance-changes?limit=1&tx_id=0x7793237893fe95cd64e8ba44c798ae7e42a51d90515f16d7bf4810a1f512c0a8"
4
response = requests.get(url, headers={"accept": "application/json"}, timeout=30)
5
response.raise_for_status()
6

7
print(response.json())
8

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

5
url = URI("https://docs-demo.stacks-mainnet.quiknode.pro/extended/v3/principals/SP5KCQ6CQAS73AMM002HMK94CCYEA4P3C94VX3K4/balance-changes?limit=1&tx_id=0x7793237893fe95cd64e8ba44c798ae7e42a51d90515f16d7bf4810a1f512c0a8")
6
request = Net::HTTP::Get.new(url)
7
request["accept"] = "application/json"
8

9
response = Net::HTTP.start(url.hostname, url.port, use_ssl: url.scheme == "https") do |http|
10
  http.request(request)
11
end
12

13
raise "Request failed with status #{response.code}" unless response.is_a?(Net::HTTPSuccess)
14

15
puts JSON.pretty_generate(JSON.parse(response.body))
16

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

5
url = URI("https://docs-demo.stacks-mainnet.quiknode.pro/extended/v3/principals/SP5KCQ6CQAS73AMM002HMK94CCYEA4P3C94VX3K4/balance-changes?limit=1&tx_id=0x7793237893fe95cd64e8ba44c798ae7e42a51d90515f16d7bf4810a1f512c0a8")
6
request = Net::HTTP::Get.new(url)
7
request["accept"] = "application/json"
8

9
response = Net::HTTP.start(url.hostname, url.port, use_ssl: url.scheme == "https") do |http|
10
  http.request(request)
11
end
12

13
raise "Request failed with status #{response.code}" unless response.is_a?(Net::HTTPSuccess)
14

15
puts JSON.pretty_generate(JSON.parse(response.body))
16

Response

1
{
2
  "total": 1,
3
  "limit": 1,
4
  "cursor": {
5
    "next": null,
6
    "previous": null,
7
    "current": "8702017:2147483647:5:1:stx"
8
  },
9
  "results": [
10
    {
11
      "tx_id": "0x7793237893fe95cd64e8ba44c798ae7e42a51d90515f16d7bf4810a1f512c0a8",
12
      "asset": {
13
        "type": "stx"
14
      },
15
      "balance_change": {
16
        "sent": "579",
17
        "received": "0",
18
        "net": "-579"
19
      }
20
    }
21
  ]
22
}

1
{
2
  "total": 1,
3
  "limit": 1,
4
  "cursor": {
5
    "next": null,
6
    "previous": null,
7
    "current": "8702017:2147483647:5:1:stx"
8
  },
9
  "results": [
10
    {
11
      "tx_id": "0x7793237893fe95cd64e8ba44c798ae7e42a51d90515f16d7bf4810a1f512c0a8",
12
      "asset": {
13
        "type": "stx"
14
      },
15
      "balance_change": {
16
        "sent": "579",
17
        "received": "0",
18
        "net": "-579"
19
      }
20
    }
21
  ]
22
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free