Skip to main content
Version: Next

IBC REST API

Endpoints the node exposes under /ibc/*.

apps​

MethodPathSummary
GET/ibc/apps/gmp/v1/accounts/{account_address}/identifierAccountIdentifier queries the account identifier for a given interchain account address.
GET/ibc/apps/gmp/v1/clients/{client_id}/accounts/{sender}/{salt}AccountAddress queries the interchain account address for a given client_id, sender, and salt. If the account is not registered, the address is computed deterministically
GET/ibc/apps/interchain_accounts/controller/v1/owners/{owner}/connections/{connection_id}InterchainAccount returns the interchain account address for a given owner address on a given connection
GET/ibc/apps/interchain_accounts/controller/v1/paramsParams queries all parameters of the ICA controller submodule.
GET/ibc/apps/interchain_accounts/host/v1/paramsParams queries all parameters of the ICA host submodule.
GET/ibc/apps/transfer/v1/channels/{channel_id}/ports/{port_id}/escrow_addressEscrowAddress returns the escrow address for a particular port and channel id.
GET/ibc/apps/transfer/v1/denom_hashes/{trace}DenomHash queries a denomination hash information.
GET/ibc/apps/transfer/v1/denomsDenoms queries all denominations
GET/ibc/apps/transfer/v1/denoms/{hash}Denom queries a denomination
GET/ibc/apps/transfer/v1/paramsParams queries all parameters of the ibc-transfer module.
GET/ibc/apps/transfer/v1/total_escrow/{denom}TotalEscrowForDenom returns the total amount of tokens in escrow based on the denom.

core​

MethodPathSummary
GET/ibc/core/channel/v1/channelsChannels queries all the IBC channels of a chain.
GET/ibc/core/channel/v1/channels/{channel_id}/ports/{port_id}Channel queries an IBC Channel.
GET/ibc/core/channel/v1/channels/{channel_id}/ports/{port_id}/client_stateChannelClientState queries for the client state for the channel associated with the provided channel identifiers.
GET/ibc/core/channel/v1/channels/{channel_id}/ports/{port_id}/consensus_state/revision/{revision_number}/height/{revision_height}ChannelConsensusState queries for the consensus state for the channel associated with the provided channel identifiers.
GET/ibc/core/channel/v1/channels/{channel_id}/ports/{port_id}/next_sequenceNextSequenceReceive returns the next receive sequence for a given channel.
GET/ibc/core/channel/v1/channels/{channel_id}/ports/{port_id}/next_sequence_sendNextSequenceSend returns the next send sequence for a given channel.
GET/ibc/core/channel/v1/channels/{channel_id}/ports/{port_id}/packet_acknowledgementsPacketAcknowledgements returns all the packet acknowledgements associated with a channel.
GET/ibc/core/channel/v1/channels/{channel_id}/ports/{port_id}/packet_acks/{sequence}PacketAcknowledgement queries a stored packet acknowledgement hash.
GET/ibc/core/channel/v1/channels/{channel_id}/ports/{port_id}/packet_commitmentsPacketCommitments returns all the packet commitments hashes associated with a channel.
GET/ibc/core/channel/v1/channels/{channel_id}/ports/{port_id}/packet_commitments/{packet_ack_sequences}/unreceived_acksUnreceivedAcks returns all the unreceived IBC acknowledgements associated with a channel and sequences.
GET/ibc/core/channel/v1/channels/{channel_id}/ports/{port_id}/packet_commitments/{packet_commitment_sequences}/unreceived_packetsUnreceivedPackets returns all the unreceived IBC packets associated with a channel and sequences.
GET/ibc/core/channel/v1/channels/{channel_id}/ports/{port_id}/packet_commitments/{sequence}PacketCommitment queries a stored packet commitment hash.
GET/ibc/core/channel/v1/channels/{channel_id}/ports/{port_id}/packet_receipts/{sequence}PacketReceipt queries if a given packet sequence has been received on the queried chain
GET/ibc/core/channel/v1/connections/{connection}/channelsConnectionChannels queries all the channels associated with a connection end.
GET/ibc/core/channel/v2/clients/{client_id}/next_sequence_sendNextSequenceSend returns the next send sequence for a given channel.
GET/ibc/core/channel/v2/clients/{client_id}/packet_acknowledgementsPacketAcknowledgements returns all packet acknowledgements associated with a channel.
GET/ibc/core/channel/v2/clients/{client_id}/packet_acks/{sequence}PacketAcknowledgement queries a stored acknowledgement commitment hash.
GET/ibc/core/channel/v2/clients/{client_id}/packet_commitmentsPacketCommitments queries a stored packet commitment hash.
GET/ibc/core/channel/v2/clients/{client_id}/packet_commitments/{packet_ack_sequences}/unreceived_acksUnreceivedAcks returns all the unreceived IBC acknowledgements associated with a channel and sequences.
GET/ibc/core/channel/v2/clients/{client_id}/packet_commitments/{sequences}/unreceived_packetsUnreceivedPackets returns all the unreceived IBC packets associated with a channel and sequences.
GET/ibc/core/channel/v2/clients/{client_id}/packet_commitments/{sequence}PacketCommitment queries a stored packet commitment hash.
GET/ibc/core/channel/v2/clients/{client_id}/packet_receipts/{sequence}PacketReceipt queries a stored packet receipt.
GET/ibc/core/client/v1/client_creator/{client_id}ClientCreator queries the creator of a given client.
GET/ibc/core/client/v1/client_statesClientStates queries all the IBC light clients of a chain.
GET/ibc/core/client/v1/client_states/{client_id}ClientState queries an IBC light client.
GET/ibc/core/client/v1/client_status/{client_id}Status queries the status of an IBC client.
GET/ibc/core/client/v1/consensus_states/{client_id}ConsensusStates queries all the consensus state associated with a given client.
GET/ibc/core/client/v1/consensus_states/{client_id}/heightsConsensusStateHeights queries the height of every consensus states associated with a given client.
GET/ibc/core/client/v1/consensus_states/{client_id}/revision/{revision_number}/height/{revision_height}ConsensusState queries a consensus state associated with a client state at a given height.
GET/ibc/core/client/v1/paramsClientParams queries all parameters of the ibc client submodule.
GET/ibc/core/client/v1/upgraded_client_statesUpgradedClientState queries an Upgraded IBC light client.
GET/ibc/core/client/v1/upgraded_consensus_statesUpgradedConsensusState queries an Upgraded IBC consensus state.
POST/ibc/core/client/v1/verify_membershipVerifyMembership queries an IBC light client for proof verification of a value at a given key path.
GET/ibc/core/client/v2/config/{client_id}Config queries the IBC client v2 configuration for a given client.
GET/ibc/core/client/v2/counterparty_info/{client_id}CounterpartyInfo queries an IBC light counter party info.
GET/ibc/core/connection/v1/client_connections/{client_id}ClientConnections queries the connection paths associated with a client state.
GET/ibc/core/connection/v1/connectionsConnections queries all the IBC connections of a chain.
GET/ibc/core/connection/v1/connections/{connection_id}Connection queries an IBC connection end.
GET/ibc/core/connection/v1/connections/{connection_id}/client_stateConnectionClientState queries the client state associated with the connection.
GET/ibc/core/connection/v1/connections/{connection_id}/consensus_state/revision/{revision_number}/height/{revision_height}ConnectionConsensusState queries the consensus state associated with the connection.
GET/ibc/core/connection/v1/paramsConnectionParams queries all parameters of the ibc connection submodule.

lightclients​

MethodPathSummary
GET/ibc/lightclients/wasm/v1/checksumsGet all Wasm checksums
GET/ibc/lightclients/wasm/v1/checksums/{checksum}/codeGet Wasm code for given checksum