REST API
Every QUAC node can serve the standard Cosmos SDK REST API (gRPC-gateway) on port 1317. On the public testnet it is published at:
https://testnet-api.quantcoin.world
All responses are JSON. Amounts are strings in uquac. Binary fields such as hashes, keys and signatures are base64. Browsers may call the API from any origin (CORS *).
Chain and blocks
| Method & path | Returns |
|---|---|
GET /cosmos/base/tendermint/v1beta1/node_info |
Chain ID, node software versions |
GET /cosmos/base/tendermint/v1beta1/syncing |
{"syncing": false} once caught up |
GET /cosmos/base/tendermint/v1beta1/blocks/latest |
Latest block |
GET /cosmos/base/tendermint/v1beta1/blocks/{height} |
Block at a height |
GET /cosmos/base/tendermint/v1beta1/validatorsets/latest |
Current validator set with voting power |
A block response has two copies of the block: block (proposer address as base64 bytes) and sdk_block (proposer as a quacvalcons1… address). Each last_commit.signatures[] entry is one validator's ML-DSA-65 vote on the previous block:
{
"block_id_flag": "BLOCK_ID_FLAG_COMMIT",
"validator_address": "BlB8ufmoGAOvPlYPrCLrFkZjYuI=",
"timestamp": "2026-11-18T19:20:34.833643100Z",
"signature": "…4,412 base64 characters = 3,309 bytes…"
}
curl -s https://testnet-api.quantcoin.world/cosmos/base/tendermint/v1beta1/blocks/latest \
| jq '.block.header.height, (.block.last_commit.signatures | length)'
Transactions
| Method & path | Returns |
|---|---|
GET /cosmos/tx/v1beta1/txs/{hash} |
One transaction (tx) and its result (tx_response) |
GET /cosmos/tx/v1beta1/txs?query=…&order_by=ORDER_BY_DESC&limit=N |
Search by events |
GET /cosmos/tx/v1beta1/txs/block/{height} |
Decoded transactions in a block |
POST /cosmos/tx/v1beta1/txs |
Broadcast {"tx_bytes": "<base64>", "mode": "BROADCAST_MODE_SYNC"} |
POST /cosmos/tx/v1beta1/simulate |
Estimate gas for {"tx_bytes": "<base64>"} |
A transaction hash is the uppercase hex SHA-256 of the transaction bytes. Search queries use CometBFT event syntax:
# Everything, newest first
curl -sG https://testnet-api.quantcoin.world/cosmos/tx/v1beta1/txs \
--data-urlencode "query=tx.height>0" --data-urlencode order_by=ORDER_BY_DESC --data-urlencode limit=10
# Sent by an address
--data-urlencode "query=message.sender='quac1…'"
# Received by an address
--data-urlencode "query=transfer.recipient='quac1…'"
In a transaction, tx.auth_info.signer_infos[i].public_key["@type"] is /cosmos.crypto.mldsa65.PubKey on an account's first transaction. Later transactions omit the key, because the chain already stores it. tx.signatures[i] is the 3,309-byte ML-DSA-65 signature.
Accounts and balances
| Method & path | Returns |
|---|---|
GET /cosmos/auth/v1beta1/accounts/{address} |
Account number, sequence, stored public key. 404 if the address has never been used. |
GET /cosmos/bank/v1beta1/balances/{address} |
All balances |
GET /cosmos/bank/v1beta1/balances/{address}/by_denom?denom=uquac |
QUAC balance |
GET /cosmos/bank/v1beta1/supply/by_denom?denom=uquac |
Total QUAC supply |
GET /cosmos/bank/v1beta1/denoms_metadata/uquac |
Display metadata (QUAC, 6 decimals, logo) |
Minting
| Method & path | Returns |
|---|---|
GET /cosmos/mint/v1beta1/inflation |
Current annual inflation rate, e.g. "0.050000006751337462" |
GET /cosmos/mint/v1beta1/annual_provisions |
Current annual issuance in uquac |
GET /cosmos/mint/v1beta1/params |
Mint parameters, including max_supply |
Staking and distribution
| Method & path | Returns |
|---|---|
GET /cosmos/staking/v1beta1/validators |
All validators: moniker, tokens, commission, status, consensus key |
GET /cosmos/staking/v1beta1/pool |
Bonded and not-bonded totals |
GET /cosmos/staking/v1beta1/delegations/{delegator} |
An account's delegations |
GET /cosmos/distribution/v1beta1/delegators/{delegator}/rewards |
Pending staking rewards |
GET /cosmos/distribution/v1beta1/community_pool |
Community pool balance |
Each validator's consensus_pubkey["@type"] is /cosmos.crypto.mldsa65.PubKey. Its consensus address is the first 20 bytes of SHA-256 of that key. The explorer uses this to match block proposers to validator names.
Parameters
| Path | Of note |
|---|---|
/cosmos/auth/v1beta1/params |
sig_verify_cost_mldsa65 (750), tx_size_cost_per_byte (10) |
/cosmos/staking/v1beta1/params |
bond_denom (uquac), unbonding_time, key_rotation_fee |
/cosmos/gov/v1/params/voting |
Governance timing |
/cosmos/consensus/v1/params |
validator.pub_key_types (["ml_dsa_65"]) |
Not available publicly
The public testnet does not expose CometBFT RPC (26657) or gRPC (9090/9190), so that validator IPs stay private (see Public testnet). Run your own node if you need them.