wickra-exchange-core 0.2.0

Core traits, types and shared connectivity machinery for wickra-exchange: a typed, unified API over the ten largest crypto exchanges.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91

//! # wickra-exchange-core
//!
//! Core traits, types and shared machinery for [`wickra-exchange`], a
//! streaming-native crypto-exchange connectivity library built on the Wickra
//! core.
//!
//! The crate exposes one typed, unified API — `Exchange` = `MarketData` +
//! `Execution` — implemented per exchange behind bespoke auth and WebSocket
//! state machines. Market-data streams are **pull-based** (`poll_events`), so
//! the same surface crosses the C ABI to every binding (including single-threaded
//! R) as trivially as a synchronous call.
//!
//! Order-layer quantities use [`rust_decimal::Decimal`], never `f64`: exchanges
//! reject mis-rounded prices and quantities, and float drift loses money.
//!
//! [`wickra-exchange`]: https://github.com/wickra-lib/wickra-exchange

mod clock;
mod credentials;
mod deadman;
mod error;
mod events;
mod exchanges;
mod feeds;
mod idempotency;
mod instruments;
mod normalize;
mod observability;
mod options;
mod orderbook;
mod positions;
mod ratelimiter;
mod reconcile;
mod retry;
mod signing;
mod symbol;
mod throttle;
mod traits;
mod transport;
mod types;
mod wsutil;

pub use clock::{NonceGenerator, ServerClock, TokenTtl};
pub use credentials::Credentials;
pub use deadman::DeadMansSwitch;
pub use error::{Error, Result};
pub use events::{BookDelta, BookLevel, Event, OrderBookSnapshot, TradePrint};
pub use exchanges::{
    Binance, Bitget, Bybit, Coinbase, Gate, Htx, Kraken, KuCoin, Okx, PaperExchange,
    ReplayExchange, Upbit,
};
pub use feeds::{
    cross_section, order_book_from_snapshot, trade_from_print, BreadthMember, DerivativesChannel,
    DerivativesFeed, DerivativesTickBuilder, FundingRate, Liquidation, LongShortRatio, MarkIndex,
    OpenInterest,
};
pub use idempotency::ClientIdGenerator;
pub use instruments::{Instrument, InstrumentCache, InstrumentFilters};
pub use normalize::{format_decimal, parse_decimal, parse_opt_decimal};
pub use observability::{redact, Health};
pub use options::{ExchangeOptions, MarginMode, MarketType, PositionMode, SelfTradePrevention};
pub use orderbook::{BookUpdate, OrderBookBuilder};
pub use positions::{Position, PositionSide};
pub use ratelimiter::{Acquire, WeightedRateLimiter};
pub use reconcile::{reconcile_orders, Reconciliation};
pub use retry::Backoff;
pub use signing::{
    hmac_sha256_base64, hmac_sha256_hex, hmac_sha512_base64, hmac_sha512_base64_with_b64_secret,
    hmac_sha512_bytes, hmac_sha512_hex, sha256, sha512_hex,
};
pub use symbol::Symbol;
pub use throttle::ThrottledTransport;
pub use traits::{
    AdvancedOrders, Derivatives, DerivativesStream, Exchange, Execution, MarketData, WsExecution,
    WsUserData,
};
pub use transport::{
    HttpMethod, HttpRequest, HttpResponse, HttpTransport, MockHttpTransport, MockWsTransport,
    WsConnection, WsTransport,
};
pub use types::{
    Balance, OcoRequest, Order, OrderRequest, OrderSide, OrderStatus, OrderType, Ticker,
    TimeInForce,
};

/// Re-export of [`wickra_core::Candle`], the candle type returned by
/// [`MarketData::klines`] so market data feeds the indicator core directly.
pub use wickra_core::Candle;

/// The crate version, sourced from `Cargo.toml`.
pub const VERSION: &str = env!("CARGO_PKG_VERSION");