Akash Network Staking API

The Staking API from Akash Network — 14 operation(s) for staking.

Operations 16

GET /staking/delegators/{delegatorAddr}/delegations Get all delegations from a delegator
POST /staking/delegators/{delegatorAddr}/delegations Submit delegation
GET /staking/delegators/{delegatorAddr}/delegations/{validatorAddr} Query the current delegation between a delegator and a validator
GET /staking/delegators/{delegatorAddr}/unbonding_delegations Get all unbonding delegations from a delegator
POST /staking/delegators/{delegatorAddr}/unbonding_delegations Submit an unbonding delegation
GET /staking/delegators/{delegatorAddr}/unbonding_delegations/{validatorAddr} Query all unbonding delegations between a delegator and a validator
GET /staking/redelegations Get all redelegations (filter by query params)
POST /staking/delegators/{delegatorAddr}/redelegations Submit a redelegation
GET /staking/delegators/{delegatorAddr}/validators Query all validators that a delegator is bonded to
GET /staking/delegators/{delegatorAddr}/validators/{validatorAddr} Query a validator that a delegator is bonded to
GET /staking/validators Get all validator candidates. By default it returns only the bonded validators.
GET /staking/validators/{validatorAddr} Query the information from a single validator
GET /staking/validators/{validatorAddr}/delegations Get all delegations from a validator
GET /staking/validators/{validatorAddr}/unbonding_delegations Get all unbonding delegations from a validator
GET /staking/pool Get the current state of the staking pool
GET /staking/parameters Get the current staking parameter values

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-staking-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-staking-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: AKASH - gRPC Gateway docs Addresses Staking API
  description: A REST interface for state queries
  version: 1.0.0
