> ## Documentation Index
> Fetch the complete documentation index at: https://docs.p2p.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Cardano

> Unified API + Cardano Integration Workflow

This guide explains how to integrate the `cardano` chain using the Unified API. The Cardano integration aligns with the general [Unified API process](/docs/unified-api-getting-started) but with network-specific parameters.

[Get an authentication token](/docs/authentication) to start using the Unified API.

Request examples are provided using [cURL](https://curl.se/).

> To check the integration guides for other chains, refer to the [Networks Supported](/docs/unified-api-networks) section.

<Note>
  **Key Cardano-specific details**

  * `chain` — always set to `cardano` for Cardano-related requests.
  * `network` — environment in which the transaction is processed: `mainnet` only.
  * `stakerAddress` — account address initiating staking, unstaking or withdrawal transactions.
  * `amount` — amount of tokens in ADA.
</Note>

## Staking flow

### 1. Create staking request

Send a POST request to [/api/v1/unified/staking/stake](/reference/unified-create-stake-transaction).

Example request:

<CodeGroup>
  ```bash bash theme={null}
  curl --request POST \
       --url https://api.p2p.org/api/v1/unified/staking/stake \
       --header 'Content-Type: application/json' \
       --header 'Authorization: Bearer <token>' \
       --data '{
      "chain": "cardano",
      "network": "mainnet",
      "stakerAddress": "addr1q847hfazcye3f4g4f4fwf6l386tud6lp6lqvfawzvcartzvg73xawnxm8wvflhpt8kkm5kg4nlv8a0fx6ezxgv6r2nrqcl6wxm",
      "amount": 5
  }'
  ```
</CodeGroup>

* `chain` — blockchain network, always set to `cardano` for Cardano-related requests.
* `network` — environment in which the transaction is processed: `mainnet` only.
* `stakerAddress` — Cardano account address initiating the staking transaction.
* `amount` — amount of tokens to stake in ADA, minimum amount is 5 ADA.

Example response:

<CodeGroup>
  ```json JSON theme={null}
  {
      "error": null,
      "result": {
          "amount": 5,
          "stakerAddress": "addr1q847hfazcye3f4g4f4fwf6l386tud6lp6lqvfawzvcartzvg73xawnxm8wvflhpt8kkm5kg4nlv8a0fx6ezxgv6r2nrqcl6wxm",
          "unsignedTransactionData": "84a400d9010281825820a7aec4e68399fd4668ac034cccc3fbb726a40fac88f0e5fd74be702ce2f2d93a00018182583901ebeba7a2c13314d5154d52e4ebf13e97c6ebe1d7c0c4f5c2663a358988f44dd74cdb3b989fdc2b3dadba59159fd87ebd26d64464334354c61a003517dd021a0002a96104d901028282008200581c88f44dd74cdb3b989fdc2b3dadba59159fd87ebd26d64464334354c683028200581c88f44dd74cdb3b989fdc2b3dadba59159fd87ebd26d64464334354c6581cc29c92f8319150962650bc8a5e24d918491e8a7b3ac43525afe76baaa0f5f6",
          "createdAt": "2025-05-15T20:23:20.088Z",
          "extraData": {
              "transactionId": "2de012ab-72d8-4971-a570-9771f3530fca",
              "stakeId": "b3d6c077-a59b-4585-a0df-85ae16c0d3af",
              "gasEstimate": {
                  "amount": "0.165149000000000000",
                  "gasLimit": ""
              }
          }
      }
  }
  ```
</CodeGroup>

* `amount` — amount of tokens to stake in ADA.

* `stakerAddress` — account address initiating the staking transaction.

* `unsignedTransactionData` — unsigned transaction in CBOR, Base64 encrypted format. Sign the transaction and submit it to the blockchain to perform the called action.

* `createdAt` — timestamp of the transaction in the ISO 8601 format.

* `extraData` — additional transaction details:

  * `transactionId` — unique identifier of the transaction within this staking session.

  * `stakeId` — unique identifier of the staking request.

  * `gasEstimate` — estimated gas usage details:

    * `amount` — estimated fee in ADA for processing the transaction.
    * `gasLimit` — maximum gas limit for the transaction; can be left empty or ignored, since it is not used in Cardano and reserved for compatibility only.

### 2. Sign and send transaction

Use `unsignedTransactionData` to [sign](/docs/unified-api-signing-transaction) the transaction.

To broadcast the signed transaction to the Cardano network, send a POST request to [/api/v1/unified/transaction/broadcast](/reference/unified-transaction-send).

Example request:

<CodeGroup>
  ```bash bash theme={null}
  curl --request POST \
       --url https://api.p2p.org/api/v1/unified/transaction/broadcast \
       --header 'Content-Type: application/json' \
       --header 'Authorization: Bearer <token>' \
       --data '{
      "chain": "cardano",
      "network": "mainnet",
      "signedTransaction": "84a400d9010281825820a7aec4e68399fd4668ac034cccc3fbb726a40fac88f0e5fd74be702ce2f2d93a00018182583901ebeba7a2c13314d5154d52e4ebf13e97c6ebe1d7c0c4f5c2663a358988f44dd74cdb3b989fdc2b3dadba59159fd87ebd26d64464334354c61a003517dd021a0002a96104d901028282008200581c88f44dd74cdb3b989fdc2b3dadba59159fd87ebd26d64464334354c683028200581c88f44dd74cdb3b989fdc2b3dadba59159fd87ebd26d64464334354c6581cc29c92f8319150962650bc8a5e24d918491e8a7b3ac43525afe76baaa1008282582020c22b2dbf4eacea4eb791bd9606806bd3428fc336ddcc42f316a55dbfc1aa2f584094b1c1a9c804b8355abd57e8a496bfef1bf42a5d6b3f1377b6d5d9c3cc443e790f0cbcd34ea347801a51a79ca79a4e0cf2d6925383e707c0a7c4246614101f09825820197e920a7fe4ab16264c847f748d15ec82b0cdc126a12373aa20f0bf154aa23458408603bd62494828461177ba2c0ad96ec6b071b7f4c89e3b9c013c50e1027d7b04d49e91168f31d7a9f12f333c566a27f1bc6ed53a4ab5be2aef523751e2fa5507f5f6",
      "stakerAddress": "addr1q847hfazcye3f4g4f4fwf6l386tud6lp6lqvfawzvcartzvg73xawnxm8wvflhpt8kkm5kg4nlv8a0fx6ezxgv6r2nrqcl6wxm",
      "extra": {
          "transactionId": "2de012ab-72d8-4971-a570-9771f3530fca"
      }
  }'
  ```
</CodeGroup>

* `chain` — blockchain network.
* `network` — environment in which the transaction is processed.
* `signedTransaction` — signed transaction in Base64 encrypted format, which contains all transaction details (e.g., accounts, instructions, and signatures) required to broadcast the transaction to the network.
* `stakerAddress` — staking account address receiving the staked tokens.
* `extra` — additional request parameters:
  * `transactionId` — unique identifier of the transaction within this staking session.

Example response:

<CodeGroup>
  ```json JSON theme={null}
  {
      "error": null,
      "result": {
          "extraData": {
              "transactionHash": "0a98464fa4eb52c666a03f8f9f1673db7a905c32e475e1e76f33ad0af506b6f9"
          }
      }
  }
  ```
</CodeGroup>

* `extraData` — additional transaction details:
  * `transactionHash` — hash of the block in which the transaction has been included.

## Unstaking flow

### 1. Create unstaking request

Send a POST request to [/api/v1/unified/staking/unstake](/reference/unified-create-unstake-transaction).

Example request:

<CodeGroup>
  ```bash bash theme={null}
  curl --request POST \
       --url https://api.p2p.org/api/v1/unified/staking/unstake \
       --header 'Content-Type: application/json' \
       --header 'Authorization: Bearer <token>' \
       --data '{
      "chain": "cardano",
      "network": "mainnet",
      "stakerAddress": "addr1q847hfazcye3f4g4f4fwf6l386tud6lp6lqvfawzvcartzvg73xawnxm8wvflhpt8kkm5kg4nlv8a0fx6ezxgv6r2nrqcl6wxm",
      "extra": {
          "amount": 5
      }
  }'
  ```
</CodeGroup>

* `chain` — blockchain network.
* `network` — environment in which the transaction is processed.
* `stakerAddress` — account address initiated the staking transaction.
* `extra` — additional parameters:
  * `amount` — amount of tokens to withdraw in ADA.

Example response:

<CodeGroup>
  ```json JSON theme={null}
  {
      "error": null,
      "result": {
          "amount": 5,
          "stakerAddress": "addr1q847hfazcye3f4g4f4fwf6l386tud6lp6lqvfawzvcartzvg73xawnxm8wvflhpt8kkm5kg4nlv8a0fx6ezxgv6r2nrqcl6wxm",
          "unsignedTransactionData": "84a400d90102818258200a98464fa4eb52c666a03f8f9f1673db7a905c32e475e1e76f33ad0af506b6f900018182583901ebeba7a2c13314d5154d52e4ebf13e97c6ebe1d7c0c4f5c2663a358988f44dd74cdb3b989fdc2b3dadba59159fd87ebd26d64464334354c61a0050fdfc021a00029e6104d901028182018200581c88f44dd74cdb3b989fdc2b3dadba59159fd87ebd26d64464334354c6a0f5f6",
          "createdAt": "2025-05-15T20:24:32.851Z",
          "extraData": {
              "transactionId": "ce8f7141-114a-4f72-b2ae-155edbf8da43",
              "stakeId": "23b263c3-3994-442b-8f18-d73b568ecf12",
              "gasEstimate": {
                  "amount": "0.171617000000000000",
                  "gasLimit": ""
              }
          }
      }
  }
  ```
</CodeGroup>

* `amount` — amount of tokens to withdraw in ADA.

* `stakerAddress` — account address initiated the staking transaction.

* `unsignedTransactionData` — unsigned transaction in Base64 encrypted format. Sign the transaction and submit it to the blockchain to perform the called action.

* `createdAt` — timestamp of the transaction in the ISO 8601 format.

* `extraData` — additional transaction details:

  * `transactionId` — unique identifier of the transaction within this withdrawal session.

  * `stakeId` — unique identifier of the withdrawal request.

  * `gasEstimate` — estimated gas usage details:

    * `amount` — estimated fee for processing the transaction in ADA.
    * `gasLimit` — maximum gas limit for the transaction; can be left empty or ignored, since it is not used in Cardano and reserved for compatibility only.

### 2. Sign and send transaction

Use `unsignedTransactionData` to [sign and send](/docs/unified-api-signing-transaction) the transaction following the Cardano-specific signing logic.


## Related topics

- [Unified API Reference](/reference/unified-create-stake-transaction.md)
- [Integration Workflow Example](/docs/unified-api-getting-started.md)
- [Networks Supported](/docs/unified-api-networks.md)