# Vertex API Documentation > API and WebSocket reference for Vertex partners REST request and response schemas: [OpenAPI 3.1 spec](/openapi/vertex.json). ## Table of Contents - [Introduction](https://docs.vertex-api.com/docs/intro): A B2B low-latency real-time sports odds and trading API. - [Quickstart](https://docs.vertex-api.com/docs/quickstart): Confirm your Vertex credentials work in two checks: one REST call and one WebSocket connection. - [🗂️ Data Hierarchy](https://docs.vertex-api.com/docs/concepts/data-hierarchy): Every price in the Vertex feed is anchored to a five-level hierarchy: **Sport → Competition → Event → Market → Selection**. Understanding this stru... - [💡 Concepts Overview](https://docs.vertex-api.com/docs/concepts/overview): Vertex is the B2B odds delivery API of a quantitative sports betting syndicate and odds provider. It gives external clients programmatic access to ... - [⚖️ Stake Limits](https://docs.vertex-api.com/docs/concepts/stake-limits): Every market carries a **minimum** and **maximum** stake. Read them over REST with [`GET /events/{eventId}/markets?expand=stake_limits`](../rest-ap... - [🔑 Authentication](https://docs.vertex-api.com/docs/rest-api/authentication): Every request takes a Bearer token; the same key also authenticates the WebSocket feed. - [⚠️ Errors](https://docs.vertex-api.com/docs/rest-api/errors): The JSON error envelope and the HTTP status codes returned on failed requests. - [Get a bet by reference](https://docs.vertex-api.com/docs/rest-api/get-bet-by-reference): Look up a bet by the `bet_reference` you supplied when placing it. This lets you retrieve a bet using your own identifier instead of our bet id. If... - [Get a bet](https://docs.vertex-api.com/docs/rest-api/get-bet): Fetch a single bet by its id. Returns the full bet record, including its current status and the selection it was placed on. Use the id returned to ... - [List bets](https://docs.vertex-api.com/docs/rest-api/get-bets): Returns bets placed by your API key, filtered by time window, event, sport, and other dimensions. - [Get a competition](https://docs.vertex-api.com/docs/rest-api/get-competition): Fetch a single competition by its id. Returns the same competition object you get from the list endpoint. Use this when you already hold a competit... - [List competitions](https://docs.vertex-api.com/docs/rest-api/get-competitions): Returns the competitions your API key has access to: leagues, tournaments, championships, etc. Filter by `sport_id` to scope to one sport; use `exp... - [Get event by ID](https://docs.vertex-api.com/docs/rest-api/get-event): Returns a single event by its `id`. Use `expand` to embed sport, competition, and participants inline. - [List events](https://docs.vertex-api.com/docs/rest-api/get-events): Returns events the API key has access to. Filter by sport, competition, or time window, or use `has_prices` to get back only events that have price... - [Get a market](https://docs.vertex-api.com/docs/rest-api/get-market): Fetch a single market on an event by its id. Use `expand` to fold in selections, participants, or stake limits in the same call. This returns the s... - [List markets for an event](https://docs.vertex-api.com/docs/rest-api/get-markets): Returns the markets priced for a single event. Each market represents a betting line (moneyline, totals, spreads, etc.) and has one or more selecti... - [Get a participant](https://docs.vertex-api.com/docs/rest-api/get-participant): Fetch a single participant by its id. Returns the same participant object you get from the list endpoint. Use this when you already hold a particip... - [List participants](https://docs.vertex-api.com/docs/rest-api/get-participants): Returns the participants your API key has access to: teams and players that compete in events. Responses are paginated — the participant catalog ru... - [Get a selection](https://docs.vertex-api.com/docs/rest-api/get-selection): Fetch a single selection by its id. The response includes the selection with its current Vertex price. Use this to refresh the price on one selecti... - [Get a sport](https://docs.vertex-api.com/docs/rest-api/get-sport): Fetch a single sport by its id. Returns the same sport object you get from the list endpoint, including its code. Use this when you already hold a ... - [List sports](https://docs.vertex-api.com/docs/rest-api/get-sports): Returns every sport your API key has access to. This is the entry point to the catalog: every pricing call and bet placement is ultimately scoped t... - [🧭 Overview](https://docs.vertex-api.com/docs/rest-api/overview): HTTP endpoints for catalog discovery, pricing, and bet placement, with base URLs and conventions. - [Place a bet](https://docs.vertex-api.com/docs/rest-api/place-bet): Places a bet on a single selection at a given price. The request must reference a `selection_id` from `GET /events/{eventId}/markets?expand=selecti... - [Place a Bet](https://docs.vertex-api.com/docs/rest-api/walkthroughs/place-a-bet): End-to-end walkthrough for placing a bet against Vertex: discover a sport, find a scheduled event, pick a selection, resolve your account reference... - [🔑 Authentication](https://docs.vertex-api.com/docs/websocket/authentication): Connect with your API key passed as a token query parameter; what the handshake accepts and rejects. - [⚠️ WebSocket Errors](https://docs.vertex-api.com/docs/websocket/errors): Handshake failures, subscribe errors, in-stream error messages, and close codes. - [💓 Heartbeat](https://docs.vertex-api.com/docs/websocket/heartbeat): The optional client-initiated ping/pong you can use as a liveness and latency check. - [✉️ Message Format](https://docs.vertex-api.com/docs/websocket/messages): The flat message envelope and the per-channel payloads for event and market updates. - [📡 WebSocket Overview](https://docs.vertex-api.com/docs/websocket/overview): How the real-time feed works, the two partner channels, and when to use it over REST. - [🔄 Reconnecting](https://docs.vertex-api.com/docs/websocket/reconnect): What happens on disconnect (no replay) and how to re-subscribe and re-baseline from REST. - [🔔 Subscriptions](https://docs.vertex-api.com/docs/websocket/subscriptions): Subscribe and unsubscribe to channels, filter by event, and the replace-on-resubscribe rule. - [Changelog](https://docs.vertex-api.com/docs/changelog): This page records changes to the Vertex API — the REST endpoints, the WebSocket feed, and the developer documentation itself. New capabilities, upd...