Join PocketOption with Six's affiliate link: Six PocketOption Affiliate link
Join PocketOption with Chipas affiliate link: Chipas PocketOption Affiliate link
A comprehensive, modern async Python API for PocketOption trading platform with advanced features including persistent connections, monitoring, and extensive testing frameworks.
This project is no longer actively developed, please switch to BinaryOptionsToolsV2
- Complete SSID Format Support: Works with full authentication strings from browser (format:
42["auth",{"session":"...","isDemo":1,"uid":...,"platform":1}]) - Persistent Connections: Automatic keep-alive with 20-second ping intervals (like the original API)
- Auto-Reconnection: Intelligent reconnection with multiple region fallback
- Connection Pooling: Optimized connection management for better performance
- Real-time Monitoring: Connection health, performance metrics, and error tracking
- Diagnostics Reports: Comprehensive health assessments with recommendations
- Performance Analytics: Response times, throughput analysis, and bottleneck detection
- Alert System: Automatic alerts for connection issues and performance problems
- Load Testing: Concurrent client simulation and stress testing
- Integration Testing: End-to-end validation of all components
- Performance Benchmarks: Automated performance analysis and optimization
- Advanced Test Suites: Edge cases, error scenarios, and long-running stability tests
- Message Batching: Efficient message queuing and processing
- Concurrent Operations: Parallel API calls for better throughput
- Caching System: Intelligent caching with TTL for frequently accessed data
- Rate Limiting: Built-in protection against API rate limits
- Graceful Degradation: Continues operation despite individual failures
- Automatic Recovery: Self-healing connections and operations
- Comprehensive Logging: Detailed error tracking and debugging information
- Exception Management: Type-specific error handling and recovery strategies
# Clone the repository
git clone <repository-url>
cd PocketOptionAPI
# Install dependencies
pip install -r requirements.txt
# For development
pip install -r requirements-dev.txtTo use the API with real data, you need to extract your session ID from the browser:
- Open PocketOption in your browser
- Open Developer Tools (F12)
- Go to Network tab
- Filter by WebSocket (WS)
- Look for authentication message starting with
42["auth" - Copy the complete message including the
42["auth",{...}]format
Example SSID format:
42["auth",{"session":"abcd1234efgh5678","isDemo":1,"uid":12345,"platform":1}]
If you are unable to find it, try running the automatic SSID scraper under the tools folder.
If you see errors like:
WARNING | pocketoptionapi_async.websocket_client:receive_messages:395 - WebSocket connection closed
WARNING | pocketoptionapi_async.client:_start_regular_connection:245 - Failed to connect to region DEMO: Authentication timeout
Solution: Your SSID is likely in the wrong format or is expired. Make sure you are using the complete SSID format, not just the session ID:
✅ Correct format:
SSID = '42["auth",{"session":"n1p5ah5u8t9438rbunpgrq0hlq","isDemo":1,"uid":84402008,"platform":1}]'❌ Wrong format (just the session):
SSID = 'dxxxxxxxxxxxxxxxxxxxxxxxxxxxx' # This won't work!To get the correct SSID:
- Open PocketOption in your browser
- Open Developer Tools (F12)
- Go to Network tab
- Filter by "WS" (WebSocket)
- Look for a message that starts with
42["auth", - Copy the entire message including the
42["auth",{...}]part
2025-07-13 15:25:16.531 | INFO | pocketoptionapi_async.client:__init__:130 - Initialized PocketOption client (demo=True, uid=105754921, persistent=False) with enhanced monitoring
2025-07-13 15:25:16.532 | INFO | pocketoptionapi_async.client:connect:162 - Connecting to PocketOption...
2025-07-13 15:25:16.532 | INFO | pocketoptionapi_async.client:_start_regular_connection:187 - Starting regular connection...
2025-07-13 15:25:16.532 | INFO | pocketoptionapi_async.client:_start_regular_connection:198 - Demo mode: Using demo regions: ['DEMO', 'DEMO_2']
2025-07-13 15:25:16.532 | INFO | pocketoptionapi_async.client:_start_regular_connection:219 - Trying region: DEMO with URL: wss://demo-api-eu.po.market/socket.io/?EIO=4&transport=websocket
2025-07-13 15:25:16.532 | INFO | pocketoptionapi_async.websocket_client:connect:162 - Attempting to connect to wss://demo-api-eu.po.market/socket.io/?EIO=4&transport=websocket
2025-07-13 15:25:16.556 | WARNING | pocketoptionapi_async.websocket_client:connect:206 - Failed to connect to wss://demo-api-eu.po.market/socket.io/?EIO=4&transport=websocket: BaseEventLoop.create_connection() got an unexpected keyword argument 'extra_headers'
2025-07-13 15:25:16.556 | WARNING | pocketoptionapi_async.client:_start_regular_connection:242 - Failed to connect to region DEMO: Failed to connect to any WebSocket endpoint
2025-07-13 15:25:16.556 | INFO | pocketoptionapi_async.client:_start_regular_connection:219 - Trying region: DEMO_2 with URL: wss://try-demo-eu.po.market/socket.io/?EIO=4&transport=websocket
2025-07-13 15:25:16.556 | INFO | pocketoptionapi_async.websocket_client:connect:162 - Attempting to connect to wss://try-demo-eu.po.market/socket.io/?EIO=4&transport=websocket
2025-07-13 15:25:16.558 | WARNING | pocketoptionapi_async.websocket_client:connect:206 - Failed to connect to wss://try-demo-eu.po.market/socket.io/?EIO=4&transport=websocket: BaseEventLoop.create_connection() got an unexpected keyword argument 'extra_headers'
2025-07-13 15:25:16.558 | WARNING | pocketoptionapi_async.client:_start_regular_connection:242 - Failed to connect to region DEMO_2: Failed to connect to any WebSocket endpoint
Traceback (most recent call last):
File "/Users/vigowalker/Downloads/resurgenthavoc_bot/test1.py", line 20, in <module>
asyncio.run(main())
File "/Users/vigowalker/Downloads/resurgenthavoc_bot/.conda/lib/python3.11/asyncio/runners.py", line 190, in run
return runner.run(main)
^^^^^^^^^^^^^^^^
File "/Users/vigowalker/Downloads/resurgenthavoc_bot/.conda/lib/python3.11/asyncio/runners.py", line 118, in run
return self._loop.run_until_complete(task)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/Users/vigowalker/Downloads/resurgenthavoc_bot/.conda/lib/python3.11/asyncio/base_events.py", line 654, in run_until_complete
return future.result()
^^^^^^^^^^^^^^^
File "/Users/vigowalker/Downloads/resurgenthavoc_bot/test1.py", line 9, in main
account_info = await client.get_balance()
^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/Users/vigowalker/Downloads/resurgenthavoc_bot/.conda/lib/python3.11/site-packages/pocketoptionapi_async/client.py", line 376, in get_balance
raise ConnectionError("Not connected to PocketOption")
pocketoptionapi_async.exceptions.ConnectionError: Not connected to PocketOption
to fix this error, run this commands:
pip uninstall websockets
pip install websockets==11.0
