---
updatedAt: 2026-05-07T01:57:09.000Z
agentTools:
  projectIndex: https://docs.mavan.bitminetech.io/llms.txt
---

# Add Cardano Stake Account

Add a known Cardano stake account to your account

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "paths": {
    "/cardano/stake/account": {
      "post": {
        "description": "Add a known Cardano stake account to your account",
        "operationId": "addCardanoStakeAccount",
        "parameters": [
          {
            "name": "api-key",
            "in": "header",
            "description": "mavan api key",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AddCardanoStakeAccountDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/ApiResponseBase"
                    },
                    {
                      "properties": {
                        "data": {
                          "$ref": "#/components/schemas/CardanoStakeAccount"
                        }
                      }
                    }
                  ],
                  "required": [
                    "data"
                  ]
                }
              }
            }
          }
        },
        "summary": "Add Cardano Stake Account",
        "tags": [
          "Cardano"
        ]
      }
    }
  },
  "info": {
    "title": "MAVAN Staking API",
    "description": "The MAVAN Staking API Docs",
    "version": "1.0.181-main-mainnet",
    "contact": {}
  },
  "servers": [
    {
      "url": "https://gw-1.api.standardvalidator.com"
    }
  ],
  "components": {
    "schemas": {
      "ApiResponseBase": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string"
          }
        }
      },
      "CardanoStakeAccount": {
        "type": "object",
        "properties": {
          "stakeAccountAddress": {
            "type": "string"
          },
          "poolId": {
            "type": "string"
          },
          "lovelace": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "reference": {
            "type": "string"
          },
          "label": {
            "type": "string"
          },
          "activationEpoch": {
            "type": "number"
          },
          "lastSyncEpoch": {
            "type": "number"
          },
          "totalWithdrawals": {
            "type": "string"
          },
          "withdrawableAmount": {
            "type": "string"
          },
          "drepId": {
            "type": "string"
          },
          "performanceTotal": {
            "type": "string"
          },
          "performance30d": {
            "type": "string"
          },
          "performance7d": {
            "type": "string"
          }
        },
        "required": [
          "stakeAccountAddress",
          "poolId",
          "lovelace",
          "status",
          "reference",
          "label",
          "activationEpoch",
          "lastSyncEpoch",
          "totalWithdrawals",
          "withdrawableAmount",
          "drepId",
          "performanceTotal",
          "performance30d",
          "performance7d"
        ]
      },
      "AddCardanoStakeAccountDto": {
        "type": "object",
        "properties": {
          "stakeAccountAddress": {
            "type": "string",
            "description": "The stake account address to add to the system",
            "example": "stake1u9klnfr0v4f2k3v2c0t4d0h3l2p8x9q6r7s8t9u0v1w2x3y4z5a6b7c8d9e0f"
          },
          "reference": {
            "type": "string",
            "description": "Arbitrary reference/grouping, this will show in the UI as the account",
            "example": "Test Fund"
          },
          "label": {
            "type": "string",
            "description": "Secondary label for this particular stake position",
            "example": "Balance Sheet Stake"
          }
        },
        "required": [
          "stakeAccountAddress",
          "reference"
        ]
      }
    }
  }
}
```