Accounts
The Account API creates and manages the accounts that trade on the Gateway. Most self-serve traders never touch it — Create an account does all of this through the web app.
You need it when your app creates accounts for other people, not for yourself — a partner embedding True Markets, or any integration where the end user isn't you. Your app holds one set of partner credentials and acts on behalf of many users.
The model
Every account has a client_id. The JWT your app mints for a user must carry that user's client_id claim — that claim is what scopes each Gateway request to the right account and keeps balances, orders, and transfers separated.
- Provision a user — create the account, get a
client_id. - Verify identity — each end user completes KYC before trading.
- Fund the account — deposit crypto or use the fiat on-ramp.
- Trade — mint a scoped JWT and use the Gateway as normal.
- Withdraw — move funds back out with a signed transfer.
Partner onboarding itself (the commercial agreement and KYB for your organization) is handled by the team — see the White-label path.