External user id

externalUserId is an optional tag you attach to an order on POST /orders-v3. The tag is a value you choose so that, when one SX wallet places orders for many people on your platform, you can tell the resulting orders, fills, and trades apart. externalUserId has no effect on funds, fees, or matching. It is the mechanism behind the single-account model.

Example

JavaScript

await fetch(`${API}/orders-v3`, authed({
  method: "POST",
  body: JSON.stringify({
    orders: [{ ...order, externalUserId: platformUserId }],
  }),
}));

const { data } = await fetch(`${API}/trades-v3?perPage=50`, authed()).then((r) => r.json());
const forUser = data.trades.filter((t) => t.externalUserId === platformUserId);

Posting orders

The submit flow this field rides on.

Client order id

A per-order tag. Unique, charset-restricted, and absent from the bet grain.

Bet grains

Bets, fills, and positions — which row to read for a per-user history.

Create orders

Every field, every validation rule.

Account models

The two ways to represent your site’s users on SX.bet.

Work with us

Building at scale or exploring a partnership.

Last modified on August 13, 2026

Getting Started

Upgrading to V3

Accounts & Funding

Core Concepts

Markets

Market Data

Realtime Data

Trading

Lifecycles

My Activity

Partners

Resources

Example

Posting orders

Client order id

Bet grains

Create orders

Account models

Work with us

​Example

​Related

Posting orders

Client order id

Bet grains

Create orders

Account models

Work with us

Example

Related