> This page is for Taurus PROTECT, version v3.52.
> For other versions, use one of these documentation indexes:
> - v3.58 (default): https://taurushq.ferndocs.com/protect-capital/v3.58/llms.txt
> - v3.56: https://taurushq.ferndocs.com/protect-capital/v3.56/llms.txt
> - v3.54: https://taurushq.ferndocs.com/protect-capital/v3.54/llms.txt
> - v3.52: https://taurushq.ferndocs.com/protect-capital/v3.52/llms.txt
> - v3.50: https://taurushq.ferndocs.com/protect-capital/v3.50/llms.txt
> - v3.48: https://taurushq.ferndocs.com/protect-capital/v3.48/llms.txt
> - v3.46: https://taurushq.ferndocs.com/protect-capital/v3.46/llms.txt
> - v3.44: https://taurushq.ferndocs.com/protect-capital/v3.44/llms.txt
> - v3.42: https://taurushq.ferndocs.com/protect-capital/v3.42/llms.txt
> - v3.40: https://taurushq.ferndocs.com/protect-capital/v3.40/llms.txt
> - v3.38: https://taurushq.ferndocs.com/protect-capital/v3.38/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://taurushq.ferndocs.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://taurushq.ferndocs.com/_mcp/server.

# Pledging & Collateral

> **Note**
>
> **In This Article**
>
> This article will cover the following topics:
>
> * How to pledge collateral with Taurus Network (TN).
> * How to accept a pledge as the counter-party.
> * How to configure collateral transfer settings for a pledge via API.
>
> Note: Completing this guide requires access to two PROTECT tenants that are both connected to the Taurus Network (TN).

## Introduction

Once a shared address has been established with your counterparty, you can use the Taurus Network to pledge collateral to any connected participant. Collateral withdrawal permissions are fully configurable: you may require bilateral approval for any collateral call or withdrawal, delegate unilateral withdrawal rights to the counterparty, or retain exclusive control yourself. This document walks through the workflow to configure this via the API and requires steps from both the pledge initiator and the counterparty.

## Pledge Workflow

![](/_fern-img/287312bac9ce91777eacbcec865474c08567d8c56b904a48b6659c0da0b8f751.webp)

\


1. Initiate a pledge (owner)
2. Approve pledge action (owner)
3. Accept a Pledge (target)
   1. Optionally set a default destination (if *auto-approved by pledgee* is enabled)
   2. Approve a pledge action

## Initiate a Pledge (owner)

1. Look up the participantID of the counter party via the [List Participants endpoint.](/protect-capital/v3.52/reference/taurus-network-participants/list)
2. Look up the pledge token's CurrencyID via the [List Currencies endpoint.](/protect-capital/v3.52/reference/currencies/list)
3. Look up the shared addressID via the [List Shared Addresses endpoint.](/protect-capital/v3.52/reference/taurus-network-sharing/get-shared-addresses) If the address with the funds is not listed it must first be [shared](/protect-capital/v3.52/reference/address-asset-sharing).
4. Create a pledge via the [Create a Pledge endpoint. ](/protect-capital/v3.52/reference/taurus-network-pledges/create), filling in the following fields:
   1. curencyID
   2. participantID
   3. sharedAddressID
   4. pledgeDurationSetup (all three values)
   5. pledgetype
5. Confirm you receive a 200 response from the endpoint.

## Approve a Pledge Action (owner)

1. After creating the pledge, it must be signed using the [Approve a Pledge Action endpoiint.](/protect-capital/v3.52/reference/taurus-network-pledges/approve-actions) Please see Signing for Approval for more information on signing.
2. The pledge will then appear to be accepted by the counterparty.

## Accept a Pledge (target)

After a participant signs a pledge request, it must be accepted by the counterparty. This is the same action on both sides. Once the counterparty signs the pledge action, it is accepted. Depending on the configured Collateral Transfer Rules, an additional step may be required, and the exact steps may vary slightly based on the selected rule.

**Collateral Transfer Rule: Approved by pledgor**

1. Use the [for-approval endpoint](/protect-capital/v3.52/reference/requests/list-for-approval-v-2)  to find the appropriate. Save the hash of the request.
2. [Sign the request](/protect-capital/reference/signing-for-approval) (note that multiple signatures may be required based on the respective Governance rules).

**Collateral Transfer Rule: Approved by pledgee**

1. Use the [for-approval endpoint](/protect-capital/v3.52/reference/requests/list-for-approval-v-2)  to find the appropriate. Save the hash of the request.
2. Call the [Update Pledge endpoint](/protect-capital/v3.52/reference/taurus-network-pledges/update) and provide a default deposit address.

> **Warning**
>
> **Important**
>
> 1. This must be an address that is shared with the pledgor since the address needs to be whitelisted on their side. Sharing an address with a participant whitelists the address. The address provided via the  `sharedDestinationAddressId`or `internalDestinationAddressId` **must be shared.** It is recommended to use the `sharedDestinationAddressId` parameter.

3. After updating the pledge with a shared destination address, [sign the request](/protect-capital/reference/signing-for-approval) hash to approve the transaction.

**Collateral Transfer Rule: Not Allowed**

No additional steps required since actual transfer of funds is disabled.

## Withdraw Pledge

If the pledgor has delegated withdraw permissions, the participant can request a withdrawal with the [Withdraw Pledge endpoint.](/protect-capital/v3.52/reference/taurus-network-pledges/withdraw)

If the Collateral Transfer Rules are set to Approved by ***Pledgee*** (target), you will be able to sign the request and initiate the transfer (ensure a shared destination address is set).

> **Warning**
>
> **Important**
>
> This will automatically initiate the transfer on the blockchain without approval from the pledgor.

If the Collateral Transfer Rules are set to Approved by ***Pledgor*,** (owner) you will be able to initiate a request but it will need to be signed by the pledgor.

In both cases, the transaction hash would be signed the same way any oth