GuidesRecipesAPI ReferenceChangelog
Guides

Trade Process

Walk through the steps to set up a customer and execute your first trade on the Cybrid platform.

Prerequisites

Complete the Getting Started Guide before proceeding. You should have an Organization and Bank set up in the Partner Portal.

Platform hierarchy

  • Organization is the top-level object. One or more Banks belong to it.
  • All downstream objects — Customers, Accounts, Identity Verifications, and others — belong to a Bank.
  • The Customer object is the primary data model for each individual. Accounts, identity verifications, quotes, trades, and transfers all belong to the Customer.

Trade setup steps

Executing a trade requires several one-time setup steps:

  1. Create a Customer via POST /api/customers.
  2. Create a fiat and trading Account for the Customer via POST /api/accounts.
  3. Complete simulated KYC and bank account connection using the Web Demo. To drive the bank connect process programmatically, see Plaid Integration.
  4. Fund the fiat account using a funding transfer type via POST /api/transfers (a quote is required for funding transfers).
  5. Generate a Quote via POST /api/quotes.
  6. Execute a Trade against the Quote via POST /api/trades.
ℹ️

Sandbox simulation

In the sandbox environment, KYC and Plaid-connected bank accounts are simulated for easy testing.

Steps 1–3 are one-time setup. Subsequent funding, quoting, and trading only require steps 4–6.

ℹ️

Funding limit

Simulated Plaid funding limits each deposit to $100. You can complete multiple $100 deposits to increase the balance.