Skip to content

Latest commit

 

History

History
83 lines (60 loc) · 3.5 KB

README-zh_CN.md

File metadata and controls

83 lines (60 loc) · 3.5 KB
Raw

rust-bybit

Build Status

English | 简体中文

Rust 实现的 Bybit V5 版 WebSocket 行情和交易接口非官方 SDK。

免责声明

本项目是 Rust 实现的 Bybit 行情和交易接口非官方 SDK。加密货币市场风险巨大，使用本项目前请仔细评估风险，如因使用本项目而造成的一切损失均由使用者自行承担。

安装

将以下依赖加到 Cargo.toml

[dependencies]
rust-bybit = "0.2"

基础用法

根据需订阅的消息类型，创建对应的 client：

use bybit::ws::response::SpotPublicResponse;
use bybit::ws::spot;
use bybit::KlineInterval;
use bybit::WebSocketApiClient;

let mut client = WebSocketApiClient::spot().build();

订阅感兴趣的消息。例如下面的代码将订阅 ETHUSDT 交易对（杠杆代币为 BTC3SUSDT）的全部消息（关于有哪些消息类型可供订阅，请参考 Bybit V5 API）。注意直到 client.run 被调用时才会发送订阅请求：

let symbol = "ETHUSDT";
let lt_symbol = "BTC3SUSDT";

client.subscribe_orderbook(symbol, spot::OrderbookDepth::Level1);
client.subscribe_orderbook(symbol, spot::OrderbookDepth::Level50);
client.subscribe_trade(symbol);
client.subscribe_ticker(symbol);
client.subscribe_kline(symbol, KlineInterval::Min1);
client.subscribe_lt_kline(lt_symbol, KlineInterval::Min5);
client.subscribe_lt_ticker(lt_symbol);
client.subscribe_lt_nav(lt_symbol);

调用 client.run 方法并传入一个回调函数以启动 client。回调函数接受一个 WebSocket 应答枚举类型作为其唯一参数。每当收到一条 WebSocket 应答消息时，该回调函数都会被调用：

let callback = |res: SpotPublicResponse| match res {
    SpotPublicResponse::Orderbook(res) => println!("Orderbook: {:?}", res),
    SpotPublicResponse::Trade(res) => println!("Trade: {:?}", res),
    SpotPublicResponse::Ticker(res) => println!("Ticker: {:?}", res),
    SpotPublicResponse::Kline(res) => println!("Kline: {:?}", res),
    SpotPublicResponse::LtTicker(res) => println!("LtTicker: {:?}", res),
    SpotPublicResponse::LtNav(res) => println!("LtNav: {:?}", res),
    SpotPublicResponse::Op(res) => println!("Op: {:?}", res),
};

match client.run(callback) {
    Ok(_) => {}
    Err(e) => println!("{}", e),
}

以上是一个简单打印接收到的 WebSocket 应答消息的例子。examples 中还有一些更为实际的例子可供参考，例如通过订阅 Orderbook 维护一个本地订单薄。你可以运行 cargo run --example local_orderbook 启动此示例程序，程序启动后将在终端实时显示 ETHUSDT 10 档订单薄行情。

捐赠

您可以向下面的钱包地址进行捐赠以支持此项目的长远发展。

网络 钱包地址
Ethereum (ERC20) 0x2ef22ed84D6b57496dbb95257C4eb8F02cE9b7A6
BNB Smart Chain (BEP20) 0x869F8F9A78a18818F93061A02B233507b5F64151
Tron (TRC20) TPvqJYHFQ7iqEgtEcYrSLTjpGsAq41dhFt
Bitcoin 3C6o4ADGFXyuf6TUXKL6YyMyRfhek6zxzx