StreamBboBook gRPC Method

이 방식은 데이터 사용량을 기준으로 0.0165 MB당 10 API 크레딧으로 과금된다는 점에 유의하시기 바랍니다.

매개변수

동전

반복되는 문자열

로딩 중...

반품

스트림

stream<BboBookUpdate>

로딩 중...

동전

문자열

로딩 중...

시간

uint64

로딩 중...

block_number

uint64

로딩 중...

bid

L2Level

로딩 중...

ask

L2Level

로딩 중...

요청

1
// StreamBboBook Example - Stream top-of-book best bid/ask changes via gRPC
2
패키지 main
3

4
import (
5
	"문맥"
6
	"깃발"
7
	"fmt"
8
	"io"
9
	"로그"
10
	"수학"
11
	"문자열"
12
	"시간"
13

14
	"google.golang.org/grpc"
15
	"google.golang.org/grpc/codes"
16
	"google.golang.org/grpc/credentials"
17
	"google.golang.org/grpc/metadata"
18
	"google.golang.org/grpc/status"
19

20
	pb "hyperliquid-orderbook-example/proto"
21
)
22

23
const (
24
	grpcEndpoint = "your-endpoint.hype-mainnet.quiknode.pro:10000"
25
	authToken    = "your-auth-token"
26
	maxRetries   = 10
27
	baseDelay    = 2 * time.초
28
)
29

30
func streamBboBook(coins []string) error {
31
	fmt.PrintlnPrintln문자열.반복("=", 60))
32
	fmt.Printf("Streaming BBO Book for %s\n", strings.Join(coins, ", "))
33
	fmt.PrintlnPrintln ("자동 재연결: true")
34
	fmt.PrintlnPrintln문자열.반복("=", 60) + "\n")
35

36
	retryCount := 0
37

38
	for retryCount < maxRetries {
39
		creds := 인증 정보.NewClientTLSFromCert(nil, "")
40
		conn, err := grpc.Dial(grpcEndpoint,
41
			grpc.WithTransportCredentials(creds),
42
			grpc.WithDefaultCallOptions(grpc.MaxCallRecvMsgSize(100*1024*1024)))
43
		만약 err != nil {
44
			return fmt.Errorf("연결 실패: %w", err)
45
		}
46

47
		클라이언트 := pb.NewOrderBookStreamingClient)(conn)
48
		ctx := 메타데이터.AppendToOutgoingContext(컨텍스트.배경(), "x-token", authToken)
49

50
		request := &pb.BboBookRequest{
51
			동전: 동전,
52
		}
53

54
		if retryCount > 0 {
55
			fmt.Printf("\n🔄 재연결 중 (시도 %d/%d)...\n", retryCount+1, maxRetries)
56
		} else {
57
			fmt.Printf("%s에 연결 중...\n", printf("%s에 연결 중...\n",)
58
		}
59

60
		stream, err := client.StreamBboBook(ctx, request)
61
		만약 err != nil {
62
			conn.닫기()
63
			return fmt.Errorf("스트림 시작에 실패했습니다: %w", err)
64
		}
65

66
		msgCount := 0
67
		shouldRetry := false
68

69
		~을 위해 {
70
			업데이트, 오류 := 스트림.Recv()
71
			만약 err == io.EOF {
72
				중단
73
			}
74
			만약 err != nil {
75
				st, 알겠습니다 := 상태.FromError(err)
76
				만약 ok && st.코드() == 코드.DataLoss {
77
					fmt.Printf("\n⚠️  서버 재초기화됨: %s\n", st.메시지())
78
					retryCount++
79
					if retryCount < maxRetries {
80
						지연 := 기본지연 * time.Duration(수학.Pow(2, float64(retryCount-1)))
81
						fmt.Printf("⏳ 재연결하기 전 %v 동안 대기 중...\n", delay)
82
						시간.수면(지연)
83
						shouldRetry = true
84
						중단
85
					} else {
86
						fmt.Printf("\n❌ 최대 재시도 횟수(%d)에 도달했습니다. 중단합니다.\n", maxRetries)
87
						conn.닫기()
88
						return nil
89
					}
90
				}
91
				conn.닫기()
92
				return fmt.Errorf("스트림 오류: %w", err)
93
			}
94

95
			msgCount++
96
			if msgCount == 1 {
97
				fmt.Println("✓ First BBO update received!\n")
98
				retryCount = 0 // 성공 시 재설정
99
			}
100

101
			// Display BBO update
102
			fmt.PrintlnPrintln ("\n" + strings.반복("─", 60))
103
			fmt.Printf("Block: %d | Time: %d | Coin: %s\n", update.BlockNumber, update.Time, update.Coin)
104
			fmt.PrintlnPrintln문자열.반복("─", 60))
105

106
			// Display best ask
107
			if update.Ask != nil {
108
				fmt.Printf("  BEST ASK: %12s | %12s | (%d orders)\n", update.Ask.Px, update.Ask.Sz, update.Ask.N)
109
			} else {
110
				fmt.Println("  BEST ASK: (none)")
111
			}
112

113
			// Display best bid
114
			if update.Bid != nil {
115
				fmt.Printf("  BEST BID: %12s | %12s | (%d orders)\n", update.Bid.Px, update.Bid.Sz, update.Bid.N)
116
			} else {
117
				fmt.Println("  BEST BID: (none)")
118
			}
119

120
			// Display spread
121
			if update.Bid != nil && update.Ask != nil {
122
				fmt.Printf("  SPREAD:   (best bid: %s, best ask: %s)\n", update.Bid.Px, update.Ask.Px)
123
			}
124

125
			fmt.Printf("\n  수신된 메시지: %d\n", msgCount)
126
		}
