developers:api [Documentation]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
<note warning>**Legacy — V1.** This page documents the ''/v1'' WebSocket API and is retained for existing integrations. New development should use [[developers:apiv2|V2]]. See [[developers:apiv2:migrating|Migrating from V1]].</note>


====== Plus500 Futures Technologies WebSocket API ======

Welcome to the **Plus500 Futures Technologies WebSocket API**! Our API delivers **high-performance, real-time market data and trading capabilities** using **Google Protocol Buffers (Protobuf)** for ultra-efficient binary messaging. Designed for **speed, scalability, and security**, this API ensures seamless access to market data and order execution with minimal latency.

With an **industry-standard design**, it is easy to integrate and built to meet the demands of **futures traders, risk managers, and financial platforms**.

===== Key Capabilities =====

^ Feature ^ Included ^ Description ^
| **Real-time Quotes** | ✅ | Stream live bid/ask price updates for any instrument. |
| **Level 1 Data** | ✅ | Access top-of-book best bid and offer (BBO). |
| **Level 2 (Market Depth)** | ✅ | View **up to 10 levels** of bid/ask depth. |
| **Market by Order (MBO)** | ✅ | See individual resting orders in the order book. |
| **Trade Feed (Ticker)** | ✅ | Get a **real-time execution stream** of all trades. |
| **Order Management** | ✅ | Submit, modify, and cancel orders programmatically. |
| **Position & Account Monitoring** | ✅ | Track open positions, P&L, and margin usage. |
| **Instrument Metadata** | ✅ | Retrieve contract specs, tick sizes, and margin requirements. |
| **Spread Trading** | ✅ | Execute spread orders with **complex multi-leg strategies**. |
| **Risk & Margin Data** | ✅ | Get real-time margin requirements and risk exposure. |
| **Historical Data Requests** | ✅ | Fetch recent trade history and market activity. |
| **Efficient Binary Encoding** | ✅ | Uses Protobuf for **low-bandwidth, high-speed** messaging. |
| **Secure Authentication** | ✅ | Ensures safe access with API key-based authentication. |
| **Robust Reconnection** | ✅ | Auto-reconnect and resume subscriptions on disconnection. |

===== Why Use This API? =====

  * **Fast & Reliable** – Designed for **high-frequency updates and real-time execution**.
  * **Compact & Efficient** – Protobuf minimizes bandwidth, ensuring **fast message processing**.
  * **Comprehensive Market Data** – Access **Level 1, Level 2, and Market by Order** data.
  * **Built for Futures Trading** – Includes **contract metadata, spread trading, and risk monitoring**.
  * **Scalable & Industry-Proven** – Handles **thousands of concurrent connections**.
  * **Secure & Encrypted** – Uses **WSS (WebSocket Secure) over SSL/TLS** to protect data.
  * **Event-Driven & Easy to Integrate** – A simple subscription model delivers the data you need.

===== Developer Guides =====

^ **Section**                                        ^ **Description**  ^
| **[[developers:websocket|WebSocket API Introduction]]** | Overview of WebSockets and Google Protocol Buffers used in the API. |
| **[[developers:websocket:messages|Message Reference]]** | Detailed message reference. |
| **[[developers:websocket:connecting|Connecting and Authenticating]]** | Instructions on establishing a connection and handling authentication. |
| **[[developers:websocket:markets|Market Data & Definitions]]** | How to retrieve market lists and understand market definition messages. |
| **[[developers:websocket:quotes|Quote Feed]]** | Subscribing to market data and processing MBP and MBO quotes. |
| **[[developers:websocket:accounts|Account Feed]]** | Receiving account, position, and order updates in real time. |
| **[[developers:websocket:orders|Order Routing]]** | Submitting orders, supported order types, rate limits, and handling updates. |
| **[[developers:websocket:pricing|Pricing and Data Types]]** | Understanding price formatting and how decimal values are represented. |
| **[[developers:websocket:certification|Certification and Testing]]** | Development checklist and pre/post-certification requirements. |
| **[[developers:websocket:faq|FAQ]]** | Answers to common questions about the API. |