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
| Path | Returns |
|---|---|
/cosmos/base/tendermint/v1beta1/node_info | network, node version (application_version.version) |
/cosmos/base/tendermint/v1beta1/blocks/latest | latest 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/supply | total supply |
/cosmos/staking/v1beta1/validators | validators |
/cosmos/staking/v1beta1/delegations/{bkc1…} | an account's delegations |
/cosmos/distribution/v1beta1/delegators/{bkc1…}/rewards | pending rewards |
/cosmos/gov/v1/proposals | governance proposals |
/cosmos/tx/v1beta1/txs/{hash} | a transaction with its events |
/BKC/bkc/v1/params | x/bkc parameters (allowed key types and sign modes) — note the upper-case BKC |
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… | jqAccount types you will see: BaseAccount, and PeriodicVestingAccount for the vesting genesis wallets. Public keys are /cosmos.crypto.mldsa65.PubKey.
gRPC
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/TotalSupplyThe 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.