127

128
		conn.닫기()
129

130
		만약 !shouldRetry {
131
			중단
132
		}
133
	}
134

135
	return nil
136
}
137

138
func main() {
139
	coinsFlag := flag.String("coins", "BTC", "Comma-separated coin symbols to stream (e.g., BTC,ETH)")
140

141
	깃발.구문 분석()
142

143
	동전 := 문자열.Split(*coinsFlag, ",")
144

145
	fmt.PrintlnPrintln ("\n" + strings.반복("=", 60))
146
	fmt.Println("Hyperliquid StreamBboBook Example")
147
	fmt.Printf("엔드포인트: %s\n", grpcEndpoint)
148
	fmt.PrintlnPrintln문자열.반복("=", 60))
149

150
	if err := streamBboBook(coins); err != nil {
151
		로그.치명적(err)
152
	}
153
}
154

1
// StreamBboBook Example - Stream top-of-book best bid/ask changes via gRPC
2
패키지 main
3

4
import (
5
	"문맥"
6
	"깃발"
7
	"fmt"
8
	"io"
9
	"로그"
10
	"수학"
11
	"문자열"
12
	"시간"
13

14
	"google.golang.org/grpc"
15
	"google.golang.org/grpc/codes"
16
	"google.golang.org/grpc/credentials"
17
	"google.golang.org/grpc/metadata"
18
	"google.golang.org/grpc/status"
19

20
	pb "hyperliquid-orderbook-example/proto"
21
)
22

23
const (
24
	grpcEndpoint = "your-endpoint.hype-mainnet.quiknode.pro:10000"
25
	authToken    = "your-auth-token"
26
	maxRetries   = 10
27
	baseDelay    = 2 * time.초
28
)
29

30
func streamBboBook(coins []string) error {
31
	fmt.PrintlnPrintln문자열.반복("=", 60))
32
	fmt.Printf("Streaming BBO Book for %s\n", strings.Join(coins, ", "))
33
	fmt.PrintlnPrintln ("자동 재연결: true")
34
	fmt.PrintlnPrintln문자열.반복("=", 60) + "\n")
35

36
	retryCount := 0
37

38
	for retryCount < maxRetries {
39
		creds := 인증 정보.NewClientTLSFromCert(nil, "")
40
		conn, err := grpc.Dial(grpcEndpoint,
41
			grpc.WithTransportCredentials(creds),
42
			grpc.WithDefaultCallOptions(grpc.MaxCallRecvMsgSize(100*1024*1024)))
43
		만약 err != nil {
44
			return fmt.Errorf("연결 실패: %w", err)
45
		}
46

47
		클라이언트 := pb.NewOrderBookStreamingClient)(conn)
48
		ctx := 메타데이터.AppendToOutgoingContext(컨텍스트.배경(), "x-token", authToken)
49

50
		request := &pb.BboBookRequest{
51
			동전: 동전,
52
		}
53

