> ## 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. # Get Market > Fetch a single market by Kalshi ticker or Polymarket condition ID. Use the optional venue query parameter when you already know the source venue. ## OpenAPI ````yaml GET /markets/{ticker} openapi: 3.0.3 info: title: Totalis RFQ API version: 2.1.0 description: >- Public REST surface for the Totalis parlay RFQ platform — a decentralized request-for-quote marketplace for parlay bets across Kalshi and Polymarket, with on-chain Solana vault settlement. **Wire format**: snake_case JSON. All successful responses are wrapped in `{ "data": ... }`; list endpoints add `meta` with cursor-based pagination. Errors use a `{ "error": { code, message, details? } }` envelope. **Authentication**: programmatic clients send `X-API-Key`; the web dashboard uses Privy JWTs (`Authorization: Bearer ...`). Any authenticated user can both place parlays and quote as a market maker — there is no separate MM role. Admin endpoints are out of scope for this public reference. **Rate limiting**: 100 req/min anonymous, 300 req/min authenticated. Responses include `X-RateLimit-*` headers. Request body limit: 256KB. **Pagination**: list endpoints use opaque cursor pagination. Pass `meta.cursor` from the previous response as `?cursor=...` to fetch the next page; do not parse or construct cursors client-side. servers: - url: https://api.totalis.trade description: Production security: - ApiKey: [] tags: - name: Markets description: Cached Kalshi and Polymarket market data. - name: User description: User profile, wallet, and devnet helpers. - name: API Keys description: Manage programmatic access keys for the authenticated user. paths: /markets/{ticker}: get: tags: - Markets summary: Get Market description: >- Fetch a single Kalshi market by ticker or a single Polymarket market by condition ID. When `venue` is omitted, the API infers Polymarket for condition IDs that look like `0x...`; otherwise it looks up the market as Kalshi. operationId: getMarket parameters: - name: ticker in: path required: true description: Kalshi market ticker or Polymarket `condition_id`. schema: type: string maxLength: 160 pattern: ^[A-Za-z0-9_.:-]+$ - name: venue in: query required: false description: >- Optional venue hint. Use this when the caller already knows whether the ticker belongs to Kalshi or Polymarket. schema: $ref: '#/components/schemas/Venue' responses: '200': description: Market details content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/Market' '400': $ref: '#/components/responses/BadRequest' '404': $ref: '#/components/responses/NotFound' security: [] components: schemas: Venue: type: string enum: - kalshi - polymarket description: Source venue for a market. Market: type: object properties: ticker: type: string description: >- Unique market identifier on its venue. **Kalshi**: market ticker (e.g. `KXBTC-25FEB07-T100000`). **Polymarket**: `condition_id`, the 0x-prefixed hex string from Polymarket's CTF (e.g. `0x4d2…`); not the gamma id, question id, or market slug. Yes/no CLOB token ids are not returned by this API. event_ticker: type: string description: >- Event identifier the market belongs to. **Kalshi**: event ticker (e.g. `KXBTC-25FEB07`). **Polymarket**: Gamma `event_slug` (falls back to `market_slug` when no parent event exists). series_ticker: type: string description: >- Series identifier the event belongs to. **Kalshi**: series ticker (e.g. `KXBTC`). **Polymarket**: Gamma `market_slug` — Polymarket has no native series concept, so we key whitelisting on the market slug. title: type: string subtitle: type: string nullable: true yes_sub_title: type: string nullable: true no_sub_title: type: string nullable: true bet_group: type: string nullable: true description: >- Polymarket-only: section label for the row (e.g. "Match O/U 21.5"). Always null on Kalshi rows. category: type: string subcategory: type: string nullable: true frequency: type: string nullable: true description: >- Cadence of the underlying series: daily/weekly/monthly/hourly/other. Null for categories without timeframe pills. venue: $ref: '#/components/schemas/Venue' status: type: string yes_bid: type: number yes_ask: type: number no_bid: type: number no_ask: type: number last_price: type: number price_to_beat: type: number nullable: true description: >- Reference price for Polymarket up/down markets. Null on Kalshi and on non-up/down Polymarket markets. volume: type: integer volume_24h: type: integer open_interest: type: integer venue_url: type: string nullable: true description: Canonical market URL on its source venue. open_time: type: string format: date-time close_time: type: string format: date-time expiration_time: type: string format: date-time exclusion_keys: type: array items: type: string description: >- Parlay-correlation keys. Two markets **cannot co-exist in the same parlay if (and only if) their `exclusion_keys` arrays intersect** — i.e. share at least one string. Apply a pure set-intersection; there is no rule table to maintain client-side. The keys encode every correlation rule (cross-series exclusion groups, threshold ladders, same-game sports family/kind/participant correlation, Polymarket sub-events). Keys are opaque and namespaced by reason and scope (e.g. `kp::moneyline|spread`, `grp::`, `fam::`), and are derived solely from the market itself, so a selected leg can snapshot its keys and compare them later. The plain one-leg-per-event rule (same `event_ticker`) is intentionally not encoded here. Always present; an empty array means the market participates in no correlation rule. ErrorEnvelope: type: object required: - error properties: error: $ref: '#/components/schemas/ErrorBody' ErrorBody: type: object required: - code - message properties: code: type: string enum: - VALIDATION_ERROR - UNAUTHORIZED - FORBIDDEN - NOT_FOUND - CONFLICT - RATE_LIMITED - PAYLOAD_TOO_LARGE - INTERNAL_ERROR - SERVICE_UNAVAILABLE description: Machine-readable error code. message: type: string description: Human-readable error message. details: type: object description: Additional error context. retry_after: type: integer nullable: true description: Seconds until retry; set on 429 responses. responses: BadRequest: description: Validation error content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' NotFound: description: Resource not found content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' example: error: code: NOT_FOUND message: Resource not found securitySchemes: ApiKey: type: apiKey in: header name: X-API-Key description: >- Programmatic API key. Sent as `X-API-Key: `. Generate one from the Totalis dashboard. The same header is accepted on the WebSocket auth message. ````