servers:
- url: https://console-api.akash.network/
tags:
- name: Staking
paths:
  /staking/delegators/{delegatorAddr}/delegations:
    parameters:
    - in: path
      name: delegatorAddr
      description: Bech32 AccAddress of Delegator
      required: true
      x-example: cosmos16xyempempp92x9hyzz9wrgf94r6j9h5f06pxxv
      schema:
        type: string
    get:
      deprecated: true
      summary: Get all delegations from a delegator
      tags:
      - Staking
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    delegator_address:
                      type: string
                    validator_address:
                      type: string
                    shares:
                      type: string
                    balance:
                      type: object
                      properties:
                        denom:
                          type: string
                          example: stake
                        amount:
                          type: string
                          example: '50'
        '400':
          description: Invalid delegator address
        '500':
          description: Internal Server Error
    post:
      summary: Submit delegation
      tags:
      - Staking
      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 delegator address or delegation request 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)
                delegator_address:
                  type: string
                  description: bech32 encoded address
                  example: cosmos1depk54cuajgkzea6zpgkq36tnjwdzv4afc3d27
                validator_address:
                  type: string
                  description: bech32 encoded address
                  example: cosmosvaloper16xyempempp92x9hyzz9wrgf94r6j9h5f2w4n2l
                amount:
                  type: object
                  properties:
                    denom:
                      type: string
                      example: stake
                    amount:
                      type: string
                      example: '50'
        description: Delegate an amount of liquid coins to a validator
  /staking/delegators/{delegatorAddr}/delegations/{validatorAddr}:
    parameters:
    - in: path
      name: delegatorAddr
      description: Bech32 AccAddress of Delegator
      required: true
      x-example: cosmos16xyempempp92x9hyzz9wrgf94r6j9h5f06pxxv
      schema:
        type: string
    - in: path
      name: validatorAddr
      description: Bech32 OperatorAddress of validator
      required: true
      x-example: cosmosvaloper16xyempempp92x9hyzz9wrgf94r6j9h5f2w4n2l
      schema:
        type: string
    get:
      deprecated: true
      summary: Query the current delegation between a delegator and a validator
      tags:
      - Staking
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  delegator_address:
                    type: string
                  validator_address:
                    type: string
                  shares:
                    type: string
                  balance:
                    type: object
                    properties:
                      denom:
                        type: string
                        example: stake
                      amount:
                        type: string
                        example: '50'
        '400':
          description: Invalid delegator address or validator address
        '500':
          description: Internal Server Error
  /staking/delegators/{delegatorAddr}/unbonding_delegations:
    parameters:
    - in: path
      name: delegatorAddr
      description: Bech32 AccAddress of Delegator
      required: true
      x-example: cosmos16xyempempp92x9hyzz9wrgf94r6j9h5f06pxxv
      schema:
        type: string
    get:
      deprecated: true
      summary: Get all unbonding delegations from a delegator
      tags:
      - Staking
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    delegator_address:
                      type: string
                    validator_address:
                      type: string
                    initial_balance:
                      type: string
                    balance:
                      type: string
                    creation_height:
                      type: integer
                    min_time:
                      type: integer
        '400':
          description: Invalid delegator address
        '500':
          description: Internal Server Error
    post:
      summary: Submit an unbonding delegation
      tags:
      - Staking
      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 delegator address or unbonding delegation request 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)
                delegator_address:
                  type: string
                  description: bech32 encoded address
                  example: cosmos1depk54cuajgkzea6zpgkq36tnjwdzv4afc3d27
                validator_address:
                  type: string
                  description: bech32 encoded address
                  example: cosmosvaloper16xyempempp92x9hyzz9wrgf94r6j9h5f2w4n2l
                amount:
                  type: object
                  properties:
                    denom:
                      type: string
                      example: stake
                    amount:
                      type: string
                      example: '50'
        description: Unbond an amount of bonded shares from a validator
  /staking/delegators/{delegatorAddr}/unbonding_delegations/{validatorAddr}:
    parameters:
    - in: path
      name: delegatorAddr
      description: Bech32 AccAddress of Delegator
      required: true
      x-example: cosmos16xyempempp92x9hyzz9wrgf94r6j9h5f06pxxv
      schema:
        type: string
    - in: path
      name: validatorAddr
      description: Bech32 OperatorAddress of validator
      required: true
      x-example: cosmosvaloper16xyempempp92x9hyzz9wrgf94r6j9h5f2w4n2l
      schema:
        type: string
    get:
      deprecated: true
      summary: Query all unbonding delegations between a delegator and a validator
      tags:
      - Staking
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  delegator_address:
                    type: string
                  validator_address:
                    type: string
                  entries:
                    type: array
                    items:
                      type: object
                      properties:
                        initial_balance:
                          type: string
                        balance:
                          type: string
                        creation_height:
                          type: string
                        min_time:
                          type: string
        '400':
          description: Invalid delegator address or validator address
        '500':
          description: Internal Server Error
  /staking/redelegations:
    parameters:
    - in: query
      name: delegator
      description: Bech32 AccAddress of Delegator
      required: false
      schema:
        type: string
    - in: query
      name: validator_from
      description: Bech32 ValAddress of SrcValidator
      required: false
      schema:
        type: string
    - in: query
      name: validator_to
      description: Bech32 ValAddress of DstValidator
      required: false
      schema:
        type: string
    get:
      deprecated: true
      summary: Get all redelegations (filter by query params)
      tags:
      - Staking
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Redelegation'
        '500':
          description: Internal Server Error
  /staking/delegators/{delegatorAddr}/redelegations:
    parameters:
    - in: path
      name: delegatorAddr
      description: Bech32 AccAddress of Delegator
      required: true
      x-example: cosmos16xyempempp92x9hyzz9wrgf94r6j9h5f06pxxv
      schema:
        type: string
    post:
      deprecated: true
      summary: Submit a redelegation
      tags:
      - Staking
      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 delegator address or redelegation request 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)
                delegator_address:
                  type: string
                  description: bech32 encoded address
                  example: cosmos1depk54cuajgkzea6zpgkq36tnjwdzv4afc3d27
                validator_src_addressess:
                  type: string
                  description: bech32 encoded address
                  example: cosmosvaloper16xyempempp92x9hyzz9wrgf94r6j9h5f2w4n2l
                validator_dst_address:
                  type: string
                  description: bech32 encoded address
                  example: cosmosvaloper16xyempempp92x9hyzz9wrgf94r6j9h5f2w4n2l
                shares:
                  type: string
                  example: '100'
        description: The sender and tx information
  /staking/delegators/{delegatorAddr}/validators:
    parameters:
    - in: path
      name: delegatorAddr
      description: Bech32 AccAddress of Delegator
      required: true
      x-example: cosmos16xyempempp92x9hyzz9wrgf94r6j9h5f06pxxv
      schema:
        type: string
    get:
      deprecated: true
      summary: Query all validators that a delegator is bonded to
      tags:
      - Staking
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    operator_address:
                      type: string
                      description: bech32 encoded address
                      example: cosmosvaloper16xyempempp92x9hyzz9wrgf94r6j9h5f2w4n2l
                    consensus_pubkey:
                      type: string
                      example: cosmosvalconspub1zcjduepq0vu2zgkgk49efa0nqwzndanq5m4c7pa3u4apz4g2r9gspqg6g9cs3k9cuf
                    jailed:
                      type: boolean
                    status:
                      type: integer
                    tokens:
                      type: string
                    delegator_shares:
                      type: string
                    description:
                      type: object
                      properties:
                        moniker:
                          type: string
                        identity:
                          type: string
                        website:
                          type: string
                        security_contact:
                          type: string
                        details:
                          type: string
                    bond_height:
                      type: string
                      example: '0'
                    bond_intra_tx_counter:
                      type: integer
                      example: 0
                    unbonding_height:
                      type: string
                      example: '0'
                    unbonding_time:
                      type: string
                      example: '1970-01-01T00:00:00Z'
                    commission:
                      type: object
                      properties:
                        rate:
                          type: string
                          example: '0'
                        max_rate:
                          type: string
                          example: '0'
                        max_change_rate:
                          type: string
                          example: '0'
                        update_time:
                          type: string
                          example: '1970-01-01T00:00:00Z'
        '400':
          description: Invalid delegator address
        '500':
          description: Internal Server Error
  /staking/delegators/{delegatorAddr}/validators/{validatorAddr}:
    parameters:
    - in: path
      name: delegatorAddr
      description: Bech32 AccAddress of Delegator
      required: true
      x-example: cosmos16xyempempp92x9hyzz9wrgf94r6j9h5f06pxxv
      schema:
        type: string
    - in: path
      name: validatorAddr
      description: Bech32 ValAddress of Delegator
      required: true
      x-example: cosmosvaloper16xyempempp92x9hyzz9wrgf94r6j9h5f2w4n2l
      schema:
        type: string
    get:
      deprecated: true
      summary: Query a validator that a delegator is bonded to
      tags:
      - Staking
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  operator_address:
                    type: string
                    description: bech32 encoded address
                    example: cosmosvaloper16xyempempp92x9hyzz9wrgf94r6j9h5f2w4n2l
                  consensus_pubkey:
                    type: string
                    example: cosmosvalconspub1zcjduepq0vu2zgkgk49efa0nqwzndanq5m4c7pa3u4apz4g2r9gspqg6g9cs3k9cuf
                  jailed:
                    type: boolean
                  status:
                    type: integer
                  tokens:
                    type: string
                  delegator_shares:
                    type: string
                  description:
                    type: object
                    properties:
                      moniker:
                        type: string
                      identity:
                        type: string
                      website:
                        type: string
                      security_contact:
                        type: string
                      details:
                        type: string
                  bond_height:
                    type: string
                    example: '0'
                  bond_intra_tx_counter:
                    type: integer
                    example: 0
                  unbonding_height:
                    type: string
                    example: '0'
                  unbonding_time:
                    type: string
                    example: '1970-01-01T00:00:00Z'
                  commission:
                    type: object
                    properties:
                      rate:
                        type: string
                        example: '0'
                      max_rate:
                        type: string
                        example: '0'
                      max_change_rate:
                        type: string
                        example: '0'
                      update_time:
                        type: string
                        example: '1970-01-01T00:00:00Z'
        '400':
          description: Invalid delegator address or validator address
        '500':
          description: Internal Server Error
  /staking/validators:
    get:
      deprecated: true
      summary: Get all validator candidates. By default it returns only the bonded validators.
      parameters:
      - in: query
        name: status
        description: The validator bond status. Must be either 'bonded', 'unbonded', or 'unbonding'.
        x-example: bonded
        schema:
          type: string
      - in: query
        name: page
        description: The page number.
        x-example: 1
        schema:
          type: integer
      - in: query
        name: limit
        description: The maximum number of items per page.
        x-example: 1
        schema:
          type: integer
      tags:
      - Staking
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    operator_address:
                      type: string
                      description: bech32 encoded address
                      example: cosmosvaloper16xyempempp92x9hyzz9wrgf94r6j9h5f2w4n2l
                    consensus_pubkey:
                      type: string
                      example: cosmosvalconspub1zcjduepq0vu2zgkgk49efa0nqwzndanq5m4c7pa3u4apz4g2r9gspqg6g9cs3k9cuf
                    jailed:
                      type: boolean
                    status:
                      type: integer
                    tokens:
                      type: string
                    delegator_shares:
                      type: string
                    description:
                      type: object
                      properties:
                        moniker:
                          type: string
                        identity:
                          type: string
                        website:
                          type: string
                        security_contact:
                          type: string
                        details:
                          type: string
                    bond_height:
                      type: string
                      example: '0'
                    bond_intra_tx_counter:
                      type: integer
                      example: 0
                    unbonding_height:
                      type: string
                      example: '0'
                    unbonding_time:
                      type: string
                      example: '1970-01-01T00:00:00Z'
                    commission:
                      type: object
                      properties:
                        rate:
                          type: string
                          example: '0'
                        max_rate:
                          type: string
                          example: '0'
                        max_change_rate:
                          type: string
                          example: '0'
                        update_time:
                          type: string
                          example: '1970-01-01T00:00:00Z'
        '500':
          description: Internal Server Error
  /staking/validators/{validatorAddr}:
    parameters:
    - in: path
      name: validatorAddr
      description: Bech32 OperatorAddress of validator
      required: true
      x-example: cosmosvaloper16xyempempp92x9hyzz9wrgf94r6j9h5f2w4n2l
      schema:
        type: string
    get:
      deprecated: true
      summary: Query the information from a single validator
      tags:
      - Staking
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  operator_address:
                    type: string
                    description: bech32 encoded address
                    example: cosmosvaloper16xyempempp92x9hyzz9wrgf94r6j9h5f2w4n2l
                  consensus_pubkey:
                    type: string
                    example: cosmosvalconspub1zcjduepq0vu2zgkgk49efa0nqwzndanq5m4c7pa3u4apz4g2r9gspqg6g9cs3k9cuf
                  jailed:
                    type: boolean
                  status:
                    type: integer
                  tokens:
                    type: string
                  delegator_shares:
                    type: string
                  description:
                    type: object
                    properties:
                      moniker:
                        type: string
                      identity:
                        type: string
                      website:
                        type: string
                      security_contact:
                        type: string
                      details:
                        type: string
                  bond_height:
                    type: string
                    example: '0'
                  bond_intra_tx_counter:
                    type: integer
                    example: 0
                  unbonding_height:
                    type: string
                    example: '0'
                  unbonding_time:
                    type: string
                    example: '1970-01-01T00:00:00Z'
                  commission:
                    type: object
                    properties:
                      rate:
                        type: string
                        example: '0'
                      max_rate:
                        type: string
                        example: '0'
                      max_change_rate:
                        type: string
                        example: '0'
                      update_time:
                        type: string
                        example: '1970-01-01T00:00:00Z'
        '400':
          description: Invalid validator address
        '500':
          description: Internal Server Error
  /staking/validators/{validatorAddr}/delegations:
    parameters:
    - in: path
      name: validatorAddr
      description: Bech32 OperatorAddress of validator
 

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