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: 
curl https://api.totalis.trade/v1/me \
  -H "X-API-Key: $TOTALIS_API_KEY"

{
  "data": {
    "id": "did:privy:…",
    "username": "satoshi",
    "wallet_address": "7Xy…"
  }
}
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: 
curl "https://api.totalis.trade/markets?limit=5" \
  -H "X-API-Key: $TOTALIS_API_KEY"
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: 
curl https://api.totalis.trade/v1/portfolio \
  -H "X-API-Key: $TOTALIS_API_KEY"

​
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.