Path Parameters

address

string

REQUIRED

The address to query balances for

Query Parameters

denom

string

The coin denom to query balances for (e.g., amoca)

Returns

balances

array

An array of balances of all the coins

denom

string

The denomination or identifier of the token

amount

string

The amount of the token held by the address

pagination

object

The pagination object which contains the following fields:

next_key

string

The key to be passed to PageRequest.key to query the next page most efficiently. It will be empty if there are no more results

total

string

The total number of results available if PageRequest.count_total was set, its value is undefined otherwise

Request

1
curl --location 'https://docs-demo.moca-testnet.quiknode.pro/cosmos/bank/v1beta1/balances/0xF129D121D1A660dc8274bD40374D8dc51880E3F0?by_denom=amoca'

1
curl --location 'https://docs-demo.moca-testnet.quiknode.pro/cosmos/bank/v1beta1/balances/0xF129D121D1A660dc8274bD40374D8dc51880E3F0?by_denom=amoca'

1
package main
2

3
import (
4
	"context"
5
	banktypes "cosmossdk.io/api/cosmos/bank/v1beta1"
6
	"fmt"
7
	"google.golang.org/grpc"
8
	"log"
9
)
10

11
func main() {
12
	endpoint := "YOUR_QUICKNODE_ENDPOINT"
13
	target, opts := getGrpcOptions(endpoint)
14
	grpcConn, err := grpc.Dial(target, opts...)
15
	if err != nil {
16
		log.Fatal(err)
17
	}
18
	defer grpcConn.Close()
19

20
	bankClient := banktypes.NewQueryClient(grpcConn)
21
	address := "0xF129D121D1A660dc8274bD40374D8dc51880E3F0"
22
	denom := "amoca"
23
	balanceReq := &banktypes.QueryBalanceRequest{
24
		Address: address,
25
		Denom:   denom,
26
	}
27
	resp, err := bankClient.Balance(context.Background(), balanceReq)
28
	if err != nil {
29
		log.Fatal(err)
30
	}
31
	fmt.Println("coin balance: ", resp.Balance.Denom, resp.Balance.Amount)
32
}
33

1
package main
2

3
import (
4
	"context"
5
	banktypes "cosmossdk.io/api/cosmos/bank/v1beta1"
6
	"fmt"
7
	"google.golang.org/grpc"
8
	"log"
9
)
10

11
func main() {
12
	endpoint := "YOUR_QUICKNODE_ENDPOINT"
13
	target, opts := getGrpcOptions(endpoint)
14
	grpcConn, err := grpc.Dial(target, opts...)
15
	if err != nil {
16
		log.Fatal(err)
17
	}
18
	defer grpcConn.Close()
19

20
	bankClient := banktypes.NewQueryClient(grpcConn)
21
	address := "0xF129D121D1A660dc8274bD40374D8dc51880E3F0"
22
	denom := "amoca"
23
	balanceReq := &banktypes.QueryBalanceRequest{
24
		Address: address,
25
		Denom:   denom,
26
	}
27
	resp, err := bankClient.Balance(context.Background(), balanceReq)
28
	if err != nil {
29
		log.Fatal(err)
30
	}
31
	fmt.Println("coin balance: ", resp.Balance.Denom, resp.Balance.Amount)
32
}
33

1
const requestOptions = {
2
    method: "GET",
3
    redirect: "follow"
4
  };
5
  
6
  fetch("https://docs-demo.moca-testnet.quiknode.pro/cosmos/bank/v1beta1/balances/0xF129D121D1A660dc8274bD40374D8dc51880E3F0?by_denom=amoca", requestOptions)
7
    .then((response) => response.text())
8
    .then((result) => console.log(result))
9
    .catch((error) => console.error(error));

1
const requestOptions = {
2
    method: "GET",
3
    redirect: "follow"
4
  };
5
  
6
  fetch("https://docs-demo.moca-testnet.quiknode.pro/cosmos/bank/v1beta1/balances/0xF129D121D1A660dc8274bD40374D8dc51880E3F0?by_denom=amoca", requestOptions)
7
    .then((response) => response.text())
8
    .then((result) => console.log(result))
9
    .catch((error) => console.error(error));

1
import requests
2

3
url = "https://docs-demo.moca-testnet.quiknode.pro/cosmos/bank/v1beta1/balances/0xF129D121D1A660dc8274bD40374D8dc51880E3F0?by_denom=amoca"
4

5
payload = {}
6
headers = {}
7

8
response = requests.request("GET", url, headers=headers, data=payload)
9

10
print(response.text)
11

1
import requests
2

3
url = "https://docs-demo.moca-testnet.quiknode.pro/cosmos/bank/v1beta1/balances/0xF129D121D1A660dc8274bD40374D8dc51880E3F0?by_denom=amoca"
4

5
payload = {}
6
headers = {}
7

8
response = requests.request("GET", url, headers=headers, data=payload)
9

10
print(response.text)
11

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

4
url = URI("https://docs-demo.moca-testnet.quiknode.pro/cosmos/bank/v1beta1/balances/0xF129D121D1A660dc8274bD40374D8dc51880E3F0?by_denom=amoca")
5

6
http = Net::HTTP.new(url.host, url.port);
7
request = Net::HTTP::Get.new(url)
8

9
response = http.request(request)
10
puts response.read_body
11

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

4
url = URI("https://docs-demo.moca-testnet.quiknode.pro/cosmos/bank/v1beta1/balances/0xF129D121D1A660dc8274bD40374D8dc51880E3F0?by_denom=amoca")
5

6
http = Net::HTTP.new(url.host, url.port);
7
request = Net::HTTP::Get.new(url)
8

9
response = http.request(request)
10
puts response.read_body
11

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free