B2B Overview
The CoinSwitch B2B APIs let vendors manage multiple trading subaccounts under a single master account. If you need to allocate capital across strategies, teams, or end-clients — all controlled from one set of master credentials — this is the surface for you.
B2B access requires a master account. Contact your CoinSwitch representative to get onboarded before calling any of these endpoints.
How it works
- You create subaccounts under your master account — each gets its own API key and secret.
- You fund the master account from your CoinSwitch wallet.
- You distribute USDT from the master to individual subaccounts.
- Each subaccount trades independently using the standard HFT APIs.
- You can recall funds back to master and withdraw to your wallet at any time.
Base URL
All B2B endpoints live under the same HFT base URL: https://dma.coinswitch.co/
Authentication
B2B uses the same Ed25519 signature scheme as the rest of HFT: X-Auth-Apikey, X-AUTH-SIGNATURE, X-AUTH-EPOCH headers, signature over METHOD + REQUEST_PATH + epoch.
All /master/* endpoints require the master account API key. Subaccount API keys will be rejected with 403 Forbidden. The /funds/transfer/master-account endpoint requires your CoinSwitch main book API key instead.
Response format
Unlike HFT trading endpoints ({"retCode": 0, ...}), B2B responses use a simpler envelope:
{
"message": "description of the outcome",
"data": { ... }
}
Errors omit data and return the appropriate HTTP status code with a message field.
Supported assets
Only USDT is supported for all transfer operations. Specifying any other coin returns a 400 error.
Quickstart workflow
| Step | Action | Endpoint |
|---|---|---|
| 1 | Create subaccounts | POST /master/subaccount/create |
| 2 | Transfer funds between CoinSwitch account and master | POST /funds/transfer/master-account |
| 3 | Transfer funds between master and subaccounts | POST /master/transfer |
| 4 | Monitor balances | GET /master/balance, GET /master/subaccount/balance, GET /master/balance/consolidated |
| 5 | List subaccounts | GET /master/subaccounts |