> ## Documentation Index
> Fetch the complete documentation index at: https://docs.totalis.trade/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Authenticate, make your first call, and find your way to placing a parlay.

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](https://app.totalis.trade) (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](/guides/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:

```bash theme={null}
curl https://api.totalis.trade/v1/me \
  -H "X-API-Key: $TOTALIS_API_KEY"
```

```json theme={null}
{
  "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:

```bash theme={null}
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](/api-reference/markets/list) for filters (category, venue, search).

## 4. Read your account

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

```bash theme={null}
curl https://api.totalis.trade/v1/portfolio \
  -H "X-API-Key: $TOTALIS_API_KEY"
```

## Next steps

<CardGroup cols={2}>
  <Card title="How parlays work" icon="arrows-spin" href="/guides/lifecycle">
    The full path from quote request to settlement.
  </Card>

  <Card title="Fund your wallet" icon="wallet" href="/guides/funding">
    Get USDC in and enable trading before you place a parlay.
  </Card>

  <Card title="Reading your data" icon="table-list" href="/guides/reading-data">
    Positions, history, settlement outcomes, and P\&L.
  </Card>

  <Card title="Webhooks" icon="bell" href="/guides/webhooks">
    Get pushed events instead of polling.
  </Card>
</CardGroup>

<Note>
  Placing a parlay requires a funded wallet with trading enabled — enabling trading is a one time interactive step (see [Fund your wallet](/guides/funding)). Reads work as soon as your key does.
</Note>