/extended/v3/principals/{principal}/balances/ft/{asset_identifier} REST API Endpoint

Path Parameters

principal

string

REQUIRED

Loading...

asset_identifier

string

REQUIRED

Loading...

Returns

asset_identifier

string

Loading...

balance

string

Loading...

Request

1
curl --request GET \
2
  'https://docs-demo.stacks-mainnet.quiknode.pro/extended/v3/principals/SP5KCQ6CQAS73AMM002HMK94CCYEA4P3C94VX3K4/balances/ft/SM3VDXK3WZZSA84XXFKAFAF15NNZX32CTSG82JFQ4.sbtc-token::sbtc-token' \
3
  --header 'accept: application/json'
4

1
curl --request GET \
2
  'https://docs-demo.stacks-mainnet.quiknode.pro/extended/v3/principals/SP5KCQ6CQAS73AMM002HMK94CCYEA4P3C94VX3K4/balances/ft/SM3VDXK3WZZSA84XXFKAFAF15NNZX32CTSG82JFQ4.sbtc-token::sbtc-token' \
3
  --header 'accept: application/json'
4

1
const response = await fetch(
2
	'https://docs-demo.stacks-mainnet.quiknode.pro/extended/v3/principals/SP5KCQ6CQAS73AMM002HMK94CCYEA4P3C94VX3K4/balances/ft/SM3VDXK3WZZSA84XXFKAFAF15NNZX32CTSG82JFQ4.sbtc-token::sbtc-token',
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/balances/ft/SM3VDXK3WZZSA84XXFKAFAF15NNZX32CTSG82JFQ4.sbtc-token::sbtc-token',
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/balances/ft/SM3VDXK3WZZSA84XXFKAFAF15NNZX32CTSG82JFQ4.sbtc-token::sbtc-token"
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/balances/ft/SM3VDXK3WZZSA84XXFKAFAF15NNZX32CTSG82JFQ4.sbtc-token::sbtc-token"
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/balances/ft/SM3VDXK3WZZSA84XXFKAFAF15NNZX32CTSG82JFQ4.sbtc-token::sbtc-token")
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/balances/ft/SM3VDXK3WZZSA84XXFKAFAF15NNZX32CTSG82JFQ4.sbtc-token::sbtc-token")
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
  "asset_identifier": "SM3VDXK3WZZSA84XXFKAFAF15NNZX32CTSG82JFQ4.sbtc-token::sbtc-token",
3
  "balance": "0"
4
}

1
{
2
  "asset_identifier": "SM3VDXK3WZZSA84XXFKAFAF15NNZX32CTSG82JFQ4.sbtc-token::sbtc-token",
3
  "balance": "0"
4
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free