Pfun Real-Time WebSocket

Connect to the Pfun WebSocket for real-time price, orderbook, and trade updates.

---

Connection

Connect to the WebSocket endpoint:

Code sample:

• const ws = new WebSocket('wss://api.delphiterminal.co/ws/pfun');

---

Subscribing to Markets

Once connected, send a JSON message to subscribe to Pfun data using their market_id:

Code sample:

• {
• "action": "subscribe",
• "market_ids": ["market123", "market456"],
• "message_types": ["prices", "orderbook", "trades"]
• }

Subscription Fields

Field	Type	Required	Description
action	string	Yes	subscribe or unsubscribe
market_ids	array	Yes	Array of Pfun market identifiers
message_types	array	No	["prices"], ["orderbook"], ["trades"], or any combination. Defaults to prices and orderbook if omitted

---

Unsubscribing

Code sample:

• {
• "action": "unsubscribe",
• "market_ids": ["market123"]
• }

---

Message Types

Price Messages

Real-time price updates for subscribed markets:

Code sample:

• {
• "type": "prices",
• "data": {
• "exchange": "pfun",
• "market_id": "market123",
• "price": 0.65,
• "yes_bid": 0.64,
• "yes_ask": 0.66,
• "last_update": "2026-02-06T12:00:00Z"
• }
• }

Orderbook Messages

Real-time orderbook snapshots for subscribed markets:

Code sample:

• {
• "type": "orderbook",
• "data": {
• "exchange": "pfun",
• "market_id": "market123",
• "venue_market_id": "venue123",
• "best_yes_price": 65,
• "best_yes_size": 100,
• "best_no_price": 35,
• "best_no_size": 50,
• "yes_side": [100, 200, 300],
• "no_side": [50, 100, 150],
• "server_time": "2026-02-06T12:00:00Z"
• }
• }

Trade Messages

Real-time trade executions for subscribed markets:

Code sample:

• {
• "type": "trades",
• "data": {
• "exchange": "pfun",
• "market_id": "market123",
• "yes_price": 0.65,
• "no_price": 0.35,
• "count": 10,
• "taker_side": "buy",
• "last_update": "2026-02-06T12:00:00Z"
• }
• }

---

Full JavaScript Example

Code sample:

• const ws = new WebSocket('wss://api.delphiterminal.co/ws/pfun');
• ws.onopen = () => {
• console.log('Connected to Pfun WebSocket');
• // Subscribe to markets
• ws.send(JSON.stringify({
• action: 'subscribe',
• market_ids: ['market123'],
• message_types: ['prices', 'orderbook', 'trades']
• }));
• };
• ws.onmessage = (event) => {
• const data = JSON.parse(event.data);
• if (data.type === 'prices') {
• console.log('Price update:', data.data);
• } else if (data.type === 'orderbook') {
• console.log('Orderbook update:', data.data);
• } else if (data.type === 'trades') {
• console.log('Trade:', data.data);
• }
• };
• ws.onclose = () => {
• console.log('Disconnected from WebSocket');
• };
• ws.onerror = (error) => {
• console.error('WebSocket error:', error);
• };

---

Connection Details

Property	Value
Protocol	WebSocket (wss://)
Keepalive	Ping every 54 seconds
Timeout	60 seconds without pong
Max Message Size	16 KB

---

Notes

• No authentication required for WebSocket connection
• You must use market_id (Pfun market identifier) to subscribe
• Messages are only sent for markets you have explicitly subscribed to
• Multiple markets can be subscribed in a single message
• Subscribe to specific message types to reduce message volume
• Trades must be explicitly requested (not included in default subscription)

GET /ws/pfun

Response

101

WebSocket connection upgraded successfully