Skip to main content

Chain API

The Chain API provides standard REST endpoints for querying blockchain state — blocks, transactions, accounts, balances, validators, and token metadata.

Base URL

http://67.205.164.156:1317
This is the Light Client Daemon (LCD) REST interface running on the primary validator node. All endpoints return JSON.

Authentication

All read endpoints are public. No API key or authentication is required for queries. Transactions must be signed client-side before broadcasting. See the SDK docs for signing helpers.

Rate Limits

Endpoint TypeLimit
Read queries100 requests/min per IP
Transaction broadcast10 requests/min per IP
For higher throughput, run your own node.

Common Patterns

Pagination

Most list endpoints support cursor-based pagination:
# First page (10 results)
curl "http://67.205.164.156:1317/cosmos/bank/v1beta1/balances/xyz1...?pagination.limit=10"

# Next page (pass next_key from previous response)
curl "http://67.205.164.156:1317/cosmos/bank/v1beta1/balances/xyz1...?pagination.key=ABC123&pagination.limit=10"

# Include total count
curl "http://67.205.164.156:1317/cosmos/bank/v1beta1/balances/xyz1...?pagination.count_total=true"

Error Responses

Errors return a standard structure:
{
  "code": 5,
  "message": "rpc error: code = NotFound desc = account xyz1... not found",
  "details": []
}
CodeMeaning
2Unknown error
3Invalid argument
5Not found
11Out of range

Available Endpoints

SectionWhat You Can Query
BlocksLatest block, block by height
TransactionsTx by hash, search by sender/recipient/height
AccountsAccount info, sequence number, public key
BalancesNative token balances, total supply
ValidatorsValidator set, delegations, staking pool
NetworkNode info, syncing status
Token MetadataDenomination metadata for native tokens