Cosmos Explorer

Cosmos Explorer · Actions GPT

Cosmos Ecosystem API

  • GET /api/v1/tokens/pricesRetrieve the prices of tokens in the Cosmos ecosystem
  • GET /api/v1/address/{address}Retrieves the balance of a Cosmos ecosystem address
  • POST /api/v1/addressesRetrieves the balance of multiple cryptocurrency addresses at the same time
  • POST /api/v1/proposalsRetrieves the list of proposals from one or more blockchains by setting the 'chains' or by 'status' to obtain information on several blockchains at once.
  • GET /api/v1/proposal/{chain}/{id}Retrieves the information of a blockchain proposal
  • POST /api/v1/validatorsRetrieves the list of validators of a blockchain by defining the 'chains' or 'moniker' parameter for the search.
  • POST /api/v1/address/convertDerive a public address to obtain associated addresses for use with other blockchains.
  • GET /api/v1/validator/{chain}/{validator}Retrieves the information of a blockchain validator
  • GET /api/v1/chain/{chain}/metricsRetrieves metrics of a blockchain such as Inflation, Bonded Tokens, Not Bonded Tokens, Total Supply Tokens, Community Pool, Community Tax
  • GET /api/v1/chain/{chain}/parametersThis API retrieves detailed information on a blockchain. It provides data on various aspects of the chain, such as token supply, governance parameters, IBC configurations, minting details, slashing rules, and staking specifics.
  • GET /api/v1/transaction/{chain}/{hash}Get information about a blockchain transaction from its hash
  • POST /api/v1/address/historyRetrieves the transaction history of a Cosmos ecosystem address
