Parameters

address

string

The Injective account address whose CW20 balances are requested.

limit

integer

The maximum number of records to return.

Returns

field

array

The CW20 balances that match the request.

contract_address

string

The Injective address of the CW20 token contract.

account

string

The Injective account address associated with the CW20 balance.

balance

string

The CW20 token balance for the account, represented as a decimal string.

updated_at

string

The latest CW20 balance update time expressed in Unix milliseconds.

cw20_metadata

object

The indexed token and marketing metadata for the CW20 contract.

token_info

object

The name, symbol, decimals, and total supply of the CW20 token.

name

string

The human-readable name of the CW20 token.

symbol

string

The ticker symbol of the CW20 token.

decimals

string

The number of decimal places used by the CW20 token.

total_supply

string

The total CW20 token supply, represented as a decimal string.

marketing_info

object

The project, description, logo, and marketing address published for the CW20 token.

project

string

The project information published in the CW20 marketing metadata.

description

string

The project description published in the CW20 marketing metadata.

logo

string

The URL or embedded representation of the CW20 token logo.

marketing

string

The optional marketing metadata published by the CW20 token contract, base64-encoded in JSON responses.

Request

1
package main
2

3
import (
4
	"context"
5
	"crypto/tls"
6
	"fmt"
7
	"log"
8
	"time"
9

10
	"google.golang.org/grpc"
11
	"google.golang.org/grpc/credentials"
12
	"google.golang.org/grpc/metadata"
13
	"google.golang.org/protobuf/encoding/protojson"
14

15
	pb "injective-indexer-grpc/pb/explorer"
16
)
17

18
const grpcEndpoint = "YOUR_ENDPOINT_NAME.injective-mainnet.quiknode.pro:443"
19
const authToken = "YOUR_TOKEN"
20

21
func main() {
22
	creds := credentials.NewTLS(&tls.Config{MinVersion: tls.VersionTLS12})
23
	conn, err := grpc.Dial(grpcEndpoint, grpc.WithTransportCredentials(creds))
24
	if err != nil {
25
		log.Fatal(err)
26
	}
27
	defer conn.Close()
28

29
	ctx, cancel := context.WithTimeout(context.Background(), 20*time.Second)
30
	defer cancel()
31
	ctx = metadata.AppendToOutgoingContext(ctx, "x-token", authToken)
32

33
	client := pb.NewInjectiveExplorerRPCClient(conn)
34
	request := &pb.GetCw20BalanceRequest{}
35
	requestJSON := `{"address":"inj13rqjnfdlwqqkgfszzmdd7fjl8qwguf0n95jcpp","limit":1}`
36
	if err := protojson.Unmarshal([]byte(requestJSON), request); err != nil {
37
		log.Fatal(err)
38
	}
39

40
	response, err := client.GetCw20Balance(ctx, request)
41
	if err != nil {
42
		log.Fatal(err)
43
	}
44

45
	data, err := protojson.MarshalOptions{UseProtoNames: true, Indent: "  "}.Marshal(response)
46
	if err != nil {
47
		log.Fatal(err)
48
	}
49
	data = append(data, '\n')
50
	fmt.Print(string(data))
51
}
52

1
package main
2

3
import (
4
	"context"
5
	"crypto/tls"
6
	"fmt"
7
	"log"
8
	"time"
9

10
	"google.golang.org/grpc"
11
	"google.golang.org/grpc/credentials"
12
	"google.golang.org/grpc/metadata"
13
	"google.golang.org/protobuf/encoding/protojson"
14

15
	pb "injective-indexer-grpc/pb/explorer"
16
)
17

18
const grpcEndpoint = "YOUR_ENDPOINT_NAME.injective-mainnet.quiknode.pro:443"
19
const authToken = "YOUR_TOKEN"
20

21
func main() {
22
	creds := credentials.NewTLS(&tls.Config{MinVersion: tls.VersionTLS12})
23
	conn, err := grpc.Dial(grpcEndpoint, grpc.WithTransportCredentials(creds))
24
	if err != nil {
25
		log.Fatal(err)
26
	}
27
	defer conn.Close()
28

29
	ctx, cancel := context.WithTimeout(context.Background(), 20*time.Second)
30
	defer cancel()
31
	ctx = metadata.AppendToOutgoingContext(ctx, "x-token", authToken)
32

33
	client := pb.NewInjectiveExplorerRPCClient(conn)
34
	request := &pb.GetCw20BalanceRequest{}
35
	requestJSON := `{"address":"inj13rqjnfdlwqqkgfszzmdd7fjl8qwguf0n95jcpp","limit":1}`
36
	if err := protojson.Unmarshal([]byte(requestJSON), request); err != nil {
37
		log.Fatal(err)
38
	}
39

40
	response, err := client.GetCw20Balance(ctx, request)
41
	if err != nil {
42
		log.Fatal(err)
43
	}
44

45
	data, err := protojson.MarshalOptions{UseProtoNames: true, Indent: "  "}.Marshal(response)
46
	if err != nil {
47
		log.Fatal(err)
48
	}
49
	data = append(data, '\n')
50
	fmt.Print(string(data))
51
}
52

1
const grpc = require('@grpc/grpc-js')
2
const protoLoader = require('@grpc/proto-loader')
3
const path = require('path')
4

5
const GRPC_ENDPOINT = 'YOUR_ENDPOINT_NAME.injective-mainnet.quiknode.pro:443'
6
const AUTH_TOKEN = 'YOUR_TOKEN'
7

