For AI agents: an LLM-friendly Markdown version of every page is available by appending .md to its URL or by sending an Accept: text/markdown request header. The full documentation index is at https://www.ankr.com/docs/llms.txt
Skip to main content

TAC — Cosmos REST methods (3/4)

API reference for TAC. All methods ->

Part 3 of 4: 1 · 2 · 3 · 4

/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_acks/{sequence}​

Retrieves a stored packet acknowledgement hash.

Parameters​

  • channel_id (string; required): a channel unique identifier.
  • port_id (string; required): a port unique identifier.
  • sequence (string, uint64): a packet sequence.

Returns​

Packet acknowledgements.

Request example​

curl https://rpc.ankr.com/http/tac_turin_cosmos/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_acks/{sequence}

Response example​

{
  "acknowledgement": "string",
  "proof": "string",
  "proof_height": {
    "revision_number": "string",
    "revision_height": "string"
  }
}

/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_commitments​

Retrieves all the packet commitments hashes associated with a channel.

Parameters​

  • channel_id (string; required): a channel unique identifier.
  • port_id (string; required): a port unique identifier.
  • pagination.key (string, byte): a value returned in PageResponse.next_key to begin querying the next page efficiently. Only one of offset or key should be set.
  • pagination.key (string, uint64): a numeric offset that can be used when key is unavailable (less efficient than using key). Only one of offset or key should be set.
  • pagination.limit (string, uint64): a total number of results to be returned in the results page. If empty, will default to a value to be set by each app.
  • pagination.count_total (boolean): set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected when offset is used, ignored when key is set.

Returns​

Packet commitments.

Request example​

curl https://rpc.ankr.com/http/tac_turin_cosmos/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_commitments

Response example​

