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

# Introduction

> The Symbiosis REST API

Symbiosis is a block-execution venue for prediction markets. The REST API covers three
services behind one hostname:

<CardGroup cols={3}>
  <Card title="Auth" icon="key" href="/api-reference/auth">
    Accounts, sessions, API keys, and websocket tickets.
  </Card>

  <Card title="Custody" icon="vault" href="/api-reference/custody">
    Deposit addresses, balances, and withdrawals.
  </Card>

  <Card title="RFQ" icon="arrows-left-right" href="/api-reference/rfq">
    Quote requests, quotes, and matching.
  </Card>
</CardGroup>

## Core concepts

**Requests and quotes.** A taker posts a quote request for an asset on a venue
(Polymarket, Kalshi, or Limitless). Market makers see the request — without the
requester's identity unless they opted into disclosure — and respond with quotes.
The taker accepts a quote to match. Quotes expire; a match against an expired
quote is rejected.

**Custody.** Deposits arrive on per-user derived addresses. Balances are tracked
per `(venue, asset)`, with USDC held separately. Withdrawals are queued and
processed asynchronously.

## Wire formats

| Type                                  | Format                                                                                              |
| ------------------------------------- | --------------------------------------------------------------------------------------------------- |
| Token amounts (`U256`)                | Responses: `0x`-prefixed hex strings. Requests: decimal strings, `0x`-hex strings, or JSON numbers. |
| Asset ids, addresses                  | `0x`-prefixed hex strings.                                                                          |
| Prices                                | Integers scaled by 1e6 (`650000` = 0.65).                                                           |
| Ids (users, requests, quotes, orders) | UUIDs.                                                                                              |
| Timestamps                            | RFC 3339 / ISO 8601.                                                                                |

## Websockets

Market data, user events, and the RFQ stream are served over websockets
(`/ws/market`, `/ws/user`, `/ws/rfq`), authenticated with short-lived tickets
minted from [`POST /auth/ws-ticket`](/api-reference/auth). The websocket protocol
is not part of this OpenAPI reference.