Skip to main content
A delegation reserves assets held in one Atlas participant’s vault for another participant, under an agreement the two have signed. The assets stay in the owner’s Anchorage Digital custody vault. A hold stops them from being moved except as the agreement allows, and Anchorage Digital enforces those terms as a neutral custodian.

Parties

Both parties are Atlas participants. See Atlas for creating participants and sharing their IDs.

What a delegation contains

  • vaultUniqueId: the delegator’s vault that holds the delegated assets. Only the delegator sees it.
  • delegatedAssets: one entry per delegated asset holding, with the amount currently delegated. Amounts never include fees. For the delegator, each entry also has walletUniqueId, the wallet that holds it. The delegatee does not see vault or wallet IDs.
  • sourceAddresses on each asset: the on-chain addresses currently holding it. The delegator always sees them. The delegatee sees them only if the pledgor has opted in to disclosing them. Assets can move between addresses over time, but they stay in the delegator’s wallet. An empty list means the asset has no attributable on-chain address, for example fiat.
  • revokedOn: set once the delegation has ended. Absent while it is active.
In the delegator’s balances, delegated assets appear as Held for Atlas delegation. See Reading balances.

Settling assets in and out

Either party can propose moving assets between a wallet its organization owns and the delegation, within the agreement’s settle rights.
  1. Call POST /atlas/delegations/{delegationId}/settle with one entry per wallet and asset, plus an idempotentId so a retried request is not applied twice. clientReferenceId is an optional memo both parties see. A positive quantity is an asset your wallet receives; a negative quantity is an asset your wallet sends. Every entry in one request points the same way. An asset can be received into only one wallet, but can be sent from several.
  2. The request returns 202 with a settlementRequestId once it is accepted for processing. Nothing has moved yet.
  3. The delegator approves the settlement, whichever party proposed it. Assets move only after that approval.
Assets settled into the delegation land in the delegator’s wallet for that asset in the delegation’s vault, and the delegation grows by that amount. Assets settled out leave the delegation and arrive in the receiving wallet.

Permissions