Create 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.

❗️

Main deposit bank account required (effective 2026-06-17)

Each customer fiat account must have a main deposit bank account before any funding transfer can complete. See
Customer Deposit Bank Accounts for the
provisioning step and error handling.

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 USDC trading account with POST /api/accounts:

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

{
  "type": "trading",
  "asset": "USDC",
  "customer_guid": "<insert customer_guid>",
  "name": "USDC 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.