Skip to content

REST & gRPC ​

The Cosmos SDK query services, over REST (https://api.bkc.network, grpc-gateway) and gRPC (grpc.bkc.network:443, TLS).

Common REST queries ​

PathReturns
/cosmos/base/tendermint/v1beta1/node_infonetwork, node version (application_version.version)
/cosmos/base/tendermint/v1beta1/blocks/latestlatest block
/cosmos/auth/v1beta1/accounts/{bkc1…}account number and sequence (the nonce wrapped EVM calls need)
/cosmos/bank/v1beta1/balances/{bkc1…}balances (bkc, 18 decimals)
/cosmos/bank/v1beta1/supplytotal supply
/cosmos/staking/v1beta1/validatorsvalidators
/cosmos/staking/v1beta1/delegations/{bkc1…}an account's delegations
/cosmos/distribution/v1beta1/delegators/{bkc1…}/rewardspending rewards
/cosmos/gov/v1/proposalsgovernance proposals
/cosmos/tx/v1beta1/txs/{hash}a transaction with its events
/BKC/bkc/v1/paramsx/bkc parameters (allowed key types and sign modes) — note the upper-case BKC
bash
curl -s https://api.bkc.network/cosmos/auth/v1beta1/accounts/bkc1… | jq '.account.sequence'
curl -s https://api.bkc.network/cosmos/bank/v1beta1/balances/bkc1… | jq

Account types you will see: BaseAccount, and PeriodicVestingAccount for the vesting genesis wallets. Public keys are /cosmos.crypto.mldsa65.PubKey.

gRPC ​

bash
grpcurl grpc.bkc.network:443 list
grpcurl grpc.bkc.network:443 cosmos.base.tendermint.v1beta1.Service/GetLatestBlock
grpcurl -d '{"address":"bkc1…","denom":"bkc"}' grpc.bkc.network:443 cosmos.bank.v1beta1.Query/Balance
grpcurl grpc.bkc.network:443 cosmos.bank.v1beta1.Query/TotalSupply

The endpoint is TLS on 443 — do not pass -plaintext. Reflection is enabled, so list and describe work without proto files. BKC's own service is bkc.bkc.v1.Query.

Broadcasting over REST ​

POST /cosmos/tx/v1beta1/txs with {"tx_bytes": "<base64>", "mode": "BROADCAST_MODE_SYNC"} accepts a signed transaction, as an alternative to CometBFT's broadcast_tx_sync.

Simulation does not work ​

/cosmos/tx/v1beta1/simulate fails on BKC: the chain only accepts SIGN_MODE_DIRECT, and simulation signs with SIGN_MODE_UNSPECIFIED. Budget gas explicitly — see Gas & fees.

BKC testnet is unaudited. Do not hold value on it.