# OddsPush

> Real-time Pinnacle odds over a single WebSocket: every price change pushed as it happens, plus a small REST API for the current state.

OddsPush streams live Pinnacle odds for 13 sports to trading bots. Clients connect to wss://feed.oddspush.com/v1/stream, log in with a key (opk_ followed by 43 characters) that works from one IP address at a time (a new IP takes over; nothing to set), subscribe by sport, event and channel, and keep a price book from snapshots and updates merged by market version. Accounts start with a 7-day trial activated on request on Telegram at @oddspush (https://t.me/oddspush).

If you are a coding agent building an OddsPush client, read the agent guide: it is complete and self-contained, with the full protocol, the book-keeping rules, reconnection policy, close codes and reference clients in Python and Node.js.

OddsPush is not affiliated with, endorsed by or sponsored by Pinnacle.

## Docs

- [OddsPush integration guide for coding agents](https://oddspush.com/oddspush-agent-guide.md): the full guide for agents, in one Markdown file
- [Streaming API reference](https://oddspush.com/docs): the human documentation