54
		if retryCount > 0 {
55
			fmt.Printf("\n🔄 재연결 중 (시도 %d/%d)...\n", retryCount+1, maxRetries)
56
		} else {
57
			fmt.Printf("%s에 연결 중...\n", printf("%s에 연결 중...\n",)
58
		}
59

60
		stream, err := client.StreamBboBook(ctx, request)
61
		만약 err != nil {
62
			conn.닫기()
63
			return fmt.Errorf("스트림 시작에 실패했습니다: %w", err)
64
		}
65

66
		msgCount := 0
67
		shouldRetry := false
68

69
		~을 위해 {
70
			업데이트, 오류 := 스트림.Recv()
71
			만약 err == io.EOF {
72
				중단
73
			}
74
			만약 err != nil {
75
				st, 알겠습니다 := 상태.FromError(err)
76
				만약 ok && st.코드() == 코드.DataLoss {
77
					fmt.Printf("\n⚠️  서버 재초기화됨: %s\n", st.메시지())
78
					retryCount++
79
					if retryCount < maxRetries {
80
						지연 := 기본지연 * time.Duration(수학.Pow(2, float64(retryCount-1)))
81
						fmt.Printf("⏳ 재연결하기 전 %v 동안 대기 중...\n", delay)
82
						시간.수면(지연)
83
						shouldRetry = true
84
						중단
85
					} else {
86
						fmt.Printf("\n❌ 최대 재시도 횟수(%d)에 도달했습니다. 중단합니다.\n", maxRetries)
87
						conn.닫기()
88
						return nil
89
					}
90
				}
91
				conn.닫기()
92
				return fmt.Errorf("스트림 오류: %w", err)
93
			}
94

95
			msgCount++
96
			if msgCount == 1 {
97
				fmt.Println("✓ First BBO update received!\n")
98
				retryCount = 0 // 성공 시 재설정
99
			}
100

101
			// Display BBO update
102
			fmt.PrintlnPrintln ("\n" + strings.반복("─", 60))
103
			fmt.Printf("Block: %d | Time: %d | Coin: %s\n", update.BlockNumber, update.Time, update.Coin)
104
			fmt.PrintlnPrintln문자열.반복("─", 60))
105

106
			// Display best ask
107
			if update.Ask != nil {
108
				fmt.Printf("  BEST ASK: %12s | %12s | (%d orders)\n", update.Ask.Px, update.Ask.Sz, update.Ask.N)
109
			} else {
110
				fmt.Println("  BEST ASK: (none)")
111
			}
112

113
			// Display best bid
114
			if update.Bid != nil {
115
				fmt.Printf("  BEST BID: %12s | %12s | (%d orders)\n", update.Bid.Px, update.Bid.Sz, update.Bid.N)
116
			} else {
117
				fmt.Println("  BEST BID: (none)")
118
			}
119

120
			// Display spread
121
			if update.Bid != nil && update.Ask != nil {
122
				fmt.Printf("  SPREAD:   (best bid: %s, best ask: %s)\n", update.Bid.Px, update.Ask.Px)
123
			}
124

125
			fmt.Printf("\n  수신된 메시지: %d\n", msgCount)
126
		}
127

128
		conn.닫기()
129

130
		만약 !shouldRetry {
131
			중단
132
		}
133
	}
134

135
	return nil
136
}
137

138
func main() {
139
	coinsFlag := flag.String("coins", "BTC", "Comma-separated coin symbols to stream (e.g., BTC,ETH)")
140

141
	깃발.구문 분석()
142

143
	동전 := 문자열.Split(*coinsFlag, ",")
144

145
	fmt.PrintlnPrintln ("\n" + strings.반복("=", 60))
146
	fmt.Println("Hyperliquid StreamBboBook Example")
147
	fmt.Printf("엔드포인트: %s\n", grpcEndpoint)
148
	fmt.PrintlnPrintln문자열.반복("=", 60))
149

150
	if err := streamBboBook(coins); err != nil {
151
		로그.치명적(err)
152
	}
153
}
154

1
// StreamBboBook Example - Stream top-of-book best bid/ask changes via gRPC
2
const grpc = require('@grpc/grpc-js');
3
const protoLoader = require('@grpc/proto-loader');
4
const path = require('path');
5

6
const GRPC_ENDPOINT = 'your-endpoint.hype-mainnet.quiknode.pro:10000';
7
const AUTH_TOKEN = 'your-auth-token';
8
const PROTO_PATH = path.join(__dirname, 'proto', 'orderbook.proto');
9

10
const 패키지 정의 = protoLoader.loadSync(PROTO_PATH, {
11
  keepCase: true,
12
  longs: String,
13
  열거형: String,
14
  기본값: true,
15
  oneofs: true
16
});
17
const proto = grpc.loadPackageDefinition(packageDefinition).hyperliquid;
18

