API Reference

Query the network

All endpoints are publicly accessible. No authentication or API keys required. Rate limits are generous for testnet usage.

REST API Base URL
https://api.torvainchain.com
RPC Base URL
https://rpc.torvainchain.com
REST API Endpoints

Bank

Balances & Transfers
GET/torvainchain/bank/v1beta1/supply

Total token supply across all denominations

GET/torvainchain/bank/v1beta1/supply/by_denom?denom=utvn

Supply for a specific denomination

GET/torvainchain/bank/v1beta1/balances/{address}

All balances for a specific account address

GET/torvainchain/bank/v1beta1/spendable_balances/{address}

Spendable balances (excluding locked/vesting amounts)

GET/torvainchain/bank/v1beta1/denoms_metadata

Metadata for all registered denominations

GET/torvainchain/bank/v1beta1/params

Bank module parameters (send enabled, default denom)

Staking

Validators & Delegation
GET/torvainchain/staking/v1beta1/validators

List all validators (use ?status=BOND_STATUS_BONDED for active set)

GET/torvainchain/staking/v1beta1/validators/{validator_addr}

Query a specific validator by operator address

GET/torvainchain/staking/v1beta1/validators/{validator_addr}/delegations

All delegations to a specific validator

GET/torvainchain/staking/v1beta1/delegations/{delegator_addr}

All delegations from a delegator

GET/torvainchain/staking/v1beta1/delegators/{delegator_addr}/redelegations

Pending redelegations for a delegator

GET/torvainchain/staking/v1beta1/delegators/{delegator_addr}/unbonding_delegations

Pending unbonding delegations (21 day unbonding period)

GET/torvainchain/staking/v1beta1/pool

Staking pool — bonded and not-bonded token amounts

GET/torvainchain/staking/v1beta1/params

Staking parameters: bond_denom, unbonding_time, max_validators, etc.

Distribution

Rewards & Commission
GET/torvainchain/distribution/v1beta1/delegators/{delegator_addr}/rewards

Total pending staking rewards for a delegator across all validators

GET/torvainchain/distribution/v1beta1/delegators/{delegator_addr}/rewards/{validator_addr}

Pending rewards from a specific validator

GET/torvainchain/distribution/v1beta1/validators/{validator_addr}/commission

Accumulated commission for a validator

GET/torvainchain/distribution/v1beta1/validators/{validator_addr}/outstanding_rewards

Total outstanding rewards for a validator

GET/torvainchain/distribution/v1beta1/community_pool

Community pool balance (governance-controlled treasury)

GET/torvainchain/distribution/v1beta1/params

Distribution parameters: community_tax, base_proposer_reward, etc.

Governance

Proposals & Voting
GET/torvainchain/gov/v1beta1/proposals

List all governance proposals (filter by ?status=PROPOSAL_STATUS_VOTING_PERIOD)

GET/torvainchain/gov/v1beta1/proposals/{proposal_id}

Query a specific proposal by ID

GET/torvainchain/gov/v1beta1/proposals/{proposal_id}/votes

All votes on a proposal

GET/torvainchain/gov/v1beta1/proposals/{proposal_id}/deposits

All deposits on a proposal

GET/torvainchain/gov/v1beta1/proposals/{proposal_id}/tally

Current vote tally (yes, no, abstain, no_with_veto)

GET/torvainchain/gov/v1beta1/params/{params_type}

Gov parameters: deposit_params, voting_params, tally_params

Mint

Inflation & Supply
GET/torvainchain/mint/v1beta1/params

Minting parameters: inflation_rate_change, inflation_max/min, blocks_per_year

GET/torvainchain/mint/v1beta1/inflation

Current annualized inflation rate

GET/torvainchain/mint/v1beta1/annual_provisions

Current annual provisions (tokens minted per year at current rate)

Auth

Accounts
GET/torvainchain/auth/v1beta1/accounts/{address}

Account details: type, account_number, sequence (nonce)

GET/torvainchain/auth/v1beta1/params

Auth parameters: max_memo_characters, sig_verify_cost, etc.

CosmWasm

Smart Contracts
GET/torvainchainwasm/wasm/v1/code

All deployed WASM code entries with code_id, creator, checksum

GET/torvainchainwasm/wasm/v1/code/{code_id}

Specific code entry details (creator, checksum, instantiate_permission)

GET/torvainchainwasm/wasm/v1/code/{code_id}/contracts

All contracts instantiated from a given code_id

GET/torvainchainwasm/wasm/v1/contract/{address}

Contract metadata: code_id, creator, admin, label

GET/torvainchainwasm/wasm/v1/contract/{address}/smart/{query_b64}

Smart query — pass base64-encoded JSON (e.g. btoa('{"minter":{}}'))

GET/torvainchainwasm/wasm/v1/contract/{address}/state

Raw contract state — all stored key-value pairs

GET/torvainchainwasm/wasm/v1/contract/{address}/history

Contract migration history

IBC

Cross-Chain
GET/ibc/core/channel/v1/channels

All IBC channels

GET/ibc/core/connection/v1/connections

All IBC connections

GET/ibc/core/client/v1/client_states

All IBC light client states

GET/ibc/apps/transfer/v1/denom_traces

IBC denomination traces (transferred tokens)

GET/ibc/apps/transfer/v1/params

IBC transfer parameters

Transactions

Tx Query & Broadcast
GET/torvainchain/tx/v1beta1/txs/{hash}

Query a transaction by its hash

GET/torvainchain/tx/v1beta1/txs?events={events}

Search transactions by event attributes (e.g. message.sender=torv1...)

POST/torvainchain/tx/v1beta1/txs

Broadcast a signed transaction (use BROADCAST_MODE_SYNC or BROADCAST_MODE_ASYNC)

POST/torvainchain/tx/v1beta1/simulate

Simulate a transaction to estimate gas consumption

TvcBurn

Fee Burn Module
GET/torvainchain/tvcburn/v1/total_burned

Total tokens permanently burned by the TvcBurn module

GET/torvainchain/tvcburn/v1/params

Burn module parameters (burn_fraction: 0.30)

GET/torvainchain/tvcburn/v1/burn_history

Historical burn records with timestamps and amounts

RPC Endpoints

CometBFT RPC

Blocks, Txs, Consensus, Network
GET/status

Node status: network, sync_info, latest block height, validator info

GET/block?height={height}

Full block data at a specific height (omit height for latest)

GET/blockchain?minHeight={min}&maxHeight={max}

Block headers for a height range (max 20 blocks)

GET/block_results?height={height}

Block results including events, tx results, and begin/end block events

GET/tx?hash=0x{hash}

Transaction by hash (hex-encoded with 0x prefix)

GET/tx_search?query="{query}"

Search transactions by event query (e.g. "tx.height=1000")

GET/validators?height={height}

Validator set at a given height with voting power

GET/consensus_state

Current consensus state: round, step, prevotes, precommits

GET/net_info

Network peer info: number of peers, listener addresses, connection details

GET/health

Node health check (returns 200 if node is running)

GET/abci_info

Application info: version, block height, app hash

GET/genesis

Full genesis file (large response — use with caution)

← DocumentationBack to home →