Trading (Retail Gateway)

The Gateway is a single REST surface for trading across CeFi and DeFi. You send an order; it handles venue selection, cross-chain bridging, and price discovery.

Authentication is a short-lived JWT minted from an API key. Every request is scoped to the account the token was issued for — which is how partners trade on behalf of their own users (see Accounts).

The flow

1. Mint a JWT — sign {key_id}.{timestamp}, exchange it for an access_token.
2. List assets — the catalog of tradable assets, per venue. Public, no token needed.
3. Compute a quote — priced, non-binding, no funds move.
4. Create and execute an order — returns an order_id.
5. Check status — poll the order to confirm the fill.

The Quickstart walks all five end to end with runnable code in cURL, Node.js, Python, and Java.

Reference

• Retail Gateway API — every endpoint, schema, and error code
• Auth Service API — token exchange and refresh
• Clients and SDKs — typed TypeScript and Python clients that handle signing for you

---

Next → Quickstart