Akash Network Governance API

The Governance API from Akash Network — 12 operation(s) for governance.

Operations 15

POST /gov/proposals Submit a proposal
GET /gov/proposals Query proposals
POST /gov/proposals/param_change Generate a parameter change proposal transaction
GET /gov/proposals/{proposalId} Query a proposal
GET /gov/proposals/{proposalId}/proposer Query proposer
GET /gov/proposals/{proposalId}/deposits Query deposits
POST /gov/proposals/{proposalId}/deposits Deposit tokens to a proposal
GET /gov/proposals/{proposalId}/deposits/{depositor} Query deposit
GET /gov/proposals/{proposalId}/votes Query voters
POST /gov/proposals/{proposalId}/votes Vote a proposal
GET /gov/proposals/{proposalId}/votes/{voter} Query vote
GET /gov/proposals/{proposalId}/tally Get a proposal's tally result at the current time
GET /gov/parameters/deposit Query governance deposit parameters
GET /gov/parameters/tallying Query governance tally parameters
GET /gov/parameters/voting Query governance voting parameters

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/akash-governance-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

akash-governance-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: AKASH - gRPC Gateway docs Addresses Governance API
  description: A REST interface for state queries
  version: 1.0.0
servers:
- url: https://console-api.akash.network/
tags:
- name: Governance
paths:
  /gov/proposals:
    post:
      deprecated: true
      summary: Submit a proposal
      description: Send transaction to submit a proposal
      tags:
      - Governance
      responses:
        '200':
          description: Tx was succesfully generated
          content:
            application/json:
              schema:
                type: object
                properties:
                  msg:
                    type: array
                    items:
                      type: string
                  fee:
                    type: object
                    properties:
                      gas:
                        type: string
                      amount:
                        type: array
                        items:
                          type: object
                          properties:
                            denom:
                              type: string
                              example: stake
                            amount:
                              type: string
                              example: '50'
                  memo:
                    type: string
                  signature:
                    type: object
                    properties:
                      signature:
                        type: string
                        example: MEUCIQD02fsDPra8MtbRsyB1w7bqTM55Wu138zQbFcWx4+CFyAIge5WNPfKIuvzBZ69MyqHsqD8S1IwiEp+iUb6VSdtlpgY=
                      pub_key:
                        type: object
                        properties:
                          type:
                            type: string
                            example: tendermint/PubKeySecp256k1
                          value:
                            type: string
                            example: Avz04VhtKJh8ACCVzlI8aTosGy0ikFXKIVHQ3jKMrosH
                      account_number:
                        type: string
                        example: '0'
                      sequence:
                        type: string
                        example: '0'
        '400':
          description: Invalid proposal body
        '500':
          description: Internal Server Error
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                base_req:
                  type: object
                  properties:
                    from:
                      type: string
                      example: cosmos1g9ahr6xhht5rmqven628nklxluzyv8z9jqjcmc
                      description: Sender address or Keybase name to generate a transaction
                    memo:
                      type: string
                      example: Sent via Cosmos Voyager 🚀
                    chain_id:
                      type: string
                      example: Cosmos-Hub
                    account_number:
                      type: string
                      example: '0'
                    sequence:
                      type: string
                      example: '1'
                    gas:
                      type: string
                      example: '200000'
                    gas_adjustment:
                      type: string
                      example: '1.2'
                    fees:
                      type: array
                      items:
                        type: object
                        properties:
                          denom:
                            type: string
                            example: stake
                          amount:
                            type: string
                            example: '50'
                    simulate:
                      type: boolean
                      example: false
                      description: Estimate gas for a transaction (cannot be used in conjunction with generate_only)
                title:
                  type: string
                description:
                  type: string
                proposal_type:
                  type: string
                  example: text
                proposer:
                  type: string
                  description: bech32 encoded address
                  example: cosmos1depk54cuajgkzea6zpgkq36tnjwdzv4afc3d27
                initial_deposit:
                  type: array
                  items:
                    type: object
                    properties:
                      denom:
                        type: string
                        example: stake
                      amount:
                        type: string
                        example: '50'
        description: valid value of `"proposal_type"` can be `"text"`, `"parameter_change"`, `"software_upgrade"`
        required: true
    get:
      deprecated: true
      summary: Query proposals
      description: Query proposals information with parameters
      tags:
      - Governance
      parameters:
      - in: query
        name: voter
        description: voter address
        required: false
        schema:
          type: string
      - in: query
        name: depositor
        description: depositor address
        required: false
        schema:
          type: string
      - in: query
        name: status
        description: proposal status, valid values can be `"deposit_period"`, `"voting_period"`, `"passed"`, `"rejected"`
        required: false
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    proposal_id:
                      type: integer
                    title:
                      type: string
                    description:
                      type: string
                    proposal_type:
                      type: string
                    proposal_status:
                      type: string
                    final_tally_result:
                      type: object
                      properties:
                        'yes':
                          type: string
                          example: '0.0000000000'
                        abstain:
                          type: string
                          example: '0.0000000000'
                        'no':
                          type: string
                          example: '0.0000000000'
                        no_with_veto:
                          type: string
                          example: '0.0000000000'
                    submit_time:
                      type: string
                    total_deposit:
                      type: array
                      items:
                        type: object
                        properties:
                          denom:
                            type: string
                            example: stake
                          amount:
                            type: string
                            example: '50'
                    voting_start_time:
                      type: string
        '400':
          description: Invalid query parameters
        '500':
          description: Internal Server Error
  /gov/proposals/param_change:
    post:
      deprecated: true
      summary: Generate a parameter change proposal transaction
      description: Generate a parameter change proposal transaction
      tags:
      - Governance
      responses:
        '200':
          description: The transaction was succesfully generated
          content:
            application/json:
              schema:
                type: object
                properties:
                  msg:
                    type: array
                    items:
                      type: string
                  fee:
                    type: object
                    properties:
                      gas:
                        type: string
                      amount:
                        type: array
                        items:
                          type: object
                          properties:
                            denom:
                              type: string
                              example: stake
                            amount:
                              type: string
                              example: '50'
                  memo:
                    type: string
                  signature:
                    type: object
                    properties:
                      signature:
                        type: string
                        example: MEUCIQD02fsDPra8MtbRsyB1w7bqTM55Wu138zQbFcWx4+CFyAIge5WNPfKIuvzBZ69MyqHsqD8S1IwiEp+iUb6VSdtlpgY=
                      pub_key:
                        type: object
                        properties:
                          type:
                            type: string
                            example: tendermint/PubKeySecp256k1
                          value:
                            type: string
                            example: Avz04VhtKJh8ACCVzlI8aTosGy0ikFXKIVHQ3jKMrosH
                      account_number:
                        type: string
                        example: '0'
                      sequence:
                        type: string
                        example: '0'
        '400':
          description: Invalid proposal body
        '500':
          description: Internal Server Error
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                base_req:
                  type: object
                  properties:
                    from:
                      type: string
                      example: cosmos1g9ahr6xhht5rmqven628nklxluzyv8z9jqjcmc
                      description: Sender address or Keybase name to generate a transaction
                    memo:
                      type: string
                      example: Sent via Cosmos Voyager 🚀
                    chain_id:
                      type: string
                      example: Cosmos-Hub
                    account_number:
                      type: string
                      example: '0'
                    sequence:
                      type: string
                      example: '1'
                    gas:
                      type: string
                      example: '200000'
                    gas_adjustment:
                      type: string
                      example: '1.2'
                    fees:
                      type: array
                      items:
                        type: object
                        properties:
                          denom:
                            type: string
                            example: stake
                          amount:
                            type: string
                            example: '50'
                    simulate:
                      type: boolean
                      example: false
                      description: Estimate gas for a transaction (cannot be used in conjunction with generate_only)
                title:
                  type: string
                  x-example: Param Change
                description:
                  type: string
                  x-example: Update max validators
                proposer:
                  type: string
                  description: bech32 encoded address
                  example: cosmos1depk54cuajgkzea6zpgkq36tnjwdzv4afc3d27
                deposit:
                  type: array
                  items:
                    type: object
                    properties:
                      denom:
                        type: string
                        example: stake
                      amount:
                        type: string
                        example: '50'
                changes:
                  type: array
                  items:
                    type: object
                    properties:
                      subspace:
                        type: string
                        example: staking
                      key:
                        type: string
                        example: MaxValidators
                      subkey:
                        type: string
                        example: ''
                      value:
                        type: object
        description: The parameter change proposal body that contains all parameter changes
        required: true
  /gov/proposals/{proposalId}:
    get:
      deprecated: true
      summary: Query a proposal
      description: Query a proposal by id
      tags:
      - Governance
      parameters:
      - name: proposalId
        required: true
        in: path
        x-example: '2'
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  proposal_id:
                    type: integer
                  title:
                    type: string
                  description:
                    type: string
                  proposal_type:
                    type: string
                  proposal_status:
                    type: string
                  final_tally_result:
                    type: object
                    properties:
                      'yes':
                        type: string
                        example: '0.0000000000'
                      abstain:
                        type: string
                        example: '0.0000000000'
                      'no':
                        type: string
                        example: '0.0000000000'
                      no_with_veto:
                        type: string
                        example: '0.0000000000'
                  submit_time:
                    type: string
                  total_deposit:
                    type: array
                    items:
                      type: object
                      properties:
                        denom:
                          type: string
                          example: stake
                        amount:
                          type: string
                          example: '50'
                  voting_start_time:
                    type: string
        '400':
          description: Invalid proposal id
        '500':
          description: Internal Server Error
  /gov/proposals/{proposalId}/proposer:
    get:
      deprecated: true
      summary: Query proposer
      description: Query for the proposer for a proposal
      tags:
      - Governance
      parameters:
      - name: proposalId
        required: true
        in: path
        x-example: '2'
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  proposal_id:
                    type: string
                  proposer:
                    type: string
        '400':
          description: Invalid proposal ID
        '500':
          description: Internal Server Error
  /gov/proposals/{proposalId}/deposits:
    get:
      deprecated: true
      summary: Query deposits
      description: Query deposits by proposalId
      tags:
      - Governance
      parameters:
      - name: proposalId
        required: true
        in: path
        x-example: '2'
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    amount:
                      type: array
                      items:
                        type: object
                        properties:
                          denom:
                            type: string
                            example: stake
                          amount:
                            type: string
                            example: '50'
                    proposal_id:
                      type: string
                    depositor:
                      type: string
                      description: bech32 encoded address
                      example: cosmos1depk54cuajgkzea6zpgkq36tnjwdzv4afc3d27
        '400':
          description: Invalid proposal id
        '500':
          description: Internal Server Error
    post:
      deprecated: true
      summary: Deposit tokens to a proposal
      description: Send transaction to deposit tokens to a proposal
      tags:
      - Governance
      parameters:
      - description: proposal id
        name: proposalId
        required: true
        in: path
        x-example: '2'
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  msg:
                    type: array
                    items:
                      type: string
                  fee:
                    type: object
                    properties:
                      gas:
                        type: string
                      amount:
                        type: array
                        items:
                          type: object
                          properties:
                            denom:
                              type: string
                              example: stake
                            amount:
                              type: string
                              example: '50'
                  memo:
                    type: string
                  signature:
                    type: object
                    properties:
                      signature:
                        type: string
                        example: MEUCIQD02fsDPra8MtbRsyB1w7bqTM55Wu138zQbFcWx4+CFyAIge5WNPfKIuvzBZ69MyqHsqD8S1IwiEp+iUb6VSdtlpgY=
                      pub_key:
                        type: object
                        properties:
                          type:
                            type: string
                            example: tendermint/PubKeySecp256k1
                          value:
                            type: string
                            example: Avz04VhtKJh8ACCVzlI8aTosGy0ikFXKIVHQ3jKMrosH
                      account_number:
                        type: string
                        example: '0'
                      sequence:
                        type: string
                        example: '0'
        '400':
          description: Invalid proposal id or deposit body
        '401':
          description: Key password is wrong
        '500':
          description: Internal Server Error
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                base_req:
                  type: object
                  properties:
                    from:
                      type: string
                      example: cosmos1g9ahr6xhht5rmqven628nklxluzyv8z9jqjcmc
                      description: Sender address or Keybase name to generate a transaction
                    memo:
                      type: string
                      example: Sent via Cosmos Voyager 🚀
                    chain_id:
                      type: string
                      example: Cosmos-Hub
                    account_number:
                      type: string
                      example: '0'
                    sequence:
                      type: string
                      example: '1'
                    gas:
                      type: string
                      example: '200000'
                    gas_adjustment:
                      type: string
                      example: '1.2'
                    fees:
                      type: array
                      items:
                        type: object
                        properties:
                          denom:
                            type: string
                            example: stake
                          amount:
                            type: string
                            example: '50'
                    simulate:
                      type: boolean
                      example: false
                      description: Estimate gas for a transaction (cannot be used in conjunction with generate_only)
                depositor:
                  type: string
                  description: bech32 encoded address
                  example: cosmos1depk54cuajgkzea6zpgkq36tnjwdzv4afc3d27
                amount:
                  type: array
                  items:
                    type: object
                    properties:
                      denom:
                        type: string
                        example: stake
                      amount:
                        type: string
                        example: '50'
        required: true
  /gov/proposals/{proposalId}/deposits/{depositor}:
    get:
      deprecated: true
      summary: Query deposit
      description: Query deposit by proposalId and depositor address
      tags:
      - Governance
      parameters:
      - description: proposal id
        name: proposalId
        required: true
        in: path
        x-example: '2'
        schema:
          type: string
      - description: Bech32 depositor address
        name: depositor
        required: true
        in: path
        x-example: cosmos16xyempempp92x9hyzz9wrgf94r6j9h5f06pxxv
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  amount:
                    type: array
                    items:
                      type: object
                      properties:
                        denom:
                          type: string
                          example: stake
                        amount:
                          type: string
                          example: '50'
                  proposal_id:
                    type: string
                  depositor:
                    type: string
                    description: bech32 encoded address
                    example: cosmos1depk54cuajgkzea6zpgkq36tnjwdzv4afc3d27
        '400':
          description: Invalid proposal id or depositor address
        '404':
          description: Found no deposit
        '500':
          description: Internal Server Error
  /gov/proposals/{proposalId}/votes:
    get:
      deprecated: true
      summary: Query voters
      description: Query voters information by proposalId
      tags:
      - Governance
      parameters:
      - description: proposal id
        name: proposalId
        required: true
        in: path
        x-example: '2'
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    voter:
                      type: string
                    proposal_id:
                      type: string
                    option:
                      type: string
        '400':
          description: Invalid proposal id
        '500':
          description: Internal Server Error
    post:
      deprecated: true
      summary: Vote a proposal
      description: Send transaction to vote a proposal
      tags:
      - Governance
      parameters:
      - description: proposal id
        name: proposalId
        required: true
        in: path
        x-example: '2'
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  msg:
                    type: array
                    items:
                      type: string
                  fee:
                    type: object
                    properties:
                      gas:
                        type: string
                      amount:
                        type: array
                        items:
                          type: object
                          properties:
                            denom:
                              type: string
                              example: stake
                            amount:
                              type: string
                              example: '50'
                  memo:
                    type: string
                  signature:
                    type: object
                    properties:
                      signature:
                        type: string
                        example: MEUCIQD02fsDPra8MtbRsyB1w7bqTM55Wu138zQbFcWx4+CFyAIge5WNPfKIuvzBZ69MyqHsqD8S1IwiEp+iUb6VSdtlpgY=
                      pub_key:
                        type: object
                        properties:
                          type:
                            type: string
                            example: tendermint/PubKeySecp256k1
                          value:
                            type: string
                            example: Avz04VhtKJh8ACCVzlI8aTosGy0ikFXKIVHQ3jKMrosH
                      account_number:
                        type: string
                        example: '0'
                      sequence:
                        type: string
                        example: '0'
        '400':
          description: Invalid proposal id or vote body
        '401':
          description: Key password is wrong
        '500':
          description: Internal Server Error
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                base_req:
                  type: object
                  properties:
                    from:
                      type: string
                      example: cosmos1g9ahr6xhht5rmqven628nklxluzyv8z9jqjcmc
                      description: Sender address or Keybase name to generate a transaction
                    memo:
                      type: string
                      example: Sent via Cosmos Voyager 🚀
                    chain_id:
                      type: string
                      example: Cosmos-Hub
                    account_number:
                      type: string
                      example: '0'
                    sequence:
                      type: string
                      example: '1'
                    gas:
                      type: string
                      example: '200000'
                    gas_adjustment:
                      type: string
                      example: '1.2'
                    fees:
                      type: array
                      items:
                        type: object
                        properties:
                          denom:
                            type: string
                            example: stake
                          amount:
                            type: string
                            example: '50'
                    simulate:
                      type: boolean
                      example: false
                      description: Estimate gas for a transaction (cannot be used in conjunction with generate_only)
                voter:
                  type: string
                  description: bech32 encoded address
                  example: cosmos1depk54cuajgkzea6zpgkq36tnjwdzv4afc3d27
                option:
                  type: string
                  example: 'yes'
        description: valid value of `"option"` field can be `"yes"`, `"no"`, `"no_with_veto"` and `"abstain"`
        required: true
  /gov/proposals/{proposalId}/votes/{voter}:
    get:
      deprecated: true
      summary: Query vote
      description: Query vote information by proposal Id and voter address
      tags:
      - Governance
      parameters:
      - description: proposal id
        name: proposalId
        required: true
        in: path
        x-example: '2'
        schema:
          type: string
      - description: Bech32 voter address
        name: voter
        required: true
        in: path
        x-example: cosmos16xyempempp92x9hyzz9wrgf94r6j9h5f06pxxv
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  voter:
                    type: string
                  proposal_id:
                    type: string
                  option:
                    type: string
        '400':
          description: Invalid proposal id or voter address
        '404':
          description: Found no vote
        '500':
          description: Internal Server Error
  /gov/proposals/{proposalId}/tally:
    get:
      deprecated: true
      summary: Get a proposal's tally result at the current time
      description: Gets a proposal's tally result at the current time. If the proposal is pending deposits (i.e status 'DepositPeriod') it returns an empty tally result.
      tags:
      - Governance
      parameters:
      - description: proposal id
        name: proposalId
        required: true
        in: path
        x-example: '2'
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  'yes':
                    type: string
                    example: '0.0000000000'
                  abstain:
                    type: string
                    example: '0.0000000000'
                  'no':
                    type: string
                    example: '0.0000000000'
                  no_with_veto:
                    type: string
                    example: '0.0000000000'
        '400':
          description: Invalid proposal id
        '500':
          description: Internal Server Error
  /gov/parameters/deposit:
    get:
      deprecated: true
      summary: Query governance deposit parameters
      description: Query governance deposit parameters. The max_deposit_period units are in nanoseconds.
      tags:
      - Governance
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  min_deposit:
                    type: array
                    items:
                      type: object
                      properties:
                        denom:
                          type: string
                          example: stake
                        amount:
                          type: string
                          example: '50'
                  max_deposit_period:
                    type: string
                    example: '86400000000000'
        '400':
          description: <other_path> is not a valid query request path
        '404':
          description: Found no deposit parameters
        '500':
          description: Internal Server Error
  /gov/parameters/tallying:
    get:
      deprecated: true
      summary: Query governance tally parameters
      description: Query governance tally parameters
      tags:
      - Governance
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                properties:
                  threshold:
                    type: string
                    example: '0.5000000000'
                  veto:
                    type: string
                    example: '0.3340000000'
                  govern

# --- truncated at 32 KB (33 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/akash/refs/heads/main/openapi/akash-governance-api-openapi.yml