Schéma original API
{
  "openapi": "3.1.0",
  "info": {
    "title": "Cosmos Ecosystem API",
    "version": "1.1.0"
  },
  "servers": [
    {
      "url": "https://gpt.foxinodes.net",
      "description": "Production server connected to the mainnets of blockchains"
    }
  ],
  "paths": {
    "/api/v1/tokens/prices": {
      "get": {
        "summary": "Retrieve the prices of tokens in the Cosmos ecosystem",
        "operationId": "getTokensPrices",
        "x-openai-isConsequential": false,
        "tags": [
          "tokens",
          "prices"
        ],
        "responses": {
          "200": {
            "description": "Successful response containing the list of tokens",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/defaultAnswer"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request"
          },
          "500": {
            "description": "Internal server error"
          }
        }
      }
    },
    "/api/v1/address/{address}": {
      "get": {
        "summary": "Retrieves the balance of a Cosmos ecosystem address",
        "operationId": "getAddressBalance",
        "x-openai-isConsequential": true,
        "tags": [
          "balance",
          "address"
        ],
        "parameters": [
          {
            "in": "path",
            "name": "address",
            "required": true,
            "description": "Variable containing the public address of the account",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response containing the address information",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/defaultAnswer"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request"
          },
          "500": {
            "description": "Internal server error"
          }
        }
      }
    },
    "/api/v1/addresses": {
      "post": {
        "summary": "Retrieves the balance of multiple cryptocurrency addresses at the same time",
        "operationId": "getAddressesBalance",
        "x-openai-isConsequential": true,
        "tags": [
          "balance",
          "list"
        ],
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "addresses": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "List of addresses limited to a maximum of 10 entries"
                  }
                },
                "required": [
                  "addresses"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response containing the information of an address",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/defaultAnswer"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request"
          },
          "500": {
            "description": "Internal server error"
          }
        }
      }
    },
    "/api/v1/proposals": {
      "post": {
        "summary": "Retrieves the list of proposals from one or more blockchains by setting the 'chains' or by 'status' to obtain information on several blockchains at once.",
        "operationId": "getProposals",
        "x-openai-isConsequential": false,
        "tags": [
          "proposal",
          "list"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "chains": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "List of blockchains for the search which can have one of the following values: cosmoshub, osmosis, bitsong, atomone, sentinel, teritori, gitopia, agoric"
                  },
                  "status": {
                    "type": "string",
                    "description": "State of the proposals which can be one of the following values: deposit, voting, passed, rejected, failed"
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page number containing the information which by default is 1."
                  },
                  "limit": {
                    "type": "integer",
                    "description": "Number of items displayed per page between 10 and 25."
                  },
                  "sort_by": {
                    "type": "string",
                    "description": "Specifies sorting field: choose one from: proposal_id, time_submit, time_deposit_end, time_voting_start, time_voting_end."
                  },
                  "order": {
                    "type": "string",
                    "description": "Specifies sorting direction: 'ASC' for ascending or 'DESC' for descending."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response containing the list of the blockchain proposals",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/defaultAnswer"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request"
          },
          "500": {
            "description": "Internal server error"
          }
        }
      }
    },
    "/api/v1/proposal/{chain}/{id}": {
      "get": {
        "summary": "Retrieves the information of a blockchain proposal",
        "operationId": "getProposal",
        "x-openai-isConsequential": false,
        "tags": [
          "proposal"
        ],
        "parameters": [
          {
            "in": "path",
            "name": "chain",
            "required": true,
            "description": "Name of the blockchain. This parameter must have one of these values: cosmoshub, osmosis, bitsong, atomone, sentinel, teritori, gitopia, agoric",
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Integer serving as an identifier for a blockchain proposal."
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response containing the information of the proposal.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/defaultAnswer"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request"
          },
          "500": {
            "description": "Internal server error"
          }
        }
      }
    },
    "/api/v1/validators": {
      "post": {
        "summary": "Retrieves the list of validators of a blockchain by defining the 'chains' or 'moniker' parameter for the search.",
        "operationId": "getValidators",
        "x-openai-isConsequential": false,
        "tags": [
          "validator",
          "list"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "chains": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "List of blockchains for the search. This parameter must have one of these values: cosmoshub, osmosis, bitsong, atomone, sentinel, teritori, gitopia, agoric"
                  },
                  "moniker": {
                    "type": "string",
                    "description": "Moniker of a validator for search by name."
                  },
                  "status": {
                    "type": "string",
                    "description": "Status of the validator which can be 'active' (in the active set), 'inactive' (not in the active set but operational), and 'jailed' (punished by the network)."
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page number containing the information which by default is 1."
                  },
                  "limit": {
                    "type": "integer",
                    "description": "Number of items displayed per page between 5 and 200."
                  },
                  "sort_by": {
                    "type": "string",
                    "description": "Specifies sorting field: choose one from: rank, moniker, missed_blocks_counter, tokens."
                  },
                  "order": {
                    "type": "string",
                    "description": "Specifies sorting direction: 'ASC' for ascending or 'DESC' for descending."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response containing the list of the blockchain validators",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/defaultAnswer"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request"
          },
          "500": {
            "description": "Internal server error"
          }
        }
      }
    },
    "/api/v1/address/convert": {
      "post": {
        "summary": "Derive a public address to obtain associated addresses for use with other blockchains.",
        "operationId": "convertAddress",
        "x-openai-isConsequential": false,
        "tags": [
          "address"
        ],
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "address": {
                    "type": "string",
                    "description": "Original public address to be transformed to the public address of other blockchains"
                  },
                  "chains": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "List of blockchains for which the public address must be obtained. The value can be: cosmoshub, osmosis, atomone, sentinel, teritori, gitopia, agoric"
                  }
                },
                "required": [
                  "chains"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response containing list of derived addresses",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/defaultAnswer"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request"
          },
          "500": {
            "description": "Internal server error"
          }
        }
      }
    },
    "/api/v1/validator/{chain}/{validator}": {
      "get": {
        "summary": "Retrieves the information of a blockchain validator",
        "operationId": "getValidator",
        "x-openai-isConsequential": false,
        "tags": [
          "validator"
        ],
        "parameters": [
          {
            "in": "path",
            "name": "chain",
            "required": true,
            "description": "Name of the blockchain. This parameter must have one of these values: cosmoshub, osmosis, bitsong, atomone, sentinel, teritori, gitopia, agoric",
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "validator",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Valoper address of the validator on the blockchain."
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response containing the information of the validator.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/defaultAnswer"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request"
          },
          "500": {
            "description": "Internal server error"
          }
        }
      }
    },
    "/api/v1/chain/{chain}/metrics": {
      "get": {
        "summary": "Retrieves metrics of a blockchain such as Inflation, Bonded Tokens, Not Bonded Tokens, Total Supply Tokens, Community Pool, Community Tax",
        "operationId": "getChainMetrics",
        "x-openai-isConsequential": false,
        "tags": [
          "chain"
        ],
        "parameters": [
          {
            "in": "path",
            "name": "chain",
            "required": true,
            "description": "Name of the blockchain. This parameter must have one of these values: cosmoshub, osmosis, bitsong, atomone, sentinel, teritori, gitopia, agoric",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response containing the blockchain information.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/defaultAnswer"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request"
          },
          "500": {
            "description": "Internal server error"
          }
        }
      }
    },
    "/api/v1/chain/{chain}/parameters": {
      "get": {
        "summary": "This API retrieves detailed information on a blockchain. It provides data on various aspects of the chain, such as token supply, governance parameters, IBC configurations, minting details, slashing rules, and staking specifics.",
        "operationId": "getChainParameters",
        "x-openai-isConsequential": false,
        "tags": [
          "chain"
        ],
        "parameters": [
          {
            "in": "path",
            "name": "chain",
            "required": true,
            "description": "Name of the blockchain. This parameter must have one of these values: cosmoshub, osmosis, bitsong, atomone, sentinel, teritori, gitopia, agoric",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response containing the blockchain parameters.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/defaultAnswer"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request"
          },
          "500": {
            "description": "Internal server error"
          }
        }
      }
    },
    "/api/v1/transaction/{chain}/{hash}": {
      "get": {
        "summary": "Get information about a blockchain transaction from its hash",
        "operationId": "getTransaction",
        "x-openai-isConsequential": false,
        "tags": [
          "transaction"
        ],
        "parameters": [
          {
            "in": "path",
            "name": "chain",
            "required": true,
            "description": "Name of the blockchain. This parameter must have one of these values: cosmoshub, osmosis, bitsong, atomone, sentinel, teritori, gitopia, agoric",
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "hash",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Hash of the transaction for which information is to be displayed."
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response containing the information of the transaction.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/defaultAnswer"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request"
          },
          "500": {
            "description": "Internal server error"
          }
        }
      }
    },
    "/api/v1/address/history": {
      "post": {
        "summary": "Retrieves the transaction history of a Cosmos ecosystem address",
        "operationId": "getAddressHistory",
        "x-openai-isConsequential": false,
        "tags": [
          "address",
          "history"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "chain": {
                    "type": "string",
                    "description": "Name of the blockchain. This parameter must have one of these values: cosmoshub, osmosis, bitsong, atomone, sentinel, teritori, gitopia, agoric"
                  },
                  "address": {
                    "type": "string",
                    "description": "Public address of the account for which the transaction history is to be displayed."
                  },
                  "page": {
                    "type": "integer",
                    "description": "Page number containing the information which by default is 1."
                  },
                  "limit": {
                    "type": "integer",
                    "description": "Number of items displayed per page between 10 and 25."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response containing the transaction history of the address.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/defaultAnswer"
                }
              }
            }
          },
          "400": {
            "description": "Invalid request"
          },
          "500": {
            "description": "Internal server error"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "defaultAnswer": {
        "type": "object",
        "properties": {
          "error": {
            "type": "boolean",
            "description": "Determines if an error occurred during the data generation."
          },
          "message": {
            "type": "string",
            "description": "Contains the information provided by the API."
          }
        }
      }
    }
  }
}