Ceffu OpenAPI Documentation Platform
  1. Concepts
Ceffu OpenAPI Documentation Platform
  • Changes
    • Upcoming Changes
    • Change log
  • Development Tools and Resource
    • Overview
      • Welcome to Ceffu OpenAPI
    • Quickstart
      • Initial Setup
      • Using the Ceffu SDK
    • Authentication
    • Rate limit
    • Error Codes
    • Webhook Introduction
  • Concepts
    • Ceffu Custody
  • System Endpoints
    • Get System status
  • Wallet Management
    • Ceffu Supported Asset Endpoint
      • Get Prime Wallet supported coins list
      • Get Qualified Wallet supported coins list
      • Get Cosign Wallet supported coins list
    • Qualified Wallets and Prime Wallets Endpoint
      • Create Wallet
      • Update Wallet Details
      • Get Wallet List
      • Get Asset Details
      • Get Wallet Asset Summary
    • Deposits
      • Get Deposit Address
      • Get Deposit History
      • Get Deposit Detail
    • Withdrawals
      • Withdrawal
      • Get Withdrawal Fee (estimated)
      • Get Withdrawal History
      • Get Withdrawal Details
    • Whitelisted Addresses
      • Get Whitelisted Address List
      • Get Correspondent’s Options
      • Add/Edit Whitelisted Address
    • Transactions
      • Transaction History List
  • PW Sub Wallets
    • Sub-Wallet Management
      • Create Sub-Wallet
      • Update Sub-Wallet Details
      • Get Sub-Wallet List
      • Get Sub-Wallet Asset Details
      • Get Sub-Wallet Asset Summary
    • Sub-Wallet Deposits
      • Get Sub-Wallet Deposit Address
      • Get Deposit Address List under Prime Wallet
      • Get Deposit History under Sub-Wallet
      • Get Sub-Wallet Deposit History By Prime Wallet
    • Internal Transfers
      • Transfer between Sub Wallet and Prime Wallet
      • Get Transfer History between Sub-Wallet and Prime Wallet
    • Transactions
      • Get Transaction Details of Prime Wallet Internal Transfer
  • MirrorX
    • Link & Account
      • Get MirrorX LinkId List
    • Balances & Positions
      • Check MirrorX Available amount
      • Get MirrorX Asset Positions
    • Orders
      • Get MirrorX Orders
      • Place MirrorX Orders
  • Webhooks & Notifications
    • Resend webhook notifications
  • Archive
    • Mirror Endpoints
      • Get Mirror Linked Binance UID List
      • MIrror Assets Application
      • MIrror Assets Settlement
      • Get Mirror Operation Records
      • Get Mirrored Asset Positions
      • Get Mirrored Asset Summary
    • Wallet Endpoints
      • Get Transfer Detail with Exchange
      • Get Transfer History with Exchange
      • Transfer with Exchange
      • Get Withdrawal History
      • Get Withdrawal Details
      • Withdrawal
      • Get Sub-Wallet List (V1)
  1. Concepts

Ceffu Custody

Ceffu Custody#

Ceffu delivers institutional-grade digital asset custody and wallet orchestration, enabling enterprises, trading firms, and platforms to securely store, move, and manage crypto assets at scale. This section introduces core custody concepts and wallet models used across the Ceffu API.

Wallet Architecture Overview#

Ceffu supports multiple custody models designed for different operational needs from cold storage to automated liquidity management.
Wallet Type
DescriptionBest For
Qualified Wallet (QW)Dedicated cold-storage wallet with on-chain addresses and maximum security controlsTreasury reserves, long-term custody, regulatory storage
Prime Wallet (PW)Hybrid hot-cold operational wallet with fast settlement and network-agnostic withdrawalsActive treasury operations, exchange flows, trading connectivity
Co-Sign Wallet (CW)MPC wallet where clients co-hold a signing key shareEnhanced control
Sub-Wallets (PW only)Segregated account-level wallets under a Prime WalletPlatforms, brokerages, exchanges managing multiple users/accounts

Supported Asset Endpoints#

Determine supported assets and networks per wallet layer:
Capability
Description
Prime Wallet Supported AssetsView supported assets & withdrawal networks for operational custody
Qualified Wallet Supported AssetsCheck assets available for long-term cold storage
Co-Sign Wallet Supported AssetsView assets compatible with MPC custody flows

Prime & Qualified Wallet Operations#

Wallet Provisioning#

ActionDescription
Create WalletProvision a new QW or PW
Update Wallet DetailsModify metadata such as name or label
Get Wallet ListRetrieve all existing wallets for the organization

Asset & Balance Management#

ActionDescription
Get Asset DetailsRetrieve individual asset info
Get Wallet Asset SummaryView balances & allocations for all assets

Deposit Flow#

ActionDescription
Get Deposit AddressGenerate chain-specific deposit addresses
Get Deposit HistoryReview deposit activity
Get Deposit DetailInspect a specific deposit transaction

Withdrawal Flow#

ActionDescription
WithdrawalSubmit a withdrawal request
Get Withdrawal FeeEstimate network fees pre-transaction
Get Withdrawal HistoryRetrieve all withdrawal records
Get Withdrawal DetailsView status, tx hash, and settlement details

Address Whitelisting#

ActionDescription
Get Whitelisted Address ListRetrieve approved withdrawal addresses
Get Correspondent OptionsView network/correspondent routes (if applicable)
Add/Edit Whitelisted AddressManage whitelisted addresses for compliance & security

Wallet Transaction Records#

ActionDescription
Transaction History ListRetrieve ledger of wallet movements for audit & reporting

Sub-Wallet Management (Prime Wallet Only)#

Sub-wallets enable multi-account segregation under a single Prime Wallet — ideal for platforms and institutions managing end-users or business units.

Provisioning#

ActionDescription
Create Sub-WalletOpen a segregated account wallet
Update Sub-Wallet DetailsModify sub-wallet metadata
Get Sub-Wallet ListRetrieve all sub-wallets

Balances#

ActionDescription
Get Sub-Wallet Asset DetailsView asset balances
Get Sub-Wallet Asset SummaryOverview of sub-wallet holdings

Deposits#

ActionDescription
Get Sub-Wallet Deposit AddressGenerate unique deposit address
Get All Deposit Addresses (PW)List deposit addresses under parent PW
Get Sub-Wallet Deposit HistoryView deposit activity per sub-wallet
Get Consolidated Deposit HistoryTrack all deposits across sub-wallets

Internal Transfers#

ActionDescription
Transfer Sub-Wallet ↔ Prime WalletMove assets internally for settlement & treasury
Get Transfer HistoryReview internal transfer records

Transactions#

ActionDescription
Get PW Transaction Details by Sub-WalletView sub-wallet-linked Prime Wallet movements

MirrorX: Trading From Custody#

MirrorX enables trading execution while keeping assets custodied inside Ceffu. Ideal for execution desks, liquidity providers, and platforms.

Trading Connectivity#

ActionDescription
Get LinkID ListRetrieve trading access profiles
Check Available AmountView tradable balances
Get Asset PositionsMonitor trading account positions
Get OrdersRetrieve order activity
Place OrdersExecute orders without moving funds out of custody
Previous
Webhook Introduction
Next
Get System status