19
함수 createClient() {
20
  돌아가기 new proto.OrderBookStreaming((
21
    GRPC_ENDPOINT,
22
    grpc.인증 정보.createSsl(),
23
    { 'grpc.max_receive_message_length': 100 * 1024 * 1024 }
24
  );
25
}
26

27
// Stream best bid/offer updates
28
async function streamBboBook(coins, autoReconnect = true, retryCount = 0) {
29
  콘솔.log('='.반복(60));
30
  console.log(`Streaming BBO Book for ${coins.length > 0 ? coins.join(', ') : 'all coins'}`);
31
  console.log(`Auto-reconnect: ${autoReconnect}`);
32
  콘솔.log('='.반복(60) + '\n');
33

34
  const maxRetries = 10;
35
  const baseDelay = 2000;
36

37
  while (retryCount < maxRetries) {
38
    const client = createClient();
39
    const 메타데이터 = new grpc.메타데이터();
40
    메타데이터.추가('x-token', AUTH_TOKEN);
41

42
    const request = {
43
      동전: 동전
44
    };
45

46
    시도해 보세요 {
47
      만약 (retryCount > 0) {
48
        console.log(`\n🔄 Reconnecting (attempt ${retryCount + 1}/${maxRetries})...`);
49
      } else {
50
        console.log(`Connecting to ${GRPC_ENDPOINT}...`);
51
      }
52

53
      let msgCount = 0;
54
      const call = client.StreamBboBook(request, metadata);
55

56
      호출.on('data', (업데이트) => {
57
        msgCount++;
58

59
        만약 (msgCount === 1) {
60
          console.log('✓ First BBO update received!\n');
61
          retryCount = 0; // 성공 시 재설정
62
        }
63

64
        콘솔.log('\n' + '─'.반복(60));
65
        console.log(`Block: ${update.block_number} | Time: ${update.time} | Coin: ${update.coin}`);
66
        콘솔.log('─'.반복(60));
67

68
        // Display best ask
69
        if (update.ask) {
70
          console.log(`  BEST ASK: ${update.ask.px.padStart(12)} | ${update.ask.sz.padStart(12)} | (${update.ask.n} orders)`);
71
        } else {
72
          console.log('  BEST ASK: (none)');
73
        }
74

75
        // Display best bid
76
        if (update.bid) {
77
          console.log(`  BEST BID: ${update.bid.px.padStart(12)} | ${update.bid.sz.padStart(12)} | (${update.bid.n} orders)`);
78
        } else {
79
          console.log('  BEST BID: (none)');
80
        }
81

82
        // Display spread
83
        if (update.bid && update.ask) {
84
          const bestBid = parseFloat(update.bid.px);
85
          const bestAsk = parseFloat(update.ask.px);
86
          const spread = bestAsk - bestBid;
87
          const spreadBps = (spread / bestBid) * 10000;
88
          console.log(`  SPREAD:   ${spread.toFixed(2)} (${spreadBps.toFixed(2)} bps)`);
89
        }
90

91
        console.log(`\n  Messages received: ${msgCount}`);
92
      });
93

94
      호출.on('error', (err) => {
95
        만약 (err.코드 === grpc.상태.DATA_LOSS && autoReconnect) {
96
          console.log(`\n⚠️  Server reinitialized: ${err.message}`);
97
          retryCount++;
98
          if (retryCount < maxRetries) {
99
            const delay = baseDelay * Math.pow(2, retryCount - 1);
100
            console.log(`⏳ Waiting ${delay / 1000}s before reconnecting...`);
101
            setTimeout(() => streamBboBook(coins, autoReconnect, retryCount), delay);
102
          } else {
103
            console.log(`\n❌ Max retries (${maxRetries}) reached. Giving up.`);
104
          }
105
        } else {
106
          콘솔.오류('\ngRPC 오류:', err.code, '-', err.메시지);
107
        }
108
      });
109

110
      호출.on('end', () => {
111
        콘솔.log('\n스트림 종료됨');
112
      });
113

114
      // Wait for stream to complete
115
      기다리다 새로운 약속((결심) => {
116
        호출.on('end', 해결);
117
        호출.on('error', 해결);
118
      });
119

120
      break; // 성공 시 재시도 루프 종료
121

122
    } catch (err) {
123
      콘솔.오류('오류:', err.message);
124
      break;
125
    }
126
  }
127
}
128

129
// Parse command line args
130
const args = process.argv.slice(2);
131
const coins = (args.find(a => a.startsWith('--coins='))?.split('=')[1] || 'BTC').split(',');
132

133
콘솔.log('\n' + '='.반복(60));
134
console.log('Hyperliquid StreamBboBook Example');
135
console.log(`Endpoint: ${GRPC_ENDPOINT}`);
136
콘솔.log('='.반복(60));
137

138
streamBboBook(coins);
139

1
// StreamBboBook Example - Stream top-of-book best bid/ask changes via gRPC
2
const grpc = require('@grpc/grpc-js');
3
const protoLoader = require('@grpc/proto-loader');
4
const path = require('path');
5

6
const GRPC_ENDPOINT = 'your-endpoint.hype-mainnet.quiknode.pro:10000';
7
const AUTH_TOKEN = 'your-auth-token';
8
const PROTO_PATH = path.join(__dirname, 'proto', 'orderbook.proto');
9

10
const 패키지 정의 = protoLoader.loadSync(PROTO_PATH, {
11
  keepCase: true,
12
  longs: String,
13
  열거형: String,
14
  기본값: true,
15
  oneofs: true
16
});
17
const proto = grpc.loadPackageDefinition(packageDefinition).hyperliquid;
18

19
함수 createClient() {
20
  돌아가기 new proto.OrderBookStreaming((
21
    GRPC_ENDPOINT,
22
    grpc.인증 정보.createSsl(),
23
    { 'grpc.max_receive_message_length': 100 * 1024 * 1024 }
24
  );
25
}
26

27
// Stream best bid/offer updates
28
async function streamBboBook(coins, autoReconnect = true, retryCount = 0) {
29
  콘솔.log('='.반복(60));
30
  console.log(`Streaming BBO Book for ${coins.length > 0 ? coins.join(', ') : 'all coins'}`);
31
  console.log(`Auto-reconnect: ${autoReconnect}`);
32
  콘솔.log('='.반복(60) + '\n');
33

34
  const maxRetries = 10;
35
  const baseDelay = 2000;
36

37
  while (retryCount < maxRetries) {
38
    const client = createClient();
39
    const 메타데이터 = new grpc.메타데이터();
40
    메타데이터.추가('x-token', AUTH_TOKEN);
41

42
    const request = {
43
      동전: 동전
44
    };
45

46
    시도해 보세요 {
47
      만약 (retryCount > 0) {
48
        console.log(`\n🔄 Reconnecting (attempt ${retryCount + 1}/${maxRetries})...`);
49
      } else {
50
        console.log(`Connecting to ${GRPC_ENDPOINT}...`);
51
      }
52

53
      let msgCount = 0;
54
      const call = client.StreamBboBook(request, metadata);
55

56
      호출.on('data', (업데이트) => {
57
        msgCount++;
58

59
        만약 (msgCount === 1) {
60
          console.log('✓ First BBO update received!\n');
61
          retryCount = 0; // 성공 시 재설정
62
        }
63

64
        콘솔.log('\n' + '─'.반복(60));
65
        console.log(`Block: ${update.block_number} | Time: ${update.time} | Coin: ${update.coin}`);
66
        콘솔.log('─'.반복(60));
67

68
        // Display best ask
69
        if (update.ask) {
70
          console.log(`  BEST ASK: ${update.ask.px.padStart(12)} | ${update.ask.sz.padStart(12)} | (${update.ask.n} orders)`);
71
        } else {
72
          console.log('  BEST ASK: (none)');
73
        }
74

75
        // Display best bid
76
        if (update.bid) {
77
          console.log(`  BEST BID: ${update.bid.px.padStart(12)} | ${update.bid.sz.padStart(12)} | (${update.bid.n} orders)`);
78
        } else {
79
          console.log('  BEST BID: (none)');
80
        }
81

82
        // Display spread
83
        if (update.bid && update.ask) {
84
          const bestBid = parseFloat(update.bid.px);
85
          const bestAsk = parseFloat(update.ask.px);
86
          const spread = bestAsk - bestBid;
87
          const spreadBps = (spread / bestBid) * 10000;
88
          console.log(`  SPREAD:   ${spread.toFixed(2)} (${spreadBps.toFixed(2)} bps)`);
89
        }
90

91
        console.log(`\n  Messages received: ${msgCount}`);
92
      });
93

94
      호출.on('error', (err) => {
95
        만약 (err.코드 === grpc.상태.DATA_LOSS && autoReconnect) {
96
          console.log(`\n⚠️  Server reinitialized: ${err.message}`);
97
          retryCount++;
98
          if (retryCount < maxRetries) {
99
            const delay = baseDelay * Math.pow(2, retryCount - 1);
100
            console.log(`⏳ Waiting ${delay / 1000}s before reconnecting...`);
101
            setTimeout(() => streamBboBook(coins, autoReconnect, retryCount), delay);
102
          } else {
103
            console.log(`\n❌ Max retries (${maxRetries}) reached. Giving up.`);
104
          }
105
        } else {
106
          콘솔.오류('\ngRPC 오류:', err.code, '-', err.메시지);
107
        }
108
      });
109

110
      호출.on('end', () => {
111
        콘솔.log('\n스트림 종료됨');
112
      });
113

114
      // Wait for stream to complete
115
      기다리다 새로운 약속((결심) => {
116
        호출.on('end', 해결);
117
        호출.on('error', 해결);
118
      });
119

120
      break; // 성공 시 재시도 루프 종료
121

122
    } catch (err) {
123
      콘솔.오류('오류:', err.message);
124
      break;
125
    }
126
  }
127
}
128

129
// Parse command line args
130
const args = process.argv.slice(2);
131
const coins = (args.find(a => a.startsWith('--coins='))?.split('=')[1] || 'BTC').split(',');
132

133
콘솔.log('\n' + '='.반복(60));
134
console.log('Hyperliquid StreamBboBook Example');
135
console.log(`Endpoint: ${GRPC_ENDPOINT}`);
136
콘솔.log('='.반복(60));
137

138
streamBboBook(coins);
139

1
#!/usr/bin/env python3
2
"""
3
StreamBboBook Example - Stream top-of-book best bid/ask changes via gRPC
4

5
설정:
6
    pip install grpcio grpcio-tools protobuf zstandard
7
    python -m grpc_tools.protoc -I../../proto --python_out=. --grpc_python_out=. ../../proto/orderbook.proto
8

9
사용법:
10
    python stream_bbo_example.py --coins BTC,ETH
11
"""
12

13
import grpc
14
import sys
15
import 시간
16
import argparse
17

18
시도해 보세요:
19
    import orderbook_pb2 다음과 같이 pb
20
    import orderbook_pb2_grpc 다음과 같이 pb_grpc
21
except ImportError:
22
    인쇄("오류: Proto 파일이 생성되지 않았습니다. 다음을 실행하십시오:")
23
    인쇄("  python -m grpc_tools.protoc -I../../proto --python_out=. --grpc_python_out=. ../../proto/orderbook.proto")
24
    sys.exit(1)
25

26
# 구성
27
GRPC_ENDPOINT = "your-endpoint.hype-mainnet.quiknode.pro:10000"
28
AUTH_TOKEN = "your-auth-token"
29

30

31
def stream_bbo_book(coins: list, auto_reconnect: bool = True):
32
    """
33
    Stream best bid/offer (top-of-book) updates for one or more coins.
34

35
    인수:
36
        coins: Symbols to stream (e.g., ["BTC", "ETH"]). Empty list means all coins
37
        auto_reconnect: DATA_LOSS 오류 발생 시 자동 재연결 (기본값: True)
38
    """
39
    인쇄(f"\n{'='*60}")
40
    print(f"Streaming BBO Book for {', '.join(coins) if coins else 'all coins'}")
41
    print(f"Auto-reconnect: {auto_reconnect}")
42
    인쇄(f"{'='*60}\n")
43

44
    retry_count = 0
45
    max_retries = 10
46
    base_delay = 2
47

48
    while retry_count < max_retries:
49
        채널 = grpc.secure_channel(
50
            GRPC_ENDPOINT,
51
            grpc.ssl_channel_credentials(),
52
            옵션=[
53
                ('grpc.max_receive_message_length', 100 * 1024 * 1024),
54
                ('grpc.keepalive_time_ms', 30000),
55
            ]
56
        )
57
        스텁 = pb_grpc.OrderBookStreamingStub(채널)
58

59
        # 빌드 요청
60
        request = pb.BboBookRequest(coins=coins)
61

62
        msg_count = 0
63

64
        시도해 보세요:
65
            if retry_count > 0:
66
                인쇄(f"\n🔄 다시 연결 중 (시도 중 {재시도 횟수 + 1}/{최대 재시도 횟수})...")
67
            else:
68
                인쇄(f"연결 중 {GRPC_ENDPOINT}...")
69

70
            for update in stub.StreamBboBook(request, metadata=[('x-token', AUTH_TOKEN)]):
71
                msg_count += 1
72

73
                if msg_count == 1:
74
                    print(f"✓ First BBO update received!\n")
75
                    retry_count = 0  # 연결에 성공하면 재시도 횟수를 초기화합니다
76

77
                # Display the BBO update
78
                인쇄(f"\n{'─'*60}")
79
                print(f"Block: {update.block_number} | Time: {update.time} | Coin: {update.coin}")
80
                인쇄(f"{'─'*60}")
81

82
                # Show best ask
83
                if update.HasField('ask'):
84
                    print(f"  BEST ASK: {update.ask.px:>12} | {update.ask.sz:>12} | ({update.ask.n} orders)")
85
                else:
86
                    print("  BEST ASK: (none)")
87

88
                # Show best bid
89
                if update.HasField('bid'):
90
                    print(f"  BEST BID: {update.bid.px:>12} | {update.bid.sz:>12} | ({update.bid.n} orders)")
91
                else:
92
                    print("  BEST BID: (none)")
93

94
                # Show spread
95
                if update.HasField('bid') and update.HasField('ask'):
96
                    best_bid = float(update.bid.px)
97
                    best_ask = float(update.ask.px)
98
                    spread = best_ask - best_bid
99
                    spread_bps = (spread / best_bid) * 10000 if best_bid > 0 else 0
100
                    print(f"  SPREAD:   {spread:.2f} ({spread_bps:.2f} bps)")
101

102
                print(f"\n  Messages received: {msg_count}")
103

104
        단, grpc.RpcError 를 e:
105
            만약 e.코드() == grpc.StatusCode.DATA_LOSS 및 auto_reconnect:
106
                print(f"\n⚠️  Server reinitialized: {e.details()}")
107
                retry_count += 1
108
                if retry_count < max_retries:
109
                    지연 = 기본_지연 * (2 ** (retry_count - 1))  # 지수적 백오프
110
                    인쇄(f"⏳ 대기 중 {지연}초 후 재연결됩니다...")
111
                    시간.sleep(지연)
112
                    채널.닫기()
113
                    계속
114
                else:
115
                    인쇄(f"\n❌ 최대 재시도 횟수 ({max_retries})에 도달했습니다. 중단합니다.")
116
                    중단
117
            else:
118
                print(f"\ngRPC error: {e.code()} - {e.details()}")
119
                중단
120
        단, KeyboardInterrupt:
121
            print("\nStopping BBO stream...")
122
            중단
123
        드디어:
124
            채널.닫기()
125

126
        # 오류 없이 여기까지 도달했다면, 재시도 루프를 종료한다
127
        중단
128

129

130
def main():
131
    parser = argparse.ArgumentParser(description='Stream Hyperliquid best bid/offer data via gRPC')
132
    parser.add_argument('--coins', default='BTC', help='Comma-separated coin symbols to stream (e.g., BTC,ETH)')
133

134
    args = parser.parse_args()
135
    동전 = [c.strip() for c in args.coins.split(',') if c.strip()]
136

137
    인쇄(f"\n{'='*60}")
138
    print("Hyperliquid StreamBboBook Example")
139
    print(f"Endpoint: {GRPC_ENDPOINT}")
140
    인쇄(f"{'='*60}")
141

142
    시도해 보세요:
143
        stream_bbo_book(coins)
144
    단, 예외 ~처럼 e:
145
        print(f"\nError: {e}")
146
        import 트레이스백
147
        트레이스백.print_exc()
148
        sys.exit(1)
149

150

151
if __name__ == "__main__":
152
    main()
153

1
#!/usr/bin/env python3
2
"""
3
StreamBboBook Example - Stream top-of-book best bid/ask changes via gRPC
4

5
설정:
6
    pip install grpcio grpcio-tools protobuf zstandard
7
    python -m grpc_tools.protoc -I../../proto --python_out=. --grpc_python_out=. ../../proto/orderbook.proto
8

9
사용법:
10
    python stream_bbo_example.py --coins BTC,ETH
11
"""
12

13
import grpc
14
import sys
15
import 시간
16
import argparse
17

18
시도해 보세요:
19
    import orderbook_pb2 다음과 같이 pb
20
    import orderbook_pb2_grpc 다음과 같이 pb_grpc
21
except ImportError:
22
    인쇄("오류: Proto 파일이 생성되지 않았습니다. 다음을 실행하십시오:")
23
    인쇄("  python -m grpc_tools.protoc -I../../proto --python_out=. --grpc_python_out=. ../../proto/orderbook.proto")
24
    sys.exit(1)
25

26
# 구성
27
GRPC_ENDPOINT = "your-endpoint.hype-mainnet.quiknode.pro:10000"
28
AUTH_TOKEN = "your-auth-token"
29

30

31
def stream_bbo_book(coins: list, auto_reconnect: bool = True):
32
    """
33
    Stream best bid/offer (top-of-book) updates for one or more coins.
34

35
    인수:
36
        coins: Symbols to stream (e.g., ["BTC", "ETH"]). Empty list means all coins
37
        auto_reconnect: DATA_LOSS 오류 발생 시 자동 재연결 (기본값: True)
38
    """
39
    인쇄(f"\n{'='*60}")
40
    print(f"Streaming BBO Book for {', '.join(coins) if coins else 'all coins'}")
41
    print(f"Auto-reconnect: {auto_reconnect}")
42
    인쇄(f"{'='*60}\n")
43

44
    retry_count = 0
45
    max_retries = 10
46
    base_delay = 2
47

48
    while retry_count < max_retries:
49
        채널 = grpc.secure_channel(
50
            GRPC_ENDPOINT,
51
            grpc.ssl_channel_credentials(),
52
            옵션=[
53
                ('grpc.max_receive_message_length', 100 * 1024 * 1024),
54
                ('grpc.keepalive_time_ms', 30000),
55
            ]
56
        )
57
        스텁 = pb_grpc.OrderBookStreamingStub(채널)
58

59
        # 빌드 요청
60
        request = pb.BboBookRequest(coins=coins)
61

62
        msg_count = 0
63

64
        시도해 보세요:
65
            if retry_count > 0:
66
                인쇄(f"\n🔄 다시 연결 중 (시도 중 {재시도 횟수 + 1}/{최대 재시도 횟수})...")
67
            else:
68
                인쇄(f"연결 중 {GRPC_ENDPOINT}...")
69

70
            for update in stub.StreamBboBook(request, metadata=[('x-token', AUTH_TOKEN)]):
71
                msg_count += 1
72

73
                if msg_count == 1:
74
                    print(f"✓ First BBO update received!\n")
75
                    retry_count = 0  # 연결에 성공하면 재시도 횟수를 초기화합니다
76

77
                # Display the BBO update
78
                인쇄(f"\n{'─'*60}")
79
                print(f"Block: {update.block_number} | Time: {update.time} | Coin: {update.coin}")
80
                인쇄(f"{'─'*60}")
81

82
                # Show best ask
83
                if update.HasField('ask'):
84
                    print(f"  BEST ASK: {update.ask.px:>12} | {update.ask.sz:>12} | ({update.ask.n} orders)")
85
                else:
86
                    print("  BEST ASK: (none)")
87

88
                # Show best bid
89
                if update.HasField('bid'):
90
                    print(f"  BEST BID: {update.bid.px:>12} | {update.bid.sz:>12} | ({update.bid.n} orders)")
91
                else:
92
                    print("  BEST BID: (none)")
93

94
                # Show spread
95
                if update.HasField('bid') and update.HasField('ask'):
96
                    best_bid = float(update.bid.px)
97
                    best_ask = float(update.ask.px)
98
                    spread = best_ask - best_bid
99
                    spread_bps = (spread / best_bid) * 10000 if best_bid > 0 else 0
100
                    print(f"  SPREAD:   {spread:.2f} ({spread_bps:.2f} bps)")
101

102
                print(f"\n  Messages received: {msg_count}")
103

104
        단, grpc.RpcError 를 e:
105
            만약 e.코드() == grpc.StatusCode.DATA_LOSS 및 auto_reconnect:
106
                print(f"\n⚠️  Server reinitialized: {e.details()}")
107
                retry_count += 1
108
                if retry_count < max_retries:
109
                    지연 = 기본_지연 * (2 ** (retry_count - 1))  # 지수적 백오프
110
                    인쇄(f"⏳ 대기 중 {지연}초 후 재연결됩니다...")
111
                    시간.sleep(지연)
112
                    채널.닫기()
113
                    계속
114
                else:
115
                    인쇄(f"\n❌ 최대 재시도 횟수 ({max_retries})에 도달했습니다. 중단합니다.")
116
                    중단
117
            else:
118
                print(f"\ngRPC error: {e.code()} - {e.details()}")
119
                중단
120
        단, KeyboardInterrupt:
121
            print("\nStopping BBO stream...")
122
            중단
123
        드디어:
124
            채널.닫기()
125

126
        # 오류 없이 여기까지 도달했다면, 재시도 루프를 종료한다
127
        중단
128

129

130
def main():
131
    parser = argparse.ArgumentParser(description='Stream Hyperliquid best bid/offer data via gRPC')
132
    parser.add_argument('--coins', default='BTC', help='Comma-separated coin symbols to stream (e.g., BTC,ETH)')
133

134
    args = parser.parse_args()
135
    동전 = [c.strip() for c in args.coins.split(',') if c.strip()]
136

137
    인쇄(f"\n{'='*60}")
138
    print("Hyperliquid StreamBboBook Example")
139
    print(f"Endpoint: {GRPC_ENDPOINT}")
140
    인쇄(f"{'='*60}")
141

142
    시도해 보세요:
143
        stream_bbo_book(coins)
144
    단, 예외 ~처럼 e:
145
        print(f"\nError: {e}")
146
        import 트레이스백
147
        트레이스백.print_exc()
148
        sys.exit(1)
149

150

151
if __name__ == "__main__":
152
    main()
153

아직 계정이 없으신가요?

단 몇 초 만에 Quicknode 엔드포인트를 생성하고 개발을 시작하세요

지금 무료로 시작하세요