{
  "commitments": [
    {
      "port_id": "string",
      "channel_id": "string",
      "sequence": "string",
      "data": "string"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  },
  "height": {
    "revision_number": "string",
    "revision_height": "string"
  }
}

/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_commitments/{packet_ack_sequences}/unreceived_acks​

Retrieves all the unreceived IBC acknowledgements associated with a channel and sequences.

Parameters​

  • channel_id (string; required): a channel unique identifier.
  • port_id (string; required): a port unique identifier.
  • packet_ack_sequence (array[string]): a required list of acknowledgement sequences.

Returns​

Unreceived IBC acknowledgements.

Request example​

curl https://rpc.ankr.com/http/tac_turin_cosmos/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_commitments/{packet_ack_sequences}/unreceived_acks

Response example​

{
  "sequences": [
    "string"
  ],
  "height": {
    "revision_number": "string",
    "revision_height": "string"
  }
}

/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_commitments/{packet_commitment_sequences}/unreceived_packets​

Retrieves all the unreceived IBC packets associated with a channel and sequences.

Parameters​

  • channel_id (string; required): a channel unique identifier.
  • port_id (string; required): a port unique identifier.
  • packet_commitment_sequences (array[string]): a list of packet sequences.

Returns​

Unreceived IBC packets.

Request example​

curl https://rpc.ankr.com/http/tac_turin_cosmos/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_commitments/{packet_commitment_sequences}/unreceived_packets

Response example​

{
  "sequences": [
    "string"
  ],
  "height": {
    "revision_number": "string",
    "revision_height": "string"
  }
}

/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_commitments/{sequence}​

Retrieves a stored packet commitment hash.

Parameters​

  • channel_id (string; required): a channel unique identifier.
  • port_id (string; required): a port unique identifier.
  • packet_commitment_sequences (array[string]): a list of packet sequences.

Returns​

Packet commitment hash.

Request example​

curl https://rpc.ankr.com/http/tac_turin_cosmos/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_commitments/{sequence}

Response example​

{
  "commitment": "string",
  "proof": "string",
  "proof_height": {
    "revision_number": "string",
    "revision_height": "string"
  }
}

/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_receipts/{sequence}​

Checks whether a given packet sequence has been received on the queried chain.

Parameters​

  • channel_id (string; required): a channel unique identifier.
  • port_id (string; required): a port unique identifier.
  • sequence (string, uint64): a required packet sequence.

Returns​

Whether the given packet has been received or not.

Request example​

curl https://rpc.ankr.com/http/tac_turin_cosmos/ibc/core/channel/v1beta1/channels/{channel_id}/ports/{port_id}/packet_receipts/{sequence}

Response example​

{
  "received": true,
  "proof": "string",
  "proof_height": {
    "revision_number": "string",
    "revision_height": "string"
  }
}

/ibc/core/channel/v1beta1/connections/{connection}/channels​

Retrieves all the channels associated with a connection end.

Parameters​

  • connection (string, required): a connection unique identifier.
  • pagination.key (string, byte): a value returned in PageResponse.next_key to begin querying the next page efficiently. Only one of offset or key should be set.
  • pagination.key string($uint64): a numeric offset that can be used when key is unavailable (less efficient than using key). Only one of offset or key should be set.
  • pagination.limit (string, uint64): a total number of results to be returned in the results page. If empty, will default to a value to be set by each app.
  • pagination.count_total (boolean): set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected when offset is used, ignored when key is set.

Returns​

Channels associated with a connection.

Request example​

curl https://rpc.ankr.com/http/tac_turin_cosmos/ibc/core/channel/v1beta1/connections/{connection}/channels

Response example​

{
  "channels": [
    {
      "state": "STATE_UNINITIALIZED_UNSPECIFIED",
      "ordering": "ORDER_NONE_UNSPECIFIED",
      "counterparty": {
        "port_id": "string",
        "channel_id": "string"
      },
      "connection_hops": [
        "string"
      ],
      "version": "string",
      "port_id": "string",
      "channel_id": "string"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  },
  "height": {
    "revision_number": "string",
    "revision_height": "string"
  }
}

/ibc/client/v1beta1/params​

Retrieves all parameters of the IBC client.

Parameters​

None.

Returns​

Params of the IBC client.

Request example​

curl https://rpc.ankr.com/http/tac_turin_cosmos/ibc/client/v1beta1/params

Response example​

{
  "params": {
    "allowed_clients": [
      "string"
    ]
  }
}

/ibc/core/client/v1beta1/client_states​

Retrieves all the IBC light clients of a chain.

Parameters​

  • pagination.key (string; byte): a value returned in PageResponse.next_key to begin querying the next page efficiently. Only one of offset or key should be set.
  • pagination.key (string; uint64): a numeric offset that can be used when key is unavailable (less efficient than using key). Only one of offset or key should be set.
  • pagination.limit (string; uint64): a total number of results to be returned in the results page. If empty, will default to a value to be set by each app.
  • pagination.count_total (boolean): set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected when offset is used, ignored when key is set.

Returns​

IBC light clients.

Request example​

curl https://rpc.ankr.com/http/tac_turin_cosmos/ibc/core/client/v1beta1/client_states

Response example​

{
  "client_states": [
    {
      "client_id": "string",
      "client_state": {
        "type_url": "string",
        "value": "string"
      }
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

/ibc/core/client/v1beta1/client_states/{client_id}​

Retrieves an IBC light client.

Parameters​

  • client_id (string; required): a client state unique identifier.

Returns​

IBC light client from client_id.

Request example​

curl https://rpc.ankr.com/http/tac_turin_cosmos/ibc/core/client/v1beta1/client_states/{client_id}

Response example​

{
  "client_state": {
    "type_url": "string",
    "value": "string"
  },
  "proof": "string",
  "proof_height": {
    "revision_number": "string",
    "revision_height": "string"
  }
}

/ibc/core/client/v1beta1/consensus_states/{client_id}​

Retrieves all the consensus state associated with a given client.

Parameters​

  • client_id (string; required): a client unique identifier.
  • pagination.key (string, byte): a value returned in PageResponse.next_key to begin querying the next page efficiently. Only one of offset or key should be set.
  • pagination.key (string, uint64): a numeric offset that can be used when key is unavailable (less efficient than using key). Only one of offset or key should be set.
  • pagination.limit (string, uint64): a total number of results to be returned in the results page. If empty, will default to a value to be set by each app.
  • pagination.count_total (boolean): set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected when offset is used, ignored when key is set.

Returns​

Consensus state associated with given client

Request example​

curl https://rpc.ankr.com/http/tac_turin_cosmos/ibc/core/client/v1beta1/consensus_states/{client_id}

Response example​

{
  "consensus_states": [
    {
      "height": {
        "revision_number": "string",
        "revision_height": "string"
      },
      "consensus_state": {
        "type_url": "string",
        "value": "string"
      }
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

/ibc/core/client/v1beta1/consensus_states/{client_id}/revision/{revision_number}/height/{revision_height}​

Retrieves a consensus state associated with a client state at a given height.

Parameters​

  • channel_id (string; required): a channel unique identifier.
  • revision_number (string, uint64): a required consensus state revision number.
  • revision_height(string, uint64): a required consensus state revision height.
  • latest_height (boolean): overrides the height field and queries the latest stored consensus state.

Returns​

Consensus state associated with a client state at a given height.

Request example​

curl https://rpc.ankr.com/http/tac_turin_cosmos/ibc/core/client/v1beta1/consensus_states/{client_id}/revision/{revision_number}/height/{revision_height}

Response example​

{
  "consensus_state": {
    "type_url": "string",
    "value": "string"
  },
  "proof": "string",
  "proof_height": {
    "revision_number": "string",
    "revision_height": "string"
  }
}

/ibc/core/connection/v1beta1/client_connections/{client_id}​

Retrieves the connection paths associated with a client state.

Parameters​

  • client_id (string, required): a client identifier associated with a connection.

Returns​

Connections paths associated with a client state.

Request example​

curl https://rpc.ankr.com/http/tac_turin_cosmos/ibc/core/connection/v1beta1/client_connections/{client_id}

Response example​

{
  "connection_paths": [
    "string"
  ],
  "proof": "string",
  "proof_height": {
    "revision_number": "string",
    "revision_height": "string"
  }
}

/ibc/core/connection/v1beta1/connections​

Retrieves all the IBC connections of a chain.

Parameters​

  • pagination.key (string, byte): a value returned in PageResponse.next_key to begin querying the next page efficiently. Only one of offset or key should be set.
  • pagination.key (string, uint64): a numeric offset that can be used when key is unavailable (less efficient than using key). Only one of offset or key should be set.
  • pagination.limit (string, uint64): a total number of results to be returned in the results page. If empty, will default to a value to be set by each app.
  • pagination.count_total (boolean): set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected when offset is used, ignored when key is set.

Returns​

IBC connections.

Request example​

curl https://rpc.ankr.com/http/tac_turin_cosmos/ibc/core/connection/v1beta1/connections

Response example​

{
  "connections": [
    {
      "id": "string",
      "client_id": "string",
      "versions": [
        {
          "identifier": "string",
          "features": [
            "string"
          ]
        }
      ],
      "state": "STATE_UNINITIALIZED_UNSPECIFIED",
      "counterparty": {
        "client_id": "string",
        "connection_id": "string",
        "prefix": {
          "key_prefix": "string"
        }
      },
      "delay_period": "string"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  },
  "height": {
    "revision_number": "string",
    "revision_height": "string"
  }
}

/ibc/core/connection/v1beta1/connections/{connection_id}​

Retrieves an IBC connection end.

Parameters​

  • connection_id (string; required): a connection unique identifier.

Returns​

IBC connections end.

Request example​

curl https://rpc.ankr.com/http/tac_turin_cosmos/ibc/core/connection/v1beta1/connections/{connection_id}

Response example​

{
  "connection": {
    "client_id": "string",
    "versions": [
      {
        "identifier": "string",
        "features": [
          "string"
        ]
      }
    ],
    "state": "STATE_UNINITIALIZED_UNSPECIFIED",
    "counterparty": {
      "client_id": "string",
      "connection_id": "string",
      "prefix": {
        "key_prefix": "string"
      }
    },
    "delay_period": "string"
  },
  "proof": "string",
  "proof_height": {
    "revision_number": "string",
    "revision_height": "string"
  }
}

/ibc/core/connection/v1beta1/connections/{connection_id}/client_state​

Retrieves the client state associated with the connection.

Parameters​

  • connection_id (string; required): a connection unique identifier.

Returns​

Client state.

Request example​

curl https://rpc.ankr.com/http/tac_turin_cosmos/ibc/core/connection/v1beta1/connections/{connection_id}/client_state

Response example​

{
  "identified_client_state": {
    "client_id": "string",
    "client_state": {
      "type_url": "string",
      "value": "string"
    }
  },
  "proof": "string",
  "proof_height": {
    "revision_number": "string",
    "revision_height": "string"
  }
}

/ibc/core/connection/v1beta1/connections/{connection_id}/consensus_state/revision/{revision_number}/height/{revision_height}​

Retrieves the consensus state associated with the connection.

Parameters​

  • connection_id (string; required): a connection unique identifier.
  • revision_number (string, uint64): a required revision number.
  • revision_height (string, uint64): a required revision height.

Returns​

Consensus state.

Request example​

curl https://rpc.ankr.com/http/tac_turin_cosmos/ibc/core/connection/v1beta1/connections/{connection_id}/consensus_state/revision/{revision_number}/height/{revision_height}

Response example​

{
  "consensus_state": {
    "type_url": "string",
    "value": "string"
  },
  "client_id": "string",
  "proof": "string",
  "proof_height": {
    "revision_number": "string",
    "revision_height": "string"
  }
}

Ibc applications methods​

/ibc/applications/transfer/v1beta1/denom_traces​

Retrieves all denomination traces.

Parameters​

  • pagination.key (string, byte): a value returned in PageResponse.next_key to begin querying the next page efficiently. Only one of offset or key should be set.
  • pagination.key (string, uint64): a numeric offset that can be used when key is unavailable (less efficient than using key). Only one of offset or key should be set.
  • pagination.limit (string, uint64): a total number of results to be returned in the results page. If empty, will default to a value to be set by each app.
  • pagination.count_total (boolean): set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected when offset is used, ignored when key is set.

Returns​

Denomination traces.

Request example​

curl https://rpc.ankr.com/http/tac_turin_cosmos/ibc/applications/transfer/v1beta1/denom_traces

Response example​

{
  "denom_traces": [
    {
      "path": "string",
      "base_denom": "string"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}

/ibc/applications/transfer/v1beta1/denom_traces/{hash}​

Retrieves a denomination trace information by hash.

Parameters​

  • hash (string, hex; required): a hash of the denomination trace information.

Returns​

Denomination traces.

Request example​

curl https://rpc.ankr.com/http/tac_turin_cosmos/ibc/applications/transfer/v1beta1/denom_traces/{hash}

Response example​

{
  "denom_trace": {
    "path": "string",
    "base_denom": "string"
  }
}

/ibc/applications/transfer/v1beta1/params​

Retrieves all parameters of the IBC transfer module.

Parameters​

None.

Returns​

Parameters of the IBC transfer module.

Request example​

curl https://rpc.ankr.com/http/tac_turin_cosmos/ibc/applications/transfer/v1beta1/params

Response example​

{
  "params": {
    "send_enabled": true,
    "receive_enabled": true
  }
}

Tx methods​

/cosmos/tx/v1beta1/simulate​

Simulates executing a transaction for estimating gas usage.

Parameters​

  • <body> (object; required):
{
  "tx": {
    "body": {
      "messages": [
        {
          "type_url": "string",
          "value": "string"
        }
      ],
      "memo": "string",
      "timeout_height": "string",
      "extension_options": [
        {
          "type_url": "string",
          "value": "string"
        }
      ],
      "non_critical_extension_options": [
        {
          "type_url": "string",
          "value": "string"
        }
      ]
    },
    "auth_info": {
      "signer_infos": [
        {
          "public_key": {
            "type_url": "string",
            "value": "string"
          },
          "mode_info": {
            "single": {
              "mode": "SIGN_MODE_UNSPECIFIED"
            },
            "multi": {
              "bitarray": {
                "extra_bits_stored": 0,
                "elems": "string"
              },
              "mode_infos": [
                null
              ]
            }
          },
          "sequence": "string"
        }
      ],
      "fee": {
        "amount": [
          {
            "denom": "string",
            "amount": "string"
          }
        ],
        "gas_limit": "string",
        "payer": "string",
        "granter": "string"
      }
    },
    "signatures": [
      "string"
    ]
  }
}

Returns​

Estimated gas usage.

Request example​

curl https://rpc.ankr.com/http/tac_turin_cosmos/cosmos/tx/v1beta1/simulate

Response example​

{
  "gas_info": {
    "gas_wanted": "string",
    "gas_used": "string"
  },
  "result": {
    "data": "string",
    "log": "string",
    "events": [
      {
        "type": "string",
        "attributes": [
          {
            "key": "string",
            "value": "string",
            "index": true
          }
        ]
      }
    ]
  }
}

/cosmos/tx/v1beta1/txs​

Fetches txs by event.

Parameters​

  • events (array[string]): a list of transaction event type.
  • pagination.key (string, byte): a value returned in PageResponse.next_key to begin querying the next page efficiently. Only one of offset or key should be set.
  • pagination.key (string, uint64): a numeric offset that can be used when key is unavailable (less efficient than using key). Only one of offset or key should be set.
  • pagination.limit (string, uint64): a total number of results to be returned in the results page. If empty, will default to a value to be set by each app.
  • pagination.count_total (boolean): set to true to indicate that the result set should include a count of the total number of items available for pagination in the UIs. Only respected when offset is used, ignored when key is set.

Returns​

Transactions.

Request example​

curl https://rpc.ankr.com/http/tac_turin_cosmos/cosmos/tx/v1beta1/txs

Response example​

{
  "txs": [
    {
      "body": {
        "messages": [
          {
            "type_url": "string",
            "value": "string"
          }
        ],
        "memo": "string",
        "timeout_height": "string",
        "extension_options": [
          {
            "type_url": "string",
            "value": "string"
          }
        ],
        "non_critical_extension_options": [
          {
            "type_url": "string",
            "value": "string"
          }
        ]
      },
      "auth_info": {
        "signer_infos": [
          {
            "public_key": {
              "type_url": "string",
              "value": "string"
            },
            "mode_info": {
              "single": {
                "mode": "SIGN_MODE_UNSPECIFIED"
              },
              "multi": {
                "bitarray": {
                  "extra_bits_stored": 0,
                  "elems": "string"
                },
                "mode_infos": [
                  null
                ]
              }
            },
            "sequence": "string"
          }
        ],
        "fee": {
          "amount": [
            {
              "denom": "string",
              "amount": "string"
            }
          ],
          "gas_limit": "string",
          "payer": "string",
          "granter": "string"
        }
      },
      "signatures": [
        "string"
      ]
    }
  ],
  "tx_responses": [
    {
      "height": "string",
      "txhash": "string",
      "codespace": "string",
      "code": 0,
      "data": "string",
      "raw_log": "string",
      "logs": [
        {
          "msg_index": 0,
          "log": "string",
          "events": [
            {
              "type": "string",
              "attributes": [
                {
                  "key": "string",
                  "value": "string"
                }
              ]
            }
          ]
        }
      ],
      "info": "string",
      "gas_wanted": "string",
      "gas_used": "string",
      "tx": {
        "type_url": "string",
        "value": "string"
      },
      "timestamp": "string"
    }
  ],
  "pagination": {
    "next_key": "string",
    "total": "string"
  }
}