Funding Domain

The Funding domain handles all money movement: deposits, withdrawals, internal transfers, and settlement lines.

Deposits

Deposits bring funds into your sub-account, either via crypto on-chain transactions or bank transfers.

Crypto Deposit Flow

1. Generate deposit address for instrument
2. User sends funds to address
3. Platform detects transaction
4. Wait for confirmations
5. Balance credited

Fiat Deposit Flow

1. Get platform bank details with reference code
2. User initiates bank transfer with reference
3. Bank processes transfer (1-3 business days)
4. Platform receives and matches by reference
5. Balance credited

Deposit Status

Deposit Endpoints

Withdrawals

Withdrawals move funds out of your sub-account to external addresses (crypto) or bank accounts (fiat).

Crypto Withdrawal Flow

1. Whitelist destination address (may require approval period)
2. Initiate withdrawal
3. Confirm with MFA
4. Platform broadcasts transaction
5. Balance deducted

Fiat Withdrawal Flow

1. Register bank account (IBAN)
2. Initiate withdrawal
3. Confirm with MFA
4. Platform initiates transfer (1-3 business days)
5. Balance deducted

Address Whitelisting

Security measure requiring addresses to be pre-approved before withdrawals.

Cooling Period: New addresses may require 24-48 hours before becoming active.

Withdrawal Status

Withdrawal Endpoints

External Address Endpoints

Bank Account Endpoints

Transfers

Internal transfers move funds between sub-accounts within the same client account.

Transfer Endpoints

Settlement Lines

Settlement lines are short-term lending facilities available to entitled PRIME platform clients. They allow you to trade using funds up to a predefined limit, with the obligation to settle the exposure within a defined time window.

Key Concepts

How It Works

1. Line Allocation: A settlement line is configured for your sub-account with a maximum limit in a quotation currency (e.g., USD, CHF)
2. Trading: You can place trades even without sufficient balance, up to your settlement line limit
3. Exposure Tracking: As trades execute, your exposure increases
4. Notifications: PRIME sends daily email reports showing your outstanding positions
5. Settlement: You deposit funds and settle the exposure, either manually or automatically

Settlement Line Endpoints

Exposure Call Endpoints

Data Models

ExposureLine

Represents the settlement line configuration for a sub-account.

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "clientAccountId": "96e9c58d-f7fe-47b9-a33b-e898d5c01119",
  "subAccountId": "7376524e-6b6b-4137-9719-7e07a7709804",
  "quotationId": "20000000-2000-0000-0000-000000000000",
  "quantity": "100000.00",
  "automaticSettlement": true,
  "createdAt": "2024-01-01T00:00:00Z",
  "updatedAt": "2024-01-15T10:30:00Z"
}

ExposureCall

Represents an outstanding amount that needs to be settled.

{
  "id": "call-uuid",
  "clientAccountId": "96e9c58d-f7fe-47b9-a33b-e898d5c01119",
  "subAccountId": "7376524e-6b6b-4137-9719-7e07a7709804",
  "instrumentId": "10000000-2000-0000-0000-000000000000",
  "demandQuantity": "2.50000000",
  "coverQuantity": "1.00000000",
  "status": "STATUS_OPENED",
  "createdAt": "2024-01-14T10:00:00Z",
  "updatedAt": "2024-01-15T08:00:00Z"
}

ExposureCall.Status

WebSocket Topic

Real-time exposure updates are available via WebSocket.

Topic: {subAccountId}@exposures

Authentication: Required

Message Format:

{
  "e": "exposure",
  "t": "{subAccountId}@exposures",
  "d": {
    "i": "quotation-instrument-uuid",
    "o": "15000.50",
    "u": "25000.00",
    "l": "100000.00"
  }
}

Balance Integration

Exposure information is also reflected in balance records:

Fees

Fees are shown before confirmation and deducted from the withdrawal amount.

Related

• Use Case: Deposits & Withdrawals
• Use Case: Settlement Lines
• Use Case: Wallet Information
• Assets Domain - Balance information
• WebSocket Topics - Real-time updates