CenterChain

Reference

API Reference

The complete generated API contract: gRPC services, REST endpoints, message schemas, query schemas, and the upstream Cosmos SDK pin.

Full API reference on docs.centerchain.org

gRPC Services

CenterChain modules expose the following gRPC services (generated from protobuf):

Token Factory

  • Query/Denom, Query/Denoms
  • Query/DenomMetadata, Query/DenomsMetadata
  • Query/DenomAuthorityMetadata
  • Query/Blacklist, Query/Blacklists
  • Query/DenomRestriction
  • Query/SwapAuthorization, Query/SwapAuthorizations
  • Query/Params

Liquidity

  • Query/Pool, Query/Pools
  • Query/PoolLiquidity
  • Query/PoolFee
  • Query/Farm, Query/Farms
  • Query/FarmPosition, Query/FarmPositions
  • Query/FeeRecord, Query/FeeRecords
  • Query/Params

NFT

  • Query/Class, Query/Classes
  • Query/NFT, Query/NFTs
  • Query/ClassOwner, Query/NFTsByOwner
  • Query/Params

NFT Market

  • Query/Listing, Query/Listings
  • Query/ListingsBySeller, Query/ListingsByClass
  • Query/ClassRoyalty, Query/ClassMarketConfig
  • Query/MarketConfig, Query/Params

Income

  • Query/Stream, Query/Streams
  • Query/HolderAccrual, Query/HolderAccruals
  • Query/NFTclaimable, Query/NFTclaimables
  • Query/YieldPool
  • Query/Params

REST Endpoints

All gRPC query services are exposed as REST endpoints via the Cosmos REST gateway. Base path: /cosmos/.../v1/ for standard modules, /centerchain/.../v1/ for custom modules.

Example endpoints:

Token Factory

  • GET /centerchain/tokenfactory/v1/denoms
  • GET /centerchain/tokenfactory/v1/denoms/{denom}
  • GET /centerchain/tokenfactory/v1/denoms/{denom}/authority
  • GET /centerchain/tokenfactory/v1/denoms/{denom}/blacklist

Liquidity

  • GET /centerchain/liquidity/v1/pools
  • GET /centerchain/liquidity/v1/pools/{pool_id}
  • GET /centerchain/liquidity/v1/pools/{pool_id}/liquidity
  • GET /centerchain/liquidity/v1/farms

NFT Market

  • GET /centerchain/nftmarket/v1/listings
  • GET /centerchain/nftmarket/v1/listings/{listing_id}
  • GET /centerchain/nftmarket/v1/classes/{class_id}/royalty

Income

  • GET /centerchain/income/v1/streams
  • GET /centerchain/income/v1/streams/{stream_id}/accruals
  • GET /centerchain/income/v1/nft-claimables
  • GET /centerchain/income/v1/yield-pools/{pool_id}

Upstream Pin

CenterChain pins specific upstream versions to ensure reproducibility and auditability:

Cosmos SDK

v0.50.12

CometBFT

v1.0.0

IBC-Go

v8.7.0

See Upstream Pin for the complete dependency graph and rationale.

REST Coverage Map

Percentage of gRPC query methods exposed via REST:

Token Factory

100% (all queries)

Liquidity

100% (all queries)

NFT

100% (all queries)

NFT Market

100% (all queries)

Income

100% (all queries)

Standard Cosmos modules

Per upstream (bank, staking, gov, etc.)

See REST Coverage for the complete method-by-method table.

Message Schemas

All messages are defined in protobuf and exposed as JSON for REST. Each message type includes:

  • Field definitions with types and descriptions
  • Validation rules (caps, formats, required fields)
  • Example JSON payloads
  • Error codes and conditions

See API Reference for the complete message catalog with interactive examples.

Next steps

Full API referenceExplore modules