/cosmos/bank/v1beta1/balances/{address}/by_denom REST API Endpoint

Path Parameters

address

string

REQUIRED

Loading...

Query Parameters

denom

string

Loading...

Returns

balances

array

Loading...

denom

string

Loading...

amount

string

Loading...

pagination

object

Loading...

next_key

string

Loading...

total

string

Loading...

Request

1
curl --location 'https://docs-demo.cosmos-mainnet.quiknode.pro/cosmos/bank/v1beta1/balances/cosmos1x6m7cwjd4wlr44ezq6sgcqv7whjm9pkqtgqq3y?by_denom=usei'

1
curl --location 'https://docs-demo.cosmos-mainnet.quiknode.pro/cosmos/bank/v1beta1/balances/cosmos1x6m7cwjd4wlr44ezq6sgcqv7whjm9pkqtgqq3y?by_denom=usei'

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 := "cosmos1x6m7cwjd4wlr44ezq6sgcqv7whjm9pkqtgqq3y"
22
	denom := "usei"
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 := "cosmos1x6m7cwjd4wlr44ezq6sgcqv7whjm9pkqtgqq3y"
22
	denom := "usei"
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.cosmos-mainnet.quiknode.pro/cosmos/bank/v1beta1/balances/cosmos1x6m7cwjd4wlr44ezq6sgcqv7whjm9pkqtgqq3y?by_denom=usei", 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.cosmos-mainnet.quiknode.pro/cosmos/bank/v1beta1/balances/cosmos1x6m7cwjd4wlr44ezq6sgcqv7whjm9pkqtgqq3y?by_denom=usei", 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.cosmos-mainnet.quiknode.pro/cosmos/bank/v1beta1/balances/cosmos1x6m7cwjd4wlr44ezq6sgcqv7whjm9pkqtgqq3y?by_denom=usei"
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.cosmos-mainnet.quiknode.pro/cosmos/bank/v1beta1/balances/cosmos1x6m7cwjd4wlr44ezq6sgcqv7whjm9pkqtgqq3y?by_denom=usei"
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.cosmos-mainnet.quiknode.pro/cosmos/bank/v1beta1/balances/cosmos1x6m7cwjd4wlr44ezq6sgcqv7whjm9pkqtgqq3y?by_denom=usei")
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.cosmos-mainnet.quiknode.pro/cosmos/bank/v1beta1/balances/cosmos1x6m7cwjd4wlr44ezq6sgcqv7whjm9pkqtgqq3y?by_denom=usei")
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