8
const definition = protoLoader.loadSync(
9
	path.join(__dirname, 'proto/explorer/injective_explorer_rpc.proto'),
10
	{
11
		keepCase: true,
12
		longs: String,
13
		enums: String,
14
		bytes: String,
15
		defaults: true,
16
		oneofs: true,
17
	}
18
)
19

20
const proto = grpc.loadPackageDefinition(definition).injective_explorer_rpc
21
const client = new proto.InjectiveExplorerRPC(
22
	GRPC_ENDPOINT,
23
	grpc.credentials.createSsl()
24
)
25

26
const metadata = new grpc.Metadata()
27
metadata.add('x-token', AUTH_TOKEN)
28

29
const request = {
30
	address: 'inj13rqjnfdlwqqkgfszzmdd7fjl8qwguf0n95jcpp',
31
	limit: 1,
32
}
33

34
client.GetCw20Balance(
35
	request,
36
	metadata,
37
	{ deadline: Date.now() + 20000 },
38
	(error, response) => {
39
		if (error) {
40
			console.error(error)
41
			process.exitCode = 1
42
			return
43
		}
44

45
		console.log(JSON.stringify(response, null, 2))
46
		client.close()
47
	}
48
)
49

1
const grpc = require('@grpc/grpc-js')
2
const protoLoader = require('@grpc/proto-loader')
3
const path = require('path')
4

5
const GRPC_ENDPOINT = 'YOUR_ENDPOINT_NAME.injective-mainnet.quiknode.pro:443'
6
const AUTH_TOKEN = 'YOUR_TOKEN'
7

8
const definition = protoLoader.loadSync(
9
	path.join(__dirname, 'proto/explorer/injective_explorer_rpc.proto'),
10
	{
11
		keepCase: true,
12
		longs: String,
13
		enums: String,
14
		bytes: String,
15
		defaults: true,
16
		oneofs: true,
17
	}
18
)
19

20
const proto = grpc.loadPackageDefinition(definition).injective_explorer_rpc
21
const client = new proto.InjectiveExplorerRPC(
22
	GRPC_ENDPOINT,
23
	grpc.credentials.createSsl()
24
)
25

26
const metadata = new grpc.Metadata()
27
metadata.add('x-token', AUTH_TOKEN)
28

29
const request = {
30
	address: 'inj13rqjnfdlwqqkgfszzmdd7fjl8qwguf0n95jcpp',
31
	limit: 1,
32
}
33

34
client.GetCw20Balance(
35
	request,
36
	metadata,
37
	{ deadline: Date.now() + 20000 },
38
	(error, response) => {
39
		if (error) {
40
			console.error(error)
41
			process.exitCode = 1
42
			return
43
		}
44

45
		console.log(JSON.stringify(response, null, 2))
46
		client.close()
47
	}
48
)
49

1
import json
2
import grpc
3
from google.protobuf.json_format import MessageToJson, ParseDict
4
from explorer import injective_explorer_rpc_pb2
5
from explorer import injective_explorer_rpc_pb2_grpc
6

7
GRPC_ENDPOINT = "YOUR_ENDPOINT_NAME.injective-mainnet.quiknode.pro:443"
8
AUTH_TOKEN = "YOUR_TOKEN"
9

10
channel = grpc.secure_channel(GRPC_ENDPOINT, grpc.ssl_channel_credentials())
11
client = injective_explorer_rpc_pb2_grpc.InjectiveExplorerRPCStub(channel)
12
metadata = (("x-token", AUTH_TOKEN),)
13

14
request_data = {
15
  "address": "inj13rqjnfdlwqqkgfszzmdd7fjl8qwguf0n95jcpp",
16
  "limit": 1
17
}
18
request = ParseDict(request_data, injective_explorer_rpc_pb2.GetCw20BalanceRequest())
19

20
try:
21
    response = client.GetCw20Balance(request, metadata=metadata, timeout=20)
22
    print(MessageToJson(response, preserving_proto_field_name=True, indent=2))
23
except grpc.RpcError as error:
24
    print(f"gRPC error {error.code().name}: {error.details()}")
25
    raise
26
finally:
27
    channel.close()
28

1
import json
2
import grpc
3
from google.protobuf.json_format import MessageToJson, ParseDict
4
from explorer import injective_explorer_rpc_pb2
5
from explorer import injective_explorer_rpc_pb2_grpc
6

7
GRPC_ENDPOINT = "YOUR_ENDPOINT_NAME.injective-mainnet.quiknode.pro:443"
8
AUTH_TOKEN = "YOUR_TOKEN"
9

10
channel = grpc.secure_channel(GRPC_ENDPOINT, grpc.ssl_channel_credentials())
11
client = injective_explorer_rpc_pb2_grpc.InjectiveExplorerRPCStub(channel)
12
metadata = (("x-token", AUTH_TOKEN),)
13

14
request_data = {
15
  "address": "inj13rqjnfdlwqqkgfszzmdd7fjl8qwguf0n95jcpp",
16
  "limit": 1
17
}
18
request = ParseDict(request_data, injective_explorer_rpc_pb2.GetCw20BalanceRequest())
19

20
try:
21
    response = client.GetCw20Balance(request, metadata=metadata, timeout=20)
22
    print(MessageToJson(response, preserving_proto_field_name=True, indent=2))
23
except grpc.RpcError as error:
24
    print(f"gRPC error {error.code().name}: {error.details()}")
25
    raise
26
finally:
27
    channel.close()
28

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free