API Reference
Portal

Create customer account

post
https://api.cert.zerohash.com/accounts

Creates a new customer account. The pair (participant_code, account_label) is unique per participant and is used as idempotency check rather than X-Request-Id; submitting the same pair a second time returns an error rather than creating a duplicate.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Request body containing the customer account details to create.

The individual account type is for accounts owned by an individual. This is the most common account type and is suitable for most use cases.

string
required

The participant_code is the primary account holder.

string
required

The platform-dictated account label for the participants account. Accounts labels created for the same participant must have a different account_label value, and all maintain an individual balance.

boolean
required

Indicates whether the participant is using a prefunded model, or using the plaform float funding model to fund buy trades.

  • If true, the participant is prefunding their account and will be responsible for ensuring they have sufficient balance in their account to cover trades.
  • If false, the platform will fund trades from their float balance at zerohash, on behalf of the participant and settle at the end of the day.
string
enum
required

The account tier associated with the account with regards to the commission structure defined by the platform. The specific tier values available depend on the platform configuration.

Allowed:
string
enum
required

The account type associated with the account

Allowed:
tenants
array of strings

Tenants are the second owners of the account and have the same permissions as the primary account holder. Each tenant must be an onboarded participant to zerohash and not the same as the primary account holder.

tenants
financial_advisors
array of strings

The Financial Advisors of the participant which must be an onboarded participant to zerohash and not the same as the primary account holder.

financial_advisors
Headers
string
required

HMAC-SHA256 signature of the request, base64-encoded. See the Authentication guide for the exact signing formula.

string
required

Current Unix timestamp in seconds. Must be within 60 seconds of server time or the request is rejected.

Responses

Updated about 2 months ago

Did this page help you?
Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 2 months ago

Did this page help you?