Creating Platform Accounts

Overview

Each fiat currency a customer funds requires a fiat account. Each cryptocurrency a customer trades requires a trading account.

⚠️

Prerequisite

The customer state must be verified before you create accounts. Complete identity verification first.

Funding account

Create a USD fiat account with POST /api/accounts:

• Set type to fiat
• Set asset to USD
• Provide the customer_guid
• Provide a descriptive name

{
  "type": "fiat",
  "asset": "USD",
  "customer_guid": "<insert customer_guid>",
  "name": "USD funding account"
}

The response includes the new account details. The account state transitions from storing to created once provisioned.

ℹ️

Production note

In sandbox, provisioning is instantaneous. In production, a short delay may occur between storing and created. Design your integration to handle both states.

With a funding account created, you can generate a quote and create a funding deposit transfer.

Multiple funding accounts

Contact support to enable multiple fiat accounts per customer. This applies to both bank-level and customer-level accounts.

If multiple fiat accounts are not enabled, you receive this error:

{
  "status": 409,
  "error_message": "Account(s) for asset already exists",
  "message_code": "data_exists"
}

Trading account

Create a BTC trading account with POST /api/accounts:

• Set type to trading
• Set asset to BTC
• Provide the customer_guid
• Provide a descriptive name

{
  "type": "trading",
  "asset": "BTC",
  "customer_guid": "<insert customer_guid>",
  "name": "BTC trading account"
}

The account state transitions from storing to created, the same as funding accounts.

With a trading account created, you can generate a quote and execute a crypto buy trade.