Skip to main content
This gets you from zero to a working, authenticated request in a few minutes.

​
1. Get an API key

Create a key from the Totalis Dashboard (account settings → API keys). Give it the scopes your integration needs — for a read-only start, account:read, positions:read, and balances:read are enough. See Authentication for the full scope catalog. Copy the key when it’s shown — it’s only displayed once.

​
2. Make your first call

Every request to https://api.totalis.trade carries your key in the X-API-Key header. Confirm it works by reading your profile:
Every successful response is wrapped in a data envelope. A 401 means the key is missing or wrong; a 403 means the key lacks the scope for that endpoint.

​
3. Browse markets

Markets are the building blocks of a parlay. List what’s tradable:
Each market carries the ticker and venue you’ll reference when you build a parlay leg. See List markets for filters (category, venue, search).

​
4. Read your account

Pull your balances, open positions, and stats in one call:

​
Next steps

How parlays work

The full path from quote request to settlement.

Fund your wallet

Get USDC in and enable trading before you place a parlay.

Reading your data

Positions, history, settlement outcomes, and P&L.

Webhooks

Get pushed events instead of polling.
Placing a parlay requires a funded wallet with trading enabled — enabling trading is a one-time interactive step (see Fund your wallet). Reads work as soon as your key does.