Products & Services

The Digital Asset Service Desk API supports specific predefined types of service catalog, which will allow you to perform required operations. You can check the list of available Products to fetch the request payload templates based on your account’s permissions. Here is an example request to retrieve all products & services:

curl --request POST 'https:///v3/api/servicedesk/products'
--header 'company-identifier: ' \
--header 'submitter-id: ' \
--header 'request-identifier: ' \
--header 'request-timestamp: ' \
--header 'Content-Type: application/json' \
--header 'signature: ' \
--data-raw 
'{ }'

Here are some of the payload templates for illustration, (use above API to fetch the latest actual service payload templates) Custody Wallet Management (0x0013-001):

{
    "name": "Wallet_Name", // required
    "currency": "ETH | BTC", // required
    "currencyId": "eth-Seth | btc-btc",  // required
    "walletOwnerId": "Wallet_Beneficiary_ID" // optional
}

Beneficiary (0x0007-004):

{
    "entityType": "INDIVIDUAL|ORGANISATION", // required
    "beneficiaryName": "string", // required
    "operatingAddress": {
        "city": "London", // required
        "line1": "Eastcheap", // required
        "line2": "string", //optional
        "state": "London", // required
        "country": "United Kingdom", // required
        "zipCode": "123456" // required
    },
    "registeredAddress": {
        "city": "London", // required
        "line1": "Eastcheap", // required
        "line2": "string", // optional
        "state": "London", // required
        "country": "United Kingdom", // required
        "zipCode": "123456" // required
    },
    "registrationNumber": "23232323", // required
    "dateOfIncorporation": "2025-03-29" // required
}

New Beneficiary Address (0x0007-007):

{
    "notes": "text", // required
    "vaspId": "f8a08de5-cd37-4695-b30b-9271e60a3937", // required, use 
    "address": "crypto address", // required
    "blockchain": "ETH", // required
    "blockchainId": "eth-Seth", // required
    "beneficiaryId": "BNF-ZTEST-QMSAWYQWY4", // required 
    "hostedAddress": "boolean", // required
    "addressPurpose": [
        "INCOMING|OUTGOING|BIDIRECTIONAL" // required
    ]
}

Custody Transfer Transaction (0x0014-007):

{
    "amount": "1", // required
    "sender": { 
        "type": "WALLETID", // required
        "value": "Wallet_ID" // required
    },
    "currency": "ETH | BTC", // required
    "currencyId": "eth-Seth | btc-btc", // required
    "destination": {
        "type": "WALLETID | BENEFICIARYADDRESSID", // required
        "value": "Wallet_ID | Beneficiary_Address_ID" // required
    },
    "subtractFee": false // required
}

ETH Stake (0x0020-008):

{
    "quantity": 1, // required
    "isPectra": true, // required, true for an Auto-Compounding (0x02) validator, false for a Regular Payout (0x01) validator
    "amount": "32", // required only when isPectra is true (32-2048); optional/ignored when isPectra is false
    "provider": "BITWISE_ON_CHAIN | TWINSTAKE | BLOCKDAEMON | FIGMENT | GALAXY | PIERTWO", // required
    "walletId": "Wallet_ID", // required
    "currencyId": "currency_identifier", // required
    "withdrawalWalletId": "Wallet_ID", // optional, defaults to walletId
    "feeRecipientWalletId": "Wallet_ID" // optional, defaults to walletId
}

ETH Unstake (0x0020-009):

{
    "walletId": "Wallet_ID", // required
    "currencyId": "currency_identifier", // required
    "unstakeValidators": ["validator_public_key"] // required
}

ETH Top-up (0x0020-036):

{
    "amount": "3", // required, minimum 1 ETH
    "walletId": "Wallet_ID", // required
    "currencyId": "currency_identifier", // required
    "validatorAddress": "validator_public_key", // required
    "provider": "BITWISE_ON_CHAIN | TWINSTAKE | BLOCKDAEMON | FIGMENT | GALAXY | PIERTWO" // required
}

ETH Partial Withdrawal (0x0020-037):

{
    "amount": "20", // required
    "walletId": "Wallet_ID", // required
    "currencyId": "currency_identifier", // required
    "validatorAddress": "validator_public_key" // required
}

ETH Validator Consolidation & Transition (0x0020-040):

{
    "walletId": "Wallet_ID", // required
    "currencyId": "currency_identifier", // required
    "migrations": [ // required, 1 to 100 entries
        {
            "source": "source_validator_public_key",
            "destination": "destination_validator_public_key"
        }
    ]
}

SOL Stake (0x0020-024):

{
    "walletId": "Wallet_ID", // required, must be a DeFi wallet
    "amount": "10.5", // required, in SOL, minimum 1
    "currencyId": "currency_identifier", // required
    "provider": "provider_name" // required, the staking provider onboarded for your company, for example BLOCKDAEMON or MARINADE
}

SOL Unstake (0x0020-025):

{
    "walletId": "Wallet_ID", // required, must be a DeFi wallet
    "amount": "10.5", // required, in SOL
    "currencyId": "currency_identifier" // required
}

SOL Withdrawal (0x0020-026):

{
    "walletId": "Wallet_ID", // required, must be a DeFi wallet
    "amount": "10.5", // required, in SOL, not used for MARINADE (everything that is ready to withdraw is withdrawn)
    "currencyId": "currency_identifier" // required
}

The template returned by the products API for the SOL services is a minimal sample: send the fields described above, including currencyId and, for Stake, provider. See the SOL Staking guide for details on each operation.

Getting Started

Working with APIs

Custody (V3)

Interchange (V3)

Network Management (V3)

Service Desk (V3)

Reporting (V3)

Service Desk Guide

Status Reference

Webhooks

FAQs

What's New

Interchange Guide

AI Tools

Staking