Account Activation & Funding Models

This guide walks through how to activate trading accounts on zerohash’s Central Limit Order Book (CLOB), and explains the difference between pre-funded and non-pre-funded account setups.

Prerequisites

Before an account can be activated on the CLOB, Platforms must confirm the following steps are complete.

• A participant must be created, associated to your platform. You can create a participant on the zerohash system using the following endpoints;
  • POST /participants/customers/new to create a new Individual participant.
  • POST /participants/entity/new to create a new Entity(NNP) participant.
  • You can use the GET /participant/{participant_code}/basic_info to retrieve the participants status, along with subscribing to the zerohash participant status update events.
• The customers status in the response should be approved

Account Activation

1. Use the target customers participant_code when calling the POST /accounts endpoint.
2. Specify the funding model that you want the account to use,prefunded : true or prefunded : false.

For more information on account opening, checkout the account management API documentation.

Funding Models

Pre-Funded Accounts

prefunded : true

• USD balances are held at zerohash and ledgered directly to the customer.
• Credit checks are performed by zerohash against the customer’s USD account balance.
• Platforms can use the float account to transfer funds to the customers balance using the POST /transfers endpoint.

POST /transfers
{
    "from_participant_code": "00SCXM",
    "from_account_group": "PLAT01",
    "to_participant_code": "PART02",
    "to_account_group": "GTRT44",
    "to_account_label":"general",
    "asset": "USD",
    "amount": "1"
}

Non Pre-Funded Accounts

prefunded : false

• Customers USD balances are maintained on your platforms ledgers.
• Credit checks on customers balance are performed by the platform before order placement.
  • Customers will have the ability to place orders to the value of the platforms float if credit checks are not handled on the platforms order entries for prefunded : false accounts.
• Customers buying power will be allocated from the platforms float account upon order placement.

Example Request

{
    "prefunded": True,
    "tier": "lite",
    "type": "individual",
    "participant_code": "PAR001",
    "account_label": "custom-account-label"
}

Example Response

{
  "message": {
    "zrn": "zrn:zh:us:accounts:customer:c761fc96-5c44-40d4-8eb2-3fcd5d06754b",
    "participant_code": "PAR001",
    "platform_code": "PLAT01",
    "prefunded": false,
    "account_label": "custom-account-label",
    "account_group": "XYZ456",
    "type": "individual",
    "tier": "lite",
    "status": "open",
  }
}

Account Management

After account activation on the CLOB, you can use the following endpoints to manage your accounts:

• Get account details
  • GET /accounts/{zrn}/details
• Update account
  • PATCH /accounts